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: لمصادر Merchant CenterDestination
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)

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

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 يتحكّم هذا الإعداد في برنامج YT Affiliates.

الطُرق

create

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

delete

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

get

 لجلب مصدر إحالة ناجحة

list

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

patch

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

undelete

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