Google Ads API is returning to beta status. Please read our blog post for more details.

Требования к минимальной функциональности

Версия от 27 февраля 2019 г.

Некоторые сторонние инструменты, в которых используется Google Ads API, должны соответствовать требованиям к минимальной функциональности. Эти требования касаются функций создания, управления и отчетности и применяются в зависимости от того, как именно вы используете Google Ads API.

Функции создания Функции управления Функции отчетности
Полная функциональность
  • Инструменты для рекламодателей, агентств и других внешних партнеров, которые позволяют полноценно управлять аккаунтами Google Рекламы
Требования применяются Требования применяются Требования применяются
Только отчетность
  • Только панель отчетов для конечного рекламодателя
Требования не применяются Требования не применяются Требования применяются
Только для внутреннего использования
  • Инструменты, предназначенные только для рекламодателей и агентств, но не внешних партнеров
Требования не применяются Требования не применяются Требования не применяются

Инструменты, которые предлагают ограниченный набор специализированных возможностей и которые нельзя использовать для создания кампаний, групп объявлений и объявлений, а также управления ими, не могут считаться полнофункциональными. К ним не применяются требования к функциям создания и управления. Если вы не уверены, действуют ли требования в вашем случае, свяжитесь с нами. Наши специалисты по соблюдению требований Google Ads API определят, является ли ваш инструмент полнофункциональным. Если вы внесете в него существенные изменения, может потребоваться повторная проверка.

Требования к минимальной функциональности относятся только к идентификаторам разработчиков со стандартным доступом.

Требования к клиентам AdWords API

Все инструменты, в которых используется AdWords API, должны соответствовать требованиям к минимальной функциональности, приведенным в этом документе. При переходе с AdWords API на Google Ads API требования должны соблюдаться в любом случае: при использовании только AdWords API, только Google Ads API или обоих одновременно.

Требования к клиентам Google Ads API, предназначенным только для отчетности

Чтобы соответствовать требованиям к минимальной функциональности, клиенты Google Ads API должны содержать функции отчетности на всех иерархических уровнях Google Рекламы, представленных в интерфейсе. Под уровнями понимаются аккаунт, кампания, группа объявлений, объявление и ключевое слово. Например, если в клиенте Google Ads API представлены группы объявлений, в нем должны быть реализованы все функции отчетности на уровне группы объявлений, отмеченные в таблице ниже как обязательные.

В интерфейсе отчетов такого клиента Google Ads API могут быть представлены не все иерархические уровни. Например, если в интерфейсе клиента Google Ads API, предназначенного только для отчетности, не отображаются данные об эффективности групп объявлений, можно не реализовывать функции отчетности на уровне групп объявлений.

Эти правила распространяются на отчеты всех типов, даже если они не относятся к иерархическим уровням Google Рекламы. Если в клиенте реализован какой-либо отчет, он должен содержать все обязательные поля.

Чтобы соответствовать требованиям к минимальной функциональности, клиенты Google Ads API должны по умолчанию отображать все столбцы, помеченные как обязательные в столбце "Объект, поле, руководство" ниже. Остальные столбцы показателей должны быть доступны для выбора. Данные отчетов Google Рекламы должны быть явно заметны и доступны для конечных пользователей.

Скачиваемые отчеты

Если отчеты нельзя просмотреть в интерфейсе инструмента, но можно скачать, например в виде файла CSV, то ссылка должна находиться на видном месте и быть понятной. Загруженный файл должен содержать все необходимые поля и иметь соответствующее название.

Отчеты по периодам

Рекомендуем добавить возможность фильтрации отчетов по диапазонам дат. Если такая настройка не реализована в вашем приложении, по каждому обязательному полю отчета должны предоставляться данные не менее чем за 30 дней.

Требования к клиентам API, поддерживающим функции создания и управления

Чтобы соответствовать требованиям к минимальной функциональности, в полнофункциональном клиенте Google Ads API должны быть реализованы все обязательные функции создания и управления, указанные в таблице ниже, для всех перечисленных ниже отчетов. Все функции должны быть доступны для конечного рекламодателя в полной мере.

Инструменты API, предназначенные только для торговых кампаний

Если инструмент предназначен только для создания торговых кампаний и управления ими, то вам необходимо реализовать только те функции создания, управления и отчетности Google Ads API, которые связаны с такими кампаниями. Чтобы получить актуальный список функций, свяжитесь со специалистами по соблюдению требований Google Ads API, заполнив эту форму: https://services.google.com/fb/forms/apicontact/.

Инструменты API, предназначенные только для продвижения приложений

Если инструмент предназначен только для создания кампаний, ориентированных на продвижение приложений, и управления ими, то вам необходимо реализовать только те функции создания, управления и отчетности Google Ads API, которые связаны с такими кампаниями. Чтобы получить актуальный список функций, свяжитесь со специалистами по соблюдению требований Google Ads API, заполнив эту форму: https://services.google.com/fb/forms/apicontact/.

Требования к клиентам API, поддерживающим планирование

Если клиент Google Ads API включает какие-либо инструменты, связанные с KeywordPlanIdeaService или KeywordPlanService, в нем должны быть полностью реализованы функции создания, управления и отчетности, отмеченные ниже как обязательные.

Требования к клиентам API, поддерживающим рекомендации

Если клиент Google Ads API включает какие-либо инструменты, связанные с RecommendationService, он должен соответствовать следующим требованиям:

  1. В нем должны быть полностью реализованы функции создания, управления и отчетности, отмеченные ниже как обязательные.
  2. Все рекомендации Google Рекламы, которые показываются конечным пользователям, должны быть соответствующим образом помечены в интерфейсе клиента.
  3. У конечных пользователей должна быть возможность просматривать, применять и отклонять все рекомендации Google Рекламы, представленные в клиенте.

Требования для корректировки ставок

Все клиенты API, поддерживающие функции создания и управления, должны удовлетворять следующим требованиям в отношении корректировки ставок:

  1. Конечные пользователи должны иметь возможность вводить все допустимые значения.
  2. Конечные пользователи должны иметь возможность просматривать и изменять корректировку ставок до того, как она будет задана клиентом Google Ads API.
  3. Корректировка ставок не должна использоваться для включения или изменения других функций, например таргетинга или исключения.

Одноразовое продление срока реализации крупных обновлений

Мы понимаем, что иногда для добавления новых функций требуется значительно переработать программу. Для инструментов API, которые хотя бы 2 года подряд соответствовали всем минимальным требованиям к функциональности, можно запросить продление срока внедрения очередных обновлений на 6 месяцев. В течение этого периода мы не будем проводить проверку наличия функций, а вам необходимо привести инструмент в соответствие всем требованиям, вступающим в силу к концу срока продления. Впоследствии вам также потребуется своевременно внедрять новые функции к датам, указанным в таблице ниже.

Для каждого инструмента API срок продлевается не чаще одного раза в четыре года. Таким образом, второй шестимесячный срок можно запрашивать не ранее чем через четыре года после истечения первого.

Чтобы запросить продление срока, заполните форму на странице https://services.google.com/fb/forms/apicontact/. Заявка должна быть подписана и отправлена руководителем компании (генеральным директором, главным техническим директором или старшим вице-президентом). Учтите, что продление срока не гарантируется.

Реализация функций

Если иное не указано ниже, функция считается реализованной, если реализованы все ее доступные подфункции и параметры, описанные в документации по API. Например, функция "Включение/отключение показа в сетях" подразумевает возможность включать и отключать показ рекламы в Google Поиске, на сайтах поисковых партнеров и в контекстно-медийной сети. Более того, если в клиенте Google Ads API реализована функция, подобная любой необязательной функции Google, необходимо также внедрить в клиент ее аналог, разработанный нами. Например, если в клиенте Google Ads API используется собственный алгоритм подбора вариантов ключевых слов, добавьте также инструмент подсказки ключевых слов от Google.

Чтобы обеспечить соответствие требованиям к минимальной функциональности, все обязательные функции необходимо добавлять до определенной даты. Она указана в формате Срок: ГГГГ-MM-ДД. Если даты нет, срок считается истекшим. Кроме того, скриншоты и/или макеты будущих изменений в клиенте Google Ads API необходимо отправить нам с помощью специальной формы не позднее чем за две недели до того, как они вступят в силу. Через указанный промежуток времени вы можете внедрять изменения независимо от того, получили ли вы ответ Google.

Соблюдение требований к минимальной функциональности для разных API

Инструменты API должны соответствовать требованиям к минимальной функциональности во всех случаях, изложенных в данном руководстве: при использовании только AdWords API, только Google Ads API или обоих API одновременно.

Список функций

Номер Функциональность Объект, поле, руководство Требования

Функции создания

C.10 Создание кампании campaign Обязательно
C.14 Установка корректировки ставок для мобильных устройств campaign_criterion.bid_modifier
ad_group_bid_modifier.bid_modifier
Обязательно
C.15 Установка корректировки ставок для планшетов и компьютеров campaign_criterion.bid_modifier Обязательно. Необходима поддержка на уровне кампании и группы объявлений.
C.20 Включение геотаргетинга campaign_criterion.location Обязательно
C.21 Включение таргетинга по расстоянию Скоро Обязательно. Необходимо обеспечить соответствие требованиям для AdWords API.
C.25 Выбор значения корректировки для геотаргетинга campaign_criterion.bid_modifier Обязательно
C.30 Включение языкового таргетинга campaign_criterion.language
language_constant
Обязательно
C.50 Включение/отключение показа в сетях campaign.network_settings.target_google_search
campaign.network_settings.target_search_network
campaign.network_settings.target_content_network
campaign.network_settings.target_partner_search_network
Обязательно
C.65 Создание конверсий на сайте или звонков-конверсий, генерация кода Отслеживание конверсий Обязательно. Необходима поддержка создания глобальных тегов и тегов событий.
C.70 Указание адресов Тег фида адресов
Службы фидов
Службы настройки расширений
Обязательно. Необходима поддержка на уровне аккаунта.
C.72 Ссылки на приложения Тег фида приложения
Службы настройки расширений
Службы фидов
Обязательно. Необходима поддержка на уровне аккаунта.
C.75 Уточнения Тег фида уточнений
Службы настройки расширений
Службы фидов
Обязательно. Необходима поддержка на уровне аккаунта, кампании и группы объявлений.
C.80 Дополнительные ссылки Тег фида дополнительных ссылок
Службы настройки расширений
Службы фидов
Обязательно. Необходима поддержка на уровне аккаунта, кампании и группы объявлений.
C.90 Назначение ставок: цена за клик, вручную campaign.manual_cpc Обязательно. Необходима поддержка на уровне кампании.
C.95 Назначение ставок: Оптимизатор цены за конверсию bidding_strategy.enhanced_cpc Обязательно. Необходима поддержка на уровне кампании.
C.101 Назначение ставок: максимальное количество кликов (пакетная) bidding_strategy.target_spend Обязательно. Необходима поддержка на уровне кампании.
C.111 Назначение ставок: целевая позиция на странице поиска bidding_strategy.page_one_promoted Обязательно. Необходима поддержка на уровне кампании.
C.112 Выбор способа назначения ставок bidding_strategy.target_outrank_share Обязательно. Необходима поддержка на уровне кампании.
C.120 Выбор бюджета campaign_budget Обязательно
C.140 Выбор метода показа campaign_budgets.delivery_method Обязательно
C.190 Создание группы объявлений ad_group Обязательно
C.191 Назначение максимальной цены за клик для группы объявлений ad_group.cpc_bid_micros Обязательно, если цены за клик назначаются вручную или используется оптимизированная цена за клик.
C.192 Назначение максимальной цены за конверсию для группы объявлений ad_group.cpa_bid_micros Обязательно, если используется целевая цена за конверсию (стандартная или пакетная стратегия).
C.193 Назначение целевой рентабельности инвестиций в рекламу для группы объявлений ad_group.target_roas Обязательно, если используется целевая рентабельность инвестиций в рекламу.
C.200 Добавление развернутого текстового объявления ad_group_ad.ad.expanded_text_ad Обязательно
C.260 Добавление ключевого слова ad_group_criterion.keyword Обязательно
C.270 Добавление минус-слов на уровне группы объявлений ad_group_criterion.negative Обязательно
C.290 Указание максимальной цены за клик для ключевого слова ad_group_criterion.cpc_bid_micros Обязательно
C.300 Выбор типа соответствия ключевого слова ad_group_criterion.keyword.match_type Обязательно
C.311 Назначение конечного URL ключевого слова ad_group_criterion.final_urls Обязательно
C.320 Шаблон отслеживания на уровне аккаунта customer.tracking_url_template Обязательно
C.321 Шаблон отслеживания на уровне кампании campaign.tracking_url_template Обязательно
C.325 Специальные параметры на уровне кампании campaign.url_custom_parameters Обязательно
C.326 Специальные параметры на уровне группы объявлений ad_group.url_custom_parameters Обязательно
C.328 Назначение суффикса конечного URL на уровне аккаунта customer.final_url_suffix Обязательно
C.329 Назначение суффикса конечного URL на уровне кампании campaign.final_url_suffix Обязательно
C.500 Создание торговой кампании Торговые кампании Обязательно
C.505 Настройка идентификатора продавца campaign.shopping_setting.merchant_id Обязательно
C.506 Настройка страны сбыта campaign.shopping_setting.sales_country Обязательно
C.510 Настройка фильтра ресурсов campaign_criterion.listing_scope Обязательно
C.520 Создание товарного объявления ad_group_ad.ad.shopping_product_ad Обязательно
C.525 Настройка первого (корневого) сегмента товаров ad_group_criterion.listing_group Обязательно
C.530 Реклама местного ассортимента campaign.shopping_setting.enable_local
ad_group_criterion.listing_group.case_value.product_channel
ad_group_criterion.listing_group.case_value.product_channel_exclusivity
Обязательно
C.610 Объявления только с номером телефона ad_group_ad.ad.call_only_ad Обязательно
C.700 Создание на уровне группы объявлений или кампании критериев для таргетинга на список пользователей или его исключения ad_group_criterion.user_list
campaign_criterion.user_list
Обязательно
C.710 Настройка корректировки ставок для списков пользователей в кампаниях и группах объявлений в поисковой сети campaign_criterion.bid_modifier
ad_group_bid_modifier.bid_modifier
Обязательно

Функции управления

M.10 Изменение настроек кампании campaign.*setting Обязательно
M.15 Изменение корректировок ставок для смартфонов, планшетов и компьютеров campaign_criterion.bid_modifier
ad_group_bid_modifier.bid_modifier
Обязательно. Необходима поддержка на уровне кампании и группы объявлений.
M.20 Изменение настроек группы объявлений (всех обязательных настроек в разделе "Функции создания", относящихся к группе объявлений) ad_group.*_setting Обязательно
M.25 Изменение корректировки ставок для геотаргетинга campaign_criterion.bid_modifier Обязательно
M.31 Выбор способа назначения ставок: целевая цена за конверсию (стандартная или пакетная стратегия) campaign.target_cpa (стандартная)
bidding_strategy.target_cpa (пакетная)
Обязательно. Стандартная и пакетная стратегии должны поддерживаться на уровне кампании.
M.32 Выбор способа назначения ставок: целевая рентабельность инвестиций в рекламу (стандартная или пакетная стратегия) campaign.target_roas (стандартная)
bidding_strategy.target_roas (пакетная)
Обязательно. Стандартная и пакетная стратегии должны поддерживаться на уровне кампании.
M.35 Включение ротации объявлений ad_group.ad_rotation_mode Обязательно. Необходима поддержка на уровне группы объявлений.
M.40 Изменение максимальной цены за клик для ключевого слова ad_group_criterion.cpc_bid_micros Обязательно
M.100 Изменение развернутого текстового объявления ad_group_ad.ad.expanded_text_ad Обязательно
M.101 Изменение ставок: максимальное количество кликов (стандартная стратегия) campaign.target_spend
bidding_strategy.target_spend
Обязательно. Необходима поддержка на уровне кампании.
M.110 Приостановка, включение и удаление кампании campaign.status Обязательно
M.120 Приостановка, включение и удаление группы объявлений ad_group.status Обязательно
M.130 Приостановка, включение и удаление объявления ad_group_ad.status Обязательно
M.140 Приостановка, включение и удаление ключевого слова ad_group_criterion.status Обязательно
M.150 Изменение фильтра ресурсов campaign_criterion.listing_scope Обязательно
M.160 Сегментация (добавление сегмента товаров) ad_group_criterion.listing_group Обязательно
M.170 Удаление сегмента товаров ad_group_criterion.listing_group Обязательно
M.180 Изменение максимальной цены за клик для сегмента товаров ad_group_criterion.cpc_bid_micros Обязательно
M.190 Исключение сегмента товаров (делегирование) ad_group_criterion.negative Обязательно
M.320 Управление всеми шаблонами отслеживания в функциях создания customer.tracking_url_template
campaign.tracking_url_template
Обязательно
M.325 Управление всеми пользовательскими параметрами в функциях создания campaign.url_custom_parameters
ad_group.url_custom_parameters
Обязательно
M.328 Управление всеми суффиксами конечных URL в функциях создания customer.final_url_suffix
campaign.final_url_suffix
Обязательно
M.700 Изменение на уровне группы объявлений или кампании критериев для таргетинга на список пользователей или его исключения ad_group_criterion.user_list
campaign_criterion.user_list

(список пользователей в критерии изменять нельзя, но можно корректировать другие поля, например статус или критерии списка пользователей)
Обязательно
M.710 Изменение корректировки ставок для списка пользователей для кампаний и групп объявлений в поисковой сети campaign_criterion.bid_modifier
ad_group_bid_modifier.bid_modifier
Обязательно

Функции

R.10 Эффективность аккаунта metrics.clicks
metrics.cost_micros
metrics.impressions

… от customer
Обязательно
R.20 Эффективность кампаний campaign
campaign.status
Обязательно
R.30 Эффективность групп объявлений ad_group
ad_group.status
Обязательно
R.40 Эффективность объявлений metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.average_position
metrics.conversions
ad_group_ad.status
Обязательно
R.50 Эффективность ключевых слов keyword_view
ad_group_criterion.status
Обязательно
R.70 Эффективность поисковых запросов search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions
Обязательно
R.80 Эффективность географических районов Будет реализовано в ближайшем будущем Обязательно. Необходимо обеспечить соответствие требованиям для AdWords API.
R.90 Категория без ключевых слов dynamic_search_ads_search_term Обязательно
R.100 Запрос без ключевых слов dynamic_search_ads_search_term_view Обязательно
R.110 Эффективность торговых кампаний metrics.clicks
metrics.impressions
metrics.cost_micros
metrics.conversions
segments.product_bidding_category_level1
segments.product_bidding_category_level2
segments.product_bidding_category_level3
segments.product_bidding_category_level4
segments.product_bidding_category_level5
segments.product_type_l1
segments.product_type_l2
segments.product_type_l3
segments.product_type_l4
segments.product_type_l5
Обязательно
R.120 Сегмент товаров metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
Обязательно
R.130 Эффективность целевых ставок bidding_strategy Обязательно
R.150 Эффективность аудитории campaign_audience_view для данных на уровне кампании
ad_group_audience_view для данных на уровне группы объявлений
Обязательно