ConversionAction

یک اقدام تبدیلی

نمایندگی JSON
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
زمینه های
resourceName

string

تغییرناپذیر. نام منبع عمل تبدیل. نام منابع اقدام تبدیل به شکل زیر است:

customers/{customerId}/conversionActions/{conversion_action_id}

status

enum ( ConversionActionStatus )

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

type

enum ( ConversionActionType )

تغییرناپذیر. نوع این عمل تبدیل.

origin

enum ( ConversionOrigin )

فقط خروجی مبدا تبدیل این عمل تبدیل.

category

enum ( ConversionActionCategory )

دسته تبدیل‌های گزارش‌شده برای این اقدام تبدیلی.

valueSettings

object ( ValueSettings )

تنظیمات مربوط به مقدار رویدادهای تبدیل مرتبط با این کنش تبدیل.

countingType

enum ( ConversionActionCountingType )

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

attributionModelSettings

object ( AttributionModelSettings )

تنظیمات مربوط به مدل اسناد این کنش تبدیل.

tagSnippets[]

object ( TagSnippet )

فقط خروجی قطعه‌هایی که برای ردیابی تبدیل‌ها استفاده می‌شوند.

mobileAppVendor

enum ( MobileAppVendor )

فقط خروجی فروشنده برنامه تلفن همراه برای اقدام تبدیل برنامه.

firebaseSettings

object ( FirebaseSettings )

فقط خروجی تنظیمات Firebase برای انواع تبدیل Firebase.

thirdPartyAppAnalyticsSettings

object ( ThirdPartyAppAnalyticsSettings )

فقط خروجی تنظیمات تجزیه و تحلیل برنامه شخص ثالث برای انواع تبدیل شخص ثالث.

googleAnalytics4Settings

object ( GoogleAnalytics4Settings )

فقط خروجی تنظیمات Google Analytics 4 برای انواع تبدیل Google Analytics 4.

id

string ( int64 format)

فقط خروجی شناسه عمل تبدیل.

name

string

نام عمل تبدیل.

این فیلد ضروری است و هنگام ایجاد کنش‌های تبدیل جدید نباید خالی باشد.

primaryForGoal

boolean

اگر بیت اصلی ForGoal یک اقدام تبدیل نادرست باشد، کنش تبدیل برای همه کمپین‌ها بدون توجه به هدف تبدیل مشتری یا هدف تبدیل کمپین، غیرقابل پیشنهاد است. با این حال، اهداف تبدیل سفارشی به primeForGoal احترام نمی‌گذارند، بنابراین اگر یک کمپین دارای یک هدف تبدیل سفارشی است که با یک اقدام تبدیلی اولیهForGoal = نادرست پیکربندی شده است، آن اقدام تبدیل همچنان قابل پیشنهاد است. به طور پیش‌فرض، اگر تنظیم نشود، primeForGoal درست خواهد بود. در V9، PrimaryForGoal را فقط می‌توان پس از ایجاد از طریق عملیات «به‌روزرسانی» روی false تنظیم کرد، زیرا به‌عنوان اختیاری اعلام نشده است.

ownerCustomer

string

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

includeInConversionsMetric

boolean

آیا این اقدام تبدیل باید در معیار "تبدیل" لحاظ شود یا خیر.

clickThroughLookbackWindowDays

string ( int64 format)

حداکثر تعداد روزهایی که ممکن است بین یک تعامل (مثلاً یک کلیک) و یک رویداد تبدیل سپری شود.

viewThroughLookbackWindowDays

string ( int64 format)

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

phoneCallDurationSeconds

string ( int64 format)

مدت زمان تماس تلفنی بر حسب ثانیه که پس از آن باید یک تبدیل برای این اقدام تبدیل گزارش شود.

مقدار باید بین 0 تا 10000 باشد.

appId

string

شناسه برنامه برای اقدام تبدیل برنامه.

ConversionActionStatus

وضعیت های احتمالی یک اقدام تبدیل.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ENABLED تبدیل ها ثبت خواهد شد.
REMOVED تبدیل ثبت نخواهد شد.
HIDDEN تبدیل‌ها ثبت نمی‌شوند و عمل تبدیل در UI ظاهر نمی‌شود.

ConversionActionType

انواع احتمالی یک اقدام تبدیل

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AD_CALL تبدیل هایی که وقتی کاربر روی افزونه تماس تبلیغ کلیک می کند رخ می دهد.
CLICK_TO_CALL تبدیل‌هایی که زمانی اتفاق می‌افتند که کاربر در دستگاه تلفن همراه روی یک شماره تلفن کلیک می‌کند.
GOOGLE_PLAY_DOWNLOAD تبدیل هایی که وقتی کاربر یک برنامه تلفن همراه را از فروشگاه Google Play دانلود می کند رخ می دهد.
GOOGLE_PLAY_IN_APP_PURCHASE تبدیل‌هایی که وقتی کاربر از طریق صورت‌حساب Android در یک برنامه خرید می‌کند، رخ می‌دهد.
UPLOAD_CALLS تبدیل‌های تماسی که توسط تبلیغ‌کننده ردیابی و آپلود می‌شوند.
UPLOAD_CLICKS تبدیل هایی که توسط تبلیغ کننده ردیابی می شوند و با کلیک های نسبت داده شده آپلود می شوند.
WEBPAGE تبدیل هایی که در یک صفحه وب رخ می دهد.
WEBSITE_CALL تبدیل‌هایی که زمانی اتفاق می‌افتد که کاربر با شماره تلفنی که به‌صورت پویا ایجاد شده از وب‌سایت تبلیغ‌کننده تماس می‌گیرد.
STORE_SALES_DIRECT_UPLOAD تبدیل فروش فروشگاه بر اساس بارگذاری داده‌های فروشنده شخص اول یا شخص ثالث. فقط مشتریان موجود در لیست مجاز می توانند از انواع آپلود مستقیم فروش فروشگاه استفاده کنند.
STORE_SALES تبدیل فروش فروشگاه بر اساس بارگذاری داده‌های فروشنده شخص اول یا شخص ثالث و/یا از خریدهای داخل فروشگاه با استفاده از کارت‌های شبکه‌های پرداخت. فقط مشتریان موجود در لیست مجاز می توانند از انواع فروش فروشگاهی استفاده کنند. فقط خواندنی.
FIREBASE_ANDROID_FIRST_OPEN اولین تبدیل برنامه اندرویدی که از طریق Firebase ردیابی شد.
FIREBASE_ANDROID_IN_APP_PURCHASE تبدیل‌های خرید برنامه Android در برنامه از طریق Firebase ردیابی می‌شوند.
FIREBASE_ANDROID_CUSTOM تبدیل‌های سفارشی برنامه Android از طریق Firebase ردیابی می‌شوند.
FIREBASE_IOS_FIRST_OPEN تبدیل‌های برنامه iOS برای اولین بار از طریق Firebase ردیابی شدند.
FIREBASE_IOS_IN_APP_PURCHASE تبدیل برنامه iOS در خرید برنامه از طریق Firebase ردیابی می شود.
FIREBASE_IOS_CUSTOM تبدیل‌های سفارشی برنامه iOS از طریق Firebase ردیابی می‌شوند.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN تبدیل‌های باز برنامه اندروید برای اولین بار از طریق تجزیه و تحلیل برنامه شخص ثالث پیگیری شد.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE تبدیل برنامه Android در خرید برنامه از طریق تجزیه و تحلیل برنامه شخص ثالث پیگیری می شود.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM تبدیل‌های سفارشی برنامه Android از طریق تجزیه و تحلیل برنامه شخص ثالث پیگیری می‌شود.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN اولین تبدیل برنامه iOS از طریق تجزیه و تحلیل برنامه شخص ثالث ردیابی می شود.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE تبدیل برنامه iOS در خرید برنامه از طریق تجزیه و تحلیل برنامه شخص ثالث پیگیری می شود.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM تبدیل‌های سفارشی برنامه iOS از طریق تجزیه و تحلیل برنامه شخص ثالث پیگیری می‌شود.
ANDROID_APP_PRE_REGISTRATION تبدیل‌هایی که زمانی اتفاق می‌افتند که کاربر یک برنامه تلفن همراه را از فروشگاه Google Play از قبل ثبت می‌کند. فقط خواندنی.
ANDROID_INSTALLS_ALL_OTHER_APPS تبدیل‌هایی که همه بارگیری‌های Google Play را که توسط یک نوع برنامه خاص ردیابی نمی‌شوند، ردیابی می‌کنند. فقط خواندنی.
FLOODLIGHT_ACTION فعالیت Floodlight که تعداد دفعاتی را که کاربران پس از دیدن یا کلیک کردن بر روی یکی از تبلیغات تبلیغ‌کننده از یک صفحه وب خاص بازدید کرده‌اند، محاسبه می‌کند. فقط خواندنی.
FLOODLIGHT_TRANSACTION فعالیت Floodlight که تعداد فروش انجام شده یا تعداد اقلام خریداری شده را ردیابی می کند. همچنین می تواند ارزش کل هر فروش را بدست آورد. فقط خواندنی.
GOOGLE_HOSTED تبدیل هایی که اقدامات محلی محصولات و خدمات Google را پس از تعامل با یک آگهی ردیابی می کنند. فقط خواندنی.
LEAD_FORM_SUBMIT وقتی کاربر فرم سرنخ ارسال می کند، تبدیل ها گزارش می شود. فقط خواندنی.
SALESFORCE تبدیل هایی که از Salesforce می آیند. فقط خواندنی.
SEARCH_ADS_360 تبدیل‌های وارد شده از داده‌های Search Ads 360 Floodlight. فقط خواندنی.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL تبدیل تماس‌هایی که در تبلیغات کمپین هوشمند بدون تنظیم ردیابی تماس، با استفاده از معیارهای سفارشی کمپین هوشمند رخ می‌دهند. فقط خواندنی.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL کاربر روی یک عنصر تماس در Google Maps کلیک می کند. فقط کمپین هوشمند فقط خواندنی.
SMART_CAMPAIGN_MAP_DIRECTIONS کاربر برای یک مکان تجاری در Google Maps درخواست مسیر می کند. فقط کمپین هوشمند فقط خواندنی.
SMART_CAMPAIGN_TRACKED_CALLS تبدیل تماس‌هایی که در تبلیغات کمپین هوشمند با تنظیم ردیابی تماس، با استفاده از معیارهای سفارشی کمپین هوشمند رخ می‌دهد. فقط خواندنی.
STORE_VISITS تبدیل هایی که هنگام بازدید کاربر از فروشگاه خرده فروشی تبلیغ کننده رخ می دهد. فقط خواندنی.
WEBPAGE_CODELESS تبدیل‌های ایجاد شده از رویدادهای وب‌سایت (مانند ارسال‌های فرم یا بارگیری صفحه)، که از قطعه‌های رویداد کدگذاری شده جداگانه استفاده نمی‌کنند. فقط خواندنی.
UNIVERSAL_ANALYTICS_GOAL تبدیل‌هایی که از اهداف مرتبط Universal Analytics حاصل می‌شوند.
UNIVERSAL_ANALYTICS_TRANSACTION تبدیل هایی که از تراکنش های مرتبط Universal Analytics حاصل می شوند.
GOOGLE_ANALYTICS_4_CUSTOM تبدیل‌هایی که از تبدیل‌های رویداد سفارشی Google Analytics 4 به‌دست می‌آیند.
GOOGLE_ANALYTICS_4_PURCHASE تبدیل‌هایی که از Google Analytics 4 پیوند خورده می‌شوند.

تنظیمات ارزش

تنظیمات مربوط به مقدار رویدادهای تبدیل مرتبط با این کنش تبدیل.

نمایندگی JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
زمینه های
defaultValue

number

زمانی که رویدادهای تبدیل برای این کنش تبدیل با یک مقدار نامعتبر، غیرمجاز یا مفقود ارسال می‌شوند، یا زمانی که این کنش تبدیل به گونه‌ای پیکربندی شده است که همیشه از مقدار پیش‌فرض استفاده کند، باید استفاده شود.

defaultCurrencyCode

string

کد ارز مورد استفاده در زمانی که رویدادهای تبدیل برای این کنش تبدیل با کد ارز نامعتبر یا گمشده ارسال می‌شوند، یا زمانی که این اقدام تبدیل به گونه‌ای پیکربندی شده است که همیشه از مقدار پیش‌فرض استفاده کند.

alwaysUseDefaultValue

boolean

کنترل می‌کند که آیا ارزش پیش‌فرض و کد ارز پیش‌فرض به‌جای ارزش و کد ارز مشخص‌شده در رویدادهای تبدیل برای این اقدام تبدیل استفاده شود.

ConversionActionCountingType

نحوه شمارش تبدیل‌های این عمل را نشان می‌دهد. برای اطلاعات بیشتر، به https://support.google.com/google-ads/answer/3438531 مراجعه کنید.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ONE_PER_CLICK در هر کلیک فقط یک تبدیل بشمارید.
MANY_PER_CLICK همه تبدیل ها را در هر کلیک بشمارید.

AttributionModelSettings

تنظیمات مربوط به مدل اسناد این کنش تبدیل.

نمایندگی JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
زمینه های
attributionModel

enum ( AttributionModel )

نوع مدل انتساب این اقدام تبدیل.

dataDrivenModelStatus

enum ( DataDrivenModelStatus )

فقط خروجی وضعیت مدل اسناد مبتنی بر داده برای عمل تبدیل.

AttributionModel

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
EXTERNAL از اسناد خارجی استفاده می کند.
GOOGLE_ADS_LAST_CLICK تمام اعتبار یک تبدیل را به آخرین کلیک آن نسبت می دهد.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK تمام اعتبار را برای تبدیل به اولین کلیک آن با استفاده از انتساب جستجوی Google نسبت می دهد.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR با استفاده از انتساب جستجوی Google، اعتبار یک تبدیل را به طور یکسان در همه کلیک‌های آن مشخص می‌کند.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY به طور تصاعدی اعتبار بیشتری را برای تبدیل به کلیک های اخیر با استفاده از انتساب جستجوی Google مشخص می کند (نیمه عمر 1 هفته است).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 40٪ از اعتبار را برای تبدیل به اولین و آخرین کلیک آن نسبت می دهد. 20٪ باقیمانده به طور مساوی در بین سایر کلیک ها توزیع می شود. این از منبع جستجوی Google استفاده می کند.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN مدلی انعطاف‌پذیر که از یادگیری ماشینی برای تعیین توزیع مناسب اعتبار بین کلیک‌ها با استفاده از انتساب جستجوی Google استفاده می‌کند.

DataDrivenModelStatus

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AVAILABLE مدل داده محور در دسترس است.
STALE مدل داده محور قدیمی است. حداقل 7 روز است که به روز نشده است. هنوز در حال استفاده است، اما اگر به مدت 30 روز به روز نشود، منقضی می شود.
EXPIRED مدل داده محور منقضی شده است. حداقل 30 روز است که به روز نشده است و نمی توان از آن استفاده کرد. معمولاً به این دلیل است که تعداد رویدادهای لازم در یک دوره 30 روزه اخیر وجود نداشته است.
NEVER_GENERATED مدل داده محور هرگز تولید نشده است. معمولاً به این دلیل است که هرگز تعداد رویدادهای لازم در هیچ دوره 30 روزه وجود نداشته است.

تنظیمات Firebase

تنظیمات مربوط به یک اقدام تبدیل Firebase.

نمایندگی JSON
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
زمینه های
propertyId

string ( int64 format)

فقط خروجی شناسه ویژگی GA تبدیل.

propertyName

string

فقط خروجی نام ویژگی GA تبدیل.

eventName

string

فقط خروجی نام رویداد تبدیل Firebase.

projectId

string

فقط خروجی شناسه پروژه Firebase تبدیل.

ThirdPartyAppAnalytics Settings

تنظیمات مربوط به یک اقدام تبدیل تجزیه و تحلیل برنامه شخص ثالث.

نمایندگی JSON
{
  "providerName": string,
  "eventName": string
}
زمینه های
providerName

string

فقط خروجی نام ارائه‌دهنده تجزیه و تحلیل برنامه شخص ثالث.

eventName

string

فقط خروجی نام رویداد تبدیل تجزیه و تحلیل برنامه شخص ثالث.

GoogleAnalytics4Settings

تنظیمات مربوط به یک اقدام تبدیل Google Analytics 4.

نمایندگی JSON
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
زمینه های
eventName

string

فقط خروجی نام رویداد GA 4.

propertyName

string

فقط خروجی نام دارایی GA 4.

propertyId

string ( int64 format)

فقط خروجی شناسه اموال GA 4.