LinkedIn Insight Tag + Conversions API: Einrichtung und Hilfe

Folgen Sie den Schritten unter Schnellstart.

Öffnen Sie "Configure" im Modulmanager. Die Konfigurationsseite enthält Browsereinstellungen, Ereignisschalter, Konversionsregeln, benutzerdefinierte JSON-Regeln, Conversions API-Optionen und Warteschlangendiagnosen.

Der gemeinsame Browserleser unterstützt Cookies Revolution, Cookie Banner, Cookiebot, OneTrust und TCF. Konfigurieren und testen Sie Ihre Kategorie- und Dienstentscheidungen. Unbekannte Einwilligung hält die Übermittlung zurück. Das Modul prüft außerdem Zielinhaberschaft, Ausgangsregeln und sicheren Seitenkontext. Ein fremdes vorgeladenes Insight Tag wird nicht automatisch übernommen.

Ereignisschalter und Browser-Konversionsregeln

Alle Standardereignisschalter stehen standardmäßig auf Ja. Alle Felder für Browser-Konversions-IDs sind anfangs leer.

Konfigurieren Sie die entsprechenden Regeln im LinkedIn Campaign Manager. Geben Sie entweder die positive numerische ID oder eine vollständige URN wie urn:lla:llaPartnerConversion:12345678 ein; das Modul normalisiert sie auf den numerischen Teil.

Ein Schalter ohne Browser-Konversionsregel reicht für eine ereignisspezifische Konversion nicht aus. Das Basistag erfasst beim Laden eigene Besuche; "Track PageView" ist kein SDK-weiter Schalter, der jede automatische Seitenbeobachtung deaktiviert.

Die aktive Browserzuordnung sendet die ID der Konversionsregel und gegebenenfalls die Ereignis-ID. Sie übermittelt weder Wert und Währung noch einen allgemeinen Produktkatalog, Artikellisten oder Suchbegriffe an das Insight Tag. Die Warenkorberkennung benötigt ein erfolgreiches gemeinsames Handelssignal, nicht nur einen Schaltflächenklick.

Separate Server-Konversionsregeln

Alle Serverfelder sind standardmäßig leer. Konfigurieren Sie "Server conversion ID: page_view", "Server conversion ID: view_item", "Server conversion ID: add_to_cart", "Server conversion ID: begin_checkout", "Server conversion ID: purchase", "Server conversion ID: search", "Server conversion ID: add_to_wishlist" und "Server conversion ID: sign_up" für die gewünschten Serverereignisse. Verwenden Sie für bestätigte Formulare "Server conversion ID: contact_form_submit".

Verwenden Sie in jedem Serverfeld eine Datenquellenregel der LinkedIn Conversions API. Belassen Sie die Insight Tag-Regel im Browserfeld. Das Formular lehnt dieselbe numerische ID in zugehörigen Browser- und Serverfeldern ab. Kopieren Sie keine Regel-ID in beide Felder.

Einwilligung und Mitarbeiterstatus des Käufers werden aus seiner eigenen Shopsitzung erfasst. Käufe verwenden eine stabile, aus der Bestellung abgeleitete Ereignis-ID. Ein Serverereignis benötigt mindestens einen nutzbaren Abgleichsschlüssel wie li_fat_id, eine erlaubte gehashte E-Mail-Adresse oder eine erlaubte IPv4-Adresse; ohne ihn wird es zurückgehalten. Daten des Workers oder eines Operators ersetzen nie die für den Käufer erfassten Daten. Einwilligung, Abgleichsberechtigungen, Inhaberschaft und Ausgangsregeln werden vor dem Senden erneut geprüft.

Der gemeinsame Warteschlangenanbieter ist linkedin. Bestätigte Formulare verwenden contact_linkedin. Stellen Sie sicher, dass Ihr gemeinsamer MPR-Cron-Runner Folgendes ausführt:

task: send_linkedin_conversions
callable: mprlinkedininsight::cronProcessLinkedinConversions
schedule: every:300
context: any
timeout: 30

Browser- und Serverkennungen unterstützen die Korrelation beim Anbieter, diese Übertragungswege verwenden jedoch separate Konversionsregeln. Prüfen Sie Ihre Berichts- und Attributionskonfiguration im Campaign Manager, statt anzunehmen, dass jede doppelte Übermittlung eine einzige gemeldete Konversion ergibt.

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" und "Track product engagement" stehen standardmäßig auf Nein. Ihre Felder "Phone target", "Chat target", "Form target" und "Engagement target" sind anfangs leer. Geben Sie vor der Aktivierung eines Signals die entsprechende positive ID einer Browser-Konversionsregel ein.

"Send confirmed forms through the server API" steht standardmäßig auf Nein. Zusätzlich sind "Enable Conversions API events", ein Token und eine separate "Server conversion ID: contact_form_submit" erforderlich. Ein Formularereignis benötigt einen serverbestätigten Erfolgsbeleg. Seine serverseitigen Abgleichsdaten sind die vorhandene li_fat_id; das Kontaktereignis wird nicht mit übermittelten Formularfeldern, Hashes oder der Anfrage-IP angereichert.

Verwenden Sie "Product engagement thresholds" für die JSON-Konfiguration. Standardwerte sind 3 Galerieinteraktionen, 1 Variantenwechsel, 1 Detailinteraktion oder 45 Sekunden, mit 1500 ms Drosselung für Optionen. Zulässig sind 1 bis 20 Interaktionen, 5 bis 600 Sekunden Verweildauer und 250 bis 60000 ms Drosselung. Der Standardtracker arbeitet einmal pro Produkt/Sitzung, wenn Speicherung erlaubt ist. Die Erkennung tatsächlicher Chatstarts verwendet die unterstützte Tawk-Meldung.

"Track custom events" steht standardmäßig auf Nein. "Custom event rules" ist anfangs leer. Verwenden Sie von Standardereignissen abweichende Namen mit 1 bis 100 Buchstaben, Ziffern, Unterstrichen oder Bindestrichen. Namen werden in Kleinbuchstaben normalisiert. Jede gültige benutzerdefinierte Regel benötigt eine Browser-conversion_id. Ergänzen Sie für optionale CAPI-Übermittlung eine andere server_conversion_id.

[
  {"event":"QuoteRequest","conversion_id":"12345678","server_conversion_id":"87654321","trigger":"click","selector":".quote-request-button","params":{"value":10,"currency":"EUR"},"capi":true},
  {"event":"QuotePageView","conversion_id":"12345678","trigger":"url","contains":["/request-a-quote"],"capi":false},
  {"event":"CustomCheckoutStep","conversion_id":"12345678","trigger":"controller","controllers":["checkout"],"modules":["mprcheckoutrevolution"]},
  {"event":"GalleryView","conversion_id":"12345678","trigger":"event","dom_event":"mpr:gallery:view","capi":false}
]

document.dispatchEvent(new CustomEvent('mpr:gallery:view'));

Aus benutzerdefinierten params bleiben nur konfigurierte value und currency erhalten. Beliebige Datenattribute und DOM-Ereignisdetails werden nicht weitergeleitet. once ist standardmäßig false für Klicks und true für andere Auslöser; capi ist standardmäßig true, das Ereignis wird aber nur dann serverseitig gesendet, wenn eine berechtigte Serverregel und ein Abgleichsschlüssel vorhanden sind. Eine DOM-Ereignisregel verwendet standardmäßig mprlnin:custom, wenn ihr Ereignisname fehlt. Verwenden Sie konfigurierte Regeln statt des alten Helfers window.mprlninTrackCustom.

Prüfen Sie Hinweise zu erforderlicher "Partner ID", "Purchase conversion ID" und Token. Die Warteschlangendiagnose zeigt Anzahlen und neueste Zeilen einschließlich HTTP-Status und Fehlern. Fehlgeschlagene Events erneut versuchen setzt fehlgeschlagene LinkedIn- und bestätigte Formularzeilen gemäß den Wiederholungsregeln der Warteschlange auf ausstehend zurück. Prüfen Sie unklare oder endgültige Übermittlungen vor einem erneuten Sendeversuch.

Das Modul bietet keine API-Probe. Die Bereitschaftsprüfungen prüfen gespeicherte Einstellungen, jedoch keine API-Zugangsdaten oder Zustellung. Testen Sie tatsächliche Shop-Aktivitäten mit Einwilligung und eine Testbestellung, prüfen Sie die HTTP-Ergebnisse der Warteschlange und bestätigen Sie die Zustellung im LinkedIn Campaign Manager.

Wenn kein Tag geladen wird, prüfen Sie Hauptschalter, "Partner ID", Inhaberschaft, Marketing-/Dienstberechtigung, Mitarbeiterrichtlinie, sicheren URL-Kontext, fehlende Ressourcen und doppelte SDKs. Fehlt eine einzelne Browserkonversion, prüfen Sie deren Ereignisschalter und Browser-Regel-ID.

Fehlen Serverereignisse, prüfen Sie CAPI-Zugangsdaten, separate Server-IDs, den registrierten Worker, ob Einwilligung und Mitarbeiterstatus des Käufers erfasst wurden, und die Abgleichsschlüssel. Ein Kauf kann nie einen Zahlungs-Callback oder Cron-Operator als Käufer verwenden. Ein zurückgehaltenes oder widerrufenes Ereignis unterscheidet sich von einer HTTP-Ablehnung des Anbieters.

Setzen Sie "Enable LinkedIn Insight Tag" auf Nein und speichern Sie, um diese Integration anzuhalten. Deinstallieren Sie über den Modulmanager, um Menü, Cron-Registrierung und Modulkonfiguration zu entfernen. Gemeinsame Warteschlangen- und Kaufdatensätze, die andere Tracking-Module nutzen, bleiben erhalten. Verwalten Sie Partnerkonto, Konversionsregeln und historische Berichte in LinkedIn.

Verwenden Sie die obigen Einstellungsnamen, wenn ein Referenz-Screenshot von Ihrer installierten Version abweicht.