Рекомендуемые и специальные события Google Аналитики

Используйте Data Manager API, чтобы отправлять рекомендуемые и специальные события Google Аналитики.

Отправка рекомендуемых и специальных событий

Если вы переходите с Measurement Protocol Google Аналитики, ознакомьтесь с инструкциями в статье Как перейти с Measurement Protocol на Data Manager API.

Обзор рабочего процесса

Чтобы отправить данные о событиях с помощью Data Manager API, выполните следующие действия:

  1. Подготовьте целевые сервисы. Определите объекты Destination для поля destinations в запросе на загрузку, чтобы указать целевой аккаунт и целевой сервис для конверсий или событий. Подробнее о том, как подготовить целевые аккаунты…

  2. Подготовьте данные о событиях и идентификаторы. Заполните поля Event сведениями о событиях и необходимыми идентификаторами (например, клика по объявлению, клиента или экземпляра приложения). Если вы добавляете контактную информацию пользователей в userData, нормализуйте и хешируйте идентификаторы по алгоритму SHA-256 в соответствии с правилами форматирования и при необходимости зашифруйте их. Подробнее о том, как подготовить данные о событиях…

  3. Создайте и отправьте запрос на загрузку. Отправьте запрос events.ingest, содержащий записи destinations, Event и encryptionInfo, если вы зашифровали userData. Используйте validateOnly: true, чтобы проверить полезную нагрузку на ошибки быстрого сбоя, прежде чем отправлять рабочие данные. Требования к полям и примеры кода приведены в разделе Отправка событий.

  4. Проверьте диагностику. Получите диагностику асинхронной обработки и проверьте статус загрузки с помощью requestStatus.retrieve.

Примеры использования

Вот несколько примеров использования Data Manager API для отправки рекомендуемых и специальных событий:

  • связывать онлайн- и офлайн-действия;

  • отслеживать действия как на стороне клиента, так и на стороне сервера;

  • отправлять данные о событиях, не связанных с обычными действиями пользователей (офлайн-конверсиях и т. д.);

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

Данные, предоставленные пользователями

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

При отправке данных, предоставленных пользователями, учитывайте следующее:

  • Отправка с событиями. В Data Manager API данные, предоставленные пользователями, должны отправляться в составе Event. Отдельные загрузки без события не поддерживаются.

  • Форматирование и хеширование. Личные идентификаторы (например, адреса электронной почты, номера телефонов, имена и почтовые адреса) перед загрузкой необходимо нормализовать и хешировать с помощью алгоритма SHA-256. Другие поля (например, город, штат или область, почтовый индекс и код страны) нормализуются, но не хешируются. Соблюдайте требования, указанные в руководстве Как форматировать пользовательские данные.

  • Шифрование. При желании вы можете зашифровать хешированные пользовательские данные.

  • User-ID. Рекомендуем передавать параметр userId вместе с userData, если доступен постоянный идентификатор пользователя.

  • Реализация. Инструкции по созданию запросов вы найдете в статье Как добавить данные, предоставленные пользователями.

Что нужно учитывать при интеграции

При использовании Data Manager API учитывайте следующее:

Ремаркетинг

Google Аналитика поддерживает ремаркетинг на одном устройстве, если вы включите сигналы Google. Для ремаркетинга для нескольких устройств необходим идентификатор userId.

Кроме того, вы можете отправлять данные, предоставленные пользователями, чтобы сопоставлять собственные аудитории.

Рекламные идентификаторы

Google Аналитика автоматически сопоставляет рекламные идентификаторы (например, GBRAID или WBRAID), собранные во время онлайн-взаимодействий, с событиями Data Manager API с помощью clientId или appInstanceId.

Настройки конфиденциальности

Google Аналитика связывает события Data Manager API с онлайн-взаимодействиями при помощи clientId или appInstanceId, чтобы учитывать настройки конфиденциальности пользователей, такие как разрешение неперсонализированной рекламы или ограничение отслеживания рекламы.

Вы также можете задать настройки согласия пользователя непосредственно для каждого события с помощью объекта consent.

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

Google Аналитика автоматически сопоставляет самые свежие геоданные и информацию об устройствах из тегов с событиями Data Manager API (с помощью идентификаторов clientId или appInstanceId). Благодаря этому события Data Manager API корректно отображаются в отчетах с географическими параметрами и параметрами устройств.

Если вы хотите, чтобы событие Data Manager API отражало географическую информацию и данные об устройстве из определенного сеанса, а не последние сведения для clientId или appInstanceId, добавьте запись в additionalEventParameters, задав для parameterName значение session_id, а для value – идентификатор нужного сеанса, и отправьте событие в течение 24 часов после начала сеанса.

С помощью Data Manager API вы можете передавать географические данные и информацию об устройствах для событий.

Межсерверное взаимодействие

Для отправки событий в Google Аналитику не требуется ничего, кроме Data Manager API. Однако в таком случае в отчеты могут поступать не все данные. Data Manager API дополняет существующие события, собранные с помощью глобального тега, Менеджера тегов или Firebase. Некоторые названия событий и параметров зарезервированы для автоматического сбора – их нельзя отправлять с помощью Data Manager API.

Как создавать и переименовывать события

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

Далее
Отправка событий