با 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 را پیکربندی کنید:
ایجاد
CampaignBudgetروزانه برایcampaign_budgetباamount_microsوexplicitly_sharedتنظیمشده رویfalse(پیشفرضtrueاست؛ بودجههای مشترک وCUSTOM_PERIODناموفق است). ایجاد بودجه پویش را ببینید.nameرا تنظیم کنید و بهطور اختیاریstatusرا هنگام پیوست کردن آگهیها رویPAUSEDتنظیم کنید (پیشفرض رویENABLEDاست).immutable
advertising_channel_typeرا رویMULTI_CHANNELو immutableadvertising_channel_sub_typeرا رویAPP_CAMPAIGN،APP_CAMPAIGN_FOR_ENGAGEMENT، یاAPP_CAMPAIGN_FOR_PRE_REGISTRATIONتنظیم کنید.contains_eu_political_advertisingرا رویDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGیاCONTAINS_EU_POLITICAL_ADVERTISINGتنظیم کنید. فراخوانیهای مستقلMutateCampaignsبه این اظهارنامه اتحادیه اروپا (EU) نیاز دارند (در نسخه ۲۶ و نسخههای جدیدتر، وقتی بهطور اتمی فقط مکانهای غیراتحادیه اروپا هدفیابی میشوند، اختیاری است؛ به آگهیهای سیاسی اتحادیه اروپا مراجعه کنید).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برای هدف شما (تغییرپذیر).
استراتژی پیشنهاد قیمت استاندارد را روی
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را تنظیم نکنید.
- هزینه هدف بهازای نصب، کنشبهای هدف، یا پیشثبتنام:
پیکربندی اهداف تبدیل یا پیشثبتنام:
APP_CAMPAIGNوAPP_CAMPAIGN_FOR_ENGAGEMENT:ConversionActionنامهای منبع منطبق باapp_idرا بهselective_optimization.conversion_actionsاضافه کنید (نهCampaignConversionGoalیاoptimization_goal_setting؛ هدفهای تبدیل پویش را ببینید). درAPP_CAMPAIGN، حداکثر یکDOWNLOADکنش، مثلGOOGLE_PLAY_DOWNLOADیا Firebasefirst_open(میانای کاربر الزامی، میانای برنامهسازی کاربردی اختیاری، ممنوع در تعامل) را اضافه کنید.APP_CAMPAIGN_FOR_PRE_REGISTRATION:selective_optimizationرا لغو تنظیم کنید وAPP_PRE_REGISTRATIONرا بهoptimization_goal_setting.optimization_goal_typesاضافه کنید.
اختیاری: از نسخه ۲۴،
view_through_conversion_optimization_enabledرا رویtrueدر پویشهای AndroidAPP_CAMPAIGNبرای پیشنهاد قیمت تبدیل بازدیدِ گذری (VTC) تنظیم کنید (پیشفرض میانای کاربرtrue، پیشفرض میانای برنامهسازی کاربردیfalse).اختیاری:
start_date_time(00:00:00، امروز یا بعداً) وend_date_time(23:59:59) را در منطقه زمانی حساب (yyyy-MM-dd HH:mm:ss) تنظیم کنید. باMutateCampaignsیاGoogleAdsService.Mutateتماس بگیرید.
اختیاری: هدفیابی و کنارگذاریهای پویش را اضافه کنید
هدفیابی را پساز ایجاد یا در همان درخواست GoogleAdsService.Mutate
اصلاح کنید:
- مکانها و زبانها: منابع
CampaignCriterionرا باCampaignCriterionService.MutateCampaignCriteriaاضافه کنید، مانند معیارهایlanguageوlocation(به معیارها مراجعه کنید). - فهرستهای کلیدواژههای منفی: پیوند دادن
CampaignSharedSetبهNEGATIVE_KEYWORDSSharedSet(به مجموعههای مشترک مراجعه کنید). - مخاطبان: معیارهای
UserListInfoالزامی (APP_CAMPAIGN_FOR_ENGAGEMENT) یا سیگنالهایAudienceInfoاختیاری (APP_CAMPAIGN) را به گروههای آگهی پیوست کنید (به ایجاد گروه آگهی برنامه و آگهی مراجعه کنید).
نگاشت تنظیمات میانای کاربری 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 را
تنظیمنشده رها کنید).
|
نمونه کد و مراحل بعدی
گروه آگهی و داراییهای طرح آگهی را پیوست کنید تا پویش شما بتواند آگهی ارائه کند:
- ایجاد گروه آگهی و آگهی «برنامه»: منبع
AdGroup(با معیارهایUserListInfoلازم درAPP_CAMPAIGN_FOR_ENGAGEMENT) و آگهی «برنامه» را اضافه کنید. - نمونه کد پویش برنامه: نمونه چندزبانه
AddAppCampaignرا که بودجه، پویش، معیار، گروه آگهی، و آگهی ایجاد میکند بررسی کنید. - گزارشدهی پویش برنامه: سنجههای پویش، دارایی، نصب، و SKAdNetwork را با «زبان پُرسمان Google Ads» پُرسمان کنید.