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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Обзор

Далее описано, как форматировать запросы и отправлять их к платформе Measurement Protocol от Google Аналитики.

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

Чтобы передать данные о событии, отправьте HTTP-запрос POST к следующей конечной точке:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Обязательные параметры

Действительный запрос должен содержать два набора параметров. Для Firebase и gtag.js используются разные параметры:

  1. Параметры URL

    • api_secret – обязательный. Секретный ключ API (API SECRET), который генерируется в интерфейсе Google Аналитики. Чтобы создать новый секрет, откройте Google Аналитику и выберите:
      Администратор > Потоки данных > [нужный поток] > Measurement Protocol > Создать

    Подробнее о параметрах запросов

  2. Тело в формате JSON

    • user_id – необязательный. Уникальный идентификатор пользователя. Подробности см. в статье Функция User-ID для межплатформенного анализа.

    • events – обязательный. Массив объектов событий.

    Подробности см. в разделе Тело запроса POST в формате JSON.

Чтобы действия пользователя отображались в стандартных отчетах, например в отчете в реальном времени, предоставьте engagement_time_msec и session_id как часть params для event.

Пример

{
"client_id": "x",
"events": [
  {
    "name": "offline_purchase",
    "params": {
      "engagement_time_msec": "100",
      "session_id": "123"
    }
  }
]
}

session_start является зарезервированным названием события, однако при создании нового идентификатора session_id будет начат новый сеанс без необходимости отправлять session_start.

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

Чтобы отправить данные о событии tutorial_begin, используйте следующий запрос:

Ограничения

  • Один запрос может содержать не больше 25 событий.
  • Одно событие может содержать не больше 25 параметров.
  • Одно событие может содержать не больше 25 свойств пользователей.
  • Название свойства пользователя может содержать не больше 24 символов.
  • Значение свойства пользователя может содержать не больше 36 символов.
  • Название события может содержать не больше 40 символов (буквы, цифры, знаки подчеркивания) и должно начинаться с буквы.
  • Название параметра может содержать не больше 40 символов (буквы, цифры, знаки подчеркивания) и должно начинаться с буквы. Это касается и параметров объектов.
  • Значение параметра может содержать не больше 100 символов. Это касается и параметров объектов.
  • В параметрах объектов можно использовать не больше 10 специальных параметров.
  • Размер тела запроса POST должен быть менее 130 КБ.