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

1. Введение

Последнее обновление: 30 апреля 2019 г.

Что ты построишь

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

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

  • Как сделать первый звонок в MP
  • Понять параметры, необходимые для вызова
  • Отправьте и подтвердите свой тестовый звонок
  • Создайте пример сценария на 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.
  • Measure_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. Поздравления

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

Вы узнали

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

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