این راهنما فهرستی از انواع مختلف کنش‌های تبدیلی که می‌توانید بااستفاده از Google Ads API ایجاد کنید و اطلاعاتی درباره نحوه نگاشت این کنش‌ها به میانای وب Google Ads ارائه می‌دهد.
انتخاب نوع کنش تبدیل مناسب
برای کمک به انتخاب نوع کنش تبدیل صحیح و راهنمای راه‌اندازی برای ادغام، از مسیر تصمیم‌گیری زیر استفاده کنید:
رویداد تبدیل کجا رخ می‌دهد؟
- در دنیای آفلاین (برای مثال، در دفتر، مکان کسب‌وکار، یا ازطریق تلفن): به مرحله ۲ بروید.
- مستقیماً در وب‌سایت شما (برای مثال، خریدهای وب‌سایت، ثبت‌نام‌ها، یا ارسال فرم): به مرحله ۳ بروید.
- در برنامه تلفن همراه: به مرحله ۴ بروید.
- ازطریق تماس تلفنی که مستقیماً از آگهی‌هایتان شماره‌گیری شده است: از تماس‌ها از
آگهی‌ها (
AD_CALL) (بااستفاده ازCallAsset) استفاده کنید.
تبدیل‌های آفلاین:
تماس تلفنی است؟
بله: استفاده کنید
وارد کردن تبدیل‌های تماس (
UPLOAD_CALLS) برای پیگیری نتایج تماس.
آیا فروش در فروشگاه واقعی است؟
بله: استفاده شود
آیا این تبدیل یک فروش آفلاین یا پیشرفت مشتری بالقوه ناشی از بازدید وب‌سایت است؟
- بله: از تبدیل‌های به‌سازی‌شده برای مشتریان بالقوه بااستفاده از میانای برنامه‌سازی کاربردی مدیر داده (توصیه می‌شود) استفاده کنید، یا برای یکپارچه‌سازی‌های موجود «میانای برنامه‌سازی کاربردی Google Ads»، مدیریت تبدیل‌های کلیک آفلاین را ببینید. (توجه: از ۱۵ ژوئن ۲۰۲۶، بارگذاری تبدیل‌های کلیک بااستفاده از
UploadClickConversionsبه کدهای توسعه‌دهنده‌ای محدود می‌شود که قبلاً تبدیل‌های کلیک آفلاین بارگذاری کرده‌اند).
- بله: از تبدیل‌های به‌سازی‌شده برای مشتریان بالقوه بااستفاده از میانای برنامه‌سازی کاربردی مدیر داده (توصیه می‌شود) استفاده کنید، یا برای یکپارچه‌سازی‌های موجود «میانای برنامه‌سازی کاربردی Google Ads»، مدیریت تبدیل‌های کلیک آفلاین را ببینید. (توجه: از ۱۵ ژوئن ۲۰۲۶، بارگذاری تبدیل‌های کلیک بااستفاده از
تبدیل‌های آنلاین (وب‌سایت):
- آیا می‌خواهید بار کردن صفحه (خریدها، رسیدها) یا کلیک‌های کاربر را ردیابی کنید؟
- بله: از تبدیل‌های وب‌سایت با
تکه برچسب تنظیم‌شده روی
WEBPAGEیاWEBPAGE_ONCLICKاستفاده کنید.
- بله: از تبدیل‌های وب‌سایت با
تکه برچسب تنظیم‌شده روی
آیا می‌خواهید تماس‌های ایجادشده ازطریق شماره تلفن فهرست‌شده در وب‌سایتتان را پیگیری کنید؟
مدت زمان واقعی تماس‌ها ردیابی شود؟
بله: استفاده شود
تماس‌ها از وب‌سایت (
WEBSITE_CALL) با شماره بازارسال Google پویا و تکه‌کد رویداد برچسب.نه (فقط کلیک‌های دکمه/پیوند را در سایت تلفن همراه پیگیری کنید)؟ استفاده کردن
- آیا می‌خواهید بار کردن صفحه (خریدها، رسیدها) یا کلیک‌های کاربر را ردیابی کنید؟
تبدیل‌های برنامه تلفن همراه:
- آیا ردیابی نصب‌ها یا خریدها از «فروشگاه Google Play» کافی است؟
- بله: از تبدیل‌های برنامه
(
GOOGLE_PLAY_DOWNLOADیاGOOGLE_PLAY_IN_APP_PURCHASE) استفاده کنید.
- بله: از تبدیل‌های برنامه
(
آیا کنش‌های برنامه را بااستفاده از Google Analytics (GA4) یا تجزیه‌وتحلیل‌های برنامه طرف سوم ردیابی می‌کنید؟
بله: استفاده شود
Firebase و تجزیه‌وتحلیل‌های برنامه طرف سوم (با فعال کردن کنش‌های تبدیل
FIREBASE_*یاTHIRD_PARTY_*).
- آیا ردیابی نصب‌ها یا خریدها از «فروشگاه Google Play» کافی است؟
تبدیل‌های آفلاین
تبدیل‌های آفلاین به شما کمک می‌کند رویدادهای تبدیلی را که در دنیای آفلاین رخ می‌دهند، مانند دفتر کار، مکان کسب‌وکار، یا ازطریق تلفن، پیگیری کنید.
جدول زیر پارامترهای معادل
ConversionActionType API را برای استفاده برای هر
منبع در میانای وب Google Ads و پیوندی به اسناد مربوط به هر
نوع کنش تبدیل خاص نشان می‌دهد:
| نوع کنش تبدیل | منبع Google Ads | راهنمای راه‌اندازی میانای برنامه‌سازی کاربردی |
|---|---|---|
UPLOAD_CLICKS |
ردیابی تبدیل ازطریق کلیک و تبدیل بهبودیافته برای مشتریان بالقوه | از Data Manager API (توصیه می‌شود) استفاده کنید یا برای ادغام‌های موجود Google Ads API، به مدیریت تبدیل‌های کلیک آفلاین مراجعه کنید |
UPLOAD_CALLS |
پیگیری تبدیل‌ها از تماس‌ها | راهنمای وارد کردن تبدیل‌های تماس |
STORE_SALES |
پیگیری تبدیل‌ها از فروش فروشگاهی | برای جزئیات، فروش فروشگاهی: وارد کردن به کنش تبدیل با گزارش را ببینید |
تبدیل‌های آنلاین (وب‌سایت)
تبدیل وب‌سایت به شما امکان می‌دهد کنش‌های وب‌سایت مانند فروش آنلاین، کلیک‌های پیوند، بازدیدهای صفحه، و ثبت‌نام‌ها را پیگیری کنید.
برای پیگیری تبدیل‌ها در وب‌سایتتان، باید
ConversionAction با
ConversionActionType تنظیم‌شده روی WEBPAGE ایجاد کنید و تکه‌کدی
به‌نام برچسب به صفحه تبدیل در وب‌سایتتان اضافه کنید.
ConversionAction شامل چندین نوع تبدیل وب‌سایت است که در API با فیلد type در هر TagSnippet فهرست‌شده در فیلد tag_snippets یک ConversionAction متمایز می‌شوند.
TagSnippet کد پیگیری را ارائه می‌دهد که باید در وب‌سایتتان گنجانده شود تا بتوانید کنش‌های تبدیل را پیگیری کنید.
تبدیل‌های وب‌سایت و کلیک روی شماره تلفن به
event_snippet نیاز دارند که باید در صفحه‌های وبی قرار داده شود که
نشان‌دهنده کنش تبدیل هستند، مانند صفحه تأیید تسویه‌حساب یا صفحه ارسال فرم مشتری بالقوه،
و global_site_tag که باید در هر صفحه از وب‌سایت شما نصب شود. می‌توانید هر دو این مشخصه‌ها را با ConversionActionService بازیابی کنید. برای اطلاعات بیشتر درباره نحوه برچسب‌گذاری صفحه‌هایتان،
به مرکز راهنمایی ما مراجعه کنید.
جدول زیر پارامترهای معادل میانای برنامه‌سازی کاربردی را برای استفاده در هر منبع در میانای وب Google Ads نشان می‌دهد:
| نوع کد رهگیری | منبع Google Ads |
|---|---|
WEBPAGE |
وب‌سایت، وب‌سایت (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
وب‌سایت، وب‌سایت (Google Analytics (GA4)) |
CLICK_TO_CALL |
کلیک‌های شماره تلفن |
تبدیل‌های برنامه
تبدیل برنامه به شما امکان می‌دهد نصب‌های برنامه تلفن همراه یا خریدهای درون‌برنامه را از فروشگاه Google Play ردگیری کنید.
جدول زیر پارامترهای معادل
ConversionActionType API را برای استفاده در هر
منبع در میانای وب Google Ads نشان می‌دهد:
| نوع کنش تبدیل | منبع Google Ads |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > موارد نصب |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > خریدهای درون‌برنامه |
برای پیگیری کردن کنش‌های دیگر برنامه تلفن همراه بااستفاده از دارایی‌های Google Analytics 4 یا تجزیه‌وتحلیل‌های برنامه طرف سوم، انواع کنش تبدیل اضافی را ببینید.
تبدیل‌های تماس تلفنی
پیگیری تبدیل تماس تلفنی به شما امکان می‌دهد تماس‌های ناشی از آگهی‌ها، تماس با شماره تلفن وب‌سایتتان، و کلیک‌های روی شماره تلفن در سایت‌های تلفن همراه را پیگیری کنید.
جدول زیر پارامترهای معادل
ConversionActionType API را برای استفاده در هر
منبع در میانای وب Google Ads نشان می‌دهد:
| نوع کنش تبدیل | منبع Google Ads |
|---|---|
AD_CALL |
تماس‌ها از آگهی‌ها بااستفاده از افزونه‌های تماس یا آگهی‌های فقط تماس |
WEBSITE_CALL |
تماس با شماره تلفن موجود در وب‌سایت شما |
CLICK_TO_CALL |
کلیک‌ها روی شماره در وب‌سایت تلفن همراه شما |
AD_CALL
کنش تبدیل AD_CALL به‌صورت تبدیل
تماس از آگهی در میانای وب Google Ads نشان داده می‌شود.
پس‌از ایجاد کنش تبدیل AD_CALL، نام منبع آن را در فیلد call_conversion_action هنگام ایجاد CallAsset مشخص کنید.
دارایی‌های تماس به شما امکان می‌دهد شماره تلفن را مستقیماً در آگهی‌هایتان نشان دهید.
اگر تماس بیشتر از مدت‌زمان مشخص‌شده طول بکشد، به‌عنوان تبدیل گزارش می‌شود. پیش‌فرض ۶۰ ثانیه است.
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 برای پیگیری تماس‌های تلفنی استفاده کنید.
تبدیل‌های بهبودیافته
تبدیل‌های بهبودیافته به شما کمک می‌کند تا دقت سنجش تبدیل خود را با تکمیل برچسب‌های تبدیل موجود با داده‌های تبدیل طرف اول، مانند نشانی ایمیل، نام، نشانی خانه، و شماره تلفن، بهبود دهید.
جدول زیر پارامترهای معادل میانای برنامه‌سازی کاربردی را برای استفاده در هر نوع تبدیل بهبودیافته نشان می‌دهد:
| نوع کنش تبدیل | نوع تبدیل بهبودیافته | راهنمای راه‌اندازی میانای برنامه‌سازی کاربردی |
|---|---|---|
UPLOAD_CLICKS |
تبدیل‌های بهبودیافته برای مشتریان بالقوه
سنجش تراکنش‌های آفلاین را که از مشتری بالقوه یا بازدیدکننده وب‌سایت حاصل شده‌اند بهبود می‌بخشد |
از Data Manager API (توصیه‌شده) استفاده کنید یا برای ادغام‌های Google Ads API موجود، مدیریت تبدیل‌های کلیک آفلاین را ببینید |
WEBPAGE |
تبدیل‌های بهبودیافته برای وب
سنجش تبدیل‌های آنلاین را بهبود می‌بخشد |
راهنمای راه‌اندازی API |
انواع کنش تبدیل اضافی
Google Ads API انواع دیگری از کنش‌های تبدیل را در گزارش‌ها دردسترس قرار می‌دهد،
اما ممکن است ایجاد یا اصلاح آن کنش‌ها را محدود یا ممنوع کند. می‌توانید کنش‌های تبدیل و انواع آن‌ها را بااستفاده از GoogleAdsService پُرسمان کنید:
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
تبدیل‌های SKAdNetwork
اگر پویش‌های برنامه iOS اجرا می‌کنید و
SKAdNetwork را پیاده‌سازی کرده‌اید، می‌توانید بااستفاده از منابع زیر به داده‌های SKAdNetwork ارائه‌شده به Google در سطح Customer و Campaign دسترسی پیدا کنید:
| فیلد گزارش | شرح |
|---|---|
metrics.sk_ad_network_installs |
تعداد نصب‌های گزارش‌شده توسط Apple. این سنجه فقط می‌تواند براساس هر ترکیبی از segments.sk_ad_network_conversion_value و بخش‌های مربوط به تاریخ تقسیم‌بندی شود.
|
metrics.sk_ad_network_total_conversions |
تعداد کل تبدیل‌ها، ازجمله نصب‌ها و انواع دیگر تبدیل‌های گزارش‌شده توسط Apple. این سنجه فقط می‌تواند براساس بخش‌های مرتبط با SKAdNetwork و بخش‌های مرتبط با تاریخ تقسیم‌بندی شود. |
segments.sk_ad_network_ad_event_type |
نوع رویدادی که برای تبدیل خاصی رخ داده است. |
segments.sk_ad_network_attribution_credit |
نحوه اعتباردهی اسناد برای تبدیلی خاص. |
segments.sk_ad_network_fine_conversion_value |
مقدار تبدیل گزارش‌شده توسط Apple. این بخش نمی‌تواند
برای هیچ سنجه‌ای به‌جز اگر Apple مقدار |
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 Store Kit Ad Network شد در آنجا نمایش داده شده است. |
segments.sk_ad_network_source_domain |
وب‌سایتی که آگهی‌ای که باعث نصب iOS Store Kit Ad Network شد در آنجا نمایش داده شده است. مقدار تهی یعنی این بخش قابل‌اعمال نیست—برای مثال، پویشی غیراز iOS—یا در هیچ‌یک از بازگشت‌های ارسالی Apple وجود نداشته است. |
segments.sk_ad_network_source_type |
نوع منبعی که آگهی‌ای که باعث نصب iOS Store Kit Ad Network شد در آنجا نمایش داده شده است. مقدار تهی یعنی این بخش قابل‌اعمال نیست—برای مثال، پویش غیر iOS—یا اینکه نه دامنه منبع و نه برنامه منبع در هیچ‌یک از ارسال‌های مجدد ارسال‌شده توسط Apple وجود نداشته‌اند. |
segments.sk_ad_network_user_type |
نوع کاربری که تبدیل خاصی را ایجاد کرده است. |
segments.sk_ad_network_redistributed_fine_conversion_value |
مقدارهای تبدیل در این بخش شامل مقدارهای تهی است که به مقدارهای تبدیل بازتوزیع شده‌اند. این بخش نشان‌دهنده مجموع مقادیر تبدیل مناسب مشاهده‌شده است که Apple برگردانده است و مقادیر تهی مدل‌سازی‌شده از Google. |
segments.sk_ad_network_version |
نسخه iOS Store Kit Ad Network API که استفاده شده است. |
Google Analytics
تبدیل‌های حاصل از
دارایی Google Analytics پیوندشده یکی از
مقادیر زیر را type دارند:
تبدیل دارایی GA4:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_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_APP_AD_IMPRESSIONFIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_APP_AD_IMPRESSIONFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
فروش فروشگاهی: وارد کردن به کنش تبدیل با گزارش‌دهی
اگرچه نمی‌توانید کنش‌های تبدیل STORE_SALES یا STORE_SALES_DIRECT_UPLOAD را بااستفاده از Google Ads API ایجاد کنید، اما این API از وارد کردن تراکنش‌های فروش فروشگاه پشتیبانی می‌کند.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
انواع کنش تبدیل فقط خواندنی
انواع کنش تبدیل زیر در Google Ads API فقط‌خواندنی هستند و برای اهداف گزارش‌دهی ارائه شده‌اند.
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
نامشخص
اگر حساب Google Ads شما شامل انواع دیگری از کنش‌های تبدیل باشد، ممکن است متوجه شوید که پُرسمان‌ها و گزارش‌ها کنش‌های تبدیلی را برمی‌گردانند که در آن‌ها ConversionAction.type UNKNOWN است. این API از مدیریت این کنش‌های تبدیل پشتیبانی نمی‌کند، اما آن‌ها را در گزارش‌ها برمی‌گرداند تا نتایج کاملی برای سنجه‌های کلیدی تبدیل مانند metrics.conversions و metrics.conversions_value ارائه دهد.