TikTok Pixel Tracking Pro Modul für PrestaShop

Funktionen und Vorteile des TikTok-Pixel-Moduls für PrestaShop

• Implementierung des TikTok Pixels über das PrestaShop-Panel: Es genügt, die TikTok Pixel ID in der Modulkonfiguration anzugeben; der Pixel-Code muss nicht manuell in die Theme-Dateien eingefügt werden.
• Unterstützung der Kaufstrecke: Das Modul erfasst die Ereignisse ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase und CompleteRegistration an den Stellen, an denen die entsprechenden Shop-Daten verfügbar sind.
• Kontrolle über das Kaufereignis: Purchase wird in die Warteschlange gestellt, nachdem die Bestellung in einen von PrestaShop als bezahlt markierten Status übergegangen ist, und nicht bereits beim Start der Zahlung.
• Schutz der Datenqualität des Warenkorbs: AddToCart wird nach einer erfolgreichen Aktualisierung des Warenkorbs gesendet, und die Produktdaten für dieses Ereignis werden aus dem aktuellen Serverstatus abgerufen.
• Anpassung an den TikTok-Katalog: Für Produktereignisse können Produkt-ID, Produkt-ID mit Kombination, Referenz, EAN-13 oder UPC ausgewählt sowie ein gemeinsames Präfix für die Kennungen verwendet werden.
• Optionale TikTok Events API: Das Modul kann bezahlte Käufe zusätzlich serverseitig übermitteln, ohne das standardmäßige Tracking durch das TikTok Pixel im Browser zu deaktivieren.
• Gemeinsame Ereignis-ID: Browserseitiges und serverseitiges Purchase verwenden dieselbe deterministische event_id, um die Deduplizierung beider Versandkanäle zu ermöglichen.
• Konfiguration pro Shop: Im Multistore kann jeder Shop eine eigene Pixel ID, ein eigenes Events-API-Token, einen eigenen Produkttyp-Bezeichner, ein eigenes Präfix und eigene Zustimmungseinstellungen haben.

Wichtigste Funktionen

• Start des Pixels und Aufruf von page: Nach Erfüllung der Konfigurations- und Zustimmungsbedingungen lädt das Modul die TikTok-Pixel-Bibliothek und ruft page auf.
• ViewContent auf der Produktseite: Das Ereignis enthält die ausgewählte Produktkennung, den Preis, die Währung, die Menge und Positionsdaten, die aus dem aktuellen Produkt vorbereitet werden.
• Search auf der Suchseite: Bei einer nicht leeren Suchphrase übermittelt das Modul die Suchanfrage an das Search-Ereignis.
• AddToCart nach Bestätigung der Warenkorbänderung: Das Skript reagiert auf eine erfolgreiche Aktualisierung des PrestaShop-Warenkorbs und ruft die Ereignisdaten über den geschützten Endpunkt des Moduls ab.
• InitiateCheckout und AddPaymentInfo: Das Modul erstellt InitiateCheckout auf unterstützten Checkout-Seiten und AddPaymentInfo nach einer Änderung der standardmäßigen Auswahl der Zahlungsmethode.
• CompleteRegistration: Nach der Kontoerstellung stellt das Modul das Registrierungsereignis in die Warteschlange und übermittelt es auf der nächsten unterstützten Kundenseite.
• Purchase auf der Bestätigungsseite: Das Modul verwendet die Daten der bezahlten Bestellung, einschließlich Positionen, Wert und Währung, und weist dem Ereignis eine deterministische event_id zu.
• CRON-Endpunkt für die Events API: Wenn die Events API konfiguriert ist, stellt das Modul eine durch Token geschützte Adresse bereit, um kurzzeitige Zustellfehler des serverseitigen Purchase erneut zu versuchen.

Marketing-Zustimmung und Advanced Matching

• Optionale Zustimmungs-Schranke: Nach Aktivierung der Anforderung einer Marketing-Zustimmung wird das Pixel nicht geladen, bis die Integration des verwendeten Consent-Managers die bereitgestellte JavaScript-Funktion oder das JavaScript-Ereignis des Moduls aufruft oder die Entscheidung von PD Cookie Pro erkannt wird.
• Integration mit PD Cookie Pro: Das Modul erkennt die signierte Entscheidung aus einem aktiven PD Cookie Pro in Version 1.1.1 oder neuer. Die Zustimmung „all“ erteilt dem Modul die Zustimmung für Tracking und Advanced Matching, wobei die Funktion Advanced Matching selbst weiterhin in der Konfiguration aktiviert werden muss; benutzerdefinierte Gruppen erfordern den Wert ad_storage für Tracking sowie ad_storage und ad_user_data für Advanced Matching.
• Advanced Matching standardmäßig deaktiviert: Nach seiner Aktivierung und dem Erhalt der Marketing-Zustimmung kann das Modul die gültige E-Mail-Adresse sowie die Telefonnummer übermitteln, die bei der Lieferadresse dieses eingeloggten Kunden gespeichert ist, sofern die Nummer bereits im E.164-Format vorliegt.
• Daten in der Events API: Beim serverseitigen Purchase werden E-Mail und Telefonnummer nur dann normalisiert und mit SHA-256 gehasht, wenn Advanced Matching aktiviert ist und die Marketing-Zustimmung gespeichert wurde.
• Technischer Umfang: Das Modul hilft dabei, die Funktionsweise des Pixels entsprechend dem Zustimmungsstatus zu steuern, ersetzt jedoch weder die Konfiguration des Cookie-Banners noch die Datenschutzerklärung oder die Bewertung der rechtlichen Pflichten des Shop-Administrators.

TikTok Events API und Zuverlässigkeit der Übermittlung

• Freiwillige Serververbindung: Das Zugriffstoken für die TikTok Events API ist optional; ohne dieses funktioniert das Ereignis-Tracking über das browserseitige TikTok Pixel weiterhin.
• Nur bezahlte Purchase: Die Events API sendet nicht die vollständige Liste der Browser-Ereignisse; die serverseitige Übermittlung betrifft ausschließlich den bezahlten Kauf.
• Umgang mit Transportproblemen: Kurzzeitige Fehler können per CRON erneut versucht werden, zurückgewiesene Daten oder ungültige Zugangsdaten werden jedoch nicht endlos erneut gesendet.
• Sichere Administrator-Einstellungen: Das Speichern eines neuen Events-API-Tokens kann nach einem Fehler bei den Zugangsdaten gestoppte Zustellungen wieder aufnehmen, und ein Schalter ermöglicht das Entfernen des Tokens und das Stoppen ausschließlich der serverseitigen Übermittlung.

Produktkennungen und TikTok-Katalog

• Auswahl der content_id-Quelle: Verfügbar sind Produkt-ID, Produkt-ID mit Kombination, Referenz, EAN-13 und UPC.
• Präfix für Kennungen: Ein optionales gemeinsames Präfix wird jeder Kennung hinzugefügt, die in Produktereignissen übermittelt wird.
• Kompatibilität mit dem Katalog: Die ausgewählte Kennung und das Präfix sollten exakt den Werten entsprechen, die im TikTok-Produktkatalog verwendet werden. Wenn für die ausgewählte Referenz, EAN-13 oder UPC ein Wert fehlt, überspringt das Modul diese Position, anstatt sie durch eine andere Kennung zu ersetzen.

Kompatibilität und Multistore

• PrestaShop: Das Modul erklärt die Kompatibilität mit PrestaShop von Version 1.7.0.0 bis 9.99.99.
• Multistore: Die Konfiguration erfordert die Auswahl eines konkreten Shops, sodass Tracking-Einstellungen nicht versehentlich zwischen Shops geteilt werden.
• Themes und Checkout: Das Modul verwendet Frontend-Hooks von PrestaShop, unterstützt den Standard-Checkout und erkennt die im Code angegebenen One-Page-Checkout-Controller, darunter TheCheckout, SuperCheckout und OnepageCheckout.