LinkedIn Insight Tag + Conversions API

LinkedIn Insight Tag + Conversions API verbindet Ihren PrestaShop-Shop mit dem LinkedIn Campaign Manager, damit Sie LinkedIn Ads anhand echter Shop-Aktionen messen können: Produktaufrufe, Warenkörbe, Checkout-Starts, Registrierungen, Suchanfragen, Wunschlisten und Käufe.

Funktionen

Einbindung des Insight Tags. Das Modul lädt den LinkedIn-Browser-Insight-Tag über displayHeader, ohne Theme-Templates zu bearbeiten.
Tracking von E-Commerce-Events. Es erfasst PageView, ViewContent, AddToCart, StartCheckout, Purchase, Search, AddToWishlist und SignUp, wenn die entsprechenden Event-Schalter aktiviert sind.
Hooks für Bestell-Conversions. Das Kauf-Tracking läuft über displayOrderConfirmation und actionValidateOrder, inklusive Bestellwert, Währung und stabiler Event-ID.
Abdeckung von Add-to-cart. Add-to-cart-Events werden über den JavaScript-Event-Bus updateCart von PrestaShop und klassische Add-to-cart-Buttons erkannt.
Abdeckung von Wunschlisten. Hinzufügungen zur Wunschliste werden über gängige Wishlist-Buttons und WishlistEventBus erkannt, sofern das Theme oder Wishlist-Modul ihn bereitstellt.
Conversion-Regeln pro Event. Jedes Standard-Event kann seine eigene LinkedIn Campaign Manager Conversion Rule ID verwenden.
Conversions API-Warteschlange. Serverseitige Events werden in der gemeinsamen Tabelle mpr_conversion_queue unter dem Provider linkedin gespeichert und durch die geplante Aufgabe send_linkedin_conversions verarbeitet.
Deduplizierung im Browser und auf dem Server. Passende Event-IDs werden verwendet, damit LinkedIn Browser- und Conversions API-Versionen derselben Conversion deduplizieren kann.
Regeln für benutzerdefinierte Events. Klick-, URL-, Controller-/Modul- und DOM-Event-Regeln ermöglichen die Messung von Angebotsbuttons, Formularen, Downloads, Konfigurator-Schritten oder anderen shopspezifischen Intent-Signalen.
Einwilligungs- und Mitarbeiterkontrollen. Das Tracking kann auf die Marketing-Einwilligung des MPR-Cookie-Moduls warten und das Tracking für angemeldete Back-Office-Mitarbeiter beim Besuch des Storefronts vermeiden.
Back-Office-Diagnose. Die Konfigurationsseite zeigt Partner ID, Purchase Conversion Rule und Conversions API-Bereitschaft, Queue-Zähler, aktuelle Queue-Zeilen, einen API-Test und eine Aktion zum erneuten Senden fehlgeschlagener Events.

LinkedIn Insight Tag + Conversions API — Linkedin insight audience

LinkedIn Insight Tag + Conversions API — Admin config events

Konfigurationsoptionen

Enable LinkedIn Insight Tag. Hauptschalter für LinkedIn-Browser-Tracking; Standard: 0.
Partner ID. Numerische LinkedIn Partner ID aus Campaign Manager > Account Assets > Insight Tag; Standard: ``.
Exclude employees. Verhindert die Tracking-Einbindung, während ein angemeldeter Back-Office-Mitarbeiter das Front Office besucht; Standard: 1.
Respect cookie consent. Wartet auf Marketing-Einwilligung von mprcookiesrevolution oder mprcookiebanner, wenn eines der Module aktiv ist; Standard: 1.
Track PageView. Sendet das grundlegende Seitenbesuchs-Event, nachdem der Insight Tag geladen wurde; Standard: 1.
Track ViewContent. Erfasst Aufrufe von Produktdetailseiten mit Produkt-ID, Name, Kategorie, Preis und Währung; Standard: 1.
Track AddToCart. Erfasst native und AJAX-Add-to-cart-Aktionen; Standard: 1.
Track StartCheckout. Erfasst den Einstieg in den Checkout mit Warenkorbwert, Artikelanzahl, Währung und Positionen; Standard: 1.
Track Purchase. Erfasst abgeschlossene Bestellungen über Hooks für Bestellbestätigung und Bestellvalidierung; Standard: 1.
Track Search. Erfasst Suchergebnisseiten, wenn eine Suchanfrage vorhanden ist; Standard: 1.
Track AddToWishlist. Erfasst Aktionen zum Hinzufügen zur Wunschliste über gängige Wishlist-Buttons und Event-Busse; Standard: 1.
Track SignUp. Markiert die Erstellung neuer Kundenkonten und sendet das Registrierungs-Event beim nächsten Laden der Kundenkonto-Seite; Standard: 1.
ViewContent conversion ID. LinkedIn Conversion Rule ID für Produktaufruf-Events; Standard: ``.
AddToCart conversion ID. LinkedIn Conversion Rule ID für Add-to-cart-Events; Standard: ``.
StartCheckout conversion ID. LinkedIn Conversion Rule ID für Checkout-Start-Events; Standard: ``.
Purchase conversion ID. LinkedIn Conversion Rule ID für Kauf-Events; Standard: ``.
Search conversion ID. LinkedIn Conversion Rule ID für Such-Events; Standard: ``.
AddToWishlist conversion ID. LinkedIn Conversion Rule ID für Wishlist-Events; Standard: ``.
SignUp conversion ID. LinkedIn Conversion Rule ID für Kontoerstellungs-Events; Standard: ``.
Track custom events. Aktiviert das JSON-Feld für benutzerdefinierte Event-Regeln; Standard: 0.
Custom event rules. JSON-Array mit benutzerdefinierten Klick-, URL-, Controller- oder DOM-Event-Regeln; Standard: ``.
Enable Conversions API events. Stellt geeignete Events mit Conversion Rule IDs für den serverseitigen Versand an LinkedIn in die Warteschlange; Standard: 0.
Conversions API access token. LinkedIn Conversions API-Token für die serverseitige Übermittlung; Standard: ``.
LinkedIn API version. LinkedIn Marketing API-Version im Format YYYYMM; Standard: 202605.
Send IP address match key. Sendet die IPv4-Adresse als LinkedIn-Match-Key, wenn Conversions API-Events erstellt werden; Standard: 1.
Queue batch limit. Maximale Anzahl wartender LinkedIn-Events, die pro Lauf verarbeitet werden, von 1 bis 100; Standard: 20.

LinkedIn Insight Tag + Conversions API — Linkedin insight purchase path

LinkedIn Insight Tag + Conversions API — Admin integrity page

Beispiele für Anpassungen

LinkedIn Conversion Rule IDs können als einfache numerische ID oder als vollständige LinkedIn URN eingegeben werden. Das Modul speichert intern den numerischen Teil.

12345678
urn:lla:llaPartnerConversion:12345678

Benutzerdefinierte Klickregel für einen Angebotsanfrage-Button:

[
  {
    "event": "QuoteRequest",
    "conversion_id": "12345678",
    "trigger": "click",
    "selector": ".quote-request-button",
    "params": {
      "location": "product_page"
    },
    "capi": true
  }
]

Zusätzliche Parameter können direkt auf dem angeklickten Element platziert werden:

<a class="quote-request-button"
   data-linkedin-param-location="product"
   data-mprlnin-param-product_id="123">
  Request a quote
</a>

URL-basierte benutzerdefinierte Regel für einen Katalog-Download oder eine Angebotsseite:

[
  {
    "event": "QuotePageView",
    "conversion_id": "12345678",
    "trigger": "url",
    "contains": ["/request-a-quote"],
    "once": true,
    "capi": true
  }
]

Controller-/Modul-Regel für eine Checkout-Modulseite:

[
  {
    "event": "CustomCheckoutStep",
    "conversion_id": "12345678",
    "trigger": "controller",
    "controllers": ["checkout"],
    "modules": ["mprcheckoutrevolution"],
    "params": {
      "step": "checkout"
    },
    "once": true,
    "capi": true
  }
]

DOM-Event-Regel für JavaScript-Integrationen:

[
  {
    "event": "GalleryView",
    "conversion_id": "12345678",
    "trigger": "event",
    "dom_event": "mpr:gallery:view",
    "capi": true
  }
]

document.dispatchEvent(new CustomEvent('mpr:gallery:view', {
  detail: {
    params: {
      gallery: 'main',
      product_id: '123'
    }
  }
}));

Sie können auch den Storefront-Helper aufrufen, nachdem das Modul geladen wurde. Bei einem benutzerdefinierten Event-Namen geben Sie conversion_id an, sofern der Event-Name nicht einer der integrierten Conversion ID-Zuordnungen entspricht.

window.mprlninTrackCustom('DemoRequest', {
  conversion_id: '12345678',
  product_id: '123',
  currency: 'USD'
}, {
  capi: true
});

Wenn Sie das gemeinsame Cron-System manuell ausführen, ist die LinkedIn-Queue-Aufgabe wie folgt registriert:

send_linkedin_conversions
schedule: every:300
provider: linkedin
table: _DB_PREFIX_ + mpr_conversion_queue

LinkedIn Insight Tag + Conversions API — Linkedin consent attribution

LinkedIn Insight Tag + Conversions API — Storefront source insight tag

Installation

Laden Sie die Modul-ZIP-Datei aus Ihrem mypresta.rocks-Konto herunter.
Gehen Sie im PrestaShop Back Office zu Modules > Module Manager.
Klicken Sie auf Upload a module und wählen Sie die ZIP-Datei aus.
Öffnen Sie nach der Installation die Konfigurationsseite des Moduls.
Fügen Sie Ihre LinkedIn Partner ID hinzu, aktivieren Sie das Tracking, speichern Sie und tragen Sie anschließend die Conversion Rule IDs ein, die LinkedIn Campaign Manager zählen soll.
Wenn Sie Conversions API verwenden, fügen Sie das Access Token hinzu, speichern Sie, senden Sie den API-Test und prüfen Sie, ob das Diagnosepanel den erwarteten Status meldet.

LinkedIn Insight Tag + Conversions API — Linkedin conversion endpoint

So funktioniert es in Ihrem Shop

Nach der Einrichtung sehen Besucher kein neues Storefront-Widget. Das Modul fügt den LinkedIn Insight Tag und Event-Listener in den Seitenkopf ein, erfasst den Klickparameter li_fat_id, wenn LinkedIn ihn sendet, und ordnet PrestaShop-Aktivitäten LinkedIn-Events zu.

Im Back Office sehen Sie die Tracking-Schalter, Conversion-Rule-Felder, das JSON-Feld für benutzerdefinierte Events und die Conversions API-Diagnose. Queue-Status werden als pending, sending, sent und failed angezeigt; fehlgeschlagene Events können über die Modulseite wieder in die Pending-Queue zurückgestellt werden.

LinkedIn Insight Tag + Conversions API — Admin config consent

Ehrliche Grenzen

Das LinkedIn-Reporting hängt von Daten aus dem LinkedIn Campaign Manager ab. Das Modul kann Events erst senden, nachdem Sie die korrekte Partner ID, Conversion Rule IDs und, für serverseitige Übermittlung, ein gültiges Conversions API-Token bereitgestellt haben.

Einwilligungseinstellungen werden für unterstützte MPR-Cookie-Module respektiert. Wenn ein anderes Consent-Tool Skripte auf andere Weise blockiert, benötigen Sie möglicherweise ein benutzerdefiniertes Event oder eine Consent-Integration.

Conversions API verbessert die Event-Übermittlung, aber LinkedIn benötigt weiterhin nutzbare Match-Daten wie Click ID, gehashte Kundendaten oder IPv4-Adresse, sofern Ihre Richtlinie dies erlaubt. Server-Events ohne nutzbare Match-Identifikatoren können abgelehnt werden oder die Attribution nicht verbessern.

Benutzerdefinierte Events benötigen stabile Selektoren, URLs, Controller-Namen oder DOM-Events. Wenn ein Theme Button-Klassen ändert oder ein Drittanbieter-Modul das Checkout-Markup ersetzt, aktualisieren Sie die benutzerdefinierte Regel passend zur neuen Seite.

LinkedIn Insight Tag + Conversions API — Admin config conversions api

Häufig gestellte Fragen

Brauche ich Conversions API?
Der Browser-Insight-Tag reicht für Website-Demografie und einfaches Retargeting aus. Conversions API wird empfohlen, wenn LinkedIn Ads-Attribution wichtig ist, besonders für Kaufberichte.

Können Browser- und Server-Events doppelt gezählt werden?
Das Modul verwendet passende Event-IDs, damit LinkedIn Browser- und Server-Versionen derselben Conversion deduplizieren kann.

Kann es Galerieansichten oder Angebotsbuttons tracken?
Ja. Verwenden Sie benutzerdefinierte Events mit Selektor-, URL-, Controller-/Modul- oder JavaScript-Event-Triggern.

Funktioniert es mit Checkout Revolution?
Ja. Native Checkout-Start- und Kauf-Events werden erfasst, und zusätzliche Checkout-Modul-Interaktionen können als benutzerdefinierte Events abgebildet werden.

Was passiert, wenn LinkedIn ein Server-Event ablehnt?
Das Event bleibt mit HTTP-Code und letztem Fehler in der Queue. Fehlgeschlagene Events können über die Modul-Konfigurationsseite erneut versucht werden.

Kompatibilität: PrestaShop 1.6 bis 9.0 (neueste Version), PHP 7.1+. Wir unterstützen auch weiterhin kommende PrestaShop-Versionen.