Custom Triggers
Custom Triggers ist ein optionales Modul, mit dem Sie eigene Ereignisse in die window.dataLayer (dieselbe Schicht, die das Modul GA4 DataLayer verwendet) senden können, sobald eine einfache Bedingung im Frontend erfüllt ist. Auf diese Weise können Sie Ereignisse abbilden, die für Ihren Shop spezifisch sind, zum Beispiel den Besuch einer bestimmten Seite oder einen Klick auf eine ausgewählte Schaltfläche, ohne eigenes JavaScript zu schreiben.
Jeder Trigger sendet ein benanntes Ereignis (mit optionalen zusätzlichen Parametern) in dieselbe Datenschicht wie die GA4-Ereignisse. Was danach geschieht (zum Beispiel die Weiterleitung an den Google Tag Manager, Meta Pixel, TikTok oder Matomo), hängt von Ihrer Tag-Konfiguration ab. Dies sind Werkzeuge, die Ihnen helfen, eigene Ereignisse abzubilden, keine Garantie für ein bestimmtes rechtliches oder analytisches Ergebnis.
Aktivierung des Moduls
Section titled “Aktivierung des Moduls”Das Modul ist standardmäßig deaktiviert. Aktivieren Sie es unter WooCommerce > Polski > Module (Modulschlüssel custom_triggers). Nach der Aktivierung und sobald mindestens ein gültiger Trigger definiert ist, lädt das Modul einen leichtgewichtigen Controller im Shop-Frontend. Ist die Trigger-Liste leer, wird kein Skript eingebunden. Der Controller läuft niemals im Administrationsbereich.
So funktionieren Trigger
Section titled “So funktionieren Trigger”Ein Trigger wird im Browser des Besuchers ausgewertet. Es stehen zwei Bedingungstypen zur Verfügung:
| Bedingung | Was das Ereignis auslöst |
|---|---|
page_url | Der aktuelle URL-Pfad oder die Abfrage enthält einen bestimmten Textteil. |
click | Ein Klick auf ein Element, das einem bestimmten CSS-Selektor entspricht. |
Jeder Trigger muss einen Ereignisnamen gesetzt haben, andernfalls wird er übersprungen. Ist der Bedingungstyp nicht auf click gesetzt, behandelt das Modul ihn als page_url.
Trigger-Einstellungen
Section titled “Trigger-Einstellungen”Jede Zeile in der Trigger-Liste wird durch die folgenden Felder beschrieben:
| Feld | Beschreibung |
|---|---|
| Ereignis | Der an dataLayer gesendete Ereignisname. Pflichtfeld, leere Trigger werden übersprungen. |
| Bedingung | page_url oder click. Standard ist page_url. |
| Wert | Der Textteil, der mit dem URL-Pfad/der Abfrage verglichen wird (für die Bedingung page_url). |
| Selektor | Der CSS-Selektor des Elements, dessen Klick das Ereignis auslöst (für die Bedingung click). |
| Kategorie | Die Einwilligungskategorie, die das Ereignis steuert. Standard ist necessary. |
| Parameter | Optionale zusätzliche Ereignisparameter (Schlüssel-Wert-Paare, nur skalare Werte). |
Die Trigger-Liste wird als JSON-codierte Daten in der Option polski_custom_triggers (Schlüssel triggers) gespeichert. Nur skalare Werte werden als Parameter beibehalten, alles andere wird verworfen.
Steuerung über die Einwilligung
Section titled “Steuerung über die Einwilligung”Ein dataLayer-Push ist eine First-Party-Aktion, aber jedem Trigger kann eine Einwilligungskategorie zugewiesen werden. Der Frontend-Controller löst einen kategorisierten Trigger erst aus, wenn der Besucher diese Kategorie erteilt hat (im Einwilligungs-Cookie gespeichert). Trigger in der Kategorie necessary werden immer ausgelöst.
Der Controller prüft die Einwilligung beim Ereignis polskiConsentChange erneut, sodass eine Änderung der Entscheidung des Besuchers (zum Beispiel das Akzeptieren von Marketing im Einwilligungs-Banner) ohne Neuladen der Seite berücksichtigt wird. So können Sie beispielsweise ein Marketing-Konversionsereignis von der Marketing-Einwilligung abhängig machen.
Ist die zugewiesene Kategorie keine gültige Einwilligungskategorie, fällt das Modul auf necessary zurück. Der Cookie-Name, der Ereignisname und die notwendige Kategorie werden aus dem Modul Consent Manager übernommen, sodass die Steuerung über die Einwilligung mit dem Einwilligungs-Banner konsistent bleibt.
Das Modul stellt Werkzeuge bereit, um Ereignisse über die Einwilligung zu steuern, es bietet keine Rechtsberatung und garantiert keine Einhaltung von Vorschriften. Die Klassifizierung von Ereignissen anhand der richtigen Einwilligungskategorie liegt in der Verantwortung des Shop-Betreibers.
Integration mit der Datenschicht
Section titled “Integration mit der Datenschicht”Trigger verwenden dieselbe window.dataLayer wie das Modul GA4 DataLayer. Damit Ereignisse empfangen und weiterverarbeitet werden können, muss diese Datenschicht auf der Seite vorhanden sein. Das Modul selbst sendet die Ereignisse nur in die Schicht, was danach mit ihnen geschieht, entscheidet Ihre Tag- und Analytics-Konfiguration.
Fehlerbehebung
Section titled “Fehlerbehebung”Ereignisse erscheinen nicht im dataLayer - stellen Sie sicher, dass das Modul aktiviert ist, mindestens ein Trigger mit einem Ereignisnamen definiert ist und dass window.dataLayer auf der Seite vorhanden ist (das Modul GA4 DataLayer).
Ein click-Trigger reagiert nicht - überprüfen Sie den CSS-Selektor. Er muss einem Element entsprechen, das auf der Seite existiert.
Ein Trigger mit einer Kategorie außer necessary tut nichts - das Ereignis wird erst gesendet, nachdem die Einwilligung für die zugewiesene Kategorie erteilt wurde. Prüfen Sie die Konfiguration des Consent Managers und die Entscheidung des Besuchers.
Probleme melden: github.com/wppoland/polski/issues