LinkedIn Conversions API mit Beaconry: OAuth in 30 Sekunden, 5 Conversion-Rule-Slots
LinkedIn Conversions API braucht fünf Dinge: einen OAuth-Token, eine Ad-Account-ID, und eine Conversion-Rule-URN pro Event-Typ, den du tracken willst. Beaconry handhabt den OAuth-Handshake; der Rest ist Paste-und-Save.
OAuth in 30 Sekunden
"Connect with LinkedIn" in Beaconry → Tracking → LinkedIn klicken. LinkedIn zeigt einen Consent-Screen, gescopet auf rw_conversions + r_ads, du genehmigst, du bist zurück in Beaconry mit dem Token verschlüsselt gespeichert. Gesamtzeit: etwa 30 Sekunden, keine LinkedIn-Developer-Portal-App nötig.
Der Account, der OAuth ausführt, braucht Account-Manager-, Campaign-Manager- oder Account-Billing-Admin-Rolle auf dem Ad-Account. Viewer-only wird von der API abgelehnt. Wenn du als Agentur Tracking für Kunden fährst, muss der Kunde deinem Account die Rolle zuerst geben.
Ad-Account-ID
Campaign Manager öffnen, URL im Browser anschauen. Sie enthält etwas wie /accounts/512345678. Numerischer Teil ist deine Ad-Account-ID. In Beaconry einfügen. Plugin baut LinkedIns internes URN-Format selbst.
5 Conversion-Rule-Slots
Beaconry mapped GA4-Event-Typen auf fünf LinkedIn-Slots. Für jeden Slot, den du nutzen willst:
- Campaign Manager → Measurement → Conversion Tracking → Create Conversion → Data Source: Direct API.
- Conversion konfigurieren (Name, Wert, Attributions-Fenster).
- Speichern. Numerische Rule-ID steht in der URL.
- In den passenden Slot in Beaconry einfügen.
Die fünf Slots, mit dem, was sie feuert:
- Purchase: WooCommerce-Purchase-Event.
- Lead: Form-Submissions (Kadence, Fluent). Der meistgenutzte Slot für B2B-SaaS.
- SignUp: WP-User-Register-Hook (Free-Trial-Aktivierungen, Account-Registrierung).
- AddToCart: WooCommerce add_to_cart, Mid-Funnel-Signal.
- KeyPageView: 50 % Scroll + 10 s Engagement auf einer einzelnen Page-View, für High-Intent-Seiten wie Pricing oder Vergleich.
Du konfigurierst nur Slots, die du tatsächlich nutzt. Die anderen lass leer.
Token-Renewal, 60-Tage-Zyklus
LinkedIn-Access-Tokens laufen alle 60 Tage ab. Beaconrys täglicher Heartbeat warnt 7 Tage im Voraus im Logs-Tab, plus mailt den Operator, falls ein Heartbeat einen abgelaufenen Token erkennt. Reconnect durch erneutes "Connect with LinkedIn"-Klicken, OAuth-Handshake wiederholt sich, Konfiguration bleibt. Kein erneutes Einfügen von Conversion-Rule-IDs.
Wenn du im Urlaub bist und der Token abläuft, ist der Worst Case 7-30 Tage un-getrackte Conversions. Beaconry queued sie mit einem "Needs-Retry"-Marker; wenn du innerhalb von 30 Tagen reconnectest, werden gequeuete Events automatisch retried. Nach 30 Tagen altert die Queue raus und verlorene Events sind verloren.
Was gesendet wird
Bei jedem Event, das Beaconry an LinkedIn schickt:
- Conversion-Rule-URN passend zum Event-Typ.
- Conversion-Timestamp (Unix-Epoch, UTC).
- Gehashte PII: SHA-256 E-Mail + LinkedIn-spezifischer Identifier-Hash (LIPA).
li_fat_idaus URL-Parametern, wenn verfügbar.- Per-Event-Idempotency-Key, verhindert Double-Counting bei Retries.
LinkedIns Matching ist am sensitivsten gegenüber E-Mail, sowohl LinkedIn-spezifischer Identifier als auch Standard-SHA-256. Beaconry sendet beide. Match-Rate auf B2B-Audiences pendelt sich typisch bei 60-75 % auf LinkedIn ein, materially höher als Browser-Tag-Only-Setups.
Hybrid-Modus, optional
Der LinkedIn Insight Tag im Hybrid-Modus fügt li_fat_id-First-Party-Cookie-Support hinzu, was die Match-Rate um weitere 10-15 % bei engaged-but-not-yet-converting Prospects heben kann. Für LinkedIn speziell ist der Hybrid-Modus auf der "in Erwägung ziehen"-Liste, weil B2B-Funnel-Fenster lang sind und jeder Match-Rate-Punkt zählt.
Fazit
LinkedIn mit Beaconry ist der B2B-relevanteste der fünf Kanäle. OAuth ist schnell, Conversion-Rules mappen sauber, der 60-Tage-Token-Zyklus ist die einzige laufende Wartung und Beaconry warnt rechtzeitig vor. Für B2B-SaaS ist das oft der Kanal, in dem Beaconrys Match-Rate-Arbeit den höchsten Dollar-Impact hat.