REST Resource: accounts.conversionSources

• منبع: ConversionSource
  • نمایندگی JSON
• GoogleAnalytics Link
  • نمایندگی JSON
• AttributionSettings
  • نمایندگی JSON
• AttributionModel
• نوع تبدیل
  • نمایندگی JSON
• MerchantCenterDestination
  • نمایندگی JSON
• ایالت
• کنترل کننده
• روش ها

منبع: ConversionSource

نشان دهنده یک منبع تبدیل متعلق به یک حساب Merchant است. یک حساب تجاری می تواند تا 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 فقط خروجی شناسه. با ایجاد یک ConversionSource جدید توسط Content API ایجاد شده است. قالب: [az]{4}:.+ چهار کاراکتر قبل از دو نقطه نشان دهنده نوع منبع تبدیل است. محتوای بعد از دو نقطه نشان دهنده شناسه منبع تبدیل در آن نوع است. شناسه دو منبع تبدیل مختلف ممکن است در انواع مختلف یکسان باشد. پیشوندهای نوع زیر پشتیبانی می شوند: - galk: برای منابع GoogleAnalyticsLink. - mcdn: برای منابع MerchantCenterDestination.
state	enum ( State ) فقط خروجی وضعیت فعلی این منبع تبدیل. از طریق API قابل ویرایش نیست.
expireTime	string ( Timestamp format) فقط خروجی زمانی که یک منبع تبدیل بایگانی شده برای همیشه حذف می شود و دیگر برای لغو حذف در دسترس نیست.
controller	enum ( Controller ) فقط خروجی کنترل کننده منبع تبدیل
source_data فیلد اتحادیه. مورد نیاز. داده های منبع تبدیل خاص برای هر نوع مختلف منبع. source_data می تواند تنها یکی از موارد زیر باشد:
googleAnalyticsLink	object ( GoogleAnalyticsLink ) تغییرناپذیر. منبع تبدیل از نوع "پیوند به ویژگی Google Analytics".
merchantCenterDestination	object ( MerchantCenterDestination ) منبع تبدیل از نوع "مقصد برچسب مرکز تجاری".

GoogleAnalytics Link

از منابع «پیوند Google Analytics» می‌توان برای دریافت داده‌های تبدیل از ویژگی Google Analytics موجود به حساب Merchant Center پیوند شده استفاده کرد.

نمایندگی JSON
{ "propertyId": string, "attributionSettings": { object (AttributionSettings) }, "property": string }

فیلدها
propertyId	string ( int64 format) مورد نیاز. تغییرناپذیر. شناسه ویژگی Google Analytics که تاجر به آن پیوند داده شده است.
attributionSettings	object ( AttributionSettings ) فقط خروجی تنظیمات ارجاع برای ویژگی Google Analytics پیوند شده.
property	string فقط خروجی نام ویژگی Google Analytics که تاجر به آن پیوند داده شده است.

AttributionSettings

نشان دهنده تنظیمات انتساب برای منابع تبدیلی است که داده های قبل از انتساب دریافت می کنند.

نمایندگی JSON
{ "attributionLookbackWindowDays": integer, "attributionModel": enum (AttributionModel), "conversionType": [ { object (ConversionType) } ] }

فیلدها
attributionLookbackWindowDays	integer مورد نیاز. پنجره های نگاه (در روز) برای ذکر منبع در این منبع استفاده می شود. مقادیر پشتیبانی شده 7، 30، 40 هستند.
attributionModel	enum ( AttributionModel ) مورد نیاز. مدل اسناد.
conversionType[]	object ( ConversionType ) تغییرناپذیر. لیست نامرتب فهرست انواع مختلف تبدیل یک رویداد تبدیل را می توان به عنوان طبقه بندی کرد. اگر این لیست در زمان ایجاد خالی باشد، یک نوع استاندارد "خرید" به طور خودکار ایجاد می شود.

AttributionModel

مدل انتساب استفاده شده برای این منبع. ما از همان مجموعه مدل‌های ارائه شده توسط Google Analytics 4 پشتیبانی می‌کنیم، همانطور که در: https://support.google.com/analytics/answer/10596866 توضیح داده شده است.

Enums
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	مدل کراس کانال Time Decay.

نوع تبدیل

پیامی که نشان دهنده انواع رویدادهای تبدیل است

نمایندگی JSON
{ "name": string, "report": boolean }

فیلدها
name	string فقط خروجی نام رویداد تبدیل، همانطور که توسط مشتری گزارش می‌شود.
report	boolean فقط خروجی گزینه ای که نشان می دهد آیا نوع باید در گزارش Merchant Center لحاظ شود یا خیر.

MerchantCenterDestination

از منابع "مقصد مرکز تجاری" می توان برای ارسال رویدادهای تبدیل از فروشگاه آنلاین با استفاده از یک برچسب Google به طور مستقیم به حساب Merchant Center جایی که منبع ایجاد شده است استفاده کرد.

نمایندگی JSON
{ "destination": string, "attributionSettings": { object (AttributionSettings) }, "displayName": string, "currencyCode": string }

فیلدها
destination	string فقط خروجی شناسه مقصد مرکز تجاری.
attributionSettings	object ( AttributionSettings ) مورد نیاز. تنظیمات ارجاع در حال استفاده برای مقصد Merchant Center.
displayName	string مورد نیاز. نام نمایشی مشخص شده توسط فروشنده برای مقصد. این نامی است که منبع تبدیل را در رابط کاربری Merchant Center مشخص می کند. محدود به 64 کاراکتر.
currencyCode	string مورد نیاز. کد ارز سه حرفی (ISO 4217). کد ارز مشخص می‌کند که تبدیل‌های ارسال شده به این مقصد با کدام ارز در Merchant Center گزارش می‌شوند.

ایالت

وضعیت منبع تبدیل را نشان می دهد.

Enums
STATE_UNSPECIFIED	منبع تبدیل وضعیت نامشخصی دارد.
ACTIVE	منبع تبدیل کاملاً کاربردی است.
ARCHIVED	منبع تبدیل در 30 روز گذشته بایگانی شده است و در حال حاضر کاربردی نیست. با استفاده از روش undelete قابل بازیابی است.
PENDING	ایجاد منبع تبدیل شروع شده است اما هنوز به طور کامل تمام نشده است.

کنترل کننده

نهادی که منبع تبدیل را کنترل می کند.

Enums
CONTROLLER_UNSPECIFIED	مقدار پیش فرض این مقدار استفاده نشده است.
MERCHANT	توسط بازرگانی که منبع تبدیل را در اختیار دارد کنترل می شود.
YOUTUBE_AFFILIATES	توسط برنامه YT Affiliates کنترل می شود.

روش ها
create	یک منبع تبدیل جدید ایجاد می کند.
delete	یک منبع تبدیل موجود را بایگانی می کند.
get	یک منبع تبدیل را واکشی می کند.
list	فهرست منابع تبدیلی را که تماس گیرنده به آنها دسترسی دارد بازیابی می کند.
patch	اطلاعات یک منبع تبدیل موجود را به روز می کند.
undelete	منبع تبدیل بایگانی شده را دوباره فعال می کند.