Hilfe › Skript einbinden
Skript einbinden
Das Skript ist wenige Kilobyte groß, lädt asynchron und braucht keinen Schlüssel. Ihre Website wird an der Domain erkannt, die Sie in der Verwaltung hinterlegt haben.
WordPress und WooCommerce: Plugin
- Im WordPress-Admin unter Plugins, Installieren, „Plugin hochladen“ die ZIP-Datei wählen.
- Installieren und aktivieren. Fertig.
Das Plugin tut genau eine Sache: Es lädt das Snippet auf allen Seiten, nicht im Admin und nicht im Customizer. Es gibt keine Einstellungen im WordPress-Admin, alles wird unter churnreturn.com eingestellt. Ein Produktfeed kommt aus WooCommerce, einem Feed-Plugin oder Ihrem Affiliate-Netzwerk.
Direkt im Quelltext
Eine Zeile vor </body> im Template, das auf allen Seiten geladen wird, meist Footer oder Layout:
<script src="https://churnreturn.com/cr.js" async></script>
Mehr ist nicht nötig. Das Skript holt sich die Konfiguration der Website, prüft Status und URL-Regeln und wartet auf einen Trigger.
Über den Google Tag Manager
Am einfachsten mit unserer Tag-Vorlage: Vorlage herunterladen
- Im Tag Manager unter Vorlagen, Tag-Vorlagen, Neu, Menü oben rechts, Importieren die heruntergeladene Datei wählen und speichern.
- Tags, Neu, Tag-Typ ChurnReturn, Aktion „Snippet laden“.
- Trigger All Pages.
- Vorschau prüfen, veröffentlichen.
Die Vorlage kennt zwei weitere Aktionen: „Einwilligung melden“ für einen Tag, der auf das Consent-Ereignis Ihres Cookie-Tools feuert, und „Eigenen Trigger auslösen“ für Shop-Ereignisse wie den Warenkorb. Sobald die Vorlage in der Galerie des Tag Managers freigegeben ist, finden Sie sie dort unter „ChurnReturn“.
Ohne Vorlage geht es auch als Tag vom Typ Benutzerdefiniertes HTML mit der Skriptzeile von oben und dem Trigger All Pages.
Einwilligung über den Tag Manager: Im Standardmodus speichert das Skript nichts und darf immer feuern. Wenn Ihr Consent-Tool zustimmt, melden Sie das mit einem zweiten HTML-Tag, dessen Trigger das Consent-Ereignis ist:
<script>window.ChurnReturn && ChurnReturn.consent(true);</script>
Soll das Skript erst nach Zustimmung laden, geben Sie dem Haupt-Tag unter „Einwilligungseinstellungen“ eine Anforderung wie analytics_storage. Nötig ist das nicht, manche Datenschutzkonzepte wollen es aber so.
Shopsysteme
| System | Wo die Zeile hin gehört |
|---|---|
| Shopware 6 | Erweiterung „Custom Code“ oder Theme-Template base.html.twig, Block base_body_script; alternativ Tag Manager |
| Shopify | Onlineshop, Themes, Code bearbeiten, theme.liquid vor </body> |
| WooCommerce | Theme-Datei footer.php oder ein Plugin für Header/Footer-Skripte |
| Magento 2 | Inhalt, Konfiguration, Design, HTML-Fußzeile |
| JTL-Shop | Einstellungen, Global, „Fußbereich Skripte“ oder das Template |
| OXID eShop | Im aktiven Theme das Basis-Template vor </body> (OXID 6: layout/base.tpl, OXID 7: layouts/base.html.twig); wer das Theme nicht anfassen will, nimmt den Tag Manager |
| plentymarkets | plentyShop LTS: Plugin-Einstellungen, Bereich für eigene Skripte im Footer, oder das Google-Tag-Manager-Plugin mit unserer Vorlage |
| Gambio | Im aktuellen Template die Footer-Datei (StyleEdit bzw. Theme-Ordner) vor </body>, alternativ das Tag-Manager-Modul von Gambio |
| Alle anderen | Überall dort, wo Sie auch Analytics oder Tracking-Pixel einfügen |
Testen, bevor es jemand sieht
Solange die Website im Status Preview ist, erscheint das Overlay nur auf Adressen mit ?cr_preview, zum Beispiel https://shop.example.de/produkt/xyz?cr_preview. Öffnen Sie die Browser-Konsole: Das Skript meldet dort, welche Konfiguration geladen wurde und warum ein Trigger nicht feuert.
Was zu beachten ist
- Content-Security-Policy: Falls Ihre Seite eine hat, muss
https://churnreturn.comunterscript-srcundconnect-srcerlaubt sein. - Nur einmal einbinden: Wer das Skript im Quelltext hat, braucht keinen Tag im Tag Manager. Doppelte Overlays verhindert das Skript, doppeltes Laden nicht.
- Mehrere Domains: Jede Domain ist eine eigene Website in der Verwaltung, die Zeile ist überall dieselbe.
- Staging: Legen Sie die Staging-Domain als eigene Website an, dann testen Sie dort mit eigenen Einstellungen.
Weiter: Trigger und Regeln →