این راهنما فهرستی از انواع مختلف اقدامات تبدیلی را که می‌توانید با استفاده از Google Ads API ایجاد کنید و اطلاعاتی درباره نحوه نگاشت این اقدامات به رابط وب Google Ads ارائه می‌دهد.
تبدیل های آفلاین
تبدیل‌های آفلاین به شما کمک می‌کند رویدادهای تبدیلی را که در دنیای آفلاین رخ می‌دهند، مانند دفتر، محل کسب‌وکار یا تلفن، ردیابی کنید.
جدول زیر پارامترهای معادل ConversionActionType API را برای استفاده برای هر منبع در رابط وب Google Ads و پیوندی به مستندات برای هر نوع اقدام تبدیل خاص نشان می دهد:
| نوع اقدام تبدیل | منبع تبلیغات گوگل | راهنمای راه اندازی API |
|---|---|---|
UPLOAD_CLICKS | ردیابی تبدیل ها از کلیک ها و تبدیل های پیشرفته برای سرنخ ها | راهنمای تبدیل کلیک آفلاین را مدیریت کنید راهنمای تبدیل های پیشرفته برای سرنخ ها |
UPLOAD_CALLS | ردیابی تبدیل ها از تماس ها | راهنمای تبدیل تماس وارد کنید |
STORE_SALES | ردیابی تبدیل های فروش فروشگاه | راهنمای تبدیل فروش فروشگاه وارداتی |
تبدیل آنلاین (وب سایت).
تبدیل وب سایت به شما امکان می دهد اقدامات وب سایت مانند فروش آنلاین، کلیک روی پیوند، بازدید از صفحه و ثبت نام را دنبال کنید.
برای ردیابی تبدیل ها در وب سایت خود، باید یک ConversionAction با ConversionActionType تنظیم شده روی WEBPAGE ایجاد کنید و یک قطعه کد به نام تگ را به صفحه تبدیل در وب سایت خود اضافه کنید.
ConversionAction شامل چندین نوع تبدیل وب سایت است که در API با فیلد type در هر TagSnippet فهرست شده در قسمت tag_snippets یک ConversionAction متمایز می شود.
TagSnippet کد رهگیری را ارائه می دهد که باید در وب سایت شما گنجانده شود تا اقدامات تبدیل شما را ردیابی کند. برای تبدیل کلیک بر روی وب‌سایت و شماره تلفن ، به event_snippet نیاز است، که باید در صفحات وب قرار گیرد که نشان‌دهنده یک عمل تبدیل مانند تأیید تسویه حساب یا صفحه ارسال فرم سرنخ، و global_site_tag است که باید در هر صفحه وب‌سایت شما نصب شود. شما می توانید هر دوی این ویژگی ها را با ConversionActionService بازیابی کنید. برای اطلاعات بیشتر در مورد نحوه برچسب گذاری صفحات خود، مرکز راهنمایی ما را بررسی کنید.
جدول زیر پارامترهای API معادل را برای استفاده برای هر منبع در رابط وب Google Ads نشان می دهد:
| نوع کد رهگیری | منبع تبلیغات گوگل |
|---|---|
WEBPAGE | وب سایت، وب سایت (Google Analytics (GA4)) |
WEBPAGE_ONCLICK | وب سایت، وب سایت (Google Analytics (GA4)) |
CLICK_TO_CALL | شماره تلفن کلیک می کند |
تبدیل برنامه
تبدیل برنامه به شما امکان می دهد نصب برنامه تلفن همراه یا خرید برنامه را از فروشگاه Google Play دنبال کنید.
جدول زیر پارامترهای معادل ConversionActionType API را برای استفاده برای هر منبع در رابط وب Google Ads نشان می دهد:
| نوع اقدام تبدیل | منبع تبلیغات گوگل |
|---|---|
GOOGLE_PLAY_DOWNLOAD | Google Play > Installs |
GOOGLE_PLAY_IN_APP_PURCHASE | Google Play > خریدهای درون برنامه ای |
برای ردیابی سایر اقدامات برنامه تلفن همراه با استفاده از ویژگی های Google Analytics 4 یا تجزیه و تحلیل برنامه های شخص ثالث ، به انواع اقدام تبدیل اضافی مراجعه کنید.
تبدیل تماس تلفنی
ردیابی تبدیل تماس تلفنی به شما امکان می‌دهد تماس‌های تبلیغاتی، تماس‌های با شماره‌ای در وب‌سایت خود و کلیک بر روی شماره‌ها را در سایت‌های تلفن همراه ردیابی کنید.
جدول زیر پارامترهای معادل ConversionActionType API را برای استفاده برای هر منبع در رابط وب Google Ads نشان می دهد:
| نوع اقدام تبدیل | منبع تبلیغات گوگل |
|---|---|
AD_CALL | تماس‌های تبلیغاتی با استفاده از برنامه‌های افزودنی تماس یا تبلیغات فقط تماس |
WEBSITE_CALL | با یک شماره تلفن در وب سایت شما تماس می گیرد |
CLICK_TO_CALL | روی شماره ای در وب سایت تلفن همراه شما کلیک می کند |
AD_CALL
یک کنش تبدیل AD_CALL به عنوان تبدیل تماس از تبلیغات در رابط وب Google Ads ظاهر می‌شود. پس از ایجاد کنش تبدیل AD_CALL خود، هنگام ایجاد CallAsset ، نام منبع آن را در قسمت call_conversion_action مشخص کنید. دارایی‌های تماس به شما امکان می‌دهد یک شماره تلفن را مستقیماً در تبلیغات خود نشان دهید.
تماس در صورتی به عنوان تبدیل گزارش می شود که بیش از مدت زمان مشخص شده طول بکشد. پیش فرض 60 ثانیه است.
WEBSITE_CALL
یک اقدام تبدیل WEBSITE_CALL به عنوان تماس از یک تبدیل وب سایت در رابط وب Google Ads ظاهر می شود.
برخلاف AD_CALL ، این ردیاب نیاز دارد که event_snippet و global_site_tag به وب‌سایت شما اضافه شود تا شماره بازارسال پویا Google برای ردیابی تماس در شماره‌های فهرست‌شده در وب‌سایت شما بازیابی شود. علاوه بر این، باید یک دارایی تماس راه‌اندازی کنید و آن را در سطح مشتری، کمپین یا گروه تبلیغاتی پیوند دهید .
CLICK_TO_CALL
یک عمل تبدیل CLICK_TO_CALL به عنوان یک کلیک روی شماره شما در تبدیل وب سایت تلفن همراه شما در رابط وب Google Ads ظاهر می شود.
نوع CLICK_TO_CALL با نوع AD_CALL متفاوت است زیرا تماس های تلفنی واقعی را ردیابی نمی کند. در عوض، CLICK_TO_CALL فقط کلیک‌های روی شماره تلفن را از دستگاه تلفن همراه ردیابی می‌کند. این زمانی مفید است که نمی‌توانید از شماره فوروارد Google برای ردیابی تماس‌های تلفنی استفاده کنید.
تبدیل های پیشرفته
تبدیل‌های پیشرفته به شما کمک می‌کند تا با تکمیل برچسب‌های تبدیل موجود خود با داده‌های تبدیل شخص اول، مانند آدرس ایمیل، نام، آدرس خانه و شماره تلفن، دقت اندازه‌گیری تبدیل خود را بهبود بخشید.
جدول زیر پارامترهای API معادل برای استفاده برای هر نوع تبدیل پیشرفته را نشان می دهد:
| نوع اقدام تبدیل | نوع تبدیل پیشرفته | راهنمای راه اندازی API |
|---|---|---|
UPLOAD_CLICKS | تبدیل های پیشرفته برای سرنخ ها اندازه گیری تراکنش های آفلاین را که از سرنخ یا بازدیدکننده وب سایت انجام می شود، بهبود می بخشد | راهنمای راه اندازی API |
WEBPAGE | تبدیل های پیشرفته برای وب اندازه گیری تبدیل های آنلاین را بهبود می بخشد | راهنمای راه اندازی API |
انواع اقدام تبدیل اضافی
Google Ads API انواع دیگری از کنش‌های تبدیل را در گزارش‌ها در دسترس قرار می‌دهد، اما ممکن است ایجاد یا تغییر آن کنش‌ها را محدود یا ممنوع کند.
تبدیل SKAdNetwork
اگر کمپین‌های برنامه iOS را اجرا می‌کنید و SKAdNetwork را پیاده‌سازی کرده‌اید، می‌توانید با استفاده از منابع زیر به داده‌های SKAdNetwork ارائه‌شده به Google در سطح Customer و Campaign دسترسی داشته باشید:
| فیلد گزارش | توضیحات |
|---|---|
metrics.sk_ad_network_installs | تعداد نصب های گزارش شده توسط اپل. این معیار را فقط می توان با هر ترکیبی از segments.sk_ad_network_conversion_value و بخش های مربوط به تاریخ تقسیم کرد. |
metrics.sk_ad_network_total_conversions | تعداد کل تبدیل‌ها، شامل نصب‌ها و انواع دیگر تبدیل‌های گزارش‌شده توسط اپل. این معیار را فقط می‌توان توسط بخش‌های مربوط به SKAdNetwork و بخش‌های مربوط به تاریخ تقسیم‌بندی کرد. |
segments.sk_ad_network_ad_event_type | نوع رویدادی که برای یک تبدیل خاص رخ داده است. |
segments.sk_ad_network_attribution_credit | نحوه انتساب برای یک تبدیل خاص. |
segments.sk_ad_network_fine_conversion_value | ارزش یک تبدیل گزارش شده توسط اپل. این بخش را نمی توان برای معیارهای دیگری به جز اگر اپل مقدار |
segments.sk_ad_network_coarse_conversion_value | مقدار درشت برای یک تبدیل فردی. |
segments.sk_ad_network_postback_sequence_index | موقعیت بک پشت، به ترتیب، برای یک تبدیل خاص. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id | شناسه برنامه که در آن تبلیغی که باعث نصب شبکه تبلیغاتی کیت فروشگاه iOS شد نشان داده شد. |
segments.sk_ad_network_source_domain | وب‌سایتی که تبلیغی را که باعث نصب شبکه تبلیغاتی کیت فروشگاه iOS شد نشان داده شد. مقدار تهی به این معنی است که این بخش قابل اجرا نیست - برای مثال، یک کمپین غیر iOS - یا در هیچ پست بک ارسال شده توسط اپل وجود نداشته است. |
segments.sk_ad_network_source_type | نوع منبعی که تبلیغی که باعث نصب شبکه تبلیغاتی کیت فروشگاه iOS شد نشان داده شد. یک مقدار تهی به این معنی است که این بخش قابل اجرا نیست - برای مثال، کمپین غیر iOS - یا اینکه نه دامنه منبع و نه برنامه منبع در هیچ پست بک ارسال شده توسط اپل وجود نداشته است. |
segments.sk_ad_network_user_type | نوع کاربری که تبدیل خاصی را ایجاد کرده است. |
segments.sk_ad_network_redistributed_fine_conversion_value | مقادیر تبدیل در این بخش شامل مقادیر تهی است که دوباره به مقادیر تبدیل توزیع شده است. این بخش مجموع مقادیر تبدیل دقیق مشاهده شده توسط اپل و مقادیر تهی مدل شده از Google را نشان می دهد. |
segments.sk_ad_network_version | نسخه API شبکه تبلیغات کیت فروشگاه iOS که استفاده شد. |
گوگل آنالیتیکس
تبدیل‌های یک ویژگی Google Analytics مرتبط دارای یکی از مقادیر type زیر است:
تبدیل ویژگی GA4:
-
GOOGLE_ANALYTICS_4_CUSTOM -
GOOGLE_ANALYTICS_4_PURCHASE
همچنین می‌توانید شناسه دارایی GA4، نام دارایی و نام رویداد را از قسمت
google_analytics_4_settingsبازیابی کنید.-
می توانید تغییرات زیر را در تبدیل ویژگی GA4 ایجاد کنید:
- با تغییر فیلد
statusآن ازHIDDENبهENABLED، تبدیل را از دارایی GA4 خود به حساب Google Ads خود وارد کنید. - فیلدهای
primary_for_goalوcategoryآن را تغییر دهید تا نشان دهید چگونه باید بر قیمت پیشنهادی و گزارش های Google Ads تأثیر بگذارد . -
nameیاvalue_settingsآن را به‌روزرسانی کنید. - با استفاده از عملیات
removeتبدیل را از حساب Google Ads خود حذف کنید.
هر تلاشی برای اصلاح سایر ویژگی‌های یک تبدیل GA4 وارد شده یا هر ویژگی تبدیل Universal Analytics وارد شده منجر به خطای MUTATE_NOT_ALLOWED می‌شود. این تغییرات را فقط می‌توانید با استفاده از رابط کاربری Google Ads انجام دهید.
Firebase و تجزیه و تحلیل برنامه های شخص ثالث
برای وارد کردن تجزیه و تحلیل برنامه های شخص ثالث یا تبدیل های Firebase ، status ConversionAction را با استفاده از روش mutate ConversionActionService از HIDDEN به ENABLED تغییر دهید. به‌روزرسانی app_id برای این اقدامات تبدیل پشتیبانی نمی‌شود.
-
FIREBASE_ANDROID_FIRST_OPEN -
FIREBASE_ANDROID_IN_APP_PURCHASE -
FIREBASE_ANDROID_CUSTOM -
FIREBASE_IOS_FIRST_OPEN -
FIREBASE_IOS_IN_APP_PURCHASE -
FIREBASE_IOS_CUSTOM -
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN -
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE -
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM -
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN -
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE -
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
فروش فروشگاه: اقدام واردات به تبدیل با گزارش
اگرچه نمی‌توانید اقدامات تبدیل STORE_SALES یا STORE_SALES_DIRECT_UPLOAD را با استفاده از Google Ads API ایجاد کنید، API از واردات تراکنش‌های فروش فروشگاه پشتیبانی می‌کند.
-
STORE_SALES -
STORE_SALES_DIRECT_UPLOAD
انواع کنش تبدیل فقط خواندنی
انواع کنش تبدیل زیر در Google Ads API فقط خواندنی است و برای اهداف گزارش ارائه شده است.
-
ANDROID_APP_PRE_REGISTRATION -
ANDROID_INSTALLS_ALL_OTHER_APPS -
FLOODLIGHT_ACTION -
FLOODLIGHT_TRANSACTION -
GOOGLE_HOSTED -
LEAD_FORM_SUBMIT -
SALESFORCE -
SEARCH_ADS_360 -
SMART_CAMPAIGN_AD_CLICKS_TO_CALL -
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL -
SMART_CAMPAIGN_MAP_DIRECTIONS -
SMART_CAMPAIGN_TRACKED_CALLS -
STORE_VISITS -
WEBPAGE_CODELESS
ناشناس
اگر حساب Google Ads شما شامل انواع دیگری از کنش‌های تبدیل باشد، ممکن است متوجه شوید که درجات ConversionAction.type UNKNOWN است، پرس‌و‌جوها و گزارش‌ها کنش‌های تبدیل را برمی‌گردانند. API از مدیریت این کنش‌های تبدیل پشتیبانی نمی‌کند، اما آنها را در گزارش‌ها برمی‌گرداند تا نتایج کاملی را برای معیارهای تبدیل کلیدی مانند metrics.conversions و metrics.conversions_value ارائه دهد.