Cloudflare Zaraz

Verwenden Sie Cloudflare Zaraz, um Zenovay Analytics zu installieren, ohne den Quellcode Ihrer Website zu verändern. Zaraz verlagert Drittanbieter-Skripte an den Edge, wodurch das Hinzufügen von Analytics nahezu keine Auswirkung auf Ihre Ladezeit hat.

---

Warum Zaraz?

Zaraz ist das Tag-Management-Produkt von Cloudflare. Im Gegensatz zu klassischen clientseitigen Tag-Managern bietet Zaraz:

• Ausführung am Edge — das Tracking-Skript wird von Cloudflares Netzwerk eingefügt, nicht von einem fremden CDN.
• Keine Render-Blockierung — keine Auswirkung auf Core Web Vitals (LCP, INP).
• Consent-Unterstützung über den integrierten Consent Manager (funktioniert auch mit Zenovays Cookieless-Modus).
• Kein Build-Schritt — Custom-HTML-Snippet einfügen, speichern, fertig.

Zaraz ist in jedem Cloudflare-Tarif enthalten, auch im kostenlosen.

---

Installation per Custom HTML (Empfohlen)

Dauer: ca. 3 Minuten

Schritt 1 — Zaraz öffnen

1. Im Cloudflare-Dashboard einloggen
2. Das Konto auswählen, zu dem Ihre Zone gehört (Zaraz wird auf Konto-Ebene konfiguriert, nicht pro Zone)
3. In der linken Seitenleiste Tag Management aufklappen → Zaraz anklicken

Oder Zaraz direkt öffnen — der Platzhalter :account wird automatisch zum gerade ausgewählten Cloudflare-Konto aufgelöst.

Schritt 2 — Custom-HTML-Tool hinzufügen

1. Auf Add new tool klicken
2. Im Katalog zu Custom Code scrollen und Custom HTML auswählen
3. Dem Tool einen Namen geben: Zenovay Analytics

Schritt 3 — Tracking-Snippet einfügen

Im HTML-Feld einfügen:

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

Schritt 4 — Trigger konfigurieren

Setzen Sie den Firing Trigger auf Pageview.

• Firing Trigger: Pageview (erforderlich)
• Blocking Triggers: leer lassen
• Match: Alle Seiten (kein Filter)

Schritt 5 — Speichern und veröffentlichen

1. Auf Save klicken
2. Zaraz veröffentlicht sofort — kein separater Deploy-Schritt

Öffnen Sie Ihre Website in einem neuen Tab. Innerhalb einer Minute erscheint der erste Visitor im Zenovay-Dashboard.

---

Cookieless-Modus

Zenovays Cookieless-Modus funktioniert auch in Zaraz. Das Snippet in Schritt 3 ersetzen durch:

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  data-cookieless="true"
  src="https://api.zenovay.com/z.js">
</script>

Mit data-cookieless="true" schreibt Zenovay keine Cookies und kein localStorage. Das passt natürlich zur Edge-Ausführung von Zaraz: der Browser des Besuchers erhält nie ein Tracking-Cookie, was ePrivacy / TDDDG / FMG Art. 45c standardmäßig erfüllt.

---

Custom Events

Zaraz kann window.zenovay() direkt aus jeder Zaraz-Action aufrufen. So senden Sie ein eigenes Event:

1. In Zaraz Custom HTML öffnen → ein zweites Tool hinzufügen (oder das bestehende bearbeiten)
2. Folgendes Snippet-Muster verwenden:

<script>
  if (window.zenovay) {
    window.zenovay('track', 'signup', { plan: 'pro' });
  }
</script>

3. Den Trigger auf Ihr benutzerdefiniertes Zaraz-Event setzen (z. B. einen Click-Trigger auf den Signup-Button)

Alle verfügbaren Event-Helfer finden Sie unter Custom Events.

---

Consent-Modus (DSGVO / ePrivacy)

Wenn Sie den eingebauten Consent Manager von Zaraz verwenden:

1. Zenovay-Tool öffnen → Tab Consent
2. Consent Purpose auf Analytics setzen (oder die von Ihren Besuchern bestätigte Kategorie)
3. Speichern

Lehnen Ihre Besucher die Analyse-Zustimmung ab, feuert Zaraz das Zenovay-Tool nicht. Wenn Sie ganz ohne Consent-Banner arbeiten möchten, aktivieren Sie den Cookieless-Modus oben — Zenovay läuft dann rechtskonform unter ePrivacy Art. 5(3) ohne Zustimmung.

---

First-Party-Proxy (Adblocker-Umgehung)

Wenn Sie einen First-Party-Proxy auf Ihrer eigenen Subdomain eingerichtet haben (z. B. analytics.ihredomain.com), ändern Sie die src im Zaraz-Snippet auf Ihre Proxy-URL:

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://analytics.ihredomain.com/z.js">
</script>

Da Zaraz für Ihre Zone bereits am Edge läuft, ergibt die Kombination mit einem First-Party-Proxy maximale Adblocker-Resistenz.

---

SPA-Unterstützung (React, Next.js, Vue, Angular)

Das Zenovay-Tracking-Skript erkennt Routenwechsel in Single-Page-Anwendungen automatisch. Keine zusätzlichen Zaraz-Trigger nötig — der Standard-Pageview-Trigger reicht aus.

---

Installation prüfen

Nach der Veröffentlichung in Zaraz lässt sich die Installation am einfachsten so prüfen:

1. Ihre Website in einem Inkognito- / Privatfenster öffnen
2. Entwicklertools öffnen → Tab Network
3. Nach zenovay filtern
4. Seite neu laden

Sie sollten eine Anfrage an https://api.zenovay.com/z.js (Tracker-Bundle) und mindestens eine Anfrage an /api/track/... (Pageview-Event) sehen. Beide sollten mit HTTP 200 antworten.

Im Zenovay-Dashboard wechselt die Karte Setup → Installation Ihrer Domain innerhalb von ca. 30 Sekunden nach dem ersten Event auf "Verified".

---

Fehlerbehebung

---

Performance-Auswirkung

Da Zaraz das Skript am Cloudflare-Edge einfügt — bevor das HTML an den Browser des Besuchers gesendet wird — wird der Tracker behandelt, als gehöre er zum Origin Ihrer Seite. Es gibt kein Drittanbieter-DNS, keinen zusätzlichen TLS-Handshake und keinen renderblockierenden externen Request.

Auf einer typischen Seite entfernt der Wechsel von einem direkt im <head> eingefügten Zenovay-Tracker zu einem über Zaraz injizierten Tracker einen DNS-Lookup (ca. 20–60 ms) und einen TLS-Handshake (ca. 80–200 ms) aus dem kritischen Pfad.

---

Weiterführende Ressourcen

• Referenz Tracking-Skript
• Custom Events
• Datenschutz-Konformität
• First-Party-Tracking
• Google Tag Manager — alternativer Tag-Management-Weg
• Cloudflare-Zaraz-Dokumentation (extern)

---

Hilfe benötigt? Schreiben Sie an [email protected] oder besuchen Sie unser Help Center.