LinkedIn, Insight Tag und Conversions API
Server-Side-Conversion-Tracking für LinkedIn Ads. Jeder Event-Typ braucht seine eigene Conversion-Rule-URN im Campaign Manager. Plugin mappt GA4-Events auf fünf Slots: Purchase, Lead, SignUp, AddToCart, KeyPageView.
Voraussetzungen
- LinkedIn-Account mit Account-Manager-, Campaign-Manager- oder Account-Billing-Admin-Rolle auf dem Ad-Account, dessen Conversions getrackt werden sollen. Viewer-Rolle wird von der API abgelehnt.
- Etwa 5 bis 10 Minuten.
1. Mit LinkedIn verbinden
WordPress-Admin → Beaconry → Tracking → LinkedIn. Klick Mit LinkedIn verbinden. Du wirst zu LinkedIn weitergeleitet.
Mit dem LinkedIn-Account einloggen, der Ad-Account-Zugriff hat. LinkedIn zeigt einen Consent-Screen für "Beaconry" mit den Scopes rw_conversions + r_ads. Genehmigen. LinkedIn leitet dich zurück mit automatisch gespeichertem Access-Token.
2. Ad-Account-ID finden
Campaign Manager öffnen (linkedin.com/campaignmanager) und den Ad-Account wählen. URL im Browser zeigt etwas wie /accounts/512345678. Der numerische Teil (hier: 512345678) ist deine Ad-Account-ID.
In Beaconry → Ad-Account-ID einfügen. Plugin baut das LinkedIn-interne URN-Format selbst.
3. Eine Conversion-Rule pro Event-Typ anlegen
Campaign Manager → Messung → Conversion Tracking → Erstellen → Datenquelle: Direct API. Eine Conversion-Rule pro Event-Typ anlegen, den du tracken willst.
Beaconry mappt GA4-Events auf fünf LinkedIn-Slots:
| Beaconry-Event | LinkedIn-Slot |
|---|---|
WooCommerce purchase | Purchase |
Form generate_lead | Lead |
sign_up | SignUp |
WooCommerce add_to_cart | AddToCart |
| Engaged Page-View (50 % Scroll + 10 s) | KeyPageView |
4. Rule-IDs in Beaconry eintragen
Nach dem Speichern jeder Conversion-Rule im Campaign Manager steht die numerische Rule-ID in der URL. In den passenden Slot in Beaconry einfügen. Du brauchst nur Slots für Events, die du tatsächlich trackst. Den Rest leer lassen.
5. Test-Event versenden
Speichern, klick LinkedIn-Test-Event senden. HTTP 201 heißt: Credentials und URN sind gültig. Der Conversion-Counter im Campaign Manager updated innerhalb von ~3 Stunden. LinkedIn hat keine Echtzeit-Test-Ansicht.
6. (Optional) Insight Tag im Hybrid-Modus
Hybrid-Modus lädt den LinkedIn Insight Tag im Browser parallel zum Server-Side-Dispatch. Bessere Match-Rate, weil LinkedIn das First-Party-li_fat_id-Cookie sieht. Standardmäßig aus, Server-Side allein deckt 100 % der zustimmenden Besucher.
Token-Renewal
LinkedIn-Access-Tokens laufen nach 60 Tagen ab. Beaconrys Logs-Tab bekommt einen täglichen Heartbeat plus eine Warnung, wenn 7 Tage übrig sind. Erneut auf Mit LinkedIn verbinden klicken, um zu erneuern. Conversion-Rule-IDs und Ad-Account-ID bleiben konfiguriert, du wiederholst nur den OAuth-Handshake.
Was automatisch versendet wird
- li_fat_id aus URL-Parametern bei Ad-Click-Landings, im
nl_ext-Cookie persistiert. - Gehashte PII (E-Mail, Telefon) server-side gemäß LinkedIns Matching-Vorgaben.
- Per-Event-Idempotency-Key, damit Retries nicht doppelt zählen.
Plan-B-Modus (Manuelles Token-Einfügen)
Falls Beaconrys zentraler OAuth-Flow auf dieser Installation nicht konfiguriert ist (Konstante BCNR_LINKEDIN_OAUTH_CLIENT_ID ist leer), kannst du einen manuell aus dem LinkedIn-Developer-Portal ausgestellten Access-Token einfügen. Der Tracking-Tab zeigt die manuellen Felder, sobald OAuth nicht verfügbar ist.
Manuelle Tokens laufen ebenfalls nach 60 Tagen ab, aber du kannst einen Refresh-Token-Flow im LinkedIn-Developer-Portal nutzen, um sie zu verlängern.
Troubleshooting
- "403 Forbidden": dein LinkedIn-Account hat keine Ad-Account-Berechtigung. Account mit mindestens Campaign-Manager-Rolle nutzen.
- "422 Invalid conversion": Rule-ID existiert nicht auf diesem Ad-Account, oder die Rule ist pausiert. Campaign Manager → Conversion Tracking checken.
- Counter bewegt sich nicht: drei Stunden Latenz sind normal. Nach drei Stunden im Beaconry-Logs-Tab nach HTTP 201s schauen.