این راهنما فهرستی از انواع مختلف اقدامات تبدیل که میتوانید با استفاده از API گوگل ادز ایجاد کنید، و اطلاعاتی در مورد نحوهی تطبیق این اقدامات با رابط وب گوگل ادز ارائه میدهد.
تبدیلهای آفلاین
تبدیلهای آفلاین به شما کمک میکنند رویدادهای تبدیل را که در دنیای آفلاین، مانند دفتر، محل کسب و کار یا از طریق تلفن رخ میدهند، پیگیری کنید.
جدول زیر پارامترهای معادل ConversionActionType API را برای استفاده برای هر منبع در رابط وب Google Ads و پیوندی به مستندات مربوط به هر نوع اقدام تبدیل خاص نشان میدهد:
| نوع اقدام تبدیل | منبع تبلیغات گوگل | راهنمای راهاندازی API |
|---|---|---|
UPLOAD_CLICKS | تبدیلها را از کلیکها و تبدیلهای بهبود یافته برای سرنخها پیگیری کنید | استفاده از رابط برنامهنویسی کاربردی مدیریت داده |
UPLOAD_CALLS | پیگیری تبدیلها از تماسها | راهنمای تبدیل تماسهای ورودی |
STORE_SALES | پیگیری تبدیلها، فروش فروشگاه | راهنمای تبدیل فروش فروشگاههای وارداتی |
تبدیلهای آنلاین (وبسایت)
تبدیل وبسایت به شما امکان میدهد اقدامات وبسایت مانند فروش آنلاین، کلیک روی لینکها، بازدید صفحات و ثبتنامها را پیگیری کنید.
برای ردیابی تبدیلها در وبسایت خود، باید یک ConversionAction با ConversionActionType تنظیم شده روی WEBPAGE ایجاد کنید و یک قطعه کد به نام tag به صفحه تبدیل در وبسایت خود اضافه کنید.
ConversionAction شامل چندین نوع تبدیل وبسایت است که در API با فیلد type در هر TagSnippet ذکر شده در فیلد tag_snippets از ConversionAction متمایز میشوند.
یک TagSnippet کد رهگیری را ارائه میدهد که باید در وبسایت شما گنجانده شود تا بتوانید اقدامات تبدیل خود را ردیابی کنید. تبدیلهای کلیکی وبسایت و شماره تلفن به event_snippet نیاز دارند که باید در صفحات وب قرار گیرد که نشاندهنده یک اقدام تبدیل مانند صفحه تأیید پرداخت یا ارسال فرم سرنخ هستند و global_site_tag که باید در هر صفحه از وبسایت شما نصب شود. میتوانید هر دوی این ویژگیها را با ConversionActionService بازیابی کنید. برای اطلاعات بیشتر در مورد نحوه برچسبگذاری صفحات خود، به مرکز راهنمایی ما مراجعه کنید.
جدول زیر پارامترهای معادل API را برای استفاده برای هر منبع در رابط وب Google Ads نشان میدهد:
| نوع کد رهگیری | منبع تبلیغات گوگل |
|---|---|
WEBPAGE | وبسایت، وبسایت (گوگل آنالیتیکس (GA4)) |
WEBPAGE_ONCLICK | وبسایت، وبسایت (گوگل آنالیتیکس (GA4)) |
CLICK_TO_CALL | کلیکهای شماره تلفن |
تبدیلهای برنامه
تبدیل برنامه به شما امکان میدهد نصب برنامههای تلفن همراه یا خریدهای برنامه را از فروشگاه Google Play ردیابی کنید.
جدول زیر پارامترهای معادل ConversionActionType API را برای استفاده برای هر منبع در رابط وب Google Ads نشان میدهد:
| نوع اقدام تبدیل | منبع تبلیغات گوگل |
|---|---|
GOOGLE_PLAY_DOWNLOAD | گوگل پلی > نصبها |
GOOGLE_PLAY_IN_APP_PURCHASE | گوگل پلی > خریدهای درون برنامهای |
برای ردیابی سایر اقدامات برنامه تلفن همراه با استفاده از ویژگیهای Google Analytics 4 یا تجزیه و تحلیل برنامههای شخص ثالث ، به انواع اقدامات تبدیل اضافی مراجعه کنید.
تبدیل تماسهای تلفنی
ردیابی تبدیل تماس تلفنی به شما امکان میدهد تماسهای دریافتی از تبلیغات، تماسهای با یک شماره در وبسایت خود و کلیک روی شمارهها در سایتهای موبایل را ردیابی کنید.
جدول زیر پارامترهای معادل ConversionActionType API را برای استفاده برای هر منبع در رابط وب Google Ads نشان میدهد:
| نوع اقدام تبدیل | منبع تبلیغات گوگل |
|---|---|
AD_CALL | تماسهای تبلیغاتی با استفاده از افزونههای تماس یا تبلیغات فقط تماس |
WEBSITE_CALL | تماس با شماره تلفن موجود در وبسایت شما |
CLICK_TO_CALL | کلیک روی یک عدد در وبسایت موبایل شما |
AD_CALL
یک اکشن تبدیل AD_CALL به صورت تبدیل تماس از تبلیغات (Calls from ads conversion) در رابط وب گوگل ادز (Google Ads) ظاهر میشود. پس از ایجاد اکشن تبدیل AD_CALL ، هنگام ایجاد CallAsset ، نام منبع آن را در فیلد call_conversion_action مشخص کنید. Call Assets به شما امکان میدهد شماره تلفن را مستقیماً در تبلیغات خود نمایش دهید.
اگر یک تماس بیش از مدت زمان مشخصی طول بکشد، به عنوان تبدیل گزارش میشود. مقدار پیشفرض ۶۰ ثانیه است.
WEBSITE_CALL
یک اقدام تبدیل WEBSITE_CALL به صورت « تماس از تبدیل وبسایت» در رابط وب گوگل ادز ظاهر میشود.
برخلاف AD_CALL ، این ردیاب برای بازیابی شماره داینامیک فوروارد گوگل جهت ردیابی تماس روی شمارههای فهرستشده در وبسایت شما، نیاز به افزودن event_snippet و global_site_tag به وبسایت شما دارد. علاوه بر این، باید یک دارایی تماس تنظیم کرده و آن را در سطح مشتری، کمپین یا گروه تبلیغاتی پیوند دهید .
CLICK_TO_CALL
یک اقدام تبدیل CLICK_TO_CALL به صورت « کلیک روی شماره شما در تبدیل وبسایت موبایل شما» در رابط وب Google Ads ظاهر میشود.
نوع CLICK_TO_CALL با نوع AD_CALL متفاوت است، زیرا تماسهای تلفنی واقعی را ردیابی نمیکند. در عوض، CLICK_TO_CALL فقط کلیکهای روی شماره تلفن از یک دستگاه تلفن همراه را ردیابی میکند. این زمانی مفید است که نمیتوانید از شماره فوروارد گوگل برای ردیابی تماسهای تلفنی استفاده کنید.
تبدیلهای بهبود یافته
تبدیلهای بهبود یافته به شما کمک میکنند تا با تکمیل برچسبهای تبدیل موجود خود با دادههای تبدیل شخص ثالث، مانند آدرس ایمیل، نام، آدرس منزل و شماره تلفن، دقت اندازهگیری تبدیل خود را بهبود بخشید.
جدول زیر پارامترهای API معادل مورد استفاده برای هر نوع تبدیل پیشرفته را نشان میدهد:
| نوع اقدام تبدیل | نوع تبدیل پیشرفته | راهنمای راهاندازی API |
|---|---|---|
UPLOAD_CLICKS | تبدیلهای بهبود یافته برای سرنخها سنجش تراکنشهای آفلاین حاصل از یک سرنخ یا بازدیدکننده وبسایت را بهبود میبخشد. | استفاده از رابط برنامهنویسی کاربردی مدیریت داده |
WEBPAGE | تبدیلهای بهبود یافته برای وب اندازهگیری تبدیلهای آنلاین را بهبود میبخشد | راهنمای راهاندازی API |
انواع اقدامات تبدیل اضافی
رابط برنامهنویسی کاربردی گوگل ادز انواع بیشتری از اقدامات تبدیل را در گزارشها در دسترس قرار میدهد، اما ممکن است ایجاد یا اصلاح این اقدامات را محدود یا ممنوع کند.
تبدیلهای SKAdNetwork
اگر کمپینهای اپلیکیشن iOS را اجرا میکنید و SKAdNetwork را پیادهسازی کردهاید، میتوانید با استفاده از منابع زیر به دادههای SKAdNetwork ارائه شده به گوگل در سطح 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 | موقعیت postback، به ترتیب، برای یک تبدیل خاص. |
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 | مقادیر تبدیل در این بخش شامل مقادیر تهی است که به مقادیر تبدیل توزیع مجدد شدهاند. این بخش نشان دهنده مجموع مقادیر تبدیل دقیق مشاهده شده توسط اپل و مقادیر تهی مدلسازی شده از گوگل است. |
segments.sk_ad_network_version | نسخه API شبکه تبلیغاتی کیت فروشگاه iOS که استفاده شده است. |
گوگل آنالیتیکس
تبدیلها از یک ویژگی گوگل آنالیتیکس لینکشده، یکی از مقادیر 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تبدیل را از حساب گوگل ادز خود حذف کنید.
هرگونه تلاشی برای تغییر سایر ویژگیهای تبدیل GA4 وارد شده یا هر ویژگی تبدیل Universal Analytics وارد شده منجر به خطای MUTATE_NOT_ALLOWED میشود. شما فقط میتوانید این تغییرات را با استفاده از رابط کاربری Google Ads انجام دهید.
فایربیس و تجزیه و تحلیل برنامههای شخص ثالث
برای وارد کردن تجزیه و تحلیلهای برنامههای شخص ثالث یا تبدیلهای 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
فروش فروشگاه: وارد کردن به عملیات تبدیل با گزارشگیری
اگرچه نمیتوانید با استفاده از API گوگل ادز، اکشنهای تبدیل STORE_SALES یا STORE_SALES_DIRECT_UPLOAD ایجاد کنید، اما این API از وارد کردن تراکنشهای فروش فروشگاه پشتیبانی میکند.
-
STORE_SALES -
STORE_SALES_DIRECT_UPLOAD
انواع عملیات تبدیل فقط خواندنی
انواع اقدامات تبدیل زیر در 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
ناشناخته
اگر حساب گوگل ادز شما شامل انواع دیگری از اقدامات تبدیل باشد، ممکن است متوجه شوید که کوئریها و گزارشها، اقدامات تبدیلی را برمیگردانند که ConversionAction.type آنها UNKNOWN است. API از مدیریت این اقدامات تبدیل پشتیبانی نمیکند، اما آنها را در گزارشها برمیگرداند تا نتایج کاملی را برای معیارهای کلیدی تبدیل مانند metrics.conversions و metrics.conversions_value ارائه دهد.