Що ви налаштуєте
- Серверне пересилання конверсій до GA4 через Measurement Protocol — працює навіть для користувачів із блокувальниками реклами.
- Секрет API Measurement Protocol, згенерований у налаштуваннях потоку даних GA4.
- Автоматичний мапінг подій: події конверсії Elido з'являються як
purchaseу вбудованих звітах монетизації GA4.
Elido надсилає події конверсії до GA4 на стороні сервера за допомогою Measurement Protocol. Це означає, що конверсії з'являються в GA4 незалежно від того, чи використовує користувач блокувальник реклами, і без використання JavaScript на вашій сторінці.
Що вам знадобиться#
- Ресурс GA4 (не Universal Analytics).
- Доступ до панелі Адміністратора ресурсу.
- Близько 5 хвилин.
Крок 1 — Знайдіть свій Measurement ID#
- Перейдіть до Google Analytics.
- Натисніть Адміністратор (іконка шестірні внизу ліворуч).
- У розділі Ресурс натисніть Потоки даних → Веб.
- Натисніть на свій веб-потік даних.
- Скопіюйте Measurement ID — він починається з G-, наприклад G-XXXXXXXXXX.
Крок 2 — Створіть секрет API Measurement Protocol#
На тій самій сторінці потоку даних:
- Прокрутіть вниз до Секрети API Measurement Protocol.
- Натисніть Створити.
- Дайте йому назву ("Elido") і натисніть Створити.
- Скопіюйте значення секрету. Воно відображається лише один раз. Якщо ви його втратите, створіть новий — старі секрети продовжують працювати, доки ви їх не видалите.
Крок 3 — Налаштування в Elido#
- Перейдіть до Панель керування → Конверсії → GA4 → Налаштувати пересилання.
- Вставте Measurement ID та секрет API.
- Натисніть Зберегти. Elido негайно надішле тестову подію (elido_test) до GA4.
Як Elido мапить client_id#
GA4 вимагає client_id для прив'язки подій до користувача. Elido отримує його наступним чином:
- Якщо цільова сторінка вашого короткого посилання встановлює кукі _ga і це значення передається назад через ваш піксель конверсії — Elido зчитує його безпосередньо.
- В іншому випадку Elido хешує click_id Elido (наприклад, clk_abc123) у стабільний рядок формату UUID і використовує його як client_id.
Це означає, що GA4 показуватиме ці події для «користувача», який може не збігатися з вашими існуючими веб-сесіями GA4 — вони не будуть об'єднані. Для повного об'єднання сесій передайте значення кукі _ga на свій сервер і додайте його до виклику Conversions API Elido.
Назви подій у GA4#
Elido пересилає такі події:
| Подія Elido | Назва події GA4 |
|---|---|
| conversion.recorded | purchase (із значенням + валютою) |
| link.clicked (якщо увімкнено) | elido_click |
| threshold.exceeded | elido_threshold |
Подія purchase використовується тому, що GA4 має вбудовані звіти для неї в розділі Монетизація. Усі події містять utm_source, utm_medium, utm_campaign як параметри подій.
Усунення несправностей#
Події не з'являються в режимі Realtime — Перевірте Measurement ID та секрет API. Неправильний секрет API повертає HTTP 204 (no content), але GA4 тихо відхиляє дані. Перевірте це, викликавши кінцеву точку 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":[]}.
Події з'являються в режимі Realtime, але не в звичайних звітах — Події Measurement Protocol можуть з'являтися в не-realtime звітах GA4 протягом 24–48 годин. Це обмеження GA4, а не проблема Elido.
Неправильна валюта в подіях покупки — Elido зчитує валюту з поля currency події конверсії. За замовчуванням це EUR. Вкажіть її явно у вашому виклику API для запису конверсій.
Дублювання подій — Якщо ваш сайт також запускає подію purchase GA4 на стороні клієнта, ви побачите дублікати. Вимкніть подію на стороні клієнта або використовуйте іншу назву події в налаштуваннях мапінгу Elido.