Was Sie einrichten
- Serverseitige Klick-Weiterleitung an GA4 über das Measurement Protocol - funktioniert auch bei Nutzern mit Werbeblocker.
- Ein Measurement-Protocol-API-Secret, erzeugt in den Einstellungen Ihres GA4-Datenstreams.
- Ein
link_click-Event in GA4 für jeden Klick auf Ihre Kurzlinks.
Elido sendet für jeden Link-Klick serverseitig ein GA4-Event über das Measurement Protocol. Die Events erreichen GA4 unabhängig davon, ob der Nutzer einen Werbeblocker hat, ohne JavaScript auf Ihrer Seite.
Was Sie brauchen
- Eine GA4-Property (nicht Universal Analytics).
- Zugriff auf den Admin-Bereich der Property.
- Etwa 5 Minuten.
Schritt 1 - Measurement ID finden
- Gehen Sie zu Google Analytics.
- Klicken Sie auf Admin (Zahnrad-Symbol unten links).
- Klicken Sie unter Property auf Data streams → Web.
- Klicken Sie auf Ihren Web-Datenstream.
- Kopieren Sie die Measurement ID - sie beginnt mit
G-, z. B.G-XXXXXXXXXX.
Schritt 2 - Ein Measurement-Protocol-API-Secret erstellen
Auf derselben Datenstream-Seite:
- Scrollen Sie zu Measurement Protocol API secrets.
- Klicken Sie auf Create.
- Geben Sie einen Namen („Elido“) ein und klicken Sie auf Create.
- Kopieren Sie den Secret-Wert. Er wird nur einmal angezeigt. Wenn Sie ihn verlieren, erstellen Sie einen neuen - alte Secrets funktionieren weiter, bis Sie sie löschen.
Schritt 3 - In Elido konfigurieren
- Gehen Sie zu Dashboard → Integrations → Google Analytics 4.
- Fügen Sie die Measurement ID und das API-Secret ein.
- Klicken Sie auf Save und dann auf Test connection. Elido sendet ein
link_click-Testevent, markiert mitelido_testunddebug_mode.
Wie Elido die client_id setzt
GA4 benötigt eine client_id, um Events einem Nutzer zuzuordnen. Elido setzt sie auf elido-<workspace_id>-<link_id>, sodass alle Klicks auf einen Link in GA4 unter einem synthetischen „Nutzer“ erscheinen. Diese Events werden nicht mit Ihren bestehenden GA4-Websitzungen verknüpft, und die Zahl eindeutiger Nutzer in GA4 spiegelt Links wider, nicht Personen.
An GA4 gesendetes Event
| Elido-Event | GA4-Eventname |
|---|---|
| Link-Klick | link_click |
Event-Parameter: workspace_id, link_id, slug, country, device, destination.
Fehlerbehebung
Keine Events in Realtime sichtbar - Prüfen Sie Measurement ID und API-Secret. Ein falsches API-Secret liefert HTTP 204 (kein Inhalt), aber GA4 verwirft das Payload stillschweigend. Prüfen Sie es, indem Sie den Measurement-Protocol-Endpunkt direkt aufrufen:
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":{}}]}'
Ein erfolgreicher Debug-Aufruf liefert {"validationMessages":[]}.
Events erscheinen in Realtime, aber nicht in regulären Berichten - Measurement-Protocol-Events können 24–48 Stunden brauchen, bis sie in nicht-Echtzeit-Berichten von GA4 erscheinen. Das ist eine GA4-Einschränkung, kein Elido-Problem.