REST Resource: accounts.conversionSources

المرجع: ConversionSource

تمثّل مصدر إحالة ناجحة يملكه حساب تاجر. يمكن أن يتضمّن حساب التاجر ما يصل إلى 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 نموذج النقرة الأخيرة للإعدادات المفضّلة للإعلانات
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".

الطُرق

create

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

delete

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

get

 تُستخدَم هذه الدالة لجلب مصدر إحالة ناجحة.

list

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

patch

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

undelete

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