Facebook Pixel: Einrichtung und Hilfe

Folgen Sie den Schritten unter Schnellstart.

Öffnen Sie "Configure" in "Module Manager". Das Modul bietet ein Einstellungsformular, ein Meta-Verbindungspanel, eine Einrichtungsanleitung und Steuerelemente für die Tracking-Zuständigkeit. Verwenden Sie ein Backoffice-Konto mit Konfigurationsberechtigung; die Verbindungsaktion prüft Bearbeitungsrechte und Admin-Token.

Bei aktiviertem Einwilligungsschutz und aktivem unterstütztem MPR-Einwilligungsmodul bereitet der Header eine Einwilligungsschranke im Browser vor. Sie startet das Pixel nach erteilter Einwilligung und reagiert auf mprcr:consent und mprcookie:consent. Die serverseitige Einwilligungsprüfung liest die MPR-Marketingentscheidung und verwendet den konfigurierten Standard des Einwilligungsmoduls, wenn dessen Cookie fehlt. Ist keines der unterstützten MPR-Einwilligungsmodule aktiv, erlaubt der Schutz dieses Moduls Tracking. Konfigurieren Sie ein anderes Einwilligungswerkzeug separat, falls Sie eines verwenden.

Verwenden Sie die Zuständigkeitssteuerung, wenn eine andere MPR-Integration dasselbe Meta-Ziel verarbeitet. Dieses Modul prüft vor dem Versand die Fähigkeit meta_pixel. Entfernen Sie unabhängig installierte doppelte Pixel-Snippets aus Theme oder anderen Modulen.

Browserereignisse

Alle Standardereignisschalter stehen standardmäßig auf Ja. Deaktivieren Sie unerwünschte Ereignisse.

PageView wird beim Start des Browser-Pixels gesendet. Es hat keinen eigenen Einstellungsschalter. Produkt-, Warenkorb- und Wunschlistenverhalten hängen von den Daten und Ereignissen Ihres Themes ab. Testen Sie angepasste Steuerelemente ausdrücklich.

Das Modul sendet über CAPI nur Purchase. Andere Standardereignisse und eigene Regeln verwenden das Browser-Pixel.

actionValidateOrder und displayOrderConfirmation können dieselbe Bestellung einreihen. Die Warteschlangenidentität verhindert doppelte Aufnahmen für dieses Ereignis. Browser- und Serverkauf verwenden dieselbe stabile, aus der Bestell-ID gebildete Ereignis-ID. Die Kaufdaten enthalten Bestellwert inklusive Steuern, Währung, Produkt-IDs, Positionsinhalte und Menge. Die Serverdaten enthalten außerdem verfügbare Kundenzuordnungsdaten und Facebook-Cookie-Kennungen.

Das Modul versucht während dieser Hooks einen kleinen Batch aus drei Ereignissen. Es registriert außerdem die gemeinsame Cron-Aufgabe:

task: send_facebook_conversions
callable: mprfacebookpixel::cronProcessFacebookConversions
schedule: every:300
context: any
timeout: 30

Stellen Sie sicher, dass Ihr gemeinsamer MPR-Cron-Runner die registrierte Aufgabe ausführt. Der normale Worker-Batch beträgt 20; dieses Modul hat kein Feld für die Batchgröße. Ausstehende Ereignisse können vom Worker erneut versucht werden. Die Warteschlangenbereinigung erhält gesendete Zeilen 30 Tage und andere alte Zeilen 90 Tage. Eine geänderte Zuständigkeitsbindung kann dazu führen, dass alte oder abgelöste Zeilen verworfen statt gesendet werden.

Die übereinstimmende Browser-/Server-Ereignis-ID ermöglicht die Deduplizierung beim Anbieter. Meta entscheidet über die Conversion-Attribution; prüfen Sie Übermittlung und Attributionsergebnisse in Meta.

"Track custom events" steht standardmäßig auf Nein. "Custom event rules" ist zunächst leer. Fügen Sie Regeln vor dem Aktivieren hinzu. Verwenden Sie einen eindeutigen Namen, der mit einem Buchstaben beginnt, Buchstaben, Zahlen oder Unterstriche enthält und höchstens 50 Zeichen hat. Standard-Meta-Ereignisnamen sind reserviert. Das Modul verarbeitet höchstens 50 Regeln und 50 unterschiedliche eigene Ereignisnamen.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-cover img","params":{"area":"product_gallery"},"once":false},
  {"event":"SizeGuideView","trigger":"url","contains":["/size-guide"],"params":{"area":"product_help"}},
  {"event":"AccountAreaView","trigger":"controller","controllers":["my-account"]},
  {"event":"ModuleCheckoutView","trigger":"controller","modules":["onepagecheckout"]},
  {"event":"ConfiguratorCompleted","trigger":"event","dom_event":"product-configurator:complete","params":{"source":"configurator"}}
]

Verwenden Sie selector, contains, controllers/modules oder dom_event für den jeweiligen Auslöser. enabled und once sind standardmäßig true. params liefert bereinigte Ereignisparameter. Das Modul ruft für diese Regeln fbq('trackCustom', ...) auf.

Lösen Sie Ihr eigenes DOM-Ereignis aus dem Theme-JavaScript aus:

document.dispatchEvent(new CustomEvent('product-configurator:complete', {
  detail: {source: 'configurator', product_type: 'custom_size'}
}));

Halten Sie Selektoren und Controller-/Modulnamen mit installiertem Theme und Checkout in Einklang.

Öffnen Sie den Shop in einem Kundenbrowser und prüfen Sie die Pixel-Anfrage nach der entsprechenden Einwilligungsentscheidung. Prüfen Sie nach Bedarf PageView, ein Produkt-ViewContent, Hinzufügen zum Warenkorb, Checkout-Start, Suche, Wunschliste und Registrierung. Verwenden Sie eine Testbestellung für Purchase.

Prüfen Sie für CAPI das Verbindungspanel und Meta Test Events mit Ihrem gespeicherten Testcode. Bestätigen Sie, dass der Serverkauf die Ereignis-ID des Browserkaufs verwendet. Prüfen Sie die Worker-Ausführung, wenn Wiederholungen ausstehen. Löschen Sie nach der Validierung den Testcode und speichern Sie. Die Verbindungsprüfung erfordert eine erlaubte Backoffice-Aktion; zeigen Sie keine Zugriffstoken in Bildschirmfotos oder eigenem Frontend-Code.

Lädt nichts, prüfen Sie Aktivierungsschalter, numerische "Pixel ID", Zuständigkeit für die Fähigkeit, Mitarbeiterkontext, Einwilligungsentscheidung und blockierte Skripte. Suchen Sie nach doppelten Ladern.

Fehlt ein bestimmtes Ereignis, prüfen Sie dessen Schalter und die benötigten Produkt-/Warenkorbdaten. Registrierung wird auf my-account verbraucht; eine andere Weiterleitung nach der Registrierung kann sie verzögern. Eine angepasste Wunschliste benötigt eine bereitgestellte Produkt-ID oder eine eigene Regel.

Ist CAPI inaktiv, prüfen Sie dessen Schalter, Token, Hauptschalter, Käufe erfassen und Zuständigkeit. Prüfen Sie Server-/Cron-Fehler und Anbieterantwort. Browserseitige Einwilligungsblockierung und Meta-Attribution können Berichte von PrestaShop-Summen abweichen lassen.

Setzen Sie "Enable Facebook Pixel" auf Nein und speichern Sie, um Browser- und Serversendungen dieses Moduls zu pausieren. Deinstallieren Sie über "Module Manager", um Menü, Cron-Registrierung und Modulkonfiguration zu entfernen. Die gemeinsame Warteschlangentabelle bleibt erhalten, wenn ein anderes Modul das Conversion-Paket verwendet; andernfalls löscht sie der Deinstallationshelfer der Warteschlange. Verwalten Sie Pixel, Datensatz und historische Berichte separat in Meta.

Verwenden Sie die obigen Einstellungsnamen, wenn ein Referenzbild von Ihrer installierten Version abweicht.