Создавайте кампании для приложений с помощью Google Ads API, чтобы продвигать свое мобильное приложение в Поиске, Google Play, YouTube, AdMob, рекомендациях и контекстно-медийной сети Google. Оптимизируйте кампании по установкам, действиям в приложении, ценности конверсий или предварительным регистрациям в Google Play. За показ объявлений Google Рекламы в активных кампаниях взимается стандартная плата в пределах бюджета.
Подготовка
Настройки API зависят от цели кампании: цена за установку (CPI), цена за конверсию (CPA), рентабельность инвестиций в рекламу (ROAS) или предварительные регистрации. Прежде чем переходить к созданию кампании, найдите свою цель в таблице ниже. Чтобы найти элемент управления пользовательского интерфейса Google Рекламы, ознакомьтесь со статьями Сопоставление настроек интерфейса Google Рекламы с полями API и Кампании для приложений.
| Выбор цели и интерфейса Google Рекламы | Перечисление подтипов и целей | Стратегия назначения ставок | Настройки конверсий (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 (без 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 (без 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).Задайте для неизменяемого свойства
advertising_channel_typeзначениеMULTI_CHANNEL, а для неизменяемого свойстваadvertising_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требуется декларация для Европейского союза (ЕС). В версии 26 и более поздних она необязательна, если таргетинг настроен только на местоположения за пределами ЕС. Подробнее о политической рекламе для ЕС…Задайте для
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 Console настроена предварительная регистрация (недоступно дляAPP_CAMPAIGNдо запуска).bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypeдля вашей цели (изменяемое).
Задайте стандартную стратегию назначения ставок для
Campaign(ресурсы пакетной стратегииBiddingStrategyне поддерживаются). Если вы включите или отключите необязательную цель в интерфейсе, то изменятся и полеbidding_strategy_goal_type, и полеoneof:- Целевая цена за установку, конверсию или предварительную регистрацию. Задайте
target_cpaс положительным значениемtarget_cpa_microsв микроединицах валюты аккаунта (1500000= 1,50 единицы, например 1,50 долл.США). - Целевая рентабельность инвестиций в рекламу. Задайте
target_roasсtarget_roasот0.01до1000.0(3.0= 300 % рентабельности инвестиций в рекламу). - Максимум без цели (только
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(обязательно для интерфейса, необязательно для API, запрещено для кампаний, ориентированных на взаимодействие).APP_CAMPAIGN_FOR_PRE_REGISTRATION: оставьтеselective_optimizationнезаданным и добавьтеAPP_PRE_REGISTRATIONвoptimization_goal_setting.optimization_goal_types.
Необязательно. Начиная с версии 24, задайте для параметра
view_through_conversion_optimization_enabledзначениеtrueв кампаниях для AndroidAPP_CAMPAIGN, чтобы назначать ставки на основе конверсий по показам (значение по умолчанию в интерфейсе –true, в API –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 Рекламы с полями API
В таблице ниже показано, как элементы управления пользовательского интерфейса Google Рекламы соотносятся с полями Google Ads API (Ставки и бюджет для кампаний, ориентированных на установку приложений, или Бюджет и ставки для кампаний, ориентированных на взаимодействие и предварительную регистрацию).
| Раздел и ярлык в интерфейсе Google Рекламы | Ресурс и поле API | Сведения |
|---|---|---|
| Приложение > Выберите подтип кампании (Установки приложения, Взаимодействие с приложением, Предварительная регистрация в приложении (только 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 (версия 24 и более поздние). Значение по умолчанию – true в интерфейсе и false в API.
|
| Настройки кампании > Политическая реклама для ЕС (Есть ли в вашей кампании политическая реклама для Европейского союза?). |
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.
|
Задает как перечисление целей, так и поле назначения ставок 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 Рекламы.