Подключите Google Analytics 4 к Elido

Elido отправляет события конверсии в GA4 на стороне сервера, используя Measurement Protocol. Это означает, что конверсии появляются в GA4 независимо от того, есть ли у пользователя блокировщик рекламы, без какого-либо JavaScript на вашей странице.

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

• Ресурс GA4 (не Universal Analytics).
• Доступ к панели администратора ресурса.
• Около 5 минут.

Шаг 1 — Найдите свой идентификатор измерения#

1. Перейдите в Google Analytics.
2. Нажмите Администратор (значок шестеренки в левом нижнем углу).
3. В разделе Ресурс нажмите Потоки данных → Интернет.
4. Нажмите на свой веб-поток данных.
5. Скопируйте Идентификатор измерения — он начинается с G-, например, G-XXXXXXXXXX.

Шаг 2 — Создайте секрет API Measurement Protocol#

На той же странице потока данных:

1. Прокрутите вниз до Секреты API Measurement Protocol.
2. Нажмите Создать.
3. Дайте ему имя ("Elido") и нажмите Создать.
4. Скопируйте значение секрета. Оно отображается только один раз. Если вы его потеряете, создайте новый — старые секреты продолжают работать, пока вы их не удалите.

Шаг 3 — Настройте в Elido#

1. Перейдите в Dashboard → Conversions → GA4 → Настроить пересылку.
2. Вставьте идентификатор измерения и секрет API.
3. Нажмите Сохранить. Elido немедленно отправляет тестовое событие (elido_test) в GA4.

Как Elido сопоставляет client_id#

GA4 требует client_id для привязки событий к пользователю. Elido извлекает его из:

1. Если ваша целевая страница короткой ссылки устанавливает файл cookie _ga и значение передается обратно через ваш пиксель конверсии — Elido считывает его напрямую.
2. В противном случае Elido хеширует click_id Elido (например, clk_abc123) в стабильную строку в формате UUID и использует ее в качестве client_id.

Это означает, что GA4 будет показывать эти события под "пользователем", который может не соответствовать вашим существующим веб-сессиям GA4 — они не будут объединяться. Для полного объединения сессий передайте значение файла cookie _ga на ваш сервер и включите его в вызов Conversions API Elido.

Названия событий в GA4#

Elido пересылает следующие события:

Событие Elido	Название события GA4
conversion.recorded	purchase (со значением + валютой)
link.clicked (если включено)	elido_click
threshold.exceeded	elido_threshold

Событие purchase используется, потому что GA4 имеет встроенную отчетность для него в разделе Monetization. Все события включают utm_source, utm_medium, utm_campaign в качестве параметров события.

Устранение неполадок#

События не появляются в режиме реального времени — Проверьте идентификатор измерения и секрет API. Неправильный секрет API возвращает HTTP 204 (без содержимого), но GA4 silently отбрасывает полезную нагрузку. Проверьте, вызвав конечную точку Measurement Protocol напрямую:

curl -X POST \
  "https://www.google-analytics.com/debug/mp/collect?measurement_id=G-XXXX&api_secret=YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"test","events":[{"name":"elido_test","params":{}}]}'

Успешный отладочный вызов возвращает {"validationMessages":[]}.

События появляются в режиме реального времени, но не в обычных отчетах — События Measurement Protocol могут занимать 24–48 часов, чтобы появиться в отчетах GA4, отличных от отчетов в реальном времени. Это ограничение GA4, а не проблема Elido.

Неправильная валюта в событиях покупки — Elido считывает валюту из поля currency события конверсии. По умолчанию используется EUR. Установите его явно в ваших вызовах API записи конверсии.

Дублирующиеся события — Если ваш сайт также инициирует событие GA4 purchase на стороне клиента, вы увидите дубликаты. Отключите событие на стороне клиента или используйте другое имя события в настройках сопоставления Elido.