این راهنما فهرستی از انواع مختلف اقدامات تبدیل که میتوانید با استفاده از API گوگل ادز ایجاد کنید، و اطلاعاتی در مورد نحوهی تطبیق این اقدامات با رابط وب گوگل ادز ارائه میدهد.
نوع اقدام تبدیل مناسب را انتخاب کنید
برای کمک به انتخاب نوع صحیح اقدام تبدیل و راهنمای تنظیم برای ادغام خود، از مسیر تصمیمگیری زیر استفاده کنید:
رویداد تبدیل کجا رخ میدهد؟
- در دنیای آفلاین (مثلاً در دفتر، محل کسب و کار یا از طریق تلفن): به مرحله ۲ بروید.
- مستقیماً در وبسایت شما (برای مثال، خریدهای وبسایت، ثبتنامها یا ارسال فرم): به مرحله ۳ بروید.
- درون یک برنامه تلفن همراه : به مرحله ۴ بروید.
- از طریق تماس تلفنی که مستقیماً از تبلیغات شما گرفته شده است : از تماسهای تبلیغاتی (
AD_CALL) استفاده کنید (با استفاده ازCallAsset).
تبدیلهای آفلاین:
- مگه تماس تلفنیه؟
- بله: برای پیگیری نتایج تماس از وارد کردن تبدیلهای تماس (
UPLOAD_CALLS) استفاده کنید.
- بله: برای پیگیری نتایج تماس از وارد کردن تبدیلهای تماس (
- آیا فروش حضوری در فروشگاه انجام میشود؟
- بله: از تبدیلهای فروش فروشگاه (
STORE_SALES) استفاده کنید.
- بله: از تبدیلهای فروش فروشگاه (
- آیا این یک فروش آفلاین است یا پیشرفت سرنخ (لید) ناشی از بازدید از وبسایت؟
- بله: با استفاده از رابط برنامهنویسی کاربردی مدیریت داده (Data Manager API) از تبدیلهای پیشرفته برای سرنخها (Leads) استفاده کنید. (توجه: آپلود تبدیلهای کلیک با استفاده از
UPLOAD_CLICKSیاUploadClickConversionاز ۱۵ ژوئن ۲۰۲۶ منسوخ شده است).
- بله: با استفاده از رابط برنامهنویسی کاربردی مدیریت داده (Data Manager API) از تبدیلهای پیشرفته برای سرنخها (Leads) استفاده کنید. (توجه: آپلود تبدیلهای کلیک با استفاده از
- مگه تماس تلفنیه؟
تبدیلهای آنلاین (وبسایت):
- آیا میخواهید تعداد صفحات (خریدها، رسیدها) یا کلیکهای کاربران را پیگیری کنید؟
- بله: از تبدیلهای وبسایت با قطعه برچسب تنظیمشده روی
WEBPAGEیاWEBPAGE_ONCLICKاستفاده کنید.
- بله: از تبدیلهای وبسایت با قطعه برچسب تنظیمشده روی
- آیا میخواهید تماسهای دریافتی از شماره تلفنی که در وبسایت شما ثبت شده است را پیگیری کنید؟
- مدت زمان واقعی تماس را پیگیری کنید؟
- بله: از تماسهای دریافتی از یک وبسایت (
WEBSITE_CALL) با یک شماره داینامیک گوگل فوروارد و تگ رویداد اسنیپت استفاده کنید. - خیر (فقط کلیکهای روی دکمه/لینک را در سایت موبایل ردیابی کنید)؟ از گزینه کلیکها روی شماره تلفن همراه خود استفاده کنید (
CLICK_TO_CALL) .
- بله: از تماسهای دریافتی از یک وبسایت (
- مدت زمان واقعی تماس را پیگیری کنید؟
- آیا میخواهید تعداد صفحات (خریدها، رسیدها) یا کلیکهای کاربران را پیگیری کنید؟
تبدیل اپلیکیشن موبایل:
- آیا ردیابی نصبها یا خریدها از فروشگاه گوگل پلی کافی است؟
- بله: از تبدیلهای برنامه (
GOOGLE_PLAY_DOWNLOADیاGOOGLE_PLAY_IN_APP_PURCHASE) استفاده کنید.
- بله: از تبدیلهای برنامه (
- آیا اقدامات برنامه را با استفاده از Google Analytics (GA4) یا تجزیه و تحلیل برنامه شخص ثالث پیگیری میکنید ؟
- بله: از Firebase و تجزیه و تحلیل برنامههای شخص ثالث استفاده کنید (با فعال کردن اقدامات تبدیل
FIREBASE_*یاTHIRD_PARTY_*).
- بله: از Firebase و تجزیه و تحلیل برنامههای شخص ثالث استفاده کنید (با فعال کردن اقدامات تبدیل
- آیا ردیابی نصبها یا خریدها از فروشگاه گوگل پلی کافی است؟
تبدیلهای آفلاین
تبدیلهای آفلاین به شما کمک میکنند رویدادهای تبدیل را که در دنیای آفلاین، مانند دفتر، محل کسب و کار یا از طریق تلفن رخ میدهند، پیگیری کنید.
جدول زیر پارامترهای معادل 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 ارائه دهد.
این راهنما فهرستی از انواع مختلف اقدامات تبدیل که میتوانید با استفاده از API گوگل ادز ایجاد کنید، و اطلاعاتی در مورد نحوهی تطبیق این اقدامات با رابط وب گوگل ادز ارائه میدهد.
نوع اقدام تبدیل مناسب را انتخاب کنید
برای کمک به انتخاب نوع صحیح اقدام تبدیل و راهنمای تنظیم برای ادغام خود، از مسیر تصمیمگیری زیر استفاده کنید:
رویداد تبدیل کجا رخ میدهد؟
- در دنیای آفلاین (مثلاً در دفتر، محل کسب و کار یا از طریق تلفن): به مرحله ۲ بروید.
- مستقیماً در وبسایت شما (برای مثال، خریدهای وبسایت، ثبتنامها یا ارسال فرم): به مرحله ۳ بروید.
- درون یک برنامه تلفن همراه : به مرحله ۴ بروید.
- از طریق تماس تلفنی که مستقیماً از تبلیغات شما گرفته شده است : از تماسهای تبلیغاتی (
AD_CALL) استفاده کنید (با استفاده ازCallAsset).
تبدیلهای آفلاین:
- مگه تماس تلفنیه؟
- بله: برای پیگیری نتایج تماس از وارد کردن تبدیلهای تماس (
UPLOAD_CALLS) استفاده کنید.
- بله: برای پیگیری نتایج تماس از وارد کردن تبدیلهای تماس (
- آیا فروش حضوری در فروشگاه انجام میشود؟
- بله: از تبدیلهای فروش فروشگاه (
STORE_SALES) استفاده کنید.
- بله: از تبدیلهای فروش فروشگاه (
- آیا این یک فروش آفلاین است یا پیشرفت سرنخ (لید) ناشی از بازدید از وبسایت؟
- بله: با استفاده از رابط برنامهنویسی کاربردی مدیریت داده (Data Manager API) از تبدیلهای پیشرفته برای سرنخها (Leads) استفاده کنید. (توجه: آپلود تبدیلهای کلیک با استفاده از
UPLOAD_CLICKSیاUploadClickConversionاز ۱۵ ژوئن ۲۰۲۶ منسوخ شده است).
- بله: با استفاده از رابط برنامهنویسی کاربردی مدیریت داده (Data Manager API) از تبدیلهای پیشرفته برای سرنخها (Leads) استفاده کنید. (توجه: آپلود تبدیلهای کلیک با استفاده از
- مگه تماس تلفنیه؟
تبدیلهای آنلاین (وبسایت):
- آیا میخواهید تعداد صفحات (خریدها، رسیدها) یا کلیکهای کاربران را پیگیری کنید؟
- بله: از تبدیلهای وبسایت با قطعه برچسب تنظیمشده روی
WEBPAGEیاWEBPAGE_ONCLICKاستفاده کنید.
- بله: از تبدیلهای وبسایت با قطعه برچسب تنظیمشده روی
- آیا میخواهید تماسهای دریافتی از شماره تلفنی که در وبسایت شما ثبت شده است را پیگیری کنید؟
- مدت زمان واقعی تماس را پیگیری کنید؟
- بله: از تماسهای دریافتی از یک وبسایت (
WEBSITE_CALL) با یک شماره داینامیک گوگل فوروارد و تگ رویداد اسنیپت استفاده کنید. - خیر (فقط کلیکهای روی دکمه/لینک را در سایت موبایل ردیابی کنید)؟ از گزینه کلیکها روی شماره تلفن همراه خود استفاده کنید (
CLICK_TO_CALL) .
- بله: از تماسهای دریافتی از یک وبسایت (
- مدت زمان واقعی تماس را پیگیری کنید؟
- آیا میخواهید تعداد صفحات (خریدها، رسیدها) یا کلیکهای کاربران را پیگیری کنید؟
تبدیل اپلیکیشن موبایل:
- آیا ردیابی نصبها یا خریدها از فروشگاه گوگل پلی کافی است؟
- بله: از تبدیلهای برنامه (
GOOGLE_PLAY_DOWNLOADیاGOOGLE_PLAY_IN_APP_PURCHASE) استفاده کنید.
- بله: از تبدیلهای برنامه (
- آیا اقدامات برنامه را با استفاده از Google Analytics (GA4) یا تجزیه و تحلیل برنامه شخص ثالث پیگیری میکنید ؟
- بله: از Firebase و تجزیه و تحلیل برنامههای شخص ثالث استفاده کنید (با فعال کردن اقدامات تبدیل
FIREBASE_*یاTHIRD_PARTY_*).
- بله: از Firebase و تجزیه و تحلیل برنامههای شخص ثالث استفاده کنید (با فعال کردن اقدامات تبدیل
- آیا ردیابی نصبها یا خریدها از فروشگاه گوگل پلی کافی است؟
تبدیلهای آفلاین
تبدیلهای آفلاین به شما کمک میکنند رویدادهای تبدیل را که در دنیای آفلاین، مانند دفتر، محل کسب و کار یا از طریق تلفن رخ میدهند، پیگیری کنید.
جدول زیر پارامترهای معادل 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 ارائه دهد.
این راهنما فهرستی از انواع مختلف اقدامات تبدیل که میتوانید با استفاده از API گوگل ادز ایجاد کنید، و اطلاعاتی در مورد نحوهی تطبیق این اقدامات با رابط وب گوگل ادز ارائه میدهد.
نوع اقدام تبدیل مناسب را انتخاب کنید
برای کمک به انتخاب نوع صحیح اقدام تبدیل و راهنمای تنظیم برای ادغام خود، از مسیر تصمیمگیری زیر استفاده کنید:
رویداد تبدیل کجا رخ میدهد؟
- در دنیای آفلاین (مثلاً در دفتر، محل کسب و کار یا از طریق تلفن): به مرحله ۲ بروید.
- مستقیماً در وبسایت شما (برای مثال، خریدهای وبسایت، ثبتنامها یا ارسال فرم): به مرحله ۳ بروید.
- درون یک برنامه تلفن همراه : به مرحله ۴ بروید.
- از طریق تماس تلفنی که مستقیماً از تبلیغات شما گرفته شده است : از تماسهای تبلیغاتی (
AD_CALL) استفاده کنید (با استفاده ازCallAsset).
تبدیلهای آفلاین:
- مگه تماس تلفنیه؟
- بله: برای پیگیری نتایج تماس از وارد کردن تبدیلهای تماس (
UPLOAD_CALLS) استفاده کنید.
- بله: برای پیگیری نتایج تماس از وارد کردن تبدیلهای تماس (
- آیا فروش حضوری در فروشگاه انجام میشود؟
- بله: از تبدیلهای فروش فروشگاه (
STORE_SALES) استفاده کنید.
- بله: از تبدیلهای فروش فروشگاه (
- آیا این یک فروش آفلاین است یا پیشرفت سرنخ (لید) ناشی از بازدید از وبسایت؟
- بله: با استفاده از رابط برنامهنویسی کاربردی مدیریت داده (Data Manager API) از تبدیلهای پیشرفته برای سرنخها (Leads) استفاده کنید. (توجه: آپلود تبدیلهای کلیک با استفاده از
UPLOAD_CLICKSیاUploadClickConversionاز ۱۵ ژوئن ۲۰۲۶ منسوخ شده است).
- بله: با استفاده از رابط برنامهنویسی کاربردی مدیریت داده (Data Manager API) از تبدیلهای پیشرفته برای سرنخها (Leads) استفاده کنید. (توجه: آپلود تبدیلهای کلیک با استفاده از
- مگه تماس تلفنیه؟
تبدیلهای آنلاین (وبسایت):
- آیا میخواهید تعداد صفحات (خریدها، رسیدها) یا کلیکهای کاربران را پیگیری کنید؟
- بله: از تبدیلهای وبسایت با قطعه برچسب تنظیمشده روی
WEBPAGEیاWEBPAGE_ONCLICKاستفاده کنید.
- بله: از تبدیلهای وبسایت با قطعه برچسب تنظیمشده روی
- آیا میخواهید تماسهای دریافتی از شماره تلفنی که در وبسایت شما ثبت شده است را پیگیری کنید؟
- مدت زمان واقعی تماس را پیگیری کنید؟
- بله: از تماسهای دریافتی از یک وبسایت (
WEBSITE_CALL) با یک شماره داینامیک گوگل فوروارد و تگ رویداد اسنیپت استفاده کنید. - خیر (فقط کلیکهای روی دکمه/لینک را در سایت موبایل ردیابی کنید)؟ از گزینه کلیکها روی شماره تلفن همراه خود استفاده کنید (
CLICK_TO_CALL) .
- بله: از تماسهای دریافتی از یک وبسایت (
- مدت زمان واقعی تماس را پیگیری کنید؟
- آیا میخواهید تعداد صفحات (خریدها، رسیدها) یا کلیکهای کاربران را پیگیری کنید؟
تبدیل اپلیکیشن موبایل:
- آیا ردیابی نصبها یا خریدها از فروشگاه گوگل پلی کافی است؟
- بله: از تبدیلهای برنامه (
GOOGLE_PLAY_DOWNLOADیاGOOGLE_PLAY_IN_APP_PURCHASE) استفاده کنید.
- بله: از تبدیلهای برنامه (
- آیا اقدامات برنامه را با استفاده از Google Analytics (GA4) یا تجزیه و تحلیل برنامه شخص ثالث پیگیری میکنید ؟
- بله: از Firebase و تجزیه و تحلیل برنامههای شخص ثالث استفاده کنید (با فعال کردن اقدامات تبدیل
FIREBASE_*یاTHIRD_PARTY_*).
- بله: از Firebase و تجزیه و تحلیل برنامههای شخص ثالث استفاده کنید (با فعال کردن اقدامات تبدیل
- آیا ردیابی نصبها یا خریدها از فروشگاه گوگل پلی کافی است؟
تبدیلهای آفلاین
تبدیلهای آفلاین به شما کمک میکنند رویدادهای تبدیل را که در دنیای آفلاین، مانند دفتر، محل کسب و کار یا از طریق تلفن رخ میدهند، پیگیری کنید.
جدول زیر پارامترهای معادل 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 ظاهر میشود.
The CLICK_TO_CALL type differs from the AD_CALL type in that it does not track actual phone calls. Instead, CLICK_TO_CALL only tracks clicks on a phone number from a mobile device. This is useful when you're unable to use a Google forwarding number for tracking phone calls.
Enhanced conversions
Enhanced conversions help you to improve the accuracy of your conversion measurement by supplementing your existing conversion tags with first-party conversion data, like email address, name, home address, and phone number.
The following table shows the equivalent API parameters to use for each Enhanced Conversion Type :
| Conversion Action Type | Enhanced Conversion Type | API Setup Guide |
|---|---|---|
UPLOAD_CLICKS | Enhanced conversions for leads Improves measurement of offline transactions that came from a website lead or visitor | Use the Data Manager API |
WEBPAGE | Enhanced conversions for web Improves measurement of online conversions | API Setup Guide |
Additional conversion action types
The Google Ads API makes additional types of conversion actions available in reports, but may limit or prohibit creation or modification of those actions.
SKAdNetwork conversions
If you run iOS App campaigns and have implemented SKAdNetwork , you can access SKAdNetwork data provided to Google at the Customer and Campaign level using the following resources:
| Report field | توضیحات |
|---|---|
metrics.sk_ad_network_installs | The number of installs reported by Apple. This metric can only be segmented by any combination of segments.sk_ad_network_conversion_value and date-related segments. |
metrics.sk_ad_network_total_conversions | The total number of conversions, including installs and other types of conversions reported by Apple. This metric can only be segmented by SKAdNetwork-related segments and date-related segments. |
segments.sk_ad_network_ad_event_type | The type of event that occurred for a particular conversion. |
segments.sk_ad_network_attribution_credit | How attribution is credited for a particular conversion. |
segments.sk_ad_network_fine_conversion_value | The value of a conversion reported by Apple. This segment cannot be applied to any metrics other than A value of |
segments.sk_ad_network_coarse_conversion_value | The coarse value for an individual conversion. |
segments.sk_ad_network_postback_sequence_index | The position of the postback, in sequence, for a particular conversion. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id | The app id where the ad that drove the iOS Store Kit Ad Network install was shown. |
segments.sk_ad_network_source_domain | The website where the ad that drove the iOS Store Kit Ad Network install was shown. A null value means this segment is not applicable--for example, a non-iOS campaign--or was not present in any postbacks sent by Apple. |
segments.sk_ad_network_source_type | The source type where the ad that drove the iOS Store Kit Ad Network install was shown. A null value means this segment is not applicable — for example, non-iOS campaign — or that neither the source domain nor source app were present in any postbacks sent by Apple. |
segments.sk_ad_network_user_type | The type of user that generated a particular conversion. |
segments.sk_ad_network_redistributed_fine_conversion_value | The conversion values in this segment include null values that were redistributed to conversion values. This segment represents the sum of observed fine conversion values returned by Apple and modeled null values from Google. |
segments.sk_ad_network_version | The iOS Store Kit Ad Network API version that was used. |
گوگل آنالیتیکس
Conversions from a linked Google Analytics property have one of the following type values:
GA4 property conversion:
-
GOOGLE_ANALYTICS_4_CUSTOM -
GOOGLE_ANALYTICS_4_PURCHASE
You can also retrieve the GA4 property ID, property name, and event name from the
google_analytics_4_settingsfield.-
You can make the following changes to a GA4 property conversion:
- Import the conversion from your GA4 property into your Google Ads account by modifying its
statusfield fromHIDDENtoENABLED. - Modify its
primary_for_goalandcategoryfields to indicate how it should impact Google Ads bidding and reports . - Update its
nameorvalue_settings. - Remove the conversion from your Google Ads account using a
removeoperation.
Any attempt to modify other attributes of an imported GA4 conversion or any attributes of an imported Universal Analytics conversion results in a MUTATE_NOT_ALLOWED error. You can only make those changes using the Google Ads UI.
Firebase and third-party app analytics
To import third-party app analytics or Firebase conversions, change the status of the ConversionAction from HIDDEN to ENABLED using the mutate method of ConversionActionService . Updating the app_id is not supported for these conversion actions.
-
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: import to conversion action with reporting
Although you cannot create STORE_SALES or STORE_SALES_DIRECT_UPLOAD conversion actions using the Google Ads API, the API does support importing store sales transactions .
-
STORE_SALES -
STORE_SALES_DIRECT_UPLOAD
Read-only conversion action types
The following conversion action types are read-only in the Google Ads API and provided for reporting purposes.
-
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
ناشناخته
If your Google Ads account includes other types of conversion actions, you may find that queries and reports return conversion actions where the ConversionAction.type is UNKNOWN . The API does not support managing these conversion actions, but returns them in reports in order to provide complete results for key conversion metrics such as metrics.conversions and metrics.conversions_value .