Что вы настроите
- Серверную пересылку кликов в 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.