Wenn Sie das Tracking auf Ihrer eigenen Domain halten und Ad-Blocker-Verluste reduzieren möchten, ist der Weg bei Zenovay ein First-Party-Proxy — eine Subdomain auf Ihrer eigenen Domain, die Tracking-Anfragen an Zenovay weiterleitet, sodass der Browser nur mit Ihrer Domain spricht.
Es gibt zwei verschiedene Dinge, die Menschen mit "Server-seitiges GTM" bei Zenovay meinen. Dieser Artikel behandelt beide und ist klar darüber, was jedes kann und nicht kann.
Information
Zenovay veröffentlicht KEINE Google Tag Manager Server-Container-Client-Vorlage. Die Zenovay-GTM-Vorlage ist eine Standard-Web-Container-Tag-Vorlage, die den Tracker (z.js) auf der Seite von https://api.zenovay.com lädt. Die GTM-Vorlage KANN nicht auf einen First-Party-Proxy verwiesen werden — die Loader-URL ist festgelegt. Wenn Sie einen First-Party-Proxy wünschen, installieren Sie den Tracker manuell (mit data-api-url), anstatt die GTM-Vorlage zu verwenden — siehe First-Party-Tracking. Wenn Sie GTM ganz überspringen möchten, können Sie Ereignisse direkt an den Tracking-Endpoint senden — siehe Server-seitiges Tracking.
Option A — Deployment über die Zenovay-GTM-Vorlage
Dies ist der No-Code-Weg. Das Tag lädt z.js direkt von https://api.zenovay.com. Es wird NICHT über einen Proxy geroutet — wenn Ad-Blocker-Bypass Ihr Ziel ist, verwenden Sie stattdessen Option B.
Schritt 1 — Zenovay-GTM-Vorlage hinzufügen
- In Google Tag Manager (Ihr Web-Container) gehen Sie zu Templates → Tag-Vorlagen → Galerie durchsuchen.
- Suchen Sie nach Zenovay und fügen Sie Zenovay Analytics zu Ihrem Workspace hinzu. (Wenn es noch nicht in der Galerie ist, können Sie stattdessen
template.tplaus dem Zenovay-GTM-Template-Repository importieren.) - Klicken Sie auf Zum Workspace hinzufügen.
Schritt 2 — Das Tag konfigurieren
- Tags → Neu → Zenovay Analytics (unter Benutzerdefiniert).
- Einstellungen (die Vorlage hat genau diese vier Felder):
- Tracking-Code — fügen Sie Ihren Zenovay-Tracking-Code ein (von Einstellungen → Allgemein auf dem Dashboard Ihrer Website).
- Cookieless-Modus — optional. Siehe Cookieless-Modus unten.
- Ausgehende Links verfolgen — optional; verfolgt automatisch Klicks auf externe Domains.
- Debug-Modus — optional; ausführliches Console-Logging. Schalten Sie es vor der Veröffentlichung aus.
- Legen Sie den Trigger auf Alle Seiten fest.
- Speichern → Absenden → Veröffentlichen.
Information
Das Zenovay-Skript erkennt SPA-Routenänderungen über die History API, daher ist der Trigger Alle Seiten alles, was Sie brauchen — kein separater History-Change-Trigger erforderlich.
Schritt 3 — Überprüfung
- Öffnen Sie einen echten Besuch auf Ihrer Site.
- Im GTM-Vorschau-Modus bestätigen Sie, dass das Zenovay-Analytics-Tag auf der Seite ausgelöst wird.
- DevTools → Netzwerk → nach
z.jsfiltern — Sie sollten es vonapi.zenovay.comgeladen sehen. - Öffnen Sie im Dashboard Ihrer Website die Registerkarte Live-Ansicht — der Besuch sollte innerhalb weniger Sekunden angezeigt werden.
Option B — First-Party-Proxy (Ad-Blocker-Bypass)
Ein First-Party-Proxy hält das Tracking auf Ihrer eigenen Domain. Es fügt operativen Overhead hinzu — Sie führen einen kleinen Reverse-Proxy auf einer Subdomain Ihrer eigenen Domain aus und verwalten ihn. Es lohnt sich, wenn:
- Sie sehen bedeutsame Adblock-bedingte Datenverluste und wünschen eine First-Party-Domain-Lieferung.
- Ihr Security- / Legal-Team verlangt, dass alle Drittanbieter-HTTP-Anfragen von Ihrem eigenen Ursprung bereitgestellt werden.
Wenn keines von beiden zutrifft, ist der reguläre Client-seitige Tracker (Option A oder ein einfaches Snippet) einfacher. First-Party-Proxying ist auf allen Plänen verfügbar.
Information
Die GTM-Vorlage kann das nicht — ihre Loader-URL ist auf api.zenovay.com festgelegt. Der Proxy benötigt das manuelle Tracking-Snippet, wo Sie den src und data-api-url kontrollieren. Diese Option verwendet also nicht die Zenovay-GTM-Vorlage.
Funktionsweise
Browser → https://analytics.example.com → https://api.zenovay.com
(Ihr First-Party-Proxy)
Der Browser sieht nur analytics.example.com (Ihre Domain). Ihr Proxy ruft z.js von Zenovay ab und leitet Tracking-Anfragen an Zenovay weiter.
Schritt 1 — First-Party-Proxy aufstellen
Erstellen Sie eine Subdomain auf Ihrer eigenen Domain (z. B. analytics.example.com) und konfigurieren Sie sie, um zu https://api.zenovay.com zu reverse-proxien. Die genauen Schritte hängen von Ihrem Stack ab (Cloudflare, nginx, Cloud Run / Serverless-Funktion usw.) — der Leitfaden First-Party-Tracking führt durch die Optionen.
Der Proxy muss:
z.jsbereitstellen (vonhttps://api.zenovay.com/z.jsweitergeleitet).- Tracking-Anfragen an Zenovay weiterleiten, wobei die echte IP des Besuchers über
X-Forwarded-Forübergeben wird, damit die Länder- / Stadterkennung auf Zenovay-Seite noch funktioniert.
Schritt 2 — Tracking-Snippet auf Ihren Proxy zeigen
Installieren Sie den Tracker manuell (nicht über die GTM-Vorlage), mit src und data-api-url auf Ihre Proxy-Subdomain eingestellt:
<script
defer
src="https://analytics.example.com/z.js"
data-tracking-code="YOUR_TRACKING_CODE"
data-api-url="https://analytics.example.com"
></script>
Sie können dieses Snippet weiterhin über GTM platzieren, wenn Sie möchten — verwenden Sie stattdessen ein Custom HTML-Tag mit dem Trigger Alle Seiten.
Schritt 3 — Ende-zu-Ende-Überprüfung
- Öffnen Sie einen echten Besuch auf Ihrer Site.
- DevTools → Netzwerk → nach
analytics.example.comfiltern — Sie solltenz.jsgeladen sehen und Tracking-Anfragen über Ihre Proxy-Domain geroutet. - Öffnen Sie im Dashboard Ihrer Website die Registerkarte Live-Ansicht — der Besuch sollte innerhalb weniger Sekunden angezeigt werden.
Cookieless-Modus
Sie können jede Methode Cookieless ausführen. Aktivieren Sie in der GTM-Vorlage den Cookieless-Modus; mit einem manuellen Snippet fügen Sie data-cookieless="true" hinzu. Im Cookieless-Modus verwendet der Tracker nur speicherinterne, fenstergebundene IDs — es werden keine Cookies geschrieben, weder auf der Seite noch über einen Proxy.
Planverfügbarkeit
Sowohl die GTM-Vorlage als auch der First-Party-Proxy funktionieren auf allen Plänen, einschließlich Free. Nachverfolgte Ereignisse zählen zur Monatsbudget Ihres Plans auf die gleiche Weise, unabhängig davon, wie der Tracker geladen wird.