Połącz Google Analytics 4 z Elido

Elido wysyła zdarzenia konwersji do GA4 po stronie serwera za pomocą Measurement Protocol. Oznacza to, że konwersje pojawiają się w 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 właściwości.
• Około 5 minut.

Krok 1 — Znajdź swój 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 web data stream.
5. Skopiuj Measurement ID — zaczyna się od G-, np. G-XXXXXXXXXX.

Krok 2 — Utwórz API secret Measurement Protocol#

Na tej samej stronie data stream:

1. Przewiń do Measurement Protocol API secrets.
2. Kliknij Create.
3. Nadaj mu nazwę ("Elido") i kliknij Create.
4. Skopiuj wartość secret. Jest pokazana tylko raz. Jeśli ją stracisz, utwórz nową — stare secret nadal działają do czasu ich usunięcia.

Krok 3 — Skonfiguruj w Elido#

1. Przejdź do Dashboard → Konwersje → GA4 → Skonfiguruj przekazywanie.
2. Wklej Measurement ID i API secret.
3. Kliknij Zapisz. Elido natychmiast wysyła zdarzenie testowe (elido_test) do GA4.

Jak Elido mapuje client_id#

GA4 wymaga client_id do przypisania zdarzeń do użytkownika. Elido wyprowadza go w następujący sposób:

1. Jeśli strona docelowa ustawia ciasteczko _ga i wartość jest przekazywana przez Twój piksel konwersji — Elido odczytuje je bezpośrednio.
2. W przeciwnym razie Elido hashuje Elido click_id (np. clk_abc123) do stabilnego ciągu w kształcie UUID i używa go jako client_id.

Oznacza to, że GA4 pokaże te zdarzenia pod "użytkownikiem", który może nie odpowiadać istniejącym sesjom web GA4 — nie będą się łączyć. Dla pełnego stitchingu sesji przekaż wartość ciasteczka _ga do serwera i dołącz ją do wywołania API Konwersji Elido.

Nazwy zdarzeń w GA4#

Elido przekazuje te zdarzenia:

Zdarzenie Elido	Nazwa zdarzenia GA4
conversion.recorded	purchase (z wartością + walutą)
link.clicked (jeśli włączone)	elido_click
threshold.exceeded	elido_threshold

Zdarzenie purchase jest używane, ponieważ GA4 ma wbudowane raporty dla niego w sekcji Monetyzacja. Wszystkie zdarzenia zawierają utm_source, utm_medium, utm_campaign jako parametry zdarzenia.

Rozwiązywanie problemów#

Brak zdarzeń w czasie rzeczywistym — Sprawdź Measurement ID i API secret. Błędny API secret zwraca HTTP 204 (brak zawartości), ale GA4 cicho odrzuca ładunek. Sprawdź 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":{}}]}'

Pomyślne wywołanie debugowania zwraca {"validationMessages":[]}.

Zdarzenia pojawiają się w czasie rzeczywistym, ale nie w zwykłych raportach — Zdarzenia Measurement Protocol mogą potrzebować 24–48 godzin, aby pojawić się w nie-realtime raportach GA4. To ograniczenie GA4, nie Elido.

Zła waluta w zdarzeniach zakupu — Elido odczytuje walutę z pola currency zdarzenia konwersji. Domyślna jest EUR. Ustaw ją jawnie w wywołaniu API rejestrowania konwersji.

Zduplikowane zdarzenia — Jeśli Twoja strona też wysyła zdarzenie GA4 purchase po stronie klienta, zobaczysz duplikaty. Wyłącz zdarzenie po stronie klienta lub użyj innej nazwy zdarzenia w ustawieniach mapowania Elido.