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

v. 2022-10-06

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

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

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

Обратите внимание, что RMF применяется только к токенам разработчиков со стандартным уровнем доступа.

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

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

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

Если вы хотите запросить продление срока действия вашего инструмента, запросите форму заявки, связавшись с нами по адресу https://support.google.com/adspolicy/contact/contact_ads_api . Ваша заявка должна быть подписана и подана руководителем (генеральным директором, техническим директором или старшим вице-президентом) вашей компании. Обратите внимание, что одобрение вашей заявки не гарантируется.

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

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

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

Для соответствия требованиям RMF, клиент Google Ads API, предназначенный только для создания отчетов, должен отображать функциональность создания отчетов для каждого из уровней иерархии Google Ads, отображаемых в его интерфейсе отчетов. Уровень иерархии Google Ads означает один из следующих уровней: Аккаунт, Кампания, Группа объявлений, Объявление или Ключевое слово. Например, если клиент Google Ads, предназначенный только для создания отчетов, отображает Группы объявлений, то он должен реализовать всю функциональность создания отчетов на уровне «Групп объявлений», которая помечена как «Обязательная» ниже.

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

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

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

Отчеты, доступные для скачивания

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

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

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

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

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

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

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

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

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

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

  • Инструменты с полным спектром услуг
  • Инструменты, доступные только внутри системы
  • API-инструменты только для онлайн-покупок, Performance Max / Smart Shopping, App Promotion и Hotel.
  • Специализированные инструменты, предоставляющие функциональные возможности для управления кампаниями.

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

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

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

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

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

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

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

Для обеспечения соответствия требованиям RMF, все новые необходимые функции должны быть добавлены к установленному сроку (указанному рядом с каждой функцией как «Срок выполнения: ГГГГ-ММ-ДД» ). Любые RMF без указанного срока выполнения считаются просроченными. Кроме того, мы требуем, чтобы вы отправляли скриншоты и/или макеты предлагаемых существенных изменений в клиент Google Ads API не менее чем за две недели до вступления этих изменений в силу, используя форму изменения инструмента . Для ясности, по истечении этих двух недель вам не нужно ждать ответа от Google, прежде чем эти существенные изменения вступят в силу.

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

Номер товара Функциональность Объект/Поле/Руководство Требование

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

С.10 Создать кампанию campaign Необходимый
С.20 Включить геотаргетинг Таргетинг по местоположению Обязательно. Необязательно, может отображаться пользователю, если для пользовательской базы актуальна только одна страна.
С.30 Включить таргетинг по языку campaign_criterion.language
language_constant
Обязательно. Может быть показано пользователю по желанию, если для пользовательской базы актуален только один язык.
С.65 Создайте веб-сайт/сгенерируйте фрагмент кода для конверсии звонков и звонков. Отслеживание конверсий Требуется наличие как минимум одного типа отслеживания конверсий.
С.75 Дополнительные звонки Заполнитель для ленты выноски
Службы настройки расширений
Кормовые услуги
Обязательно. Поддержка этой функции должна осуществляться только на уровне учетной записи.
С.96 Настройка параметров назначения ставок: Целевая цена за конверсию (портфельный и стандартный уровни) campaign.target_cpa (Standard)
bidding_strategy.target_cpa (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
С.97 Настройка параметров назначения ставок: Целевая рентабельность инвестиций (ROAS) (для портфеля и стандартного портфеля) campaign.target_roas (Standard)
bidding_strategy.target_roas (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
С.98 Настройка параметра назначения ставок: Максимизировать конверсии (стандартный) campaign.maximize_conversions (Standard) Необходимый
С.120 Установить бюджет campaign_budget Необходимый
С.190 Создать группу объявлений ad_group Обязательно. Необязательно: возможность создания нескольких групп объявлений.
С.260 Добавить ключевое слово ad_group_criterion.keyword Необходимый
С.270 Добавить минус-слова в кампанию campaign_criterion.negative Необходимый
С.300 Установить тип соответствия ключевому слову ad_group_criterion.keyword
.match_type
Необходимый

Функциональность управления

М.10 Редактировать настройки кампании campaign.*setting Обязательно. При изменении потребуются только те настройки, которые необходимы при создании.
М.96 Измените параметр назначения ставок: Целевая цена за конверсию (портфельный и стандартный уровни) campaign.target_cpa (Standard)
bidding_strategy.target_cpa (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
М.97 Параметры редактирования ставок: Целевая рентабельность инвестиций (ROAS) (для портфеля и стандартного портфеля) campaign.target_roas (Standard)
bidding_strategy.target_roas (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
М.98 Изменение параметра назначения ставок: Максимизация конверсий (стандартный) campaign.maximize_conversions (Standard) Необходимый
М.110 Приостановить / включить / удалить кампанию campaign.status Необходимый
М.130 Приостановить / включить / удалить рекламу ad_group_ad.status Необходимый
М.140 Пауза / включение / удаление ключевого слова ad_group_criterion.status Необходимый

Функциональность формирования отчетов

Р.10 Клиент metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Необходимый
Р.20 Кампания metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Необходимый
campaign.status Обязательно для отображения приостановленных, активных и удаленных кампаний.
Необязательно, если отображаются только активные кампании.
Р.40 Группа объявлений metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
Необходимый
ad_group_ad.status Обязательно для отображения приостановленных, активных и удаленных объявлений.
Необязательно, если отображаются только активные объявления.
Р.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 Обязательно, если отображаются приостановленные, активные и удаленные ключевые слова.
Необязательно, если отображаются только активные ключевые слова.
Р.70 Просмотр поискового запроса search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions
Необходимый
Р.100 Динамическая поисковая реклама Просмотр поискового запроса dynamic_search_ads_search_term_view.search_term
metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
Требуется только при внедрении динамической поисковой рекламы.
Р.130 Стратегия торгов bidding_strategy.type
metrics.clicks
metrics.cost_micros
metrics.cost_per_conversion
metrics.impressions
metrics.average_cpc
metrics.conversions
Необходимый
bidding_strategy.status Обязательно, если отображаются приостановленные, активные и удаленные стратегии.
Необязательно, если отображаются только активные стратегии.

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

Номер товара Функциональность Объект/Поле/Руководство Требование

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

С.20 Включить геотаргетинг Таргетинг по местоположению Обязательно. Необязательно, может отображаться пользователю, если для пользовательской базы актуальна только одна страна.
С.30 Включить таргетинг по языку campaign_criterion.language
language_constant
Обязательно. Может быть показано пользователю по желанию, если для пользовательской базы актуален только один язык.
С.65 Создайте веб-сайт/сгенерируйте фрагмент кода для конверсии звонков и звонков. Отслеживание конверсий Требуется наличие как минимум одного типа отслеживания конверсий.
С.96 Настройка параметров назначения ставок: Целевая цена за конверсию (портфельный и стандартный уровни) campaign.target_cpa (Standard)
bidding_strategy.target_cpa (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
Настройка варианта ставок: Предварительная регистрация Реклама приложения для предварительной регистрации Обязательно для предварительных регистраций в рамках рекламных кампаний приложений.
С.190 Создать группу объявлений ad_group Обязательно. Необязательно: возможность создания нескольких групп объявлений.
Добавить ресурсы в группу объявлений ad_group Обязательные элементы: текстовые файлы. Изображения и видеофайлы: необязательные.
С.601 Создавайте кампании по установке или повторному вовлечению пользователей в приложения.   Требуется: установка приложения в рамках рекламной кампании или повторное вовлечение пользователей в рамках рекламной кампании, но не оба действия одновременно.
С.602 Включить настройки кампании приложения AppCampaignSetting Обязательно: возможность выбора приложения для рекламы или добавления прямых ссылок для взаимодействия с аудиторией.

Функциональность управления

М.601 Приостановить / включить / удалить рекламную кампанию приложения campaign.status Необходимый
М.602 Редактировать настройки кампании приложения campaign.*setting Необходимый

Функциональность формирования отчетов

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

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

Номер товара Функциональность Объект/Поле/Руководство Требование

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

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

Функциональность управления

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

Функциональность формирования отчетов

Р.10 Эффективность аккаунта metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Необходимый
Р.20 Результаты кампании metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Обязательно для отображения приостановленных, активных и удаленных кампаний.
Необязательно, если отображаются только активные кампании.
Р.111 Отчет «Показ эффективности работы отеля» hotel_performance_view Необходимый

Список функций кампании Performance Max

Номер товара Функциональность Объект/Поле/Руководство Требование

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

С.10 Создать кампанию campaign Обязательно. Необязательно: возможность создания нескольких кампаний.
С.20 Включить геотаргетинг Таргетинг по местоположению Обязательно. Необязательно, может отображаться пользователю, если для пользовательской базы актуальна только одна страна.
С.30 Включить таргетинг по языку campaign_criterion.language
language_constant
Обязательно. Может быть показано пользователю по желанию, если для пользовательской базы актуален только один язык.
С.65 Создайте веб-сайт/сгенерируйте фрагмент кода для конверсии звонков и звонков. Отслеживание конверсий Требуется наличие как минимум одного типа отслеживания конверсий.
С.120 Установить бюджет campaign_budget Необходимый
Настройте стратегию торгов Дополнительная опция, позволяющая пользователю выбрать конкретную стратегию назначения ставок и установить целевой показатель.

Функциональность управления

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

Функциональность формирования отчетов

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

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

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

Номер товара Функциональность Объект/Поле/Руководство Требование

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

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

Функциональность управления

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

Функциональность формирования отчетов

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

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

Номер товара Функциональность Объект/Поле/Руководство Требование

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

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

Функциональность управления

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

Функциональность формирования отчетов

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

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

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

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

Обратите внимание, что RMF применяется только к токенам разработчиков со стандартным уровнем доступа.

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

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

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

Если вы хотите запросить продление срока действия вашего инструмента, запросите форму заявки, связавшись с нами по адресу https://support.google.com/adspolicy/contact/contact_ads_api . Ваша заявка должна быть подписана и подана руководителем (генеральным директором, техническим директором или старшим вице-президентом) вашей компании. Обратите внимание, что одобрение вашей заявки не гарантируется.

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

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

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

Для соответствия требованиям RMF, клиент Google Ads API, предназначенный только для создания отчетов, должен отображать функциональность создания отчетов для каждого из уровней иерархии Google Ads, отображаемых в его интерфейсе отчетов. Уровень иерархии Google Ads означает один из следующих уровней: Аккаунт, Кампания, Группа объявлений, Объявление или Ключевое слово. Например, если клиент Google Ads, предназначенный только для создания отчетов, отображает Группы объявлений, то он должен реализовать всю функциональность создания отчетов на уровне «Групп объявлений», которая помечена как «Обязательная» ниже.

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

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

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

Отчеты, доступные для скачивания

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

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

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

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

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

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

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

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

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

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

  • Инструменты с полным спектром услуг
  • Инструменты, доступные только внутри системы
  • API-инструменты только для онлайн-покупок, Performance Max / Smart Shopping, App Promotion и Hotel.
  • Специализированные инструменты, предоставляющие функциональные возможности для управления кампаниями.

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

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

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

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

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

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

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

Для обеспечения соответствия требованиям RMF, все новые необходимые функции должны быть добавлены к установленному сроку (указанному рядом с каждой функцией как «Срок выполнения: ГГГГ-ММ-ДД» ). Любые RMF без указанного срока выполнения считаются просроченными. Кроме того, мы требуем, чтобы вы отправляли скриншоты и/или макеты предлагаемых существенных изменений в клиент Google Ads API не менее чем за две недели до вступления этих изменений в силу, используя форму изменения инструмента . Для ясности, по истечении этих двух недель вам не нужно ждать ответа от Google, прежде чем эти существенные изменения вступят в силу.

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

Номер товара Функциональность Объект/Поле/Руководство Требование

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

С.10 Создать кампанию campaign Необходимый
С.20 Включить геотаргетинг Таргетинг по местоположению Обязательно. Необязательно, может отображаться пользователю, если для пользовательской базы актуальна только одна страна.
С.30 Включить таргетинг по языку campaign_criterion.language
language_constant
Обязательно. Может быть показано пользователю по желанию, если для пользовательской базы актуален только один язык.
С.65 Создайте веб-сайт/сгенерируйте фрагмент кода для конверсии звонков и звонков. Отслеживание конверсий Требуется наличие как минимум одного типа отслеживания конверсий.
С.75 Дополнительные звонки Заполнитель для ленты выноски
Службы настройки расширений
Кормовые услуги
Обязательно. Поддержка этой функции должна осуществляться только на уровне учетной записи.
С.96 Настройка параметров назначения ставок: Целевая цена за конверсию (портфельный и стандартный уровни) campaign.target_cpa (Standard)
bidding_strategy.target_cpa (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
С.97 Настройка параметров назначения ставок: Целевая рентабельность инвестиций (ROAS) (для портфеля и стандартного портфеля) campaign.target_roas (Standard)
bidding_strategy.target_roas (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
С.98 Настройка параметра назначения ставок: Максимизировать конверсии (стандартный) campaign.maximize_conversions (Standard) Необходимый
С.120 Установить бюджет campaign_budget Необходимый
С.190 Создать группу объявлений ad_group Обязательно. Необязательно: возможность создания нескольких групп объявлений.
С.260 Добавить ключевое слово ad_group_criterion.keyword Необходимый
С.270 Добавить минус-слова в кампанию campaign_criterion.negative Необходимый
С.300 Установить тип соответствия ключевому слову ad_group_criterion.keyword
.match_type
Необходимый

Функциональность управления

М.10 Редактировать настройки кампании campaign.*setting Обязательно. При изменении потребуются только те настройки, которые необходимы при создании.
М.96 Измените параметр назначения ставок: Целевая цена за конверсию (портфельный и стандартный уровни) campaign.target_cpa (Standard)
bidding_strategy.target_cpa (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
М.97 Параметры редактирования ставок: Целевая рентабельность инвестиций (ROAS) (для портфеля и стандартного портфеля) campaign.target_roas (Standard)
bidding_strategy.target_roas (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
М.98 Изменение параметра назначения ставок: Максимизация конверсий (стандартный) campaign.maximize_conversions (Standard) Необходимый
М.110 Приостановить / включить / удалить кампанию campaign.status Необходимый
М.130 Приостановить / включить / удалить рекламу ad_group_ad.status Необходимый
М.140 Пауза / включение / удаление ключевого слова ad_group_criterion.status Необходимый

Функциональность формирования отчетов

Р.10 Клиент metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Необходимый
Р.20 Кампания metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Необходимый
campaign.status Обязательно для отображения приостановленных, активных и удаленных кампаний.
Необязательно, если отображаются только активные кампании.
Р.40 Группа объявлений metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
Необходимый
ad_group_ad.status Обязательно для отображения приостановленных, активных и удаленных объявлений.
Необязательно, если отображаются только активные объявления.
Р.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 Обязательно, если отображаются приостановленные, активные и удаленные ключевые слова.
Необязательно, если отображаются только активные ключевые слова.
Р.70 Просмотр поискового запроса search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions
Необходимый
Р.100 Динамическая поисковая реклама Просмотр поискового запроса dynamic_search_ads_search_term_view.search_term
metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
Требуется только при внедрении динамической поисковой рекламы.
Р.130 Стратегия торгов bidding_strategy.type
metrics.clicks
metrics.cost_micros
metrics.cost_per_conversion
metrics.impressions
metrics.average_cpc
metrics.conversions
Необходимый
bidding_strategy.status Обязательно, если отображаются приостановленные, активные и удаленные стратегии.
Необязательно, если отображаются только активные стратегии.

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

Номер товара Функциональность Объект/Поле/Руководство Требование

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

С.20 Включить геотаргетинг Таргетинг по местоположению Обязательно. Необязательно, может отображаться пользователю, если для пользовательской базы актуальна только одна страна.
С.30 Включить таргетинг по языку campaign_criterion.language
language_constant
Обязательно. Может быть показано пользователю по желанию, если для пользовательской базы актуален только один язык.
С.65 Создайте веб-сайт/сгенерируйте фрагмент кода для конверсии звонков и звонков. Отслеживание конверсий Требуется наличие как минимум одного типа отслеживания конверсий.
С.96 Настройка параметров назначения ставок: Целевая цена за конверсию (портфельный и стандартный уровни) campaign.target_cpa (Standard)
bidding_strategy.target_cpa (Portfolio)
Обязательно. Стратегии «Портфолио» и «Стандарт» должны поддерживаться на уровне кампании.
Настройка варианта ставок: Предварительная регистрация App ads for pre-registration Required for app campaigns for pre-registration.
C.190 Создать группу объявлений ad_group Required. Optional: ability to create multiple ad groups.
Add assets to ad group ad_group Required: text assets. Optional for image and video assets.
C.601 Create install or re-engagement app campaigns   Required: app campaign install or app campaign re-engagement but not both.
C.602 Enable app campaign settings AppCampaignSetting Required: ability to select the app to be advertised or add deep links for engagement.

Management Functionality

M.601 Pause / enable / remove app campaign campaign.status Необходимый
M.602 Edit app campaign settings campaign.*setting Необходимый

Reporting Functionality

R.10 Account performance 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
Required if showing paused, active, and removed campaigns.
Optional if only showing active campaigns.

Hotel-only Tool Feature List

Номер товара Функциональность Object/Field/Guide Требование

Creation Functionality

C.11 Create hotel campaign hotel campaign Необходимый
C.12 Set Hotel Center identifier for hotel campaign HotelSettingInfo Необходимый
C.20 Enable geo targeting Location Targeting Required Optional to expose to the user if only one country is relevant for the user base.
C.30 Enable language targeting campaign_criterion.language
language_constant
Required. Optional to expose to the user if only one language is relevant for the user base.
C.65 Create website / call conversion and generate code snippet Conversion Tracking Required at least one type of conversion tracking.
C.120 Установить бюджет campaign_budget Необходимый
Set bidding strategy Hotel Bidding Optional to allow the user to choose a specific bidding strategy and set a target.
C.190 Create hotel ad group ad_group Required. Optional: ability to create multiple Ad groups.
C.526 Add first (root) partition hotel group partition hotel listing groups Required for Hotel Ads campaign to run, but not required to be exposed to the user.

Management Functionality

M.10 Edit campaign settings campaign.*setting Необходимый
M.110 Pause / enable / remove campaign campaign.status Необходимый
M.161 Subdivide (add hotel group partition) hotel listing groups Необходимый
M.191 Exclude hotel group AdGroupCriterion Необходимый

Reporting Functionality

R.10 Account performance 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
Required if showing paused, active, and removed campaigns.
Optional if only showing active campaigns.
R.111 Hotel Performance View report hotel_performance_view Необходимый

Performance Max Campaign Feature List

Номер товара Функциональность Object/Field/Guide Требование

Creation Functionality

C.10 Создать кампанию campaign Required. Optional: ability to create multiple campaigns.
C.20 Enable geo targeting Location Targeting Required. Optional to expose to the user if only one country is relevant for the user base.
C.30 Enable language targeting campaign_criterion.language
language_constant
Required. Optional to expose to the user if only one language is relevant for the user base.
C.65 Create website / call conversion and generate code snippet Conversion Tracking Required at least one type of conversion tracking.
C.120 Установить бюджет campaign_budget Необходимый
Set bidding strategy Optional to allow the user to choose a specific bidding strategy and set a target.

Management Functionality

M.10 Edit campaign settings campaign.*setting Required. Only settings required at creation time would be required at change time.
M.110 Pause / enable / remove campaign campaign.status Необходимый

Reporting Functionality

R.10 Клиент metrics.clicks
metrics.cost_micros
metrics.conversions
Required. Optional if only showing only one campaign.
R.20 Кампания metrics.clicks
metrics.cost_micros
metrics.conversions
Необходимый

Smart Campaign Feature List

The following table defines the minimum set of functionality required to implement Smart Campaigns . If your tool implements Smart Campaigns at all, you must implement at minimum this set of features. If your tool does not implement Smart Campaigns, then these features are not required.

Номер товара Функциональность Object/Field/Guide Требование

Creation Functionality

C.10 Create Smart Campaign Smart Campaign Необходимый
Add keyword theme KeywordThemeInfo Required for campaign creation, but optional to expose to the user.
C.20 Enable geo targeting Location Targeting Required for campaign creation, but optional to expose to the user.
C.70 Location assets Location assets Required only if integrating with a Business Profile .
C.120 Установить бюджет campaign_budget Необходимый
C.200 Добавить объявление Создать объявление Required for campaign creation, but optional to expose to the user.

Management Functionality

M.10 Edit campaign settings (all campaign-creation settings displayed to advertiser) campaign.*setting Необходимый
M.110 Pause / enable / remove campaign campaign.status Необходимый
M.130 Pause / enable / remove ad ad_group_ad.status Необходимый
Set / Edit Campaign schedule ad_schedule Необходимый
Remove / Add keyword theme KeywordThemeInfo Required for campaign creation, but optional to expose to the user.
Add/Remove Negative Keyword Theme KeywordThemeInfo Required for campaign creation, but optional to expose to the user.

Reporting Functionality

R.20 Результаты кампании metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
Required if showing paused, active, and removed campaigns. Optional if only showing active campaigns.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
Required only if integrating with a Business Profile .
R.70 Просмотр поисковых запросов в интеллектуальной кампании metrics.clicks
metrics.cost_micros
Необходимый

Standard Shopping Campaign Tool Feature List

Номер товара Функциональность Object/Field/Guide Требование

Creation Functionality

C.10 Создать кампанию campaign Необходимый
C.20 Enable geo targeting Location Targeting Required. Optional to expose to the user if only one country is relevant for the user base.
C.65 Create website / call conversion and generate code snippet Conversion Tracking Required at least one type of conversion tracking.
C.97 Set bidding option: Target ROAS (Portfolio and Standard) campaign.target_roas (Standard)
bidding_strategy.target_roas (Portfolio)
Required. Both the Portfolio and Standard strategies need to be supported at the campaign level.
C.120 Установить бюджет campaign_budget Необходимый
C.190 Создать группу объявлений ad_group Required. Optional: ability to create multiple Ad groups.
C.270 Add campaign negative keywords campaign_criterion.negative Необходимый
C.300 Set keyword match type ad_group_criterion.keyword
.match_type
Необходимый
C.505 Set merchant identifier   Необходимый
C.506 Set sales country   Необходимый
C.510 Set inventory filter   Необходимый
C.520 Create product ad   Необходимый
C.525 Add first (root) product partition   Необходимый
C.530 Create local inventory ads   Необходимый

Management Functionality

M.10 Edit campaign settings campaign.*setting Required. Only settings required at creation time would be required at change time.
M.97 Edit bidding option: Target ROAS (Portfolio and Standard) campaign.target_roas (Standard)
bidding_strategy.target_roas (Portfolio)
Required. Both the Portfolio and Standard strategies need to be supported at the campaign level.
M.110 Pause / enable / remove campaign campaign.status Необходимый
M.150 Edit inventory filter   Необходимый
M.160 Subdivide (add product partition)   Необходимый
M.170 Delete product partition   Необходимый
M.190 Exclude product partition   Необходимый

Reporting Functionality

R.10 Клиент metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
Required. Optional if only showing only one campaign.
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 Shopping performance metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
Required only if implementing Dynamic Search Ads.
R.120 Product partition metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
Required. Optional if products not subdivided
R.130 Bidding strategy performance   Required. Optional if products not subdivided