TikTok Pixel Plugin für Shopware

Dokumentation und FAQ

TikTok Tracking Pixel Integration inklusive dynamischer Events und DSGVO-konformes Consent Management. Shopware 5 und Shopware  6 Plugin – geeignet für Multi- und Sprachshops.

 

Dokumentation

Installation

Das Modul installieren und aktivieren:

cd [shopware6 root folder]
php bin/console plugin:refresh
php bin/console plugin:install ZweidigitalTiktokPlugin
php bin/console plugin:activate ZweidigitalTiktokPlugin
php bin/console cache:clear

Das Modul kann aber auch direkt über das Shopware Administrations Panel installiert werden.

Frontend kompilieren:

Mit diesem Shopware 6 Befehl wird das Javascript des Front- und Backends kompiliert:

cd [shopware6 root folder]
./bin/build-js.sh

Dieser Schritt ist zwingend notwendig, damit das Modul funktioniert.

 

Konfiguration

Das Plugin umfasst folgende Konfigurationsmöglichkeiten:

 

  • Verkaufskanal Auswahl
  • TikTok Pixel IDs (Mehrere ID können durch Komma getrennt angegeben werden)
  • Preisübermittlung mit/ohne Versandkosten
  • Brutto-/Netto-Preise übergeben (SW5 only, SW6 orientiert sich an der Shopeinstellung)
  • Artikelidentifikation über Artikelnummer oder interne ID
  •  Datenschutzmodus
    • Shopware Cookie Consent Tool (Opt-in)
    • Shopware Cookie Consent Tool (Opt-out)
    • Opt-In/-Out über externe Lösung (Javascript-Code)
    • Aktiv ohne Hinweis
shopware tiktok pixel konfiguration

Externe Cookie Consent Lösungen

Wird ein anderes Tool für den Consent verwenden, wie z.B. der Google Tag Manager, CookieBot oder Usercentrics, muss das Plugin entsprechend eingestellt werden im Backend. Es können folgende Javascripte zur Aktivivierung/Deaktivierung verwendet werden.

Mit dem diesem JavaScript kann der Pixel manuell gestartet werden (Opt-In):

Shopware 5:

$(document).ready(function () {
$.publish(‚plugins/ZweidigitalTiktokPlugin/remoteEnable‘);
}); 

Shopware 6:

window.addEventListener(‚load‘, function() {
const plugin = PluginManager.getPluginInstanceFromElement(document, ‚ZweidigitalTiktokPlugin‘);
if (typeof plugin === ‚object‘ && typeof plugin.remoteEnable === ‚function‘) {
plugin.remoteEnable();
}
});

  

Mit dem diesem JavaScript kann der Pixel gestoppt werden (Opt-Out):

Shopware 5:

 $.publish(‚plugins/ZweidigitalTiktokPlugin/remoteDisable‘);

 

Shopware 6:

window.addEventListener(‚load‘, function() {

const plugin = PluginManager.getPluginInstanceFromElement(document, ‚ZweidigitalTiktokPlugin‘);
if (typeof plugin === ‚object‘ && typeof plugin.remoteDisable === ‚function‘) {
plugin.remoteDisable();
}
});

 

Bei den meisten Cookie Lösungen von externen Anbietern, wie z.B. CookieBot oder Usercentrics (CMP) muss der oben gezeigte JavaScript Code Teil zwischen < script > Tags gesetzt werden, die bestimmte Attribute erfordern. Das kann im Fall von Usercentrics (CMP) zum Beispiel so aussehen:

<script data-usercentrics=TikTok Pixel type=text/plain> // Hier JavaScript zum Starten des Facebook Pixel’s einfügen </script>

FAQ

Das Modul wurde installiert, aber der Pixel erscheint nicht im Shop?

Der letzte Schritt der Installation, das Kompilieren des Front-/Backends wurde nicht durchgeführt:

cd [shopware6 root folder]
./bin/build-js.sh

Wo finde ich die TikTok Pixel ID?

Zuerst muss ein TikTok Werbekonto angelegt werden.

Als nächstes wird über Element-> Ereignis ein Pixel angelegt.

 

tiktok pixel id finden

Als nächstes wird der Pixel benannt und das manuelle Setup gewählt.

 

tiktok pixel anlegen

WICHTIG! Im folgenden Schritt muss „Developer Mode“ gewählt werden.

 

tiktok pixel developer mode

Jetzt muss nur bestätigt werden und die Pixel ID kann direkt unter dem Pixel-Namen kopiert werden.

tiktok pixel developer mode

Welche Events werden mit dem Plugin erfasst?

  • Page View
  • View Content
  • Add To Cart
  • Place an order
  • Initiate Checkout
  • Add Billing
  • Complete Payment
  • User registration
  • Search

Erfasste Parameter der Events:

  • content_type
  • contents
  • content_id
  • content_category
  • content_name
  • currency
  • value
  • quantity
  • price
  • query

Wie kann ich prüfen ob das Tracking funktioniert?

Hierfür gibt es zwei Möglickeiten:

1. im Werbekonto auf den Pixel klicken und die Event Statistik überprüfen  alternativ auf Test Events klicken und die Events direkt am Handy auslösen.

Tiktok Pixel event testen

 

2. Den TikTok Pixel Helper nutzen, um Events direkt im Browser zu sehen, wenn sie ausgelöst werden. (Achtung, der Pixel Helper funktioniert manchmal nicht richtig, die verlässlichste Kontrolle ist daher über das TikTok Konto.)

 

Im TikTok Pixel Helper sehe ich nicht alle Events

Der Pixel Helper funktioniert nicht immer zuverlässig, die beste Methode zur Kontrolle ist daher direkt über das TikTok Werbekonto.

 

Facebook Ads Agentur Beratung

TikTok Ads Expertise

Wir sind Experten im Social Ads Bereich, gerne unterstützen wir dich bei der Einrichtung und Schaltung von TikTok Ads.

Kostenlose Beratung Anfordern

Lass uns darüber sprechen, welche Marketingmaßnahmen für dein Unternehmen sinnvoll sind.

Kostenlose Beratung Anfordern

Lass uns darüber sprechen, welche Marketingmaßnahmen für dein Unternehmen sinnvoll sind.