Method: customers.uploadConversionAdjustments

معالجة تعديلات الإحالات الناجحة المحدّدة.

قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadConversionAdjustments

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
customerId

string

مطلوبة. رقم تعريف العميل الذي يُجري عملية التحميل

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
الحقول
conversionAdjustments[]

object (ConversionAdjustment)

مطلوبة. تعديلات الإحالات الناجحة التي يتم تحميلها
partialFailure

boolean

مطلوبة. في حال الصواب، سيتم تنفيذ عمليات ناجحة وعرض العمليات غير الصالحة أخطاء. وفي حال كانت القيمة خاطئة، سيتم تنفيذ جميع العمليات في معاملة واحدة فقط إذا كانت جميعها صالحة. يجب ضبط هذه السياسة دائمًا على "صحيح". يمكنك الانتقال إلى https://developers.google.com/google-ads/api/docs/best-practices/partial-failures للحصول على مزيد من المعلومات حول الفشل الجزئي.
validateOnly

boolean

إذا كانت الإجابة "صحيح"، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط وليس النتائج.
jobId

integer

اختياريّ. إدخال اختياري لضبط معرّف الوظيفة يجب أن يكون الرقم غير سالب أقل من 2^31 إذا تم تقديمه. في حال عدم توفير هذا الحقل، ستنشئ واجهة برمجة التطبيقات معرّف الوظيفة في النطاق [2^31, (2^63)-1]. ستعرض واجهة برمجة التطبيقات قيمة هذا الطلب في الحقل jobId في UploadConversionAdjustmentsResponse.

نص الاستجابة

رسالة الرد لـ "ConversionAdjustmentUploadService.UploadConversionAdjustments".

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
الحقول
partialFailureError

object (Status)

الأخطاء التي تتعلّق بحالات تعذُّر تعديل الإحالات الناجحة في وضع الفشل الجزئي. يتم عرضه عند حدوث جميع الأخطاء داخل التعديلات. في حال حدوث أي أخطاء خارج التعديلات (على سبيل المثال، أخطاء المصادقة)، نعرض خطأً على مستوى استدعاء إجراء عن بُعد (RPC). يمكنك الانتقال إلى https://developers.google.com/google-ads/api/docs/best-practices/partial-failures للحصول على مزيد من المعلومات حول الفشل الجزئي.
results[]

object (ConversionAdjustmentResult)

يُعرَض لإجراء تعديلات الإحالات الناجحة التي تمت معالجتها بنجاح. سيكون Proto فارغًا للصفوف التي تلقّت خطأ. لا يتم عرض النتائج عندما تكون trueOnly صحيحة.
jobId

string (int64 format)

معرّف الوظيفة لدفعة التحميل

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adwords

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

ConversionAdjustment

تعديل الإحالة الناجحة.

تمثيل JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
الحقول
gclidDateTimePair

object (GclidDateTimePair)

بالنسبة إلى التعديلات، يُحدِّد بشكلٍ فريد الإحالة الناجحة التي تم الإبلاغ عنها بدون تحديد مُعرّف طلب. إذا كانت قيمة AdjustType هي "ENHANCEMENT"، تكون هذه القيمة اختيارية، ولكن يمكن ضبطها بالإضافة إلى قيمة orderId.
adjustmentType

enum (ConversionAdjustmentType)

نوع التسوية.
restatementValue

object (RestatementValue)

المعلومات اللازمة لإعادة صياغة قيمة الإحالة الناجحة. مطلوبة لإعادة الصياغة. يجب عدم توفير هذه السمة لطلب سحب المطالبات. سيظهر خطأ إذا تم توفيره لسحب الطلب. ملاحظة: إذا كنت تريد تحميل إعادة صياغة ثانية بقيمة معدَّلة مختلفة، يجب أن تتضمّن وقت ورود تعديل جديد وأحدث. وبخلاف ذلك، سيتم التعامل معه كنسخة مكرّرة من إعادة الصياغة السابقة وسيتم تجاهلها.
userIdentifiers[]

object (UserIdentifier)

أرقام تعريف المستخدِمين لتحسين الإحالة الناجحة الأصلية. لا تقبل ConversionEditUploadService سوى معرّفات المستخدمين في التحسينات. الحد الأقصى لعدد معرّفات المستخدمين لكل تحسين هو 5.
orderId

string

مُعرّف ترتيب الإحالة الناجحة المراد تعديلها. إذا تم تسجيل الإحالة الناجحة مع تحديد مُعرّف طلب، يجب استخدام مُعرّف الطلب هذا كمعرّف هنا. يجب إدخال مُعرّف الطلب لإجراء التحسينات.
conversionAction

string

اسم المورد لإجراء الإحالة الناجحة المرتبط بتعديل الإحالة الناجحة هذا. ملاحظة: على الرغم من أنّ اسم المورد هذا يتألف من رقم تعريف عميل ومعرّف إجراء إحالة ناجحة، ستتجاهل عملية التحقّق الرقم التعريفي للعميل وستستخدم رقم تعريف إجراء الإحالة الناجحة كمعرّف إجراء الإحالة الناجحة الوحيد.
adjustmentDateTime

string

التاريخ الذي حدث فيه التسوية. يجب أن يكون بعد conversionDateTime. يجب تحديد المنطقة الزمنية. التنسيق هو "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "01-01-2019 12:32:45-08:00".
userAgent

string

وكيل المستخدم لتحسين الإحالة الناجحة الأصلية. ويمكن العثور على ذلك في عنوان طلب HTTP الخاص بالمستخدم عند إجراء إحالة ناجحة على صفحة الويب. على سبيل المثال، "Mozilla/5.0 (iPhone؛ CPU iPhone OS 12_2 مثل Mac OS X)". لا يمكن تحديد وكيل المستخدم إلا في التحسينات التي تحتوي على معرّفات المستخدم. يجب أن يتطابق هذا مع وكيل المستخدم التابع للطلب الذي أرسل الإحالة الناجحة الأصلية، لذا تُنسب الإحالة الناجحة وتحسيناتها على أنّها على الجهاز نفسه أو على أنّها تنسب الإحالة الناجحة على جميع الأجهزة.

GclidDateTimePair

يحدِّد بشكلٍ فريد الإحالة الناجحة التي تم الإبلاغ عنها بدون تحديد مُعرّف طلب.

تمثيل JSON 
{
  "gclid": string,
  "conversionDateTime": string
}
الحقول
gclid

string

معرّف النقرة من Google (gclid) المرتبط بالإحالة الناجحة الأصلية لهذا التعديل.
conversionDateTime

string

تاريخ حدوث الإحالة الناجحة الأصلية لهذه التسوية. يجب تحديد المنطقة الزمنية. التنسيق هو "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "01-01-2019 12:32:45-08:00".

ConversionAdjustmentType

الإجراءات المختلفة التي يمكن للمعلنين اتّخاذها لتعديل الإحالات الناجحة التي سبق أن أبلوا عنها تؤدي عمليات السحب إلى إبطال الإحالة الناجحة. تُغير إعادة الصياغة قيمة الإحالة الناجحة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN يعرض قيمة غير معروفة في هذا الإصدار.
RETRACTION يتم إبطال الإحالة الناجحة بحيث يكون كل من قيمتها الإجمالية والعدد صفر.
RESTATEMENT تغيير قيمة الإحالة الناجحة.
ENHANCEMENT يُكمِّل إحالة ناجحة حالية بمعرِّفات المستخدم ووكيل المستخدم المقدَّمة، والتي يمكن أن تستخدمها Google لتحسين عدد الإحالات الناجحة.

RestatementValue

يحتوي على المعلومات اللازمة لإعادة صياغة قيمة الإحالة الناجحة.

تمثيل JSON 
{
  "adjustedValue": number,
  "currencyCode": string
}
الحقول
adjustedValue

number

قيمة الإحالة الناجحة بعد تعديلها. هذه هي قيمة الإحالة الناجحة بعد إعادة الصياغة. على سبيل المثال، لتغيير قيمة إحالة ناجحة من 100 إلى 70، يجب الإبلاغ عن قيمة معدَّلة تبلغ 70. ملاحظة: إذا كنت تريد تحميل إعادة صياغة ثانية بقيمة معدَّلة مختلفة، يجب أن تتضمّن وقت ورود تعديل جديد وأحدث. وبخلاف ذلك، سيتم التعامل معه كنسخة مكرّرة من إعادة الصياغة السابقة وسيتم تجاهلها.
currencyCode

string

عملة القيمة بعد تعديلها. وفي حال عدم توفيرها، يتم استخدام العملة التلقائية من إجراء الإحالة الناجحة. وفي حال تركها بدون ضبط، سيتم استخدام عملة الحساب. هذا هو رمز العملة ISO 4217 المؤلّف من 3 أحرف، مثلاً USD أو EUR.

ConversionAdjustmentResult

معلومات تحدّد تسوية إحالة ناجحة تمت معالجتها بنجاح.

تمثيل JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
الحقول
gclidDateTimePair

object (GclidDateTimePair)

مَعلمة GCLID وتاريخ الإحالة الناجحة ووقتها.
orderId

string

مُعرّف ترتيب الإحالة الناجحة المراد تعديلها.
adjustmentType

enum (ConversionAdjustmentType)

نوع التسوية.
conversionAction

string

اسم المورد لإجراء الإحالة الناجحة المرتبط بتعديل الإحالة الناجحة هذا.
adjustmentDateTime

string

التاريخ الذي حدث فيه التسوية. التنسيق هو "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "01-01-2019 12:32:45-08:00".