Połącz Google Analytics 4 z Elido

Elido wysyła zdarzenie GA4 dla każdego kliknięcia linku po stronie serwera, używając Measurement Protocol. Zdarzenia docierają do GA4 niezależnie od tego, czy użytkownik ma adblocker, bez żadnego JavaScriptu na Twojej stronie.

Czego potrzebujesz

• Właściwości GA4 (nie Universal Analytics).
• Dostępu do panelu Admin tej właściwości.
• Około 5 minut.

Krok 1 - Znajdź Measurement ID

1. Przejdź do Google Analytics.
2. Kliknij Admin (ikona koła zębatego w lewym dolnym rogu).
3. W sekcji Property kliknij Data streams → Web.
4. Kliknij swój strumień danych internetowych.
5. Skopiuj Measurement ID - zaczyna się od G-, np. G-XXXXXXXXXX.

Krok 2 - Utwórz API secret Measurement Protocol

Na tej samej stronie strumienia danych:

1. Przewiń do Measurement Protocol API secrets.
2. Kliknij Create.
3. Nadaj mu nazwę („Elido”) i kliknij Create.
4. Skopiuj wartość sekretu. Jest wyświetlana tylko raz. Jeśli ją zgubisz, utwórz nowy sekret - stare nadal działają, dopóki ich nie usuniesz.

Krok 3 - Skonfiguruj w Elido

1. Przejdź do Dashboard → Integrations → Google Analytics 4.
2. Wklej Measurement ID i API secret.
3. Kliknij Save, a następnie Test connection. Elido wysyła testowe zdarzenie link_click oznaczone elido_test i debug_mode.

Jak Elido ustawia client_id

GA4 wymaga client_id, aby przypisać zdarzenia do użytkownika. Elido ustawia go na elido-<workspace_id>-<link_id>, więc wszystkie kliknięcia jednego linku pojawiają się w GA4 pod jednym syntetycznym „użytkownikiem”. Te zdarzenia nie łączą się z istniejącymi sesjami internetowymi GA4, a liczba unikalnych użytkowników w GA4 odzwierciedla linki, a nie ludzi.

Zdarzenie wysyłane do GA4

Zdarzenie Elido	Nazwa zdarzenia GA4
Kliknięcie linku	link_click

Parametry zdarzenia: workspace_id, link_id, slug, country, device, destination.

Rozwiązywanie problemów

Brak zdarzeń w Realtime - Sprawdź Measurement ID i API secret. Błędny API secret zwraca HTTP 204 (brak treści), ale GA4 po cichu odrzuca payload. Zweryfikuj to, wywołując bezpośrednio endpoint 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":{}}]}'

Udane wywołanie debugowe zwraca {"validationMessages":[]}.

Zdarzenia są widoczne w Realtime, ale nie w zwykłych raportach - Zdarzenia Measurement Protocol mogą pojawić się w raportach GA4 innych niż czasu rzeczywistego dopiero po 24–48 godzinach. To ograniczenie GA4, a nie problem Elido.