دسته‌های کنش تبدیل

این راهنما فهرستی از انواع مختلف کنش‌های تبدیل را که می‌توانید بااستفاده از Google Ads API ایجاد کنید و اطلاعاتی درباره نحوه نگاشت این کنش‌ها به میانای وب Google Ads ارائه می‌دهد.

نوع کنش تبدیل مناسب را انتخاب کنید

برای کمک به انتخاب نوع کنش تبدیل صحیح و راهنمای راه‌اندازی برای ادغام، از مسیر تصمیم‌گیری زیر استفاده کنید:

1. رویداد تبدیل کجا رخ می‌دهد؟

   • در دنیای آفلاین (برای مثال، در دفتر، مکان کسب‌وکار، یا ازطریق تلفن): به مرحله ۲ بروید.
   • مستقیماً در وب‌سایت شما (برای مثال، خریدهای وب‌سایت، ثبت‌نام‌ها، یا ارسال فرم): به مرحله ۳ بروید.
   • در برنامه تلفن همراه: به مرحله ۴ بروید.
   • ازطریق تماس تلفنی که مستقیماً از آگهی‌هایتان گرفته شده است: از تماس‌ها از آگهی‌ها (AD_CALL) (بااستفاده از CallAsset) استفاده کنید.

2. تبدیل‌های آفلاین:

   • آیا تماس تلفنی است؟

     • بله: استفاده کنید

       وارد کردن تبدیل ازطریق تماس (UPLOAD_CALLS) برای پیگیری نتایج تماس.

   • آیا فروشگاه واقعی است؟

     • بله: استفاده کنید

       تبدیل‌های فروش فروشگاهی (STORE_SALES).

   • آیا این تبدیل یک فروش آفلاین یا پیشرفت مشتری بالقوه ناشی از بازدید وب‌سایت است؟

     • بله: از تبدیل‌های به‌سازی‌شده برای مشتریان بالقوه بااستفاده از Data Manager API (توصیه‌شده) استفاده کنید، یا برای ادغام‌های Google Ads API موجود، به مدیریت تبدیل‌های کلیک آفلاین مراجعه کنید. (توجه: از ۱۵ ژوئن ۲۰۲۶، بارگذاری تبدیل‌های کلیک بااستفاده از UploadClickConversions به کدهای توسعه‌دهنده‌ای محدود می‌شود که قبلاً تبدیل‌های کلیک آفلاین بارگذاری کرده‌اند).

3. تبدیل‌های آنلاین (وب‌سایت):

   • آیا می‌خواهید بار کردن صفحه (خریدها، رسیدها) یا کلیک‌های کاربر را ردیابی کنید؟
     • بله: از تبدیل‌های وب‌سایت با تکه‌کد برچسب تنظیم‌شده روی WEBPAGE یا WEBPAGE_ONCLICK استفاده کنید.

   • آیا می‌خواهید تماس‌های حاصل از شماره تلفن فهرست‌شده در وب‌سایتتان را پیگیری کنید؟

     • مدت واقعی تماس‌ها را پیگیری می‌کنید؟

       • بله: استفاده کنید

         تماس‌ها از وب‌سایت (WEBSITE_CALL) با شماره بازارسال Google پویا و تکه‌کد رویداد برچسب.

       • نه (فقط کلیک‌های دکمه/پیوند در سایت تلفن همراه را ردیابی می‌کنم)؟ استفاده کردن

         کلیک‌ها روی شماره تلفن همراه شما (CLICK_TO_CALL).

4. تبدیل‌های برنامه تلفن همراه:

   • آیا ردیابی نصب‌ها یا خریدها از «فروشگاه Google Play» کافی است؟
     • بله: از تبدیل‌های برنامه (GOOGLE_PLAY_DOWNLOAD یا GOOGLE_PLAY_IN_APP_PURCHASE) استفاده کنید.

   • آیا کنش‌های برنامه را بااستفاده از Google Analytics (GA4) یا برنامه طرف سوم ردیابی می‌کنید؟

     • بله: استفاده کنید

       Firebase و تجزیه‌وتحلیل‌های برنامه طرف سوم (با فعال کردن کنش‌های تبدیل FIREBASE_* یا THIRD_PARTY_*).

تبدیل‌های آفلاین

هشدار: از ۱۵ ژوئن ۲۰۲۶، UploadClickConversions اگر قبلاً درخواست‌هایی برای بارگذاری تبدیل‌های آفلاین یا تبدیل‌های بهبودیافته برای مشتریان بالقوه ارسال نکرده باشد، درخواست‌ها ناموفق خواهد بود. به‌جای آن از Data Manager API استفاده کنید؛ برای جزئیات، منسوخ شدن ویژگی را ببینید.

توجه: از آن زمان، ژتون‌های توسعه‌دهنده به‌نفع پروژه‌های Google Cloud منسوخ شده‌اند، اما این محدودیت دسترسی تاریخی همچنان پابرجا است.

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

جدول زیر پارامترهای معادل 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	کلیک‌های شماره تلفن

توجه: WEBPAGE و WEBPAGE_ONCLICK منابع یکسانی با وب‌سایت دارند. تفاوت در گزینه تکه‌کد رویداد در میانای وب است. WEBPAGE با بار کردن صفحه برای این گزینه مطابقت دارد، درحالی‌که WEBPAGE_ONCLICK با کلیک مطابقت دارد. برای اطلاعات بیشتر، این مقاله مرکز راهنمایی را ببینید.

تبدیل‌های برنامه

تبدیل برنامه به شما امکان می‌دهد نصب‌های برنامه تلفن همراه یا خریدهای درون‌برنامه‌ای را از فروشگاه Google Play ردیابی کنید.

جدول زیر پارامترهای معادل ConversionActionType API را برای استفاده در هر منبع در میانای وب Google Ads نشان می‌دهد:

نوع کنش تبدیل	منبع Google Ads
GOOGLE_PLAY_DOWNLOAD	Google Play > موارد نصب
GOOGLE_PLAY_IN_APP_PURCHASE	Google Play > خریدهای درون‌برنامه

برای ردیابی دیگر کنش‌های برنامه تلفن همراه بااستفاده از دارایی‌های Google Analytics 4 یا تجزیه‌وتحلیل‌های برنامه طرف سوم، به انواع کنش‌های تبدیل اضافی مراجعه کنید.

توجه: اگر فیلد category را نیز مشخص می‌کنید، آن را روی DOWNLOAD تنظیم کنید، فقط درصورتی‌که نوع تبدیل GOOGLE_PLAY_DOWNLOAD باشد.

تبدیل‌های تماس تلفنی

ردگیری تبدیل تماس تلفنی به شما امکان می‌دهد تماس‌های حاصل از آگهی‌ها، تماس با شماره موجود در وب‌سایت، و کلیک روی شماره‌های موجود در سایت‌های تلفن همراه را ردگیری کنید.

جدول زیر پارامترهای معادل 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 برای ردیابی تماس‌های تلفنی استفاده کنید.

تبدیل‌های بهبودیافته

هشدار: از ۱۵ ژوئن ۲۰۲۶، UploadClickConversions اگر قبلاً درخواست‌هایی برای بارگذاری تبدیل‌های آفلاین یا تبدیل‌های بهبودیافته برای مشتریان بالقوه ارسال نکرده باشد، درخواست‌ها ناموفق خواهد بود. به‌جای آن از Data Manager API استفاده کنید؛ برای جزئیات، منسوخ شدن ویژگی را ببینید.

توجه: از آن زمان، ژتون‌های توسعه‌دهنده به‌نفع پروژه‌های Google Cloud منسوخ شده‌اند، اما این محدودیت دسترسی تاریخی همچنان پابرجا است.

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

جدول زیر پارامترهای معادل API را برای استفاده در هر نوع تبدیل بهبودیافته نشان می‌دهد:

نوع کنش تبدیل	نوع تبدیل بهبودیافته	راهنمای راه‌اندازی میانای برنامه‌سازی کاربردی
UPLOAD_CLICKS	تبدیل‌های بهبودیافته برای مشتریان بالقوه سنجش تراکنش‌های آفلاین را که از مشتری بالقوه یا بازدیدکننده وب‌سایت به‌دست آمده‌اند بهبود می‌بخشد	از Data Manager API (توصیه‌شده) استفاده کنید یا برای ادغام‌های Google Ads API موجود، مدیریت تبدیل‌های کلیک آفلاین را ببینید
WEBPAGE	تبدیل‌های بهبودیافته برای وب سنجش تبدیل‌های آنلاین را بهبود می‌بخشد	راهنمای راه‌اندازی میانای برنامه‌سازی کاربردی

انواع کنش تبدیل بیشتر

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. این بخش را نمی‌توان بر هیچ سنجه‌ای غیراز metrics.sk_ad_network_installs، metrics.sk_ad_network_total_conversions اعمال کرد و فقط می‌توان آن را با بخش‌های مربوط به تاریخ ترکیب کرد. اگر Apple مقدار 0 را گزارش کند، مقدار 0 برگردانده می‌شود و درغیراین‌صورت هیچ مقداری برگردانده نمی‌شود. حضور فیلد را بررسی کنید تا بین دو مورد تمایز قائل شوید.
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_CUSTOM
  • GOOGLE_ANALYTICS_4_PURCHASE

  همچنین می‌توانید شناسه دارایی GA4، نام دارایی، و نام رویداد را از فیلد google_analytics_4_settings بازیابی کنید.

می‌توانید تغییرات زیر را در تبدیل دارایی GA4 ایجاد کنید:

• تبدیل را از دارایی GA4 خود به حساب Google Ads خود وارد کنید با تغییر فیلد status آن از HIDDEN به ENABLED.
• فیلدهای 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_IMPRESSION
• FIREBASE_ANDROID_FIRST_OPEN
• FIREBASE_ANDROID_IN_APP_PURCHASE
• FIREBASE_ANDROID_CUSTOM
• FIREBASE_IOS_APP_AD_IMPRESSION
• 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

فروش فروشگاهی: وارد کردن به کنش تبدیل با گزارش‌دهی

مهم: گردش کار فروش فروشگاهتان را به Data Manager API ارتقا دهید تا تجربه توسعه‌دهنده بهبود یابد و به ویژگی‌های بیشتری دسترسی پیدا کنید. توصیه نمی‌کنیم گردش‌های کاری جدید فروش فروشگاهی را بااستفاده از Google Ads API پیاده‌سازی کنید.

اگرچه نمی‌توانید بااستفاده از Google Ads API کنش‌های تبدیل STORE_SALES یا STORE_SALES_DIRECT_UPLOAD ایجاد کنید، اما این 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 ارائه دهد.