TikTok Pixel: Einrichtung und Hilfe

Folgen Sie den Schritten unter Schnellstart.

Öffnen Sie "Configure" im Modulmanager. Sie benötigen ein bestehendes Pixel für Ihr TikTok-Konto. Die Konfigurationsseite zeigt erforderliche Einrichtungshinweise, Tracking-Bereitschaft und Events API-Diagnosen.

Browsertracking erfordert sowohl Marketing-/Dienstberechtigung als auch die Erlaubnis, Daten für den Abgleich zu senden. Die Speicherfreigabe allein reicht nicht aus. Das Modul unterstützt Einwilligungsentscheidungen von Cookies Revolution, Cookie Banner, Cookiebot, OneTrust und TCF; konfigurieren und testen Sie die Entscheidungen Ihres Shops. Unbekannte Berechtigung hält das Tracking zurück. Eine erkannte unterstützte CMP gilt auch bei deaktiviertem Einwilligungsschalter des Moduls.

Das Modul prüft außerdem sicheren Seiten-/Referrer-Kontext, Mitarbeiterstatus, Inhaberschaft und Ausgangsregeln. Es verwendet eine verifizierte pixelspezifische ttq-Instanz. Entfernen Sie vor dem Testen doppelte oder unklar initialisierte TikTok-Loader.

Standardereignisschalter

Alle Standardereignisschalter stehen standardmäßig auf Ja. Deaktivieren Sie nicht benötigte Ereignisse.

Das Modul lädt für Ihr Pixel https://analytics.tiktok.com/i18n/pixel/events.js. Warenkorbereignisse erfordern eine bestätigte erfolgreiche Mengenerhöhung; ein Hinzufügen-Klick oder eine updateCart-Meldung allein reicht nicht aus. Ereignisse enthalten Produkt-IDs und Menge. Aktuelle Preise und Warenkorbwert werden nur bei Bestätigung übermittelt.

Kaufdaten verwenden Purchase; CompletePayment ist ein interner Alias. Sie enthalten die stabile bestellbasierte Ereignis-ID, gegebenenfalls die Bestellreferenz, Wert, Währung und gekaufte Inhalte. Die Standardrichtlinie für den Kaufwert enthält Steuern und Versand und zieht Rabatte ab. Dies sind Anbieterstandardwerte in diesem Modul, keine separaten Einstellungsfelder.

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" und "Track product engagement" stehen standardmäßig auf Nein. Telefonklicks und unterstützte tatsächliche Tawk-Chatstarts werden mit groben Signalmetadaten auf Contact abgebildet. Formulare benötigen einen serverbestätigten Erfolgsbeleg.

"Confirmed form event" ist standardmäßig Lead. Wählen Sie SubmitForm nur, wenn Sie diese ältere Zuordnung benötigen. "Send confirmed forms through the server API" steht standardmäßig auf Nein; aktivieren Sie es nur zusammen mit Formularsignal und API-Zugangsdaten. Ein Formular wird nur dann vom Server gesendet, wenn Eingangsbeleg, Einwilligung des Besuchers und Klick-Attribution beim Absenden gespeichert wurden; andernfalls wird es zurückgehalten. Formularwerte werden nicht in das Ereignis kopiert.

Verwenden Sie "Product engagement thresholds" für ein JSON-Objekt. Ein leeres gespeichertes Feld verwendet Paketstandardwerte: 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. Das Standardverhalten von high_intent_product_engagement ist einmal pro Produkt/Sitzung, wenn Speicherung erlaubt ist.

"Track custom events" steht standardmäßig auf Nein. "Custom event rules" ist anfangs leer. Fügen Sie vor der Aktivierung Regeln hinzu. Namen beginnen mit einem Buchstaben und verwenden Buchstaben, Ziffern, Unterstriche oder Bindestriche bei maximal 50 Zeichen. Bis zu 50 Regeln und 50 unterschiedliche Namen werden verarbeitet. Standardereignisse einschließlich PageView, Purchase, Contact, SubmitForm, Download und Subscribe sind reserviert.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-cover img","params":{"content_type":"product"},"once":false},
  {"event":"SizeGuideView","trigger":"url","contains":["/size-guide"],"params":{"content_type":"page"}},
  {"event":"ContactIntent","trigger":"controller","controllers":["contact"],"modules":["contactform"]},
  {"event":"ConfiguratorChanged","trigger":"event","dom_event":"product:configured","params":{"configurator_step":"finish"},"once":false}
]

document.dispatchEvent(new CustomEvent('product:configured'));

Verwenden Sie selector, contains, controllers/modules oder dom_event für den entsprechenden Auslöser. once ist in diesem Modul standardmäßig true für alle Regeltypen. Die aktive Laufzeit verwendet konfigurierte Parameter und führt keine beliebigen DOM-Ereignisdetails zusammen. Verwenden Sie konfigurierte Regeln statt des alten Helfers window.mprtkpxTrack.

actionValidateOrder speichert Einwilligung und Kennungen aus der Sitzung des Käufers und stellt einen berechtigten Purchase in die Warteschlange. Ein Callback, Webhook oder eine Anfrage ohne die Sitzung des Käufers kann sie nicht liefern. Der Worker prüft ursprüngliche und aktuelle Einwilligung, Abgleichsberechtigung, Mitarbeiterrichtlinie, Ziel und Ausgangsregeln erneut. Ein Kauf ohne Abgleichskennungen wird zurückgehalten. Ein API-Token allein reicht nicht, um Käufe zu senden.

Die Serverübermittlung umfasst Käufe und optionale serverbestätigte Formulare. Standard-Browsingereignisse und benutzerdefinierte JSON-Regeln senden über den Browser. Andere Frontend-Aufrufe können nicht über die Events API gesendet werden.

Stellen Sie sicher, dass Ihr gemeinsamer MPR-Cron-Runner Folgendes ausführt:

task: send_tiktok_events_api_conversions
callable: mprtiktokpixel::cronProcessTikTokConversions
schedule: every:300
context: any
timeout: 30

Käufe verwenden den Warteschlangenanbieter tiktok_events_api. Derselbe Worker verarbeitet einen separaten Kanal für bestätigte Formulare mit einer Stapelgröße von 20 für diesen Kanal. Browser- und Serverkäufe teilen die bestellbasierte Ereignis-ID des Moduls; prüfen Sie Anbieterberichte, statt anzunehmen, jedes Warteschlangenereignis werde angenommen oder zugeordnet.

Das Modul sendet den Kauf bei der Bestellvalidierung, die vor dem Abschluss der Zahlung liegen kann. Es gibt keine Einstellung, um auf einen Bezahlt-Status zu warten, und kein späteres erneutes Senden, wenn eine Bestellung bezahlt wird.

Prüfen Sie auf der Konfigurationsseite Bereitschaft, Warteschlangenanzahlen und aktuelle HTTP-/Fehlerzeilen. Prüfen Sie mit einem Kundenbrowser und Anbietertestwerkzeugen Seitenaufruf, Produktansicht, erfolgreiche Warenkorbänderung, Bestellvorgang, Registrierung und eine Testbestellung. Testen Sie Ablehnung und Widerruf als separate Abläufe.

API-Probe senden benötigt einen gespeicherten "Test event code", Zugangsdaten, Tracking-Zuständigkeit und Ausgangsberechtigung. Es sendet einen mit dem Testcode markierten PageView mit leerem Benutzerobjekt und der Stamm-URL Ihres Shops, keinen erfundenen Kauf. Eine erfolgreiche Probe zeigt, dass die Verbindung funktioniert; echte Käufe oder Attribution testet sie nicht. Löschen Sie den Code nach dem Test.

Fehlgeschlagene Events erneut versuchen setzt berechtigte fehlgeschlagene Kauf- und Formularzeilen auf ausstehend zurück. Zeilen ohne Einwilligung oder gespeicherte Daten, von TikTok endgültig abgelehnte Zeilen und Zeilen mit unklarer Zustellung bleiben unverändert. Prüfen Sie vor der Wiederholung den aufgezeichneten Grund.

Lädt das Pixel nicht, prüfen Sie Aktivierungsstatus, "Pixel ID", Marketing-/Dienst- und Abgleichsberechtigungen, Mitarbeiterrichtlinie, sichere URLs, doppelte SDKs und blockierte Anfragen. Fehlen Warenkorb- oder Wunschlistenereignisse, bestätigen Sie die erwarteten Erfolgssignale in Ihrem Theme.

Fehlen Käufe in der Serverwarteschlange, prüfen Sie, ob Einwilligung und Kennungen des Käufers bei der Bestellvalidierung gespeichert wurden; die Bestätigungsseite kann sie nicht nachträglich ergänzen. Prüfen Sie API-Zugangsdaten, Worker-Läufe und Abgleichskennungen. Lässt sich benutzerdefiniertes JSON nicht speichern, prüfen Sie Namen, reservierte Ereignisse, Auslöserfelder und Regelgrenzen.

Das Modul erstellt weder Produktfeed noch Katalog oder Werbekampagne. Konfigurieren Sie diese bei Bedarf separat.

Setzen Sie "Enable TikTok Pixel" auf Nein und speichern Sie, um diese Integration anzuhalten. Deinstallieren Sie über den Modulmanager, um Menü, Cron-Registrierung und Modulkonfiguration zu entfernen. Die gemeinsame Warteschlangentabelle bleibt bestehen, wenn ein anderes Modul das Konversionspaket verwendet; andernfalls löscht dessen Deinstallationshelfer die Tabelle. Gemeinsame Einwilligungs- und Übermittlungsdaten werden separat verwaltet. Verwalten Sie Pixel und historische Berichte in TikTok.

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