Google Ads Data Manager API

Renta отправляет строки из вашего хранилища данных в Google Ads через Data Manager API в виде одного из двух объектов: аудиторий Customer Match и конверсий по кликам.

Строка Customer Match содержит идентификаторы, по которым Google узнаёт человека: почту, телефон, почтовый адрес. Строка конверсии содержит клик, который привёл к продаже, время события и его ценность.

Аутентификация

Renta авторизуется через Google OAuth. Авторизуйте тот аккаунт Google, у которого уже есть доступ к нужному аккаунту Google Ads.

На экране согласия Google запрашивает два разрешения: доступ к вашим аккаунтам и данным Google Ads и доступ к клиентским данным в Google Ads и Google Marketing Platform. Renta использует их, чтобы показать доступные аккаунты, прочитать списки Customer Match и действия-конверсии и записать строки, которые доставляет пайплайн.

Создание пайплайна

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

Настройка пайплайна

На последнем шаге выберите, что Renta запишет в Google Ads, куда это попадёт и какие колонки это заполнят.

Что отправляет Renta

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

Затем выберите Data model. Из этой модели берутся колонки для сопоставления и маппинга ниже.

Аккаунт Google Ads

Укажите Renta, в какой аккаунт попадут данные.

1. Login account.
   Аккаунт, через который подключается Renta, из всех доступных авторизованному пользователю Google.
2. Google Ads account.
   Аккаунт, в который попадут аудитория или конверсии. Если аккаунт подключения управляющий (MCC), в этом списке будут аккаунты под его управлением. Если обычный, оба списка укажут на один и тот же аккаунт.

Аудитория и согласие

Пайплайн Customer Match пишет в список пользователей, и Google должен знать, как эти люди дали согласие.

1. Audience mode Выберите, куда попадут участники.

   Режим	Описание
   Use existing user list	Пишет в список Customer Match, который уже есть в аккаунте. Renta поддерживает его в актуальном состоянии и не трогает списки других пайплайнов.
   Create new user list	Renta создаёт список Customer Match при создании пайплайна и дальше пишет в него. Имя задаёте вы, а если оставить поле пустым, будет использовано имя пайплайна.

2. Existing user list Для режима с существующим списком выберите тот, который будет поддерживать этот пайплайн. В списке те аудитории Customer Match, которые Google Ads отдаёт для выбранного аккаунта.

3. Consent status Укажите, согласились ли люди из модели на использование их данных для рекламы и персонализации.

   Значение	Описание
   Granted	Человек согласился на такое использование данных.
   Denied	Человек отказался, и Google ограничивает использование данных.
   Unspecified	Состояние согласия неизвестно, поэтому Google действует по настройкам аккаунта.

Сопоставление записей

Укажите Renta, какая колонка опознаёт человека, чтобы одна и та же строка хранилища обновляла того же участника в Google Ads, а не добавляла второго.

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

Маппинг полей

Свяжите колонки модели данных с полями Google Ads. Набор полей справа зависит от выбранного объекта.

Пайплайн Customer Match user list предлагает идентификаторы, по которым Google узнаёт людей.

Пайплайн Click conversions предлагает поля, описывающие саму конверсию.

Почту, телефон и части имени Renta хеширует алгоритмом SHA-256 до отправки запроса, поэтому исходные значения до Google не доходят. Код региона и почтовый индекс уходят как есть: Google сопоставляет их напрямую. Значение, которое пришло уже хешированным, передаётся без изменений.

Поведение синхронизации

Задайте, что произойдёт с записью в Google Ads, чья строка пропала из модели данных.

Дальше задайте имя пайплайна.

Поле Integration name задаёт имя пайплайна в интерфейсе Renta. Измените его так, как вам удобно.

Расписание

Выберите, как часто запускается пайплайн.

Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.

Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где видно его запуски и прогресс.

Стратегия синхронизации

Renta синхронизирует данные инкрементально. Запуск сравнивает модель данных с состоянием, записанным на прошлом запуске, и отправляет только то, что изменилось. Так аудитория остаётся актуальной без ежедневной перезаливки целиком. Первому запуску сравнивать не с чем, поэтому он отдаёт модель полностью.

Ограничения

1. Сопоставление на стороне Google, а не Renta.
   Renta считает строку доставленной, когда её принял Google. Совпадёт ли она с реальным пользователем и когда аудитория станет пригодна для таргетинга, решается внутри Google Ads. Размер аудитории скрыт, пока в списке не наберётся достаточно сопоставленных участников.
2. Конверсию нельзя отозвать.
   Принятая конверсия в Google окончательна, поэтому пайплайн конверсий только добавляет данные. Удаление строки из модели саму конверсию не убирает.
3. Запуск останавливается при массовых отказах.
   Renta прекращает запуск, если отклонено больше 30% пакета или больше 10% строк, отправленных с начала запуска. Уже доставленные строки остаются в Google Ads, а следующий запуск продолжит с места остановки.
4. Согласие задаётся на весь пайплайн.
   Оба поля согласия действуют на каждую строку синхронизации. Для разных состояний согласия нужны разные пайплайны.