Method: customers.uploadConversionAdjustments

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

قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

طلب HTTP

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

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

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

المَعلمات
customerId

string

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

نص الطلب

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

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

object (ConversionAdjustment)

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

boolean

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

boolean

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

نص الاستجابة

رسالة الرد على 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 فارغًا للصفوف التي تتلقى خطأ. لا يتم عرض النتائج عندما تكون قيمة annotate Only صحيحة.
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، تكون هذه القيمة اختيارية، ولكن قد يتم ضبطها بالإضافة إلى مُعرّف الطلب.
adjustmentType

enum (ConversionAdjustmentType)

نوع التسوية
restatementValue

object (RestatementValue)

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

object (UserIdentifier)

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

string

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

string

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

string

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