Was Sie einrichten
- Serverseitige Konversionsweitergabe an GA4 über das Measurement Protocol — funktioniert auch für Benutzer mit Adblockern.
- Ein Measurement Protocol API-Secret, generiert aus den Einstellungen Ihres GA4-Datenstreams.
- Automatisches Ereignis-Mapping: Elido-Konversionsereignisse erscheinen als
purchasein den integrierten Monetarisierungsberichten von GA4.
Elido sendet Konversionsereignisse serverseitig über das Measurement Protocol an GA4. Das bedeutet, Konversionen erscheinen in GA4 unabhängig davon, ob der Benutzer einen Adblocker hat, ohne JavaScript auf Ihrer Seite.
Was Sie benötigen#
- Eine GA4-Property (kein Universal Analytics).
- Zugriff auf das Admin-Panel der Property.
- Ca. 5 Minuten.
Schritt 1 — Ihre Measurement ID finden#
- Gehen Sie zu Google Analytics.
- Klicken Sie auf Admin (Zahnrad-Symbol unten links).
- Klicken Sie unter Property auf Datenstreams → 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 nach unten zu Measurement Protocol API-Secrets.
- Klicken Sie auf Erstellen.
- Geben Sie ihm einen Namen ("Elido") und klicken Sie auf Erstellen.
- Kopieren Sie den Secret-Wert. Er wird nur einmal angezeigt. Falls Sie ihn verlieren, erstellen Sie einen neuen — alte Secrets funktionieren weiterhin, bis Sie sie löschen.
Schritt 3 — In Elido konfigurieren#
- Gehen Sie zu Dashboard → Konversionen → GA4 → Weiterleitung einrichten.
- Fügen Sie die Measurement ID und das API-Secret ein.
- Klicken Sie auf Speichern. Elido sendet sofort ein Testereignis (
elido_test) an GA4.
Wie Elido client_id zuordnet#
GA4 benötigt eine client_id, um Ereignisse einem Benutzer zuzuordnen. Elido leitet sie wie folgt ab:
- Wenn Ihre Kurzlink-Zielseite ein
_ga-Cookie setzt und der Wert über Ihr Konversionspixel zurückgegeben wird — liest Elido ihn direkt. - Andernfalls hasht Elido die Elido
click_id(z. B.clk_abc123) zu einer stabilen UUID-ähnlichen Zeichenkette und verwendet diese alsclient_id.
Das bedeutet, GA4 zeigt diese Ereignisse unter einem "Benutzer" an, der möglicherweise nicht mit Ihren bestehenden GA4-Web-Sessions übereinstimmt — sie werden nicht zusammengeführt. Für vollständiges Session-Stitching übergeben Sie den _ga-Cookie-Wert an Ihren Server und fügen Sie ihn in den Elido-Conversions API-Aufruf ein.
Ereignisnamen in GA4#
Elido leitet diese Ereignisse weiter:
| Elido-Ereignis | GA4-Ereignisname |
|---|---|
conversion.recorded | purchase (mit Wert + Währung) |
link.clicked (falls aktiviert) | elido_click |
threshold.exceeded | elido_threshold |
Das purchase-Ereignis wird verwendet, weil GA4 dafür integrierte Berichte im Monetarisierungsbereich hat. Alle Ereignisse enthalten utm_source, utm_medium, utm_campaign als Ereignisparameter.
Fehlerbehebung#
Keine Ereignisse in Echtzeit sichtbar — Überprüfen Sie die Measurement ID und das API-Secret. Ein falsches API-Secret gibt HTTP 204 (kein Inhalt) zurück, aber GA4 verwirft die Nutzlast stillschweigend. Überprüfen Sie durch direkten Aufruf des Measurement Protocol-Endpunkts:
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 gibt {"validationMessages":[]} zurück.
Ereignisse erscheinen in Echtzeit, aber nicht in regulären Berichten — Measurement Protocol-Ereignisse können 24–48 Stunden benötigen, um in nicht-Echtzeit-GA4-Berichten zu erscheinen. Dies ist eine GA4-Einschränkung, kein Elido-Problem.
Falsche Währung bei Kauf-Ereignissen — Elido liest die Währung aus dem currency-Feld des Konversionsereignisses. Standard ist EUR. Legen Sie es explizit in Ihrem Konversionserfassungs-API-Aufruf fest.
Doppelte Ereignisse — Wenn Ihre Website auch clientseitig ein GA4-purchase-Ereignis auslöst, sehen Sie Duplikate. Deaktivieren Sie das clientseitige Ereignis oder verwenden Sie einen anderen Ereignisnamen in den Elido-Mapping-Einstellungen.