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

Версия от 6 октября 2022 г.

Любой сторонний инструмент, в котором используется Google Ads API, должен соответствовать требованиям к минимальной функциональности. Как указано ниже, требования к минимальной функциональности делятся на три группы: создание, управление и работа с отчетами. Правила применяются в зависимости от того, как именно вы работаете с Google Ads API (пометка "Требования к минимальной функциональности применяются" означает, что вы должны соблюдать эти требования).

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

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

Обратите внимание, что требования к минимальной функциональности применяются только к проектам Google Cloud со стандартным уровнем доступа.

Однократное продление для крупных обновлений

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

Продление может быть предоставлено не чаще одного раза в четыре года (второе продление должно начаться не ранее чем через четыре года после окончания первого).

Если вы хотите подать заявку на продление срока для своего инструмента, запросите форму заявки, связавшись с командой Google Ads API. Заявка должна быть подписана и отправлена руководителем вашей компании (генеральным директором, техническим директором или старшим вице-президентом). Обратите внимание, что одобрение заявки не гарантируется.

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

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

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

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

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

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

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

Загружаемые отчеты

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

Диапазоны дат в отчетах

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

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

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

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

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

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

Все API-клиенты могут использовать GoogleAdsService и RecommendationService для получения рекомендаций.

Использование RecommendationService.ApplyRecommendation() и RecommendationService.DismissRecommendation() ограничено следующими типами клиентов Google Ads API:

  • Инструменты полного цикла
  • Инструменты только для внутреннего использования
  • Инструменты API только для торговых кампаний, кампаний с максимальной эффективностью, умных торговых кампаний, кампаний для продвижения приложений и кампаний для гостиниц
  • Специализированные инструменты, которые предлагают функции управления кампаниями

Если клиент Google Ads API предлагает функцию применения или отклонения рекомендаций с помощью RecommendationService, он должен соответствовать следующим требованиям:

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

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

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

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

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

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

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

Список функций комплексного инструмента

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

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

C.10 Создание кампании campaign Обязательно
C.20 Включение геотаргетинга Геотаргетинг Обязательно. Если у вас только одна страна, то показывать ее пользователю необязательно.
C.30 Включение языкового таргетинга campaign_criterion.language
language_constant
Обязательно. Если для пользовательской базы актуален только один язык, показывать его необязательно.
C.65 Создание конверсий на сайте или звонков-конверсий, генерация кода Отслеживание конверсий Требуется хотя бы один тип отслеживания конверсий.
C.75 Уточнения Плейсхолдер фида уточнений
Extension Setting Services
Feed Services
Обязательно. Это должно поддерживаться только на уровне аккаунта.
C.96 Назначение ставок: целевая цена за конверсию (стандартная или пакетная стратегия) campaign.target_cpa (стандартная)
bidding_strategy.target_cpa (пакетная)
Обязательно. Пакетные и стандартные стратегии должны поддерживаться на уровне кампании.
C.97 Выбор способа назначения ставок: целевая рентабельность инвестиций в рекламу (стандартная или пакетная стратегия) campaign.target_roas (стандартная)
bidding_strategy.target_roas (пакетная)
Обязательно. Пакетные и стандартные стратегии должны поддерживаться на уровне кампании.
C.98 Задайте вариант назначения ставок: "Максимум конверсий" (стандартный). campaign.maximize_conversions (стандартный) Обязательно
C.120 Выбор бюджета campaign_budget Обязательно
C.190 Создать группу объявлений ad_group Обязательно. При желании вы можете создать несколько групп объявлений.
C.260 Добавление ключевого слова ad_group_criterion.keyword Обязательно
C.270 Добавьте минус-слова на уровне кампании campaign_criterion.negative Обязательно
C.300 Выбор типа соответствия ключевого слова ad_group_criterion.keyword
 .match_type
Обязательно

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

M.10 Изменить настройки кампании campaign.*setting Обязательно. При изменении нужно будет указать только те настройки, которые требуются при создании.
M.96 Изменение варианта назначения ставок: целевая цена за конверсию (пакетная и стандартная) campaign.target_cpa (стандартная)
bidding_strategy.target_cpa (пакетная)
Обязательно. Пакетные и стандартные стратегии должны поддерживаться на уровне кампании.
M.97 Изменить вариант назначения ставок: целевая рентабельность инвестиций в рекламу (пакетная и стандартная) campaign.target_roas (стандартная)
bidding_strategy.target_roas (пакетная)
Обязательно. Пакетные и стандартные стратегии должны поддерживаться на уровне кампании.
M.98 Изменить вариант назначения ставок: "Максимум конверсий" (стандартный) campaign.maximize_conversions (стандартный) Обязательно
M.110 Приостановка, включение и удаление кампании campaign.status Обязательно
M.130 Приостановка, включение и удаление объявления ad_group_ad.status Обязательно
M.140 Приостановка, включение и удаление ключевого слова ad_group_criterion.status Обязательно

Функции

R.10 Клиент metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Обязательно
R.20 Кампания metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Обязательно
campaign.status Обязательно, если показываются приостановленные, активные или удаленные кампании
Необязательно, если показываются только активные кампании.
R.40 Объявление из группы объявлений metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
Обязательно
ad_group_ad.status Обязательно, если показываются приостановленные, активные или удаленные объявления
Необязательно, если показываются только активные объявления.
R.50 Просмотр ключевых слов metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
ad_group_criterion
 .position_estimates
 .first_page_cpc_micros

ad_group_criterion
 .position_estimates
 .first_position_cpc_micros
Обязательно
ad_group_criterion.status Обязательно, если показываются приостановленные, активные или удаленные ключевые слова
Необязательно, если показываются только активные ключевые слова.
R.70 Просмотр поисковых запросов search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions
Обязательно
R.100 Просмотр поисковых запросов для динамических поисковых объявлений dynamic_search_ads_search_term_view.search_term
metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
Требуется только при использовании динамических поисковых объявлений.
R.130 Стратегия назначения ставок bidding_strategy.type
metrics.clicks
metrics.cost_micros
metrics.cost_per_conversion
metrics.impressions
metrics.average_cpc
metrics.conversions
Обязательно
bidding_strategy.status Обязательно, если показываются приостановленные, активные или удаленные стратегии
Необязательно, если показываются только активные стратегии.

Список функций инструмента для кампаний для приложений

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

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

C.20 Включение геотаргетинга Геотаргетинг Обязательно. Если у вас только одна страна, то показывать ее пользователю необязательно.
C.30 Включение языкового таргетинга campaign_criterion.language
language_constant
Обязательно. Если для пользовательской базы актуален только один язык, показывать его необязательно.
C.65 Создание конверсий на сайте или звонков-конверсий, генерация кода Отслеживание конверсий Требуется хотя бы один тип отслеживания конверсий.
C.96 Назначение ставок: целевая цена за конверсию (стандартная или пакетная стратегия) campaign.target_cpa (стандартная)
bidding_strategy.target_cpa (пакетная)
Обязательно. Пакетные и стандартные стратегии должны поддерживаться на уровне кампании.
Задать вариант назначения ставок: предварительная регистрация Объявления, ориентированные на предварительную регистрацию в приложении Обязательно для кампаний для приложений с предварительной регистрацией.
C.190 Создать группу объявлений ad_group Обязательно. При желании можно создать несколько групп объявлений.
Добавить объекты в группу объявлений ad_group Обязательно: текстовые объекты. Необязательно для объектов изображений и видео.
C.601 Создайте кампании для приложений, ориентированные на установку или повторное вовлечение.   Обязательно: кампания для приложений, ориентированная на установку, или кампания для приложений, ориентированная на повторное вовлечение (но не обе).
C.602 Как включить настройки кампании для приложений AppCampaignSetting Обязательно: возможность выбрать рекламируемое приложение или добавить ссылки на контент для повышения вовлеченности.

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

M.601 Как приостановить, включить или удалить кампанию для приложений campaign.status Обязательно
M.602 Как изменить настройки кампании для приложений campaign.*setting Обязательно

Функции

R.10 Эффективность аккаунта metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Обязательно
R.20 Эффективность кампании metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Обязательно, если показываются приостановленные, активные или удаленные кампании
Необязательно, если показываются только активные кампании.

Список функций инструмента для гостиниц

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

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

C.11 Создать кампанию для гостиниц кампания для гостиниц Обязательно
C.12 Как задать идентификатор Hotel Center для кампании для гостиниц HotelSettingInfo Обязательно
C.20 Включение геотаргетинга Геотаргетинг Обязательный. Необязательный, если для пользовательской базы актуальна только одна страна.
C.30 Включение языкового таргетинга campaign_criterion.language
language_constant
Обязательно. Если для пользовательской базы актуален только один язык, показывать его необязательно.
C.65 Создание конверсий на сайте или звонков-конверсий, генерация кода Отслеживание конверсий Требуется хотя бы один тип отслеживания конверсий.
C.120 Выбор бюджета campaign_budget Обязательно
  Выбрать стратегию назначения ставок Назначение ставок в кампаниях для гостиниц Пользователь может выбрать стратегию назначения ставок и задать цель.
C.190 Создать группу объявлений для рекламы отелей ad_group Обязательно. При желании вы можете создать несколько групп объявлений.
C.526 Добавьте первую (корневую) группу отелей группы предложений отелей Обязательный атрибут для проведения рекламной кампании отелей, но не для показа пользователям.

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

M.10 Изменение настроек кампании campaign.*setting Обязательно
M.110 Приостановка, включение и удаление кампании campaign.status Обязательно
M.161 Разбить на подгруппы (добавить сегмент группы отелей) группы предложений гостиниц Обязательно
M.191 Исключить группу отелей AdGroupCriterion Обязательно

Функции

R.10 Эффективность аккаунта metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Обязательно
R.20 Эффективность кампании metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Обязательно, если показываются приостановленные, активные или удаленные кампании
Необязательно, если показываются только активные кампании.
R.111 Отчет об эффективности гостиниц hotel_performance_view Обязательно

Список функций кампаний с максимальной эффективностью

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

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

C.10 Создать кампанию campaign Обязательно. Возможность создавать несколько кампаний (необязательно).
C.20 Включение геотаргетинга Геотаргетинг Обязательно. Если у вас только одна страна, то показывать ее пользователю необязательно.
C.30 Включение языкового таргетинга campaign_criterion.language
language_constant
Обязательно. Если для пользовательской базы актуален только один язык, показывать его необязательно.
C.65 Создание конверсий на сайте или звонков-конверсий, генерация кода Отслеживание конверсий Требуется хотя бы один тип отслеживания конверсий.
C.120 Выбор бюджета campaign_budget Обязательно
  Выбрать стратегию назначения ставок   Пользователь может выбрать стратегию назначения ставок и задать цель.

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

M.10 Изменить настройки кампании campaign.*setting Обязательно. При изменении нужно будет указать только те настройки, которые требуются при создании.
M.110 Приостановка, включение и удаление кампании campaign.status Обязательно

Функции

R.10 Клиент metrics.clicks
metrics.cost_micros
metrics.conversions
Обязательно. Необязательно, если показывается только одна кампания.
R.20 Кампания metrics.clicks
metrics.cost_micros
metrics.conversions
Обязательно

Список функций умных кампаний

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

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

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

C.10 Создать умную кампанию Умная кампания Обязательно
  Добавить тему ключевых слов KeywordThemeInfo Обязательно для создания кампании, но необязательно для показа пользователю.
C.20 Включение геотаргетинга Геотаргетинг Обязательно для создания кампании, но необязательно для показа пользователю.
C.70 Объекты адресов Объекты адресов Обязательно только при интеграции с профилем компании.
C.120 Выбор бюджета campaign_budget Обязательно
C.200 Добавить объявление Создать объявление Обязательно для создания кампании, но необязательно для показа пользователю.

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

M.10 Изменение настроек кампании (рекламодателю показываются все настройки, заданные при создании кампании). campaign.*setting Обязательно
M.110 Приостановка, включение и удаление кампании campaign.status Обязательно
M.130 Приостановка, включение и удаление объявления ad_group_ad.status Обязательно
  Как настроить или изменить расписание кампании ad_schedule Обязательно
  Удалить/добавить тему ключевых слов KeywordThemeInfo Обязательно для создания кампании, но необязательно для показа пользователю.
  Добавить/удалить тему минус-слов KeywordThemeInfo Обязательно для создания кампании, но необязательно для показа пользователю.

Функции отчетности

R.20 Эффективность кампании metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Обязательно, если показываются приостановленные, активные или удаленные кампании Необязательно, если показываются только активные кампании
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
Обязательно только при интеграции с профилем компании.
R.70 Просмотр поисковых запросов в умных кампаниях metrics.clicks
metrics.cost_micros
Обязательно

Список функций инструмента для стандартных торговых кампаний

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

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

C.10 Создание кампании campaign Обязательно
C.20 Включение геотаргетинга Геотаргетинг Обязательно. Если у вас только одна страна, то показывать ее пользователю необязательно.
C.65 Создание конверсий на сайте или звонков-конверсий, генерация кода Отслеживание конверсий Требуется хотя бы один тип отслеживания конверсий.
C.97 Выбор способа назначения ставок: целевая рентабельность инвестиций в рекламу (стандартная или пакетная стратегия) campaign.target_roas (стандартная)
bidding_strategy.target_roas (пакетная)
Обязательно. Пакетные и стандартные стратегии должны поддерживаться на уровне кампании.
C.120 Выбор бюджета campaign_budget Обязательно
C.190 Создать группу объявлений ad_group Обязательно. При желании вы можете создать несколько групп объявлений.
C.270 Добавьте минус-слова на уровне кампании campaign_criterion.negative Обязательно
C.300 Выбор типа соответствия ключевого слова ad_group_criterion.keyword
 .match_type
Обязательно
C.505 Настройка идентификатора продавца   Обязательно
C.506 Настройка страны сбыта   Обязательно
C.510 Настройка фильтра ресурсов   Обязательно
C.520 Создание товарного объявления   Обязательно
C.525 Настройка первого (корневого) сегмента товаров   Обязательно
C.530 Как создать рекламу местного ассортимента   Обязательно

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

M.10 Изменить настройки кампании campaign.*setting Обязательно. При изменении нужно будет указать только те настройки, которые требуются при создании.
M.97 Изменить вариант назначения ставок: целевая рентабельность инвестиций в рекламу (пакетная и стандартная) campaign.target_roas (стандартная)
bidding_strategy.target_roas (пакетная)
Обязательно. Пакетные и стандартные стратегии должны поддерживаться на уровне кампании.
M.110 Приостановка, включение и удаление кампании campaign.status Обязательно
M.150 Изменение фильтра ресурсов   Обязательно
M.160 Сегментация (добавление сегмента товаров)   Обязательно
M.170 Удаление сегмента товаров   Обязательно
M.190 Исключить сегмент товаров   Обязательно

Функции

R.10 Клиент metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
Обязательно. Необязательно, если показывается только одна кампания.
R.20 Кампания metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
Обязательно
R.70 Просмотр поисковых запросов search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions
Обязательно
R.110 Показатели участия в программе YouTube Покупок metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
Требуется только при использовании динамических поисковых объявлений.
R.120 Разбиение продукта metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
Обязательно. Необязательно, если товары не разделены на подгруппы.
R.130 Эффективность стратегии назначения ставок   Обязательно. Необязательный, если товары не разделены на подгруппы