Как отправлять события Measurement Protocol в Google Аналитику

В этом руководстве объясняется, как отправлять события веб-потока и потока приложений Google Analytics Measurement Protocol на сервер Google Analytics, чтобы вы могли просматривать события Measurement Protocol в своих отчетах Google Analytics .

Выберите платформу, которую вы хотите видеть в этом руководстве:

Форматирование запроса

Протокол измерения для Google Analytics 4 поддерживает только запросы HTTP POST .

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

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

В URL-адресе запроса необходимо указать следующее:

  • api_secret : СЕКРЕТ API , созданный в пользовательском интерфейсе Google Analytics.

    Чтобы создать новый секрет, перейдите в «Администратор» > «Потоки данных» > выберите поток > «Протокол измерения» > «Создать» .

  • firebase_app_id : идентификатор приложения Firebase, который можно найти в консоли Firebase в разделе «Настройки проекта» > «Основные » > «Ваши приложения» > «Идентификатор приложения» .

    firebase_app_id не совпадает с app_instance_id . firebase_app_id идентифицирует ваше приложение, тогда как app_instance_id идентифицирует одну установку приложения.

Полную информацию см. в параметрах запроса .

В теле запроса необходимо указать следующее:

  • user_id : Необязательно. Уникальный идентификатор пользователя. Может содержать только символы utf-8. Дополнительную информацию об этом идентификаторе см. в разделе User-ID для кросс-платформенного анализа .

  • consent : Необязательно. Узнайте, как настроить параметры согласия .

  • events : Массив элементов событий. Вы можете включить несколько событий в один запрос.

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

    Вот пример:

  {
   "app_instance_id": "12345678901234567890123456789012",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

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

Попробуй

Вот пример, который вы можете использовать для отправки tutorial_begin на ваш сервер Google Analytics:

const firebase_app_id = `1:1234567890:android:321abc456def7890`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

Формат firebase_app_id зависит от платформы. См. Идентификатор приложения в разделе «Файлы и объекты конфигурации Firebase» .

Ограничения

К отправке событий Measurement Protocol в Google Analytics применяются следующие ограничения:

  • Запросы могут содержать максимум 25 событий.
  • События могут иметь максимум 25 параметров.
  • События могут иметь максимум 25 пользовательских свойств.
  • Имена пользовательских свойств должны содержать не более 24 символов.
  • Значения свойств пользователя должны содержать не более 36 символов.
  • Имена событий должны содержать не более 40 символов, могут содержать только буквенно-цифровые символы и символы подчеркивания и должны начинаться с буквенного символа.
  • Имена параметров, включая параметры элементов, должны содержать не более 40 символов, могут содержать только буквенно-цифровые символы и символы подчеркивания и должны начинаться с буквенного символа.
  • Значения параметров, включая значения параметров элемента, должны содержать не более 100 символов.
  • Параметры элемента могут иметь максимум 10 пользовательских параметров.
  • Тело сообщения должно быть меньше 130 КБ.
  • Атрибуция на уровне событий из событий Measurement Protocol поддерживается в течение 63 дней после самого последнего помеченного онлайн-события для экспорта конверсий в рекламу и другие медиа-интеграции, даже если окно конверсии для события-конверсии превышает 63 дня. Напротив, атрибуция на уровне событий для маркировки онлайн-событий поддерживается для всего окна конверсии.
  • В целях ремаркетинга вы можете присоединиться к мероприятиям Measurement Protocol в течение следующего количества дней после самого последнего онлайн-события со связанным файлом cookie или идентификатором устройства:
    • Веб-поток: 30 дней
    • Поток приложений: 42 дня
  • События протокола измерения приложений, отправляемые в Google Analytics 4, не заполняют поисковые аудитории в Google Рекламе для пользователей приложения.