Отправляйте веб-события в GA4 с помощью протокола измерений.

1. Введение

Последнее обновление: 30.04.2019

Что вы построите

  • В этом практическом занятии вы узнаете, как отправлять внешние события в GA4 с помощью протокола Measurement Protocol.
  • В этом практическом задании предполагается, что у вас уже есть веб-страница/сайт с установленной системой Google Analytics 4.

Что вы узнаете

  • Шаги для совершения первого звонка депутату парламента
  • Разберитесь в параметрах, необходимых для звонка.
  • Отправьте и подтвердите свой тестовый звонок.
  • Создайте пример скрипта на Python для выполнения звонка.

Что вам понадобится

  • Веб-сайт/Веб-страница
  • Любая IDE для внесения изменений.
  • Учетная запись GA4
  • Дополнительно — среда разработки Python (или Colab)

2. Соберите обязательные поля.

Создание секретного ключа API в GA4

Перейдите в GA4 и создайте новый секретный ключ API, перейдя в раздел Администрирование > Потоки данных > выберите поток > Протокол измерения > Создать

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

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

Соберите client_id

Для получения client_id вы можете использовать любой из перечисленных ниже методов.

  1. Сбор данных с помощью gTag

Оба эти момента подробно описаны ниже.

Сбор данных с помощью gTag

Вы можете получить свой client_id через свой веб-сайт, используя:

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

Ниже приведены дополнительные ссылки в зависимости от вашей инфраструктуры.

3. Составление запроса

Вы можете создать пример вызова, используя Event Builder в GA4. (Для этого необходимо войти в систему и включить cookie-файлы). Убедитесь, что переключатель установлен на "gtag.js".

b904d2a053eb7817.png

Вам необходимо заполнить следующие поля.

  • api_secret - Уже создан ранее в GA4
  • measurement_id — Чтобы получить его, перейдите в раздел Администрирование > Потоки данных > выберите свой поток. Он должен отображаться, как показано ниже.

d362992ff592c675.png

  • client_id - Вы уже получили это значение.
  • Поле user_id не является обязательным. Пока можете оставить его пустым.
  • Категория — выберите в выпадающем списке «Пользовательская» и укажите любое название события по вашему выбору (не используйте автоматически собираемые события ). В данном случае мы используем «test_from_codelab».

cf580a708bb0a8a2.png

При желании вы также можете указать параметры события и/или свойства пользователя, нажав на кнопки ниже.

da59bb982f6f906a.png

После заполнения всех полей вы увидите что-то подобное, с кнопкой «Проверить событие».

31f720d550906298.png

Как только вы дойдете до этого места, нажмите кнопку «ПРОВЕРИТЬ СОБЫТИЕ», выделенную оранжевым цветом. Должно отобразиться сообщение, указанное ниже, подтверждающее действительность события, и вы увидите кнопку «ОТПРАВИТЬ В GA». На этом этапе, если событие будет признано недействительным, инструмент укажет вам точное поле, где возникла проблема, и вы сможете исправить это и повторить попытку.

1d63d1e067c46294.png

Теперь вы можете нажать на кнопку, и она должна отправить тестовое событие в GA4.

4. Проверка событий в GA4

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

7b9e9a0f74b64757.png

Для того чтобы события отобразились в режиме реального времени и сразу отобразились в отчете, может потребоваться около 24 часов, поэтому не стоит беспокоиться, если вы не увидите их в обычном отчете о событиях!

5. Создание скрипта на Python

Теперь, когда вы протестировали это, вы можете изучить вызов API и полезную нагрузку события, чтобы построить аналогичную архитектуру на Python (или на любом другом языке по вашему выбору), которая сможет выполнять этот вызов. Затем вы можете запланировать его с желаемой частотой и запустить в работу. Для этой части вы можете использовать любую IDE на ваш выбор, поддерживающую Python, или просто использовать блокнот Google Colab, который не требует установки на ваше устройство.

Обратившись к конструктору событий GA4, вы увидите, что конечная точка выглядит следующим образом.

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

Полезная нагрузка события была следующей:

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

Это можно перевести на Python, используя что-то подобное.

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

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

6. Поздравляем!

Поздравляем, вы успешно использовали протокол Measurement Protocol в GA4. Теперь вы можете создавать мощные архитектуры решений для отправки более значимых данных в Google Analytics и улучшения маркетинговой и бизнес-аналитики. Чтобы извлечь из этого максимальную выгоду, мы также рекомендуем подключиться к Google Ads и импортировать эти события в качестве конверсий.

Вы узнали

  • Как собрать необходимые переменные для совершения звонков MP
  • Как отправлять и проверять тестовые события
  • Как создать скрипт для отправки MP-звонков

Справочная документация