ساختن پویش برنامه

با Google Ads API «پویش‌های برنامه» ایجاد کنید تا برنامه تلفن همراهتان را در «جستجو»، Google Play،‏ YouTube،‏ AdMob، «کاوش»، و «شبکه تبلیغات Google» تبلیغ کنید. کمپین‌ها را برای نصب، کنش‌های درون‌برنامه، مقدار تبدیل، یا پیش‌ثبت‌نام‌های Android بهینه‌سازی کنید. کمپین‌های فعال‌شده هزینه‌های استاندارد ارائه آگهی Google Ads را تا سقف بودجه شما متحمل می‌شوند.

آماده‌سازی

هدف پویش شما (نصب‌بها (CPI)، کنش‌بها (CPA)، بازگشت هزینه‌کرد تبلیغات (ROAS)، یا پیش‌ثبت‌نام‌ها) تنظیمات API شما را تعیین می‌کند. قبل‌از تکمیل مراحل ایجاد، هدف خود را در جدول زیر پیدا کنید. برای جستجوی کنترل میانای کاربر Google Ads، نگاشت تنظیمات میانای کاربر Google Ads به فیلدهای API را ببینید، یا درباره پویش‌های «برنامه» را ببینید.

انتخاب هدف و میانای کاربر Google Ads نوع فرعی و شمارش هدف راهبرد پیشنهاد قیمت تنظیمات تبدیل (conversion_actions)
نصب‌های بیشتر (قیمت براساس نصب هدف).
حجم نصب > همه کاربران، تنظیم نصب‌بهای هدف (اختیاری) انتخاب شده است.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = کنش‌بهای هدف). اختیاری. حداکثر یک DOWNLOAD کنش در conversion_actions.
نصب‌های بیشتر بدون نصب‌بهای هدف.
حجم نصب > همه کاربران، تنظیم نصب‌بهای هدف (اختیاری) پاک شد.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
maximize_conversions (no target_cpa_micros). اختیاری. حداکثر یک کنش DOWNLOAD.
نصب با کنش درون‌برنامه (هزینه نصب هدف).
حجم نصب > کاربرانی که احتمالاً کنش درون‌برنامه‌ای انجام می‌دهند، نصب‌بهای هدف.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = هزینه نصب هدف). الزامی. یک کنش درون‌برنامه‌ای، به‌علاوه کنش اختیاری DOWNLOAD.
کنش‌های درون‌برنامه (کنش‌بهای هدف).
کنش‌های درون‌برنامه‌ای، تنظیم کنش‌بهای درون‌برنامه‌ای هدف (اختیاری) انتخاب شده است (یا کنش‌بهای هدف برای تعامل).
APP_CAMPAIGN یا APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
target_cpa (target_cpa_micros = کنش‌بهای هدف). الزامی. کنش‌های پس‌از نصب. اختیاری DOWNLOAD در APP_CAMPAIGN (هیچ‌کدام در تعامل).
کنش‌های درون‌برنامه‌ای بدون کنش‌بهای هدف.
کنش‌های درون‌برنامه‌ای، تنظیم کنش‌بهای درون‌برنامه‌ای هدف (اختیاری) پاک شد.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
maximize_conversions (نه target_cpa_micros). الزامی. کنش‌های پس‌از نصب، به‌علاوه کنش اختیاری DOWNLOAD.
مقدار کنش درون‌برنامه‌ای (برگشت هزینه‌های تبلیغات هدف).
مقدار کنش درون‌برنامه، تنظیم برگشتی پس‌از هزینه آگهی هدف (اختیاری) انتخاب شده باشد (یا برگشتی پس‌از هزینه آگهی هدف برای تعامل).
APP_CAMPAIGN یا APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
target_roas (target_roas = برگشت هزینه‌های تبلیغات هدف). الزامی. کنش‌های مقدار (مثل Firebase یا GOOGLE_PLAY_IN_APP_PURCHASE). DOWNLOAD اختیاری فقط در APP_CAMPAIGN.
مقدار کنش درون‌برنامه‌ای بدون بازگشت هزینه تبلیغات هدف.
مقدار کنش درون‌برنامه، تنظیم برگشتی پس‌از هزینه آگهی هدف (اختیاری) پاک شد.
APP_CAMPAIGN.
OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
maximize_conversion_value (no target_roas). الزامی. کنش‌های ارزشی (مانند Firebase یا GOOGLE_PLAY_IN_APP_PURCHASE)، به‌علاوه کنش DOWNLOAD اختیاری.
پیش‌ثبت‌نام برنامه (فقط Android).
پیش‌ثبت‌نام (هزینه هدف برای پیش‌ثبت‌نام).
APP_CAMPAIGN_FOR_PRE_REGISTRATION (فقط GOOGLE_APP_STORE).
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
target_cpa (target_cpa_micros = هزینه هدف برای پیش‌ثبت‌نام). selective_optimization را تنظیم‌نشده رها کنید. افزودن APP_PRE_REGISTRATION به optimization_goal_types.

قدم‌ها

همه منابع را به‌صورت اتمی در یک درخواست GoogleAdsService.Mutate بااستفاده از شناسه‌های موقت منفی ایجاد کنید، یا CampaignService.MutateCampaigns را فراخوانی کنید.

پیکربندی و ایجاد پویش

منبع Campaign را پیکربندی کنید:

  1. ایجاد CampaignBudget روزانه برای campaign_budget با amount_micros و explicitly_shared تنظیم‌شده روی false (پیش‌فرض true است؛ بودجه‌های مشترک و CUSTOM_PERIOD ناموفق است). ایجاد بودجه پویش را ببینید.

  2. name را تنظیم کنید و به‌طور اختیاری status را هنگام پیوست کردن آگهی‌ها روی PAUSED تنظیم کنید (پیش‌فرض روی ENABLED است).

  3. ‫immutable advertising_channel_type را روی MULTI_CHANNEL و immutable advertising_channel_sub_type را روی APP_CAMPAIGN، APP_CAMPAIGN_FOR_ENGAGEMENT، یا APP_CAMPAIGN_FOR_PRE_REGISTRATION تنظیم کنید.

  4. contains_eu_political_advertising را روی DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING یا CONTAINS_EU_POLITICAL_ADVERTISING تنظیم کنید. فراخوانی‌های مستقل MutateCampaigns به این اظهارنامه اتحادیه اروپا (EU) نیاز دارند (در نسخه ۲۶ و نسخه‌های جدیدتر، وقتی به‌طور اتمی فقط مکان‌های غیراتحادیه اروپا هدف‌یابی می‌شوند، اختیاری است؛ به آگهی‌های سیاسی اتحادیه اروپا مراجعه کنید).

  5. app_campaign_setting را روی شیء AppCampaignSetting تنظیم کنید (app_store و app_id تغییرناپذیر هستند):

    • app_store: AppCampaignAppStore (GOOGLE_APP_STORE یا APPLE_APP_STORE؛ پیش‌ثبت‌نام به GOOGLE_APP_STORE نیاز دارد).
    • app_id: نام بسته Google Play (com.example.app) یا شناسه عددی Apple App Store. تعامل به حداقل نصب نیاز دارد؛ پیش‌ثبت‌نام به برنامه پیش‌ثبت‌نام منتشرنشده در «کنسول Play» نیاز دارد (تا زمان راه‌اندازی برای APP_CAMPAIGN واجدشرایط نیست).
    • bidding_strategy_goal_type: AppCampaignBiddingStrategyGoalType برای هدف شما (تغییرپذیر).
  6. استراتژی پیشنهاد قیمت استاندارد را روی Campaign تنظیم کنید (منابع سبد سهام BiddingStrategy پشتیبانی نمی‌شوند). تغییر وضعیت هدف اختیاری میانای کاربر، هم bidding_strategy_goal_type و هم فیلد پیشنهاد قیمت oneof را تغییر می‌دهد:

    • هزینه هدف به‌ازای نصب، کنش‌بهای هدف، یا پیش‌ثبت‌نام: target_cpa را با target_cpa_micros مثبت در میکروهای واحد پول حساب (1500000 = ۱٫۵۰ واحد، مثلاً ۱٫۵۰ دلار امریکا) تنظیم کنید.
    • برگشت هزینه‌های تبلیغات هدف: target_roas را با target_roas از 0.01 به 1000.0 (3.0 = ۳۰۰٪ برگشت هزینه‌های تبلیغات) تنظیم کنید.
    • بیشینه‌سازی بدون هدف (فقط APP_CAMPAIGN): خالی تنظیم کنید maximize_conversions یا maximize_conversion_value. maximize_conversions.target_cpa_micros (ردشده در MULTI_CHANNEL) یا maximize_conversion_value.target_roas را تنظیم نکنید.
  7. پیکربندی اهداف تبدیل یا پیش‌ثبت‌نام:

  8. اختیاری: از نسخه ۲۴، view_through_conversion_optimization_enabled را روی true در پویش‌های Android APP_CAMPAIGN برای پیشنهاد قیمت تبدیل بازدیدِ گذری (VTC) تنظیم کنید (پیش‌فرض میانای کاربر true، پیش‌فرض میانای برنامه‌سازی کاربردی false).

  9. اختیاری: start_date_time (00:00:00، امروز یا بعداً) و end_date_time (23:59:59) را در منطقه زمانی حساب (yyyy-MM-dd HH:mm:ss) تنظیم کنید. با MutateCampaigns یا GoogleAdsService.Mutate تماس بگیرید.

اختیاری: هدف‌یابی و کنارگذاری‌های پویش را اضافه کنید

هدف‌یابی را پس‌از ایجاد یا در همان درخواست GoogleAdsService.Mutate اصلاح کنید:

نگاشت تنظیمات میانای کاربری Google Ads به فیلدهای میانای برنامه‌سازی کاربردی

از این جدول برای نگاشت کنترل‌های میانای کاربر Google Ads به فیلدهای Google Ads API (قیمت پیشنهادی و بودجه برای نصب‌های برنامه، یا بودجه و قیمت پیشنهادی برای تعامل و پیش‌ثبت‌نام) استفاده کنید.

بخش و برچسب میانای کاربر Google Ads منبع و فیلد میانای برنامه‌سازی کاربردی جزئیات
برنامه > انتخاب زیرنوع پویش (نصب‌های برنامه، تعامل با برنامه، پیش‌ثبت‌نام برنامه (فقط Android)). Campaign.advertising_channel_type، Campaign.advertising_channel_sub_type. تغییرناپذیر: MULTI_CHANNEL با APP_CAMPAIGN، APP_CAMPAIGN_FOR_ENGAGEMENT، یا APP_CAMPAIGN_FOR_PRE_REGISTRATION.
تنظیمات پویش > نام پویش. Campaign.name. نام نمایشی الزامی در حساب مشتری.
تنظیمات پویش > برنامه تلفن همراه. Campaign.app_campaign_setting.app_store، Campaign.app_campaign_setting.app_id. تغییرناپذیر: GOOGLE_APP_STORE (نام بسته؛ برای پیش‌ثبت‌نام الزامی است) یا APPLE_APP_STORE (شناسه عددی).
تنظیمات پویش > مکان‌ها و زبان‌ها. CampaignCriterion (location، language). با MutateCampaignCriteria یا اتمی GoogleAdsService.Mutate اضافه شده است.
تنظیمات پویش > بهینه‌سازی تبدیل بازدیدِ گذری > روشن کردن تبدیل‌های بازدیدِ گذری. Campaign.view_through_conversion_optimization_enabled. فقط Android APP_CAMPAIGN (نسخه ۲۴ و بالاتر). به‌طور پیش‌فرض true در میانای کاربر و false در میانای برنامه‌سازی کاربردی است.
تنظیمات پویش > آگهی‌های سیاسی اتحادیه اروپا (آیا پویش شما حاوی آگهی‌های سیاسی اتحادیه اروپا است؟). Campaign.contains_eu_political_advertising. بله، این پویش دارای آگهی‌های سیاسی اتحادیه اروپا است و نه، این پویش دارای آگهی‌های سیاسی اتحادیه اروپا نیست را نگاشت کنید.
تنظیمات پویش > تاریخ شروع و پایان. Campaign.start_date_time، Campaign.end_date_time. مُهرهای زمان اختیاری منطقه زمانی حساب (00:00:00 امروز یا بعداز آن، و 23:59:59).
پیشنهاد قیمت و بودجه > بودجه. CampaignBudget.amount_micros، Campaign.campaign_budget. میکرو روزانه به ارز حساب با CampaignBudget.explicitly_shared تنظیم‌شده روی false.
پیشنهاد قیمت و بودجه > پیشنهاد قیمت > می‌خواهید روی چه چیزی تمرکز کنید؟ و می‌خواهید چه نوع کاربرانی هدف‌یابی شوند؟
تنظیم نصب‌بهای هدف (اختیاری)، تنظیم کنش‌بهای درون‌برنامه‌ای هدف (اختیاری)، و تنظیم برگشتی پس‌از هزینه آگهی هدف (اختیاری).
نصب‌بهای هدف، کنش‌بهای هدف، و بازگشت هزینه‌کرد تبلیغات هدف.
Campaign.app_campaign_setting.bidding_strategy_goal_type، Campaign.target_cpa.target_cpa_micros، Campaign.target_roas.target_roas، Campaign.maximize_conversions، Campaign.maximize_conversion_value. هم هدف enum و هم فیلد oneof پیشنهاد قیمت را تنظیم می‌کند (به آماده‌سازی مراجعه کنید). استراتژی‌های غیرهدف فقط بر APP_CAMPAIGN اعمال می‌شود. در iOS، بهینه‌سازی برای مقادیر تبدیل SKAdNetwork فقط میانای کاربر است (طرح‌واره‌ها را با CustomerSkAdNetworkConversionValueSchema بخوانید).
پیشنهاد قیمت و بودجه > پیشنهاد قیمت > چطور می‌خواهید مقدار نصب را ردیابی کنید؟
چه کنشی برایتان بیشترین اهمیت را دارد؟ و چه کنش‌هایی برایتان بیشترین اهمیت را دارند؟
Campaign.selective_optimization.conversion_actions. انتخابگر نصب حداکثر یک کنش DOWNLOAD (فقط APP_CAMPAIGN) اضافه می‌کند. انتخاب‌گرهای کنش یک (مفرد) یا چند (جمع) کنش منطبق با app_id اضافه می‌کنند.
بودجه و پیشنهاد قیمت > پیشنهاد قیمت > پیش‌ثبت‌نام و هزینه هدف برای پیش‌ثبت‌نام. Campaign.target_cpa.target_cpa_micros، Campaign.optimization_goal_setting.optimization_goal_types. از OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME و APP_PRE_REGISTRATION استفاده می‌کند (selective_optimization را تنظیم‌نشده رها کنید).

نمونه کد و مراحل بعدی

گروه آگهی و دارایی‌های طرح آگهی را پیوست کنید تا پویش شما بتواند آگهی ارائه کند: