TikTok Pixel und Events API für PrestaShop | PrestaDev
TikTok Pixel und Events API für PrestaShop | PrestaDev

TikTok Pixel Tracking Pro Modul für PrestaShop

Module version: 1.3.0

PrestaShop compatibility: 1.7.x 8.x 9.x

Moduldatei aktualisiert: 2026-10-10 18:39:51

Produktdaten aktualisiert: 2026-10-10 18:40:04


TikTok Pixel Tracking Pro ist ein PrestaShop-Modul zur Implementierung des TikTok Pixel in einem Onlineshop. Nach dem Speichern der Pixel-ID lädt das Modul den TikTok-Code und verarbeitet Standardereignisse auf Produkt-, Such-, Warenkorb-, Checkout- und Bestellbestätigungsseiten. Es erfasst ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase sowie CompleteRegistration, wobei Purchase ausschließlich für eine Bestellung vorbereitet wird, die in PrestaShop den Status bezahlt erreicht hat. Die optionale TikTok Events API kann bezahlte Käufe vom Server mit derselben event_id übermitteln, die auch vom Browser-Ereignis verwendet wird. Der Administrator wählt eine mit dem TikTok-Katalog kompatible Produktkennung aus und kann ein Präfix hinzufügen. Das Modul ermöglicht außerdem die Aktivierung einer Marketing-Einwilligungsabfrage und des optionalen Advanced Matching. Die Einstellungen werden in der Multistore-Umgebung für jeden Shop separat gespeichert.

Lizenztyp / Aktualisierung
119,00 zł
96,75 złnetto
Price history:

Beschreibung

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.

Produktdetails

Unterstützung für Prestashop 9.x
Ja
Unterstützung für Prestashop 8.x
Ja
Unterstützung für Prestashop 1.7.x
so
Modulübersetzungen
PL. DE
Kostenloser Support
so
Kostenlose Updates (1 Jahr)
so
Einfache Installation
so
PDTTP-FULL

Das könnte Ihnen auch gefallen

Changelog

Release history for this product. Expand an entry to see what changed.

  • dodano obsługę content API TIkTok-a

FAQ

Find answers to the most common questions about this product.

Das Modul implementiert das TikTok Pixel im PrestaShop-Shop und sendet Ereignisse im Zusammenhang mit dem Kundenverhalten sowie dem Kaufpfad. Nach der Konfiguration der TikTok Pixel ID unterstützt es, sofern die Einwilligungseinstellungen dies zulassen, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase und CompleteRegistration. Das Modul erstellt keinen TikTok-Produktkatalog, keine Werbekampagnen und keine Berichte im TikTok Ads Manager-Dashboard.

Das Modul lädt das TikTok Pixel und ruft Page auf sowie ViewContent auf der Produktseite, Search auf der Suchseite, AddToCart nach erfolgreicher Aktualisierung des Warenkorbs, InitiateCheckout auf der unterstützten Checkout-Seite, AddPaymentInfo nach Änderung der standardmäßigen Zahlungsauswahl, Purchase für die bezahlte Bestellung sowie CompleteRegistration nach der Kontoerstellung.

Geben Sie in der Modulkonfiguration die TikTok Pixel-ID ein, wählen Sie den Typ der Produktkennung und gegebenenfalls das Präfix aus. Sie können auch Advanced Matching, die Anforderung der Marketingeinwilligung sowie optional den Token der TikTok Events API aktivieren. Die Pixel-ID sollte aus dem TikTok Ads Manager stammen; in das Feld darf kein JavaScript-Code eingefügt werden.

Ja, die TikTok Events API ist eine optionale Funktion, die nach dem Speichern des Zugriffstokens aktiviert wird. Das Modul sendet über die API ausschließlich das bezahlte Purchase-Ereignis; die übrigen Standardereignisse werden vom TikTok Pixel im Browser verarbeitet. Das Deaktivieren oder Entfernen des Tokens stoppt nur die serverseitige Übermittlung, nicht jedoch die grundlegende Funktion des Pixels.

Wenn für eine bestimmte bezahlte Bestellung beide Kanäle verwendet werden, erstellt das Modul eine deterministische event_id. Dieselbe event_id wird an das browserseitige Purchase und an das serverseitige Purchase gesendet, das über die TikTok Events API übermittelt wird, was die Deduplizierung beider Versandkanäle ermöglicht.

Der Kauf wird erst dann in die Warteschlange gestellt, wenn die Bestellung den von PrestaShop als bezahlt gekennzeichneten Status erreicht. Auf der Bestätigungsseite kann das Modul das Ereignis im Browser übermitteln, und bei konfigurierter Events API kann es dieses auch vom Server senden. Im Falle einer verzögerten Zahlungsbestätigung führt die Bestätigungsseite eine eingeschränkte erneute Überprüfung des ausstehenden Kaufs durch.

Ja. Der Schalter für die Anforderung der Marketingeinwilligung ist optional und standardmäßig deaktiviert. Nach seiner Aktivierung wartet das Pixel auf ein Signal, das von der Integration des Einwilligungsmanagers über die bereitgestellte Funktion oder das JavaScript-Ereignis des Moduls übermittelt wird, oder auf die Entscheidung des aktiven PD Cookie Pro. Dies ist eine technische Verarbeitung des Einwilligungsstatus und weder ein eigenständiges CMP-System noch eine Garantie für die rechtliche Konformität.

Die Integration erfordert ein aktives PD Cookie Pro in Version 1.1.1 oder neuer sowie eine korrekt signierte Einwilligungsentscheidung. Die Entscheidung „all“ erteilt die Einwilligung für Tracking und Advanced Matching, wobei Advanced Matching zusätzlich in der Modulkonfiguration aktiviert sein muss. Bei eigener Auswahl der Gruppen erfordert das Tracking den Wert ad_storage, und Advanced Matching gleichzeitig ad_storage und ad_user_data.

Advanced Matching ist standardmäßig deaktiviert. Nach seiner Aktivierung und dem Speichern der Marketingeinwilligung kann das Modul für den angemeldeten Kunden die korrekte E-Mail-Adresse und Telefonnummer an das browserseitige Pixel übermitteln, aber die Telefonnummer wird nur verwendet, wenn sie bei der Lieferadresse dieses Kunden vorhanden ist und bereits das E.164-Format hat. In der serverseitigen Events API werden E-Mail und Telefonnummer normalisiert und mit SHA-256 gehasht.

Wählen Sie in der Konfiguration eine Quelle für die content_id aus: Produkt-ID, Produkt-ID mit Kombination, Referenz, EAN-13 oder UPC. Sie können auch ein Präfix hinzufügen. Der ausgewählte Wert muss genau mit der Kennung im TikTok-Katalog übereinstimmen; wenn das Produkt für die ausgewählte Referenz, EAN-13 oder UPC keinen Wert hat, überspringt das Modul diese Position, anstatt sie durch die Produkt-ID zu ersetzen.

CRON wird für den browserbasierten TikTok Pixel nicht benötigt. Wenn die Events API konfiguriert ist, stellt das Modul eine durch Token geschützte CRON-Adresse bereit, um kurzzeitige Zustellungsfehler des serverseitigen Purchase erneut zu versuchen; das Konfigurationspanel empfiehlt, diese alle fünf Minuten auszuführen.

Ja. Die Einstellungen des Moduls werden für jeden Shop separat gespeichert, daher muss im Multistore-Modus vor der Konfiguration ein konkreter Shop ausgewählt werden. Im Code des Moduls wurde die Kompatibilität mit PrestaShop von Version 1.7.0.0 bis 9.99.99 deklariert.

Bewertungen (0)

Keine Bewertungen