Четверг, 30 июля 2026 г.
В последней версии Data Manager API появились функции, которые упрощают управление аудиториями, улучшают рабочие процессы загрузки данных за счет предупреждений на уровне полей и позволяют передавать в Google Аналитику более детализированные данные, предоставленные пользователями.
Как удалить всех участников аудитории
Используйте новый метод RemoveAllAudienceMembers, чтобы за одну операцию удалить всех участников из указанных списков пользователей.
Необязательный параметр removeAsOfTime позволяет настроить таргетинг только на тех участников, которые были добавлены до определенной временной метки.
Это особенно полезно, когда вам нужно полностью обновить (или заменить) данные об аудитории, очистив существующий список и заполнив его новым набором пользователей.
Предупреждения о полях загрузки
Теперь ответы на запросы на импорт данных в Data Manager API содержат подробные предупреждения на уровне полей о проблемах с проверкой необязательных полей. Если API обнаружит проблемы с проверкой необязательных полей, запрос на передачу данных будет выполнен, а остальные данные будут обработаны. Если ошибка возникнет в обязательном поле, то весь запрос будет отклонен по модели быстрого отказа.
Если какое-либо из необязательных полей недействительно, ответ от IngestEventsRequest или IngestAudienceMembersRequest будет содержать поле field_warnings со списком объектов FieldWarning. Каждое предупреждение содержит конкретную причину (WarningReason), описание и местоположение поля в запросе, где возникла проблема.
Дополнительные данные об адресе для событий Google Аналитики
Теперь вы можете передавать в Google Аналитику дополнительные данные об адресах пользователей при импорте событий. Помимо полей given_name, family_name, region_code и postal_code, ресурс AddressInfo теперь поддерживает следующие поля:
address_line(почтовый адрес)cityadministrative_area(штат или область)
Кроме того, теперь вы можете использовать существующее поле данных, предоставленных пользователями (user_data), чтобы выполнить требование к идентификаторам для событий из нескольких источников, отправляемых в потоки данных сайта. Это дает вам ещё один вариант, когда у вас нет ad_identifiers.gclid, user_id или client_id для события с несколькими источниками.
Начало работы
-
Узнайте, как реализовать новый метод
RemoveAllAudienceMembersдля вашего рабочего процесса: - Чтобы узнать, как проверять ответы на наличие предупреждений, ознакомьтесь с разделом Предупреждения о загрузке в руководстве Общие сведения об ошибках API.
- Чтобы начать отправлять события в Google Аналитику с помощью Data Manager API, выполните следующие действия:
Ускорьте работу с помощью навыков ИИ-агента. Недавно мы добавили новые навыки ИИ-агента Data Manager API, которые помогут вам быстрее выполнять интеграцию. Ознакомьтесь с новыми навыками в хранилище Google Skills на GitHub, чтобы получать более точные и эффективные рекомендации прямо в среде программирования с поддержкой ИИ.
Если у вас есть вопросы или вы хотите обсудить эту запись, свяжитесь с нами на сервере Discord сообщества Google по рекламе и аналитике. Если у вас возникли проблемы или вам нужна помощь с API, вы также можете связаться с нами через страницу поддержки.
Если вы хотите стать партнером по обработке данных, заполните форму.
– Линдси Вольта, от имени команды Data Manager API
Ярлыки: analytics, data-manager-api