الفهرس
ConversionSourcesService
(واجهة)AttributionSettings
(رسالة)AttributionSettings.AttributionModel
(تعداد)AttributionSettings.ConversionType
(رسالة)ConversionSource
(رسالة)ConversionSource.Controller
(تعداد)ConversionSource.State
(تعداد)CreateConversionSourceRequest
(رسالة)DeleteConversionSourceRequest
(رسالة)GetConversionSourceRequest
(رسالة)GoogleAnalyticsLink
(رسالة)ListConversionSourcesRequest
(رسالة)ListConversionSourcesResponse
(رسالة)MerchantCenterDestination
(رسالة)UndeleteConversionSourceRequest
(رسالة)UpdateConversionSourceRequest
(رسالة)
ConversionSourcesService
خدمة لإدارة مصادر الإحالات الناجحة لحساب تاجر
CreateConversionSource |
---|
تُنشئ مصدر إحالة ناجحة جديدًا.
|
DeleteConversionSource |
---|
أرشفة مصدر إحالة ناجحة حالي إذا كان مصدر الإحالة الناجحة هو وجهة في Merchant Center، يمكن استرداده خلال 30 يومًا. إذا كان مصدر الإحالة الناجحة هو رابط ضمن "إحصاءات Google"، سيتم حذفه على الفور ويمكن استعادته عن طريق إنشاء مصدر جديد.
|
GetConversionSource |
---|
يسترجع مصدر إحالة ناجحة.
|
ListConversionSources |
---|
يسترد قائمة مصادر الإحالات الناجحة التي يمكن للمتصل الوصول إليها.
|
UndeleteConversionSource |
---|
يُعيد تفعيل مصدر إحالة ناجحة مؤرشف. متاحة فقط لمصادر الإحالات الناجحة في الوجهات على Merchant Center
|
UpdateConversionSource |
---|
يُعدِّل معلومات مصدر إحالة ناجحة حالي. يتوفّر فقط لمصادر الإحالات الناجحة للوجهة في Merchant Center.
|
AttributionSettings
يمثل هذا الخيار إعدادات تحديد المصدر لمصادر الإحالات الناجحة التي تتلقّى بيانات ما قبل تحديد المصدر.
الحقول | |
---|---|
attribution_lookback_window_days |
مطلوبة. فترات معاينة الإعلان (بالأيام) المستخدَمة لتحديد المصدر في هذا المصدر القيم المسموح بها هي 7 و30 و40. |
attribution_model |
مطلوبة. نموذج الإحالة. |
conversion_type[] |
غير قابل للتغيير. قائمة بدون ترتيب. قائمة بأنواع الإحالات الناجحة المختلفة التي يمكن تصنيف حدث إحالة ناجحة ضمنها. سيتم إنشاء نوع "شراء" عادي تلقائيًا إذا كانت هذه القائمة فارغة في وقت الإنشاء. |
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
رسالة تمثِّل أنواع أحداث الإحالات الناجحة
الحقول | |
---|---|
name |
النتائج فقط. اسم حدث الإحالة الناجحة، كما سيبلغ عنه العميل. |
report |
النتائج فقط. خيار يشير إلى ما إذا كان يجب تضمين النوع في تقارير Merchant Center. |
ConversionSource
يمثّل مصدر إحالة ناجحة يملكه حساب تاجر. يمكن أن يضم حساب التاجر ما يصل إلى 200 مصدر إحالة ناجحة.
الحقول | |
---|---|
name |
النتائج فقط. المُعرّف. يتم إنشاؤها باستخدام Content API عند إنشاء |
state |
النتائج فقط. الحالة الحالية لمصدر الإحالة الناجحة هذا. لا يمكن التعديل من خلال واجهة برمجة التطبيقات. |
expire_time |
النتائج فقط. الوقت الذي يتم فيه حذف مصدر إحالة ناجحة مؤرشف نهائيًا ولا يصبح متاحًا لإلغاء حذفه. |
controller |
النتائج فقط. أداة التحكّم في مصدر الإحالة الناجحة |
حقل الاتحاد source_data مطلوبة. بيانات مصدر الإحالة الناجحة الخاصة بكل نوع من أنواع المصادر المختلفة. يمكن أن يكون الحقل "source_data " واحدًا فقط مما يلي: |
|
google_analytics_link |
غير قابل للتغيير. مصدر الإحالة الناجحة من نوع "الربط بموقع على "إحصاءات Google"" |
merchant_center_destination |
مصدر الإحالة الناجحة من نوع "وجهة علامة Merchant Center". |
وحدة التحكّم
الكيان الذي يتحكّم في مصدر الإحالة الناجحة
عمليات التعداد | |
---|---|
CONTROLLER_UNSPECIFIED |
القيمة التلقائية. هذه القيمة غير مستخدمة. |
MERCHANT |
يتحكّم فيه التاجر الذي يملك مصدر الإحالة الناجحة. |
YOUTUBE_AFFILIATES |
يتحكّم فيه برنامج YouTube Affiliates. |
الحالة
يمثل حالة مصدر الإحالة الناجحة.
عمليات التعداد | |
---|---|
STATE_UNSPECIFIED |
حالة مصدر الإحالة الناجحة غير محدّدة. |
ACTIVE |
مصدر الإحالة الناجحة يعمل بشكل كامل. |
ARCHIVED |
تمت أرشفة مصدر الإحالة الناجحة خلال آخر 30 يومًا، ولا يعمل حاليًا. يمكن استعادتها باستخدام طريقة إلغاء الحذف. |
PENDING |
بدأ إنشاء مصدر الإحالة الناجحة، ولكن لم ينتهِ بعد. |
CreateConversionSourceRequest
طلب رسالة لطريقة "Create ConversionSource" (إنشاء مصدر الإحالة الناجحة)
الحقول | |
---|---|
parent |
مطلوبة. حساب التاجر الذي سيمتلك مصدر الإحالة الناجحة الجديد التنسيق: الحسابات/{account} |
conversion_source |
مطلوبة. وصف مصدر الإحالة الناجحة. سيتم تلقائيًا تخصيص معرّف جديد له عند إنشائه. |
DeleteConversionSourceRequest
طلب رسالة لطريقة DeleteConversionSource
الحقول | |
---|---|
name |
مطلوبة. اسم مصدر الإحالة الناجحة الذي تريد حذفه. التنسيق: accounts/{account}/conversionSources/{conversion_source} |
GetConversionSourceRequest
طلب رسالة لطريقة GetConversionSource
الحقول | |
---|---|
name |
مطلوبة. اسم مصدر الإحالة الناجحة الذي تريد استرجاعه التنسيق: accounts/{account}/conversionsources/{conversion_source} |
GoogleAnalyticsLink
يمكن استخدام مصادر "ربط إحصاءات Google" للحصول على بيانات الإحالات الناجحة من موقع حالي على "إحصاءات Google" إلى حساب Merchant Center المرتبط.
الحقول | |
---|---|
property_id |
مطلوبة. غير قابل للتغيير. رقم تعريف الموقع على "إحصاءات Google" الذي يرتبط به التاجر. |
attribution_settings |
النتائج فقط. إعدادات تحديد المصدر للموقع المرتبط على "إحصاءات Google" |
property |
النتائج فقط. اسم الموقع الإلكتروني على "إحصاءات Google" الذي يرتبط به التاجر. |
ListConversionSourcesRequest
طلب رسالة لطريقة ListConversionSources
الحقول | |
---|---|
parent |
مطلوبة. حساب التاجر الذي يملك مجموعة مصادر الإحالات الناجحة التنسيق: الحسابات/{account} |
page_size |
اختياريّ. الحدّ الأقصى لعدد مصادر الإحالات الناجحة المطلوب عرضها في صفحة معيّنة إذا لم يتم تحديد سمة |
page_token |
اختياريّ. الرمز المميز للصفحة. |
show_deleted |
اختياريّ. إظهار الخيار المحذوف (المؤرشف). |
ListConversionSourcesResponse
رسالة استجابة لطريقة ListConversionSources
الحقول | |
---|---|
conversion_sources[] |
قائمة مصادر الإحالات الناجحة |
next_page_token |
الرمز المميّز الذي سيتم استخدامه لجلب صفحة النتائج التالية. |
MerchantCenterDestination
يمكن استخدام مصادر "الوجهة في Merchant Center" لإرسال أحداث الإحالات الناجحة من متجر على الإنترنت باستخدام علامة Google مباشرةً إلى حساب على Merchant Center تم إنشاء المصدر فيه.
الحقول | |
---|---|
destination |
النتائج فقط. رقم تعريف الوجهة في Merchant Center |
attribution_settings |
مطلوبة. إعدادات تحديد المصدر المُستخدَمة لوجهة Merchant Center |
display_name |
مطلوبة. الاسم المعروض الذي يحدّده التاجر للوجهة. هذا هو الاسم الذي يحدّد مصدر الإحالة الناجحة في واجهة مستخدم Merchant Center. يجب أن يتألف من 64 حرفًا كحدّ أقصى. |
currency_code |
مطلوبة. رمز عملة مكوَّن من ثلاثة أحرف (ISO 4217). يحدّد رمز العملة العملة التي سيتم بها الإبلاغ عن الإحالات الناجحة المُرسَلة إلى هذه الوجهة في Merchant Center. |
UndeleteConversionSourceRequest
طلب رسالة لطريقة UndeleteConversionSource
الحقول | |
---|---|
name |
مطلوبة. اسم مصدر الإحالة الناجحة المراد إلغاء حذفه. التنسيق: accounts/{account}/conversionSources/{conversion_source} |
UpdateConversionSourceRequest
طلب رسالة لطريقة UpdateConversionSource
الحقول | |
---|---|
conversion_source |
مطلوبة. الإصدار الجديد من بيانات مصدر الإحالة الناجحة. التنسيق: accounts/{account}/conversionSources/{conversion_source} |
update_mask |
مطلوبة. قائمة الحقول التي يتم تعديلها |