Создайте кампанию для приложений

Создавайте кампании для приложений с помощью 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:

  1. Создать ежедневный CampaignBudget для campaign_budget с amount_micros и explicitly_shared, для которых задано значение false (по умолчанию true; общие бюджеты и бюджеты CUSTOM_PERIOD не поддерживаются). Подробнее о том, как создать бюджет кампании…

  2. При добавлении объявлений задайте значение name и при необходимости установите для status значение PAUSED (по умолчанию используется ENABLED).

  3. Задайте для неизменяемого свойства advertising_channel_type значение MULTI_CHANNEL, а для неизменяемого свойства 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 требуется декларация для Европейского союза (ЕС). В версии 26 и более поздних она необязательна, если таргетинг настроен только на местоположения за пределами ЕС. Подробнее о политической рекламе для ЕС…

  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 Console настроена предварительная регистрация (недоступно для APP_CAMPAIGN до запуска).
    • bidding_strategy_goal_type: AppCampaignBiddingStrategyGoalType для вашей цели (изменяемое).
  6. Задайте стандартную стратегию назначения ставок для 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.
  7. Настройте цели конверсии или предварительной регистрации:

  8. Необязательно. Начиная с версии 24, задайте для параметра view_through_conversion_optimization_enabled значение true в кампаниях для Android APP_CAMPAIGN, чтобы назначать ставки на основе конверсий по показам (значение по умолчанию в интерфейсе – true, в API – 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 Рекламы с полями 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 не задан).

Пример кода и дальнейшие действия

Чтобы кампания могла показывать объявления, добавьте группу объявлений и объекты креативов.