Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

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

Подробнее о том, как отправлять события…

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

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

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

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

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

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

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

Отправка с событиями. В Data Manager API данные, предоставленные пользователем, должны отправляться как часть Event. Отдельные загрузки без события не поддерживаются.
Форматирование и хеширование. Личные идентификаторы (например, адреса электронной почты, номера телефонов, имена и почтовые адреса) перед загрузкой необходимо нормализовать и хешировать с помощью алгоритма SHA-256. Другие поля (например, город, штат или провинция, почтовый индекс и код страны) нормализуются, но не хешируются. Соблюдайте требования, указанные в руководстве Как форматировать пользовательские данные.
Шифрование. Вы можете зашифровать хешированные пользовательские данные.
Идентификатор пользователя. Мы рекомендуем указывать 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. Однако в таком случае в отчеты могут поступать не все данные. API Менеджера данных дополняет существующие события, собранные с помощью глобального тега, Менеджера тегов или Firebase. Некоторые названия событий и параметров зарезервированы для автоматического сбора – их нельзя отправлять с помощью Data Manager API.

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

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

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