REST Resource: accounts.conversionSources

منبع: 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 قابل ویرایش نیست.

expire Time

string ( Timestamp format)

فقط خروجی زمانی که یک منبع تبدیل بایگانی شده برای همیشه حذف می شود و دیگر برای لغو حذف در دسترس نیست.

controller

enum ( Controller )

فقط خروجی کنترل کننده منبع تبدیل

source_data فیلد اتحادیه. مورد نیاز. داده های منبع تبدیل خاص برای هر نوع مختلف منبع. source_data می تواند تنها یکی از موارد زیر باشد:
merchant Center Destination

object ( MerchantCenterDestination )

منبع تبدیل از نوع "مقصد برچسب مرکز تجاری".

AttributionSettings

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

نمایندگی JSON 
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
فیلدها
attribution Lookback Window Days

integer

مورد نیاز. پنجره های نگاه (در روز) برای ذکر منبع در این منبع استفاده می شود. مقادیر پشتیبانی شده 7، 30، 40 هستند.

attribution Model

enum ( AttributionModel )

مورد نیاز. مدل اسناد.

conversion Type[]

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

فقط خروجی شناسه مقصد مرکز تجاری.

attribution Settings

object ( AttributionSettings )

مورد نیاز. تنظیمات ارجاع در حال استفاده برای مقصد Merchant Center.

display Name

string

مورد نیاز. نام نمایشی مشخص شده توسط فروشنده برای مقصد. این نامی است که منبع تبدیل را در رابط کاربری Merchant Center مشخص می کند. محدود به 64 کاراکتر.

currency Code

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

 منبع تبدیل بایگانی شده را دوباره فعال می کند.
،

منبع: 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 قابل ویرایش نیست.

expire Time

string ( Timestamp format)

فقط خروجی زمانی که یک منبع تبدیل بایگانی شده برای همیشه حذف می شود و دیگر برای لغو حذف در دسترس نیست.

controller

enum ( Controller )

فقط خروجی کنترل کننده منبع تبدیل

source_data فیلد اتحادیه. مورد نیاز. داده های منبع تبدیل خاص برای هر نوع مختلف منبع. source_data می تواند تنها یکی از موارد زیر باشد:
merchant Center Destination

object ( MerchantCenterDestination )

منبع تبدیل از نوع "مقصد برچسب مرکز تجاری".

AttributionSettings

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

نمایندگی JSON 
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
فیلدها
attribution Lookback Window Days

integer

مورد نیاز. پنجره های نگاه (در روز) برای ذکر منبع در این منبع استفاده می شود. مقادیر پشتیبانی شده 7، 30، 40 هستند.

attribution Model

enum ( AttributionModel )

مورد نیاز. مدل اسناد.

conversion Type[]

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

فقط خروجی شناسه مقصد مرکز تجاری.

attribution Settings

object ( AttributionSettings )

مورد نیاز. تنظیمات ارجاع در حال استفاده برای مقصد Merchant Center.

display Name

string

مورد نیاز. نام نمایشی مشخص شده توسط فروشنده برای مقصد. این نامی است که منبع تبدیل را در رابط کاربری Merchant Center مشخص می کند. محدود به 64 کاراکتر.

currency Code

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

 منبع تبدیل بایگانی شده را دوباره فعال می کند.
،

منبع: 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 قابل ویرایش نیست.

expire Time

string ( Timestamp format)

فقط خروجی زمانی که یک منبع تبدیل بایگانی شده برای همیشه حذف می شود و دیگر برای لغو حذف در دسترس نیست.

controller

enum ( Controller )

فقط خروجی کنترل کننده منبع تبدیل

source_data فیلد اتحادیه. مورد نیاز. داده های منبع تبدیل خاص برای هر نوع مختلف منبع. source_data می تواند تنها یکی از موارد زیر باشد:
merchant Center Destination

object ( MerchantCenterDestination )

منبع تبدیل از نوع "مقصد برچسب مرکز تجاری".

AttributionSettings

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

نمایندگی JSON 
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
فیلدها
attribution Lookback Window Days

integer

مورد نیاز. پنجره های نگاه (در روز) برای ذکر منبع در این منبع استفاده می شود. مقادیر پشتیبانی شده 7، 30، 40 هستند.

attribution Model

enum ( AttributionModel )

مورد نیاز. مدل اسناد.

conversion Type[]

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

فقط خروجی شناسه مقصد مرکز تجاری.

attribution Settings

object ( AttributionSettings )

مورد نیاز. تنظیمات ارجاع در حال استفاده برای مقصد Merchant Center.

display Name

string

مورد نیاز. نام نمایشی مشخص شده توسط فروشنده برای مقصد. این نامی است که منبع تبدیل را در رابط کاربری Merchant Center مشخص می کند. محدود به 64 کاراکتر.

currency Code

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

 منبع تبدیل بایگانی شده را دوباره فعال می کند.