REST Resource: accounts.conversionSources

المرجع: مصدر الإحالة الناجحة

يمثّل مصدر إحالة ناجحة يملكه حساب تاجر. يمكن أن يضم حساب التاجر ما يصل إلى 200 مصدر إحالة ناجحة.

تمثيل JSON 
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
الحقول
name

string

النتائج فقط. المُعرّف. يتم إنشاؤها باستخدام Content API عند إنشاء ConversionSource جديد. التنسيق: [a-z]{4}:.+ تمثّل الأحرف الأربعة قبل النقطتين نوع مصدر الإحالة الناجحة. ويمثّل المحتوى بعد النقطتين رقم تعريف مصدر الإحالة الناجحة ضمن ذلك النوع. قد يكون رقم تعريف مصدرَي إحالة ناجحة مختلفين متطابقَين على مستوى أنواع مختلفة. يمكن استخدام بادئات النوع التالية: - galk: بالنسبة إلى مصادر GoogleAnalyticsLink. - mcdn: للاطّلاع على مصادر MerchantCenterDestination
state

enum (State)

النتائج فقط. الحالة الحالية لمصدر الإحالة الناجحة هذا. لا يمكن التعديل من خلال واجهة برمجة التطبيقات.
expireTime

string (Timestamp format)

النتائج فقط. الوقت الذي يتم فيه حذف مصدر إحالة ناجحة مؤرشف نهائيًا ولا يصبح متاحًا لإلغاء حذفه.
controller

enum (Controller)

النتائج فقط. أداة التحكّم في مصدر الإحالة الناجحة
حقل الاتحاد source_data مطلوبة. بيانات مصدر الإحالة الناجحة الخاصة بكل نوع من أنواع المصادر المختلفة. يمكن أن يكون الحقل "source_data" واحدًا فقط مما يلي:
merchantCenterDestination

object (MerchantCenterDestination)

مصدر الإحالة الناجحة من نوع "وجهة علامة Merchant Center".

AttributionSettings

يمثل هذا الخيار إعدادات تحديد المصدر لمصادر الإحالات الناجحة التي تتلقّى بيانات ما قبل تحديد المصدر.

تمثيل JSON 
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
الحقول
attributionLookbackWindowDays

integer

مطلوبة. فترات معاينة الإعلان (بالأيام) المستخدَمة لتحديد المصدر في هذا المصدر القيم المسموح بها هي 7 و30 و40.
attributionModel

enum (AttributionModel)

مطلوبة. نموذج الإحالة.
conversionType[]

object (ConversionType)

غير قابل للتغيير. قائمة بدون ترتيب. قائمة بأنواع الإحالات الناجحة المختلفة التي يمكن تصنيف حدث إحالة ناجحة ضمنها. سيتم إنشاء نوع "شراء" عادي تلقائيًا إذا كانت هذه القائمة فارغة في وقت الإنشاء.

AttributionModel

نموذج تحديد المصدر المُستخدَم لهذا المصدر نتيح استخدام مجموعة النماذج نفسها التي يوفّرها "إحصاءات Google 4" على النحو الموضّح في الرابط التالي: https://support.google.com/analytics/answer/10596866.

عمليات التعداد
ATTRIBUTION_MODEL_UNSPECIFIED نموذج غير محدَّد.
CROSS_CHANNEL_LAST_CLICK نموذج "النقرة الأخيرة على جميع القنوات".
ADS_PREFERRED_LAST_CLICK نموذج النقرة الأخيرة من "إعلانات Google"
CROSS_CHANNEL_DATA_DRIVEN النموذج المستند إلى البيانات على جميع القنوات.
CROSS_CHANNEL_FIRST_CLICK نموذج النقرة الأولى على جميع القنوات.
CROSS_CHANNEL_LINEAR النموذج الخطي على جميع القنوات.
CROSS_CHANNEL_POSITION_BASED نموذج الاستناد إلى الموضع على جميع القنوات.
CROSS_CHANNEL_TIME_DECAY نموذج توقيت نقاط الاتصال على جميع القنوات.

ConversionType

رسالة تمثِّل أنواع أحداث الإحالات الناجحة

تمثيل JSON 
{
  "name": string,
  "report": boolean
}
الحقول
name

string

النتائج فقط. اسم حدث الإحالة الناجحة، كما سيبلغ عنه العميل.
report

boolean

النتائج فقط. خيار يشير إلى ما إذا كان يجب تضمين النوع في تقارير Merchant Center.

MerchantCenterDestination

يمكن استخدام مصادر "الوجهة في Merchant Center" لإرسال أحداث الإحالات الناجحة من متجر على الإنترنت باستخدام علامة Google مباشرةً إلى حساب على Merchant Center تم إنشاء المصدر فيه.

تمثيل JSON 
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
الحقول
destination

string

النتائج فقط. رقم تعريف الوجهة في Merchant Center
attributionSettings

object (AttributionSettings)

مطلوبة. إعدادات تحديد المصدر المُستخدَمة لوجهة Merchant Center
displayName

string

مطلوبة. الاسم المعروض الذي يحدّده التاجر للوجهة. هذا هو الاسم الذي يحدّد مصدر الإحالة الناجحة في واجهة مستخدم Merchant Center. يجب أن يتألف من 64 حرفًا كحدّ أقصى.
currencyCode

string

مطلوبة. رمز عملة مكوَّن من ثلاثة أحرف (ISO 4217). يحدّد رمز العملة العملة التي سيتم بها الإبلاغ عن الإحالات الناجحة المُرسَلة إلى هذه الوجهة في Merchant Center.

الحالة

يمثل حالة مصدر الإحالة الناجحة.

عمليات التعداد
STATE_UNSPECIFIED حالة مصدر الإحالة الناجحة غير محدّدة.
ACTIVE مصدر الإحالة الناجحة يعمل بشكل كامل.
ARCHIVED تمت أرشفة مصدر الإحالة الناجحة خلال آخر 30 يومًا، ولا يعمل حاليًا. يمكن استعادتها باستخدام طريقة إلغاء الحذف.
PENDING بدأ إنشاء مصدر الإحالة الناجحة، ولكن لم ينتهِ بعد.

وحدة التحكّم

الكيان الذي يتحكّم في مصدر الإحالة الناجحة

عمليات التعداد
CONTROLLER_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
MERCHANT يتحكّم فيه التاجر الذي يملك مصدر الإحالة الناجحة.
YOUTUBE_AFFILIATES يتحكّم فيه برنامج YouTube Affiliates.

الطُرق

create

 تُنشئ مصدر إحالة ناجحة جديدًا.

delete

 أرشفة مصدر إحالة ناجحة حالي

get

 يسترجع مصدر إحالة ناجحة.

list

 يسترد قائمة مصادر الإحالات الناجحة التي يمكن للمتصل الوصول إليها.

patch

 يُعدِّل معلومات مصدر إحالة ناجحة حالي.

undelete

 يُعيد تفعيل مصدر إحالة ناجحة مؤرشف.