TikTok Pixel — Installation

Wichtiger Hinweis vorab

Dieses Plugin bindet ein Drittanbieter-Skript von TikTok ein und überträgt dabei Ereignisdaten (PageView, ViewContent, AddToCart, CompletePayment) an TikTok — eine Datenübertragung außerhalb der EU. Das Tracking startet ausschließlich nach ausdrücklicher Einwilligung des Besuchers über den JTL Consent Manager und respektiert den Do-Not-Track-Header des Browsers. Ist der JTL Consent Manager nicht aktiviert oder liegt keine Einwilligung vor, wird der TikTok-Pixel gar nicht geladen (Fail-Closed) — es findet dann kein Tracking statt.

Voraussetzungen

• JTL-Shop: Version 5.2.0 oder neuer (getestet bis 5.7.x), NOVA-Template
• PHP: 8.1 oder neuer
• Datenbank: keine eigenen Tabellen, keine Schema-Änderungen
• JTL Consent Manager: muss aktiviert sein; ohne Consent Manager findet kein Tracking statt
• TikTok Ads Manager: eine bestehende TikTok Pixel ID
• Sonstiges: externe Verbindung zum TikTok-Pixel-Skript (Drittanbieter-Domain), keine Cron-Jobs nötig

Installation über den JTL-Extension Store

1. Erwerben Sie die Erweiterung im JTL-Extension Store. Sie wird dadurch mit Ihrer Shop-Lizenz verknüpft.
2. Öffnen Sie im JTL-Shop-Backend Plugins → Meine Erweiterungen. Die Erweiterung erscheint dort nach kurzer Zeit automatisch.
3. Klicken Sie auf Installieren.
4. Aktivieren Sie das Plugin anschließend im Plugin-Manager unter Installiert, falls es nicht bereits aktiv ist.

Alternative: manuelle Installation (ZIP)

1. Öffnen Sie im JTL-Shop-Backend Plugins → Plugin-Manager und wählen Sie den Tab Upload.
2. Laden Sie das Plugin-Paket (ZIP) hoch. Der Ordnername im Archiv (webpowers_tiktok) darf nicht verändert werden.
3. Wechseln Sie zum Tab Vorhanden, wählen Sie TikTok Pixel aus und klicken Sie auf Installieren.
4. Aktivieren Sie das Plugin unter Installiert.

Nach der Installation

Öffnen Sie Installierte Plugins → TikTok Pixel → Einstellungen, aktivieren Sie das Plugin und tragen Sie Ihre TikTok Pixel ID aus dem TikTok Ads Manager ein. Stellen Sie außerdem sicher, dass der JTL Consent Manager aktiv ist und ein Consent-Eintrag für „TikTok Pixel“ existiert — ohne erteilte Einwilligung wird nicht getrackt. Details zu allen Einstellungen finden Sie in der Konfigurationsanleitung unter webpowers.org/docs/jtl-tiktok-pixel/konfiguration.

Deinstallation

Das Plugin kann jederzeit über den Plugin-Manager deinstalliert werden. Es legt keine eigenen Datenbanktabellen an und hinterlässt keine serverseitigen Restdaten.

Support

webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org