Google Data Manager API научился чистить аудитории одной командой и не падать на ошибках

Google Data Manager API (программный интерфейс для управления данными о клиентах в рекламных сервисах Google) получил обновление, о котором сообщило издание Search Engine Land. Изменения касаются трёх направлений: работы с аудиторными списками, обработки ошибок при загрузке данных и передачи адресной информации в Google Analytics. Обновление адресовано разработчикам и маркетологам, которые управляют списками Customer Match (сопоставление клиентов по загруженным данным) и передают пользовательские данные в аналитику.

Что изменилось в Google Data Manager API?

• Массовое удаление аудитории одной командой. Новый метод RemoveAllAudienceMembers позволяет очистить весь список аудитории за одну операцию. Необязательный параметр с меткой времени даёт возможность удалить только тех участников, которые были добавлены до указанной даты. Раньше для полного обновления аудитории приходилось удалять записи порциями.

• Предупреждения вместо остановки загрузки. API больше не прерывает весь запрос, если необязательные поля содержат невалидные данные. Корректные записи обрабатываются, а по проблемным полям приходят детальные предупреждения: какое поле не прошло проверку и почему. Это называется «field-level ingestion warnings» (предупреждения на уровне отдельных полей при загрузке).

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

• Готовые навыки для ИИ-агентов. Google выложила в репозиторий Google Skills на GitHub набор навыков для ИИ-агентов (ИИ-агент, программа, которая сама выполняет задачи по заданным правилам), чтобы разработчики быстрее строили интеграции с Data Manager API в среде с ИИ-помощником при написании кода.

Как попробовать Google Data Manager API?

1. Откройте документацию Google Data Manager API на сайте developers.google.com. Убедитесь, что у вас есть аккаунт Google Ads или Display & Video 360 с доступом к API.

2. Проверьте доступность новых методов в своём проекте. Найдите метод RemoveAllAudienceMembers и протестируйте очистку тестовой аудитории с параметром даты, чтобы убедиться, что удаляются только нужные записи.

3. Настройте обработку предупреждений. После загрузки данных проверяйте ответ API на наличие warnings (предупреждений) по отдельным полям. Это позволит находить и исправлять проблемы в данных без повторной отправки всего пакета.

4. Для ИИ-интеграций загляните в репозиторий Google Skills на GitHub, там лежат готовые шаблоны для работы с Data Manager API через ИИ-ассистентов при написании кода.

Есть ли аналог в России?

Прямого российского аналога Google Data Manager API не существует. Яндекс.Аудитории позволяют загружать списки клиентов для таргетированной рекламы в Яндекс.Директе, но это делается через веб-интерфейс или отдельный API Яндекс.Директа, и функциональность отличается. В частности, массовой очистки аудитории одной командой с фильтром по дате в Яндекс.Аудиториях на момент публикации нет.

Яндекс.Метрика собирает данные о посетителях сайтов, но передача расширенных адресных полей через API, как это сделал Google для Google Analytics, в Метрике работает иначе: упор на автоматическое определение географии по IP и данным браузера.

Для маркетологов в РФ, которые параллельно ведут кампании в Google Ads (например, на зарубежные рынки), обновление Data Manager API упрощает рутину. Для тех, кто работает только с Яндексом, новость полезна как ориентир: подобные функции могут появиться и в российских инструментах.

Частые вопросы

Google Data Manager API доступен бесплатно?

Да, API входит в набор инструментов Google Ads и не требует отдельной оплаты. Нужен аккаунт Google Ads или Display & Video 360 с доступом к API разработчика.

Можно ли использовать Google Data Manager API из России?

Технически API доступен для любого аккаунта Google Ads с разрешённым доступом к API. Однако реклама Google Ads в России приостановлена, поэтому инструмент актуален для тех, кто ведёт кампании на зарубежные рынки или работает с Google Analytics для сбора данных на международных сайтах.

Чем массовое удаление аудитории отличается от ручной очистки?

Раньше для полного обновления списка приходилось удалять записи порциями или пересоздавать аудиторию. Новый метод RemoveAllAudienceMembers делает это одной командой. Параметр с датой позволяет оставить свежие записи и удалить только устаревшие, что удобно при регулярном обновлении клиентской базы.

Если вы ведёте рекламу на зарубежные рынки и управляете аудиториями через код, проверьте новые методы Data Manager API до конца недели: сезон летних распродаж как раз требует чистых списков.