Що ви налаштуєте
- Серверне пересилання кліків до GA4 через Measurement Protocol: працює навіть у користувачів із блокувальниками реклами.
- API secret для Measurement Protocol, створений у налаштуваннях потоку даних GA4.
- Подію
link_clickу GA4 для кожного кліку за вашими короткими посиланнями.
Elido надсилає подію GA4 про кожен клік за посиланням на стороні сервера через Measurement Protocol. Події доходять до GA4 незалежно від того, чи є в користувача блокувальник реклами, і без жодного JavaScript на вашій сторінці.
Що вам знадобиться
- Ресурс GA4 (не Universal Analytics).
- Доступ до панелі адміністратора ресурсу.
- Близько 5 хвилин.
Крок 1. Знайдіть Measurement ID
- Відкрийте Google Analytics.
- Натисніть Адміністратор (значок шестерні внизу ліворуч).
- У розділі Ресурс натисніть Потоки даних → Веб.
- Натисніть на свій вебпотік даних.
- Скопіюйте Measurement ID: він починається з
G-, наприкладG-XXXXXXXXXX.
Крок 2. Створіть API secret для Measurement Protocol
На тій самій сторінці потоку даних:
- Прокрутіть вниз до Секрети API Measurement Protocol.
- Натисніть Створити.
- Дайте йому ім'я («Elido») і натисніть Створити.
- Скопіюйте значення секрета. Воно показується лише один раз. Якщо ви його втратите, створіть новий: старі секрети продовжують працювати, доки ви їх не видалите.
Крок 3. Налаштуйте в Elido
- Відкрийте Dashboard → Integrations → Google Analytics 4.
- Вставте Measurement ID та API secret.
- Натисніть Зберегти, потім Перевірити підключення. Elido надішле тестову подію
link_clickз позначкамиelido_testіdebug_mode.
Як Elido задає client_id
GA4 вимагає client_id, щоб пов'язати події з користувачем. Elido задає його як elido-<workspace_id>-<link_id>, тому всі кліки за одним посиланням відображаються в GA4 під одним синтетичним «користувачем». Ці події не склеюються з вашими наявними вебсесіями GA4, а кількість унікальних користувачів у GA4 відображає посилання, а не людей.
Подія, що надсилається до GA4
| Подія Elido | Назва події GA4 |
|---|---|
| Клік за посиланням | link_click |
Параметри події: workspace_id, link_id, slug, country, device, destination.
Усунення несправностей
Події не з'являються у звіті в реальному часі - Перевірте Measurement ID та API secret. Неправильний API secret повертає HTTP 204 (без вмісту), але 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":[]}.
Події видно в реальному часі, але не у звичайних звітах - Події Measurement Protocol можуть з'являтися у звичайних звітах GA4 через 24–48 годин. Це обмеження GA4, а не проблема Elido.