GA4, Measurement Protocol

Server-Side-Dispatch an Google Analytics 4 via dem offiziellen Measurement Protocol. Zwei Werte, beide aus der GA4-Web-Property, die Beaconry-Events empfangen soll.

1. Measurement-ID und API-Secret finden

• Google Analytics öffnen, Zahnrad (Admin) unten links anklicken.
• Unter Datenerhebung und -modifikation → Datenstreams wählen.
• Den Web-Stream anklicken, der Beaconry-Events empfangen soll.
• Measurement-ID sieht aus wie G-XXXXXXXXXX. Kopieren.
• Nach unten zu Measurement Protocol — API-Secrets → Erstellen.
• Name: "Beaconry plugin" → Erstellen → Secret-Wert kopieren.

2. Credentials in Beaconry eintragen

WordPress-Admin → Beaconry → Tracking → Google Analytics 4. Beide Werte einfügen, speichern.

API-Secret wird verschlüsselt gespeichert (AES-256-CBC). Konstanten-Variante: BCNR_GA4_MEASUREMENT_ID und BCNR_GA4_API_SECRET in wp-config.php.

3. Test-Event versenden

Klick GA4-Test-Event senden. Beaconry feuert ein synchrones Test-Event beaconry_test_ping ans Measurement Protocol und meldet die Validierung inline.

GA4 → Reports → Realtime innerhalb von ~30 Sekunden checken. Das Event sollte mit dem richtigen User-Agent und Source erscheinen.

4. Empfohlene GA4-Property-Settings

Diese liegen in GA4, nicht in Beaconry. Sie verhindern gängige Stolperfallen.

• Datenaufbewahrung: 14 Monate. Admin → Datenaufbewahrung. Standard sind 2 Monate, zu kurz für Year-over-Year-Vergleiche.
• Reporting-Währung. Admin → Property-Details → Reporting-Währung. Auf EUR umstellen, falls Events in EUR sind.
• Events als Conversions markieren. Konfigurieren → Events → "Als Conversion markieren" auf generate_lead, submit_application, sign_up, purchase, contact aktivieren.
• Realtime + DebugView zum Testen. Reports → Realtime zeigt Events innerhalb von ~30 Sek. DebugView zeigt nur Events mit debug_mode: true im Payload (Beaconry kann via Advanced-Tab in Debug-Modus geschaltet werden).

Was automatisch versendet wird

• page_view bei jedem zustimmenden Page-Load.
• user_engagement bei 50 % Scroll plus 10 Sekunden.
• generate_lead bei jeder Kadence-Blocks-Form- oder Fluent-Forms-Submission.
• add_to_cart, begin_checkout, purchase für WooCommerce. Inklusive Line Items, Währung, Wert.

Stabile per-Order-event_id für Cross-Device-Dedup, falls du parallel ein Browser-seitiges gtag-Setup laufen hast.

Troubleshooting

• "validation_messages" in der Measurement-Protocol-Antwort. Beaconrys Debug-Endpoint fängt diese ab. Logs-Tab → GA4-Dispatches → einen anklicken, um Googles Validierungs-Feedback zu sehen.
• Events in Realtime, fehlen aber in Standard-Reports. GA4-Standard-Reports haben 24-48 Stunden Verarbeitungs-Delay. Realtime ist die Source-of-Truth für "ist das Event angekommen".
• "User-Property-Limit erreicht". GA4 cappt Custom-User-Properties auf 25 pro Property. Beaconry nutzt drei (user_id, nl_pref_state, nl_attribution). Wenn du parallel gtag mit Custom Properties nutzt, könntest du das Cap erreichen.