Was ist das LinkedIn Conversions API Tool?

LinkedIn Conversions API (CAPI) ist ein serverseitiger Endpunkt, über den Ihre Website oder Ihr Backend-System Conversion-Events direkt an LinkedIn senden kann – ohne auf den Browser angewiesen zu sein. Da die Aufrufe von Ihrem Server stammen, werden die Daten weniger durch Ad-Blocker, ITP und Cookie-Einschränkungen beeinträchtigt. Die API verbindet Ihre Datenbank mit dem Campaign Manager und hilft sicherzustellen, dass mehr qualifizierte Leads oder Verkäufe erfasst werden, indem browserseitige Datenverluste reduziert werden.

Warum LinkedIn Conversions API wichtig ist

• Verknüpfen Sie telefonische Bestellungen, CRM-Stufen oder Ladenverkäufe mit Ihren Kampagnen, um ein vollständiges Bild zu erhalten.
• Umfassendere Signale helfen LinkedIn, den CPA automatisch zu senken. Werbetreibende, die CAPI nutzen, berichten von +31 % zugeordneten Conversions, −20 % CPA und −39 % Kosten pro qualifiziertem Lead im Durchschnitt.
• Server-Aufrufe überstehen Browser-Einschränkungen, die den LinkedIn Insight Tag beeinträchtigen können.
• Wählen Sie genau aus, welche gehashten Felder geteilt werden (SHA256_EMAIL, First-Party-Tracking-UUID oder Third-Party-Identitäts-IDs wie ACXIOM_ID und ORACLE_MOAT_ID).
• Serverseitiges SHA-256-Hashing, 180-tägige Datenspeicherung und Steuerungsmöglichkeiten für die Werbepräferenzen der Mitglieder vereinfachen die Einhaltung von DSGVO, CCPA und ähnlichen Datenschutzgesetzen.
• Nahezu Echtzeit-Updates erreichen den Campaign Manager schneller, sodass Gebotsstrategien angepasst werden können, bevor Budget verschwendet wird.

SaaS-Teams nutzen CAPI, um SQL-Events zu streamen. E-Commerce-Shops übermitteln Nettoumsätze. B2B-Marketer synchronisieren Webinar- und Messedaten. Informationen zur Vertriebstrichter-Automatisierung und Kampagnenoptimierung auf LinkedIn finden Sie im LinkedIn Automated Marketing Funnel: Sales Funnel Automation Guide.

So funktioniert LinkedIn Conversions API

Client-seitig vs. serverseitig:

• Pixel: Der Browser erfasst Klick-/View-Daten; anfällig für Blocker.
• API: Ihr Server sendet JSON per POST an LinkedIns /rest/conversionEvents-Endpunkt unter Verwendung eines OAuth2-Access-Tokens (mit den Scopes rw_conversions und r_ads) und vier erforderlichen Headern: Authorization: Bearer {token}, X-Restli-Protocol-Version: 2.0.0, LinkedIn-Version: {yyyymm} und Content-Type: application/json.

Conversion-Events müssen einen conversionHappenedAt-Zeitstempel innerhalb der letzten 90 Tage enthalten. Attribution-Lookback-Fenster können auf 1, 7, 30 oder 90 Tage konfiguriert werden; 365-Tage-Fenster sind für die Conversion-Typen Lead, Qualified Lead, Purchase, Submit Application und Add to Cart verfügbar.

Schritt-für-Schritt-Einrichtung

1. Conversion-Regel erstellen — Gehen Sie im Campaign Manager zu Measurement → Conversion tracking → Create conversion → Conversions API. Benennen Sie die Regel, wählen Sie einen Conversion-Typ (Lead, Purchase, Sign Up usw.), legen Sie eine Wertmethode fest (dynamisch, fest oder keine) und konfigurieren Sie die Attributionsfenster.
2. Integrationspfad wählen — Verbinden Sie sich entweder über einen Partner (Adobe, HubSpot, Google Tag Manager, Zapier, Segment, Tealium und andere) oder erstellen Sie eine direkte Integration über LinkedIns REST API. Partner-Setups sind in der Regel einmalig; direkte Integrationen dauern durchschnittlich 2–4 Wochen und bieten volle Kontrolle über die Payload.
3. OAuth2-Access-Token generieren — Ihre App benötigt die Scopes rw_conversions und r_ads. Der Token-Inhaber muss die Rolle Account Manager, Campaign Manager oder Billing Admin im Werbekonto innehaben.
4. Kampagnen verknüpfen — Ordnen Sie die Conversion-Regel jeder Kampagne zu, die eine Zuordnung erhalten soll. Verwenden Sie autoAssociationType=ALL_CAMPAIGNS beim Erstellen der Regel oder verknüpfen Sie manuell über PUT /rest/campaignConversions.
5. Events streamen — Senden Sie jede Conversion per POST an /rest/conversionEvents mit der Conversion-URN, einem Millisekunden-Zeitstempel, mindestens einer Benutzerkennung und einer optionalen eventId zur Deduplizierung.

Schlüssel zur Benutzer-Zuordnung

LinkedIn ordnet Events anhand der Kennungen zu, die Sie im userIds-Array senden:

• SHA256_EMAIL — E-Mail-Adresse in Kleinbuchstaben, getrimmt und mit SHA-256 gehasht.
• LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID — der li_fat_id-Klickparameter, der erfasst wird, wenn Enhanced Conversion Tracking aktiviert ist.
• ACXIOM_ID — LiveRamp Identity Graph.
• ORACLE_MOAT_ID — Oracle MOAT Identity Graph.
• Falls keiner der oben genannten Werte verfügbar ist, senden Sie firstName + lastName (und optional companyName, title, countryCode) im userInfo-Objekt.

Das Senden mehrerer Kennungen pro Event erhöht die Trefferquote. Nur zugeordnete Events fließen in die Attribution und Optimierung ein.

Unterstützte Conversion-Typen

LinkedIn akzeptiert über 30 Conversion-Typen, darunter Add to Cart, Download, Install, Key Page View, Lead, Purchase, Sign Up, Start Checkout, Subscribe, Qualified Lead, Submit Application, Phone Call, Book Appointment, Request Quote und weitere. Die vollständige Liste finden Sie in der Marketing API-Referenz.

Deduplizierung

Wenn Sie sowohl den Insight Tag als auch CAPI verwenden, kann LinkedIn automatisch deduplizieren. Übergeben Sie denselben eventId-String sowohl beim client-seitigen als auch beim serverseitigen Event, damit LinkedIn das Duplikat erkennt und es nur einmal zählt.

Rate Limits

• 600 Anfragen pro Minute pro Token.
• 300.000 Anfragen pro Tag pro Token.
• Der Batch-Endpunkt akzeptiert bis zu 5.000 Events in einem einzigen POST (verwenden Sie den Header X-RestLi-Method: BATCH_CREATE).

Best Practices

• Senden Sie Events in Echtzeit. Verzögerte Daten können außerhalb des Attributionsfensters liegen oder den Optimierungszyklus verpassen.
• Fügen Sie so viele Zuordnungsparameter wie möglich hinzu. Mehr Kennungen bedeuten höhere Trefferquoten und eine bessere Signalqualität.
• Aktivieren Sie Enhanced First-Party Tracking im Campaign Manager, damit LinkedIn li_fat_id an Ihre Landing-Page-URLs anhängt. Erfassen und übermitteln Sie diese UUID mit jedem Conversion-Event.
• Verwenden Sie breite Attributionsfenster. LinkedIn empfiehlt 90-Tage-Klick / 90-Tage-View für Lead- und Lower-Funnel-Conversions. Für lange B2B-Vertriebszyklen nutzen Sie das 365-Tage-Fenster bei den Typen Lead, Qualified Lead, Purchase, Submit Application und Add to Cart.
• Weisen Sie Conversion-Werte zu. Selbst statische Platzhalterwerte ermöglichen es dem Campaign Manager, den ROAS zu berechnen und hochwertige Zielgruppen sichtbar zu machen.
• Verknüpfen Sie Conversions mit allen relevanten Kampagnen. Nicht verknüpfte Kampagnen können keine Attributionszuordnung erhalten.
• Nutzen Sie Batch-Anfragen für Massenimporte. Die Migration historischer CRM-Daten oder die Synchronisierung nächtlicher Exporte ist mit Batches von bis zu 5.000 Events schneller und zuverlässiger.
• Überwachen Sie die Conversion-Tracking-Seite im Campaign Manager auf Statusmeldungen und überprüfen Sie, ob Events ankommen und zugeordnet werden.

Bonus-Tipps

• Kombinieren Sie CAPI mit dem Insight Tag, anstatt ihn zu ersetzen. Redundante Signale füllen Lücken, wenn ein Kanal Events verliert, und LinkedIn dedupliziert automatisch.
• Verwenden Sie den serverseitigen Container von Google Tag Manager, um Web-Events an CAPI weiterzuleiten, ohne eigenen Code schreiben zu müssen – LinkedIn stellt ein offizielles GTM-Template bereit.
• Teilen Sie bewährte Conversion-Regeln über den Business Manager mit anderen Werbekonten, damit jedes Team denselben Messrahmen nutzt.
• Hashen Sie E-Mails auf Ihrem Server, bevor sie Ihr Netzwerk verlassen. Vorab-Hashing hält Roh-PII aus Logs und Übertragungswegen fern.
• Erneuern Sie Ihr OAuth-Token, bevor es abläuft. Ein abgelaufenes Token verwirft Events stillschweigend, bis jemand die Lücke im Campaign Manager bemerkt.
• Testen Sie Ihre Payload mit LinkedIns Payload Builder Tool unter linkedin.com/developers/payload-builder, bevor Sie live gehen.