Benutzerdefinierte Domänen

Mit benutzerdefinierten Domänen können Sie das Zenovay-Tracking-Skript bereitstellen und von Ihrer eigenen Domäne aus auf Ihr Dashboard zugreifen. Dies kann die Bypass-Raten von Werbeblockern verbessern und ein markenbezogeneres Erlebnis bieten.

Übersicht

Mit benutzerdefinierten Domänen können Sie:

• Tracking-Skript von Ihrer Domäne bereitstellen (z. B. analytics.yourdomain.com)
• Auf Dashboard von einer benutzerdefinierten URL zugreifen (z. B. stats.yourdomain.com)
• Bypass-Raten verbessern durch Vermeidung häufiger Analysisdomänen
• Markenkonsistenz über alle Dienste wahren

Vorteile benutzerdefinierter Domänen

1. Besserer Werbeblocker-Bypass

Werbeblocker blockieren typischerweise Anfragen an bekannte Analysisdomänen wie api.zenovay.com. Die Verwendung Ihrer eigenen Domäne kann die Tracking-Genauigkeit um 10–30 % verbessern.

2. Schnellere Ladezeiten

Das Bereitstellen des Skripts von Ihrer Domäne kann die DNS-Lookups verkürzen und die Seitenladegeschwindigkeit verbessern, besonders wenn Sie diese Domäne bereits nutzen.

3. Markenkonsistenz

Greifen Sie auf Ihre Analysen unter analytics.yourdomain.com zu, anstelle von app.zenovay.com, für ein kohärenteres Markenerlebnis.

4. First-Party-Kontext

Cookies und Speicher von Ihrer Domäne werden als First-Party behandelt, was datenschutzfreundlicher ist und weniger wahrscheinlich blockiert wird.

Arten von benutzerdefinierten Domänen

Tracking-Skript-Domäne

Stellen Sie das Zenovay-Tracking-Skript von Ihrer Domäne bereit.

Beispiel: https://analytics.yourdomain.com/z.js

Anwendungsfälle:

• Werbeblocker-Bypass-Raten verbessern
• DNS-Lookups reduzieren
• First-Party-Skript-Laden

Dashboard-Domäne

Greifen Sie auf Ihr Zenovay-Dashboard von Ihrer Domäne aus zu.

Beispiel: https://stats.yourdomain.com

Anwendungsfälle:

• White-Label-Analysen für Kunden
• Markenkonsistenz
• Benutzerdefinierte Domäne für Team-Zugriff

API-Domäne (nur Enterprise)

Greifen Sie auf die Zenovay-API von Ihrer Domäne aus zu.

Beispiel: https://api-analytics.yourdomain.com

Anwendungsfälle:

• Vollständige White-Label-Lösung
• Strikte CSP-Richtlinien
• API-Rate-Limiting pro Domäne

Einrichtung benutzerdefinierter Domänen

Schritt 1: Wählen Sie Ihre Domäne

Wählen Sie eine Subdomäne für Zenovay:

Empfohlene Subdomänen:

• analytics.yourdomain.com (Tracking-Skript)
• stats.yourdomain.com (Dashboard)
• metrics.yourdomain.com
• insights.yourdomain.com

Schritt 2: Domäne in Zenovay hinzufügen

1. Öffnen Sie Domains, wählen Sie Ihre Website aus und öffnen Sie deren Einstellungen.
2. Klicken Sie auf Add Custom Domain.
3. Geben Sie Ihre Subdomäne ein (z. B. analytics.yourdomain.com).
4. Wählen Sie Domänentyp (Tracking Script / Dashboard / API).
5. Klicken Sie auf Add Domain.

Sie erhalten DNS-Konfigurationsdetails.

Schritt 3: DNS-Einträge konfigurieren

Fügen Sie die folgenden DNS-Einträge zu Ihrem Domain-Anbieter hinzu:

Für Tracking-Skript-Domäne

Fügen Sie einen CNAME-Eintrag hinzu:

Type:  CNAME
Name:  analytics
Value: proxy.zenovay.com
TTL:   3600 (or Auto)

Für Dashboard-Domäne

Fügen Sie einen CNAME-Eintrag hinzu:

Type:  CNAME
Name:  stats
Value: app.zenovay.com
TTL:   3600 (or Auto)

Verifikations-TXT-Eintrag

Fügen Sie einen TXT-Eintrag zur Domänenverifikation hinzu:

Type:  TXT
Name:  _zenovay-verification.analytics
Value: zenovay-verification=abc123xyz...
TTL:   3600 (or Auto)

Schritt 4: SSL-Zertifikat

Zenovay stellt automatisch ein SSL-Zertifikat für Ihre benutzerdefinierte Domäne über Let's Encrypt bereit.

Prozess:

1. DNS-Einträge werden verifiziert
2. SSL-Zertifikat wird angefordert
3. Zertifikat wird ausgegeben (normalerweise innerhalb von 5 Minuten)
4. Automatische Verlängerung alle 90 Tage

Status:

• Pending: DNS-Verifikation läuft
• Issuing: Zertifikat wird generiert
• Active: SSL-Zertifikat installiert und funktioniert
• Failed: Konfigurationsfehler (DNS überprüfen)

Schritt 5: Tracking-Skript aktualisieren

Sobald die Domäne aktiv ist, aktualisieren Sie Ihr Tracking-Skript:

Vorher (Standard-Domäne):

<script src="https://api.zenovay.com/z.js"
        data-tracking-code="YOUR_TRACKING_CODE"
        async></script>

Nachher (benutzerdefinierte Domäne):

<script src="https://analytics.yourdomain.com/z.js"
        data-tracking-code="YOUR_TRACKING_CODE"
        async></script>

Schritt 6: Konfiguration verifizieren

Testen Sie Ihre benutzerdefinierte Domäne:

1. Besuchen Sie https://analytics.yourdomain.com/z.js
2. Überprüfen Sie, dass das Skript ohne Fehler geladen wird
3. Überprüfen Sie SSL-Zertifikat im Browser (Schloss-Symbol)
4. Testen Sie das Tracking auf einer Seite mit dem aktualisierten Skript

DNS-Konfiguration nach Anbieter

Cloudflare

1. Melden Sie sich beim Cloudflare-Dashboard an
2. Wählen Sie Ihre Domäne
3. Gehen Sie zu DNS → Records
4. Klicken Sie auf Add record
5. Fügen Sie CNAME- und TXT-Einträge wie oben gezeigt hinzu
6. Wichtig: Setzen Sie den Proxy-Status auf „DNS only" (graue Wolke)

Google Domains (jetzt Squarespace)

1. Gehen Sie zu My Domains → Wählen Sie Domäne
2. Klicken Sie auf DNS → Manage custom records
3. Klicken Sie auf Create new record
4. Fügen Sie CNAME hinzu:
   • Host name: analytics
   • Type: CNAME
   • Data: proxy.zenovay.com
5. Fügen Sie TXT-Eintrag zur Verifikation hinzu

GoDaddy

1. Melden Sie sich bei Ihrem GoDaddy-Konto an
2. Gehen Sie zu My Products → DNS
3. Klicken Sie auf Add im DNS-Einträge-Abschnitt
4. Wählen Sie CNAME aus der Typ-Dropdown
5. Geben Sie ein:
   • Host: analytics
   • Points to: proxy.zenovay.com
   • TTL: 1 Hour
6. Fügen Sie TXT-Eintrag zur Verifikation hinzu

Namecheap

1. Melden Sie sich bei Namecheap an
2. Domain List → Manage
3. Gehen Sie zur Advanced DNS Registerkarte
4. Klicken Sie auf Add New Record
5. Wählen Sie CNAME Record:
   • Host: analytics
   • Target: proxy.zenovay.com
   • TTL: Automatic
6. Fügen Sie TXT-Eintrag zur Verifikation hinzu

Erweiterte Konfiguration

Benutzerdefinierter Skriptpfad

Ändern Sie den Skriptpfad von /z.js zu einem benutzerdefinierten Pfad:

Beispiel: https://analytics.yourdomain.com/pixel.js

Einrichtung:

1. Öffnen Sie Domains, wählen Sie Ihre Website aus, öffnen Sie deren Einstellungen und suchen Sie dann den Eintrag für die benutzerdefinierte Domäne.
2. Klicken Sie auf Advanced.
3. Geben Sie einen benutzerdefinierten Skriptpfad ein: /pixel.js.
4. Speichern Sie die Änderungen.

Aktualisieren Sie Ihr Script-Tag entsprechend.

Mehrere benutzerdefinierte Domänen

Sie können mehrere benutzerdefinierte Domänen für verschiedene Zwecke hinzufügen:

API-Proxy (nur Enterprise)

Proxying von API-Anfragen über Ihre Domäne:

// Default
fetch('https://api.zenovay.com/e/YOUR_TRACKING_CODE', { ... });

// Custom domain
fetch('https://api.yourdomain.com/e/YOUR_TRACKING_CODE', { ... });

Einrichtung:

1. Fügen Sie API-Benutzerdefinierte Domäne in Einstellungen hinzu
2. Konfigurieren Sie CNAME zu api.zenovay.com
3. Aktualisieren Sie API-Endpunkt in Ihrem Code

Fehlerbehebung

Domänenverifikation fehlgeschlagen

Ursachen:

• DNS-Einträge noch nicht verbreitet (1–24 Stunden warten)
• Falscher CNAME- oder TXT-Eintrag
• Tippfehler im Domänennamen
• DNS-Caching

Lösungen:

1. Überprüfen Sie DNS-Einträge mit dig oder nslookup:

   dig analytics.yourdomain.com CNAME
   dig _zenovay-verification.analytics.yourdomain.com TXT
   

2. DNS-Cache löschen:

   # macOS
   sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
   
   # Windows
   ipconfig /flushdns
   
   # Linux
   sudo systemd-resolve --flush-caches
   

3. Verwenden Sie online DNS-Checker: https://dnschecker.org

SSL-Zertifikat fehlgeschlagen

Ursachen:

• Domäne nicht verifiziert
• Cloudflare-Proxy aktiviert (orange Wolke)
• CAA-DNS-Eintrag blockiert Let's Encrypt
• Rate-Limit erreicht (Let's Encrypt)

Lösungen:

1. Deaktivieren Sie den Cloudflare-Proxy (auf „DNS only" setzen)
2. Überprüfen Sie CAA-Eintrag:

   dig yourdomain.com CAA
   

3. Falls CAA existiert, fügen Sie Let's Encrypt hinzu:

   Type:  CAA
   Name:  @
   Value: 0 issue "letsencrypt.org"
   

4. Warten Sie 1 Stunde und versuchen Sie die Zertifikatausstellung erneut

Skript wird nicht von benutzerdefinierter Domäne geladen

Überprüfen Sie:

1. DNS: Überprüfen Sie, dass CNAME auf das richtige Ziel zeigt
2. SSL: Stellen Sie sicher, dass das Zertifikat aktiv ist (Schloss-Symbol in der Browser-Adressleiste)
3. Skriptpfad: Bestätigen Sie, dass /z.js richtig ist
4. Browser-Konsole: Suchen Sie nach Fehlern
5. CSP: Fügen Sie benutzerdefinierte Domäne zu Content-Security-Policy hinzu

CSP-Header-Beispiel:

Content-Security-Policy: script-src 'self' https://analytics.yourdomain.com;

Dashboard nicht erreichbar

Überprüfen Sie:

1. CNAME-Eintrag zeigt auf app.zenovay.com
2. SSL-Zertifikat ist aktiv
3. Domänenstatus zeigt „Active" in Zenovay-Einstellungen
4. Keine DNS-Caching-Probleme

Test:

curl -I https://stats.yourdomain.com

Sollte 200 OK mit gültigem SSL zurückgeben.

Sicherheitsüberlegungen

SSL/TLS

• Zenovay stellt kostenlose SSL-Zertifikate über Let's Encrypt bereit
• Zertifikate werden alle 90 Tage automatisch verlängert
• TLS 1.2 und 1.3 werden unterstützt
• HSTS ist für alle benutzerdefinierten Domänen aktiviert

DNS-Sicherheit

Aktivieren Sie DNSSEC auf Ihrer Domäne, um DNS-Spoofing zu verhindern:

1. Überprüfen Sie, ob Ihr Registrar DNSSEC unterstützt
2. Aktivieren Sie DNSSEC in Domäneneinstellungen
3. Fügen Sie DS-Einträge zur übergeordneten Zone hinzu

Zugriffskontrolle

Benutzerdefinierte Dashboard-Domänen:

• Beschränken Sie den Zugriff nach IP (nur Enterprise)
• Aktivieren Sie obligatorische 2FA für Team
• Verwenden Sie SSO zur Authentifizierung (nur Enterprise)

Leistungsoptimierung

CDN-Integration

Für globale Leistung verwenden Sie Cloudflare oder ein ähnliches CDN:

1. Richten Sie Cloudflare für Ihre Domäne ein
2. Fügen Sie benutzerdefinierte Domäne zu Zenovay hinzu
3. Konfigurieren Sie CNAME-Einträge
4. Aktivieren Sie „DNS only"-Modus (graue Wolke)
5. Aktivieren Sie optional Cloudflare-Proxy NACH SSL ist aktiv

Caching-Header

Zenovay setzt angemessene Cache-Header für das Skript:

Cache-Control: public, max-age=3600, s-maxage=86400

• Browser-Cache: 1 Stunde
• CDN-Cache: 24 Stunden

HTTP/2 und HTTP/3

Benutzerdefinierte Domänen unterstützen moderne Protokolle:

• HTTP/2 ist standardmäßig aktiviert
• HTTP/3 (QUIC) ist verfügbar
• Server Push für schnelleres Laden

Benutzerdefinierte Domänen entfernen

So entfernen Sie eine benutzerdefinierte Domäne:

1. Aktualisieren Sie Tracking-Skripte, um die Standard-Domäne zu verwenden.
2. Warten Sie 48 Stunden, bis der Cache geleert ist.
3. Öffnen Sie Domains, wählen Sie Ihre Website aus und öffnen Sie deren Einstellungen.
4. Klicken Sie auf ⋮ neben dem Eintrag der benutzerdefinierten Domäne.
5. Wählen Sie Remove Domain.
6. Bestätigen Sie das Entfernen.

DNS-Einträge können nach Abschluss der Entfernung gelöscht werden.

Best Practices

1. Verwenden Sie aussagekräftige Subdomänen: analytics, stats, metrics
2. Testen Sie vor der Bereitstellung: Überprüfen Sie SSL und Laden, bevor Sie Live-Websites aktualisieren
3. Überwachen Sie die Zertifikatverfallzeit: Zenovay erneuert automatisch, aber überwachen Sie auf Probleme
4. Halten Sie DNS-Einträge aktualisiert: Dokumentieren Sie DNS-Änderungen für Ihr Team
5. Verwenden Sie separate Domänen: Verschiedene Subdomänen für Tracking vs. Dashboard

Hilfe erhalten

Für Hilfe bei der Einrichtung benutzerdefinierter Domänen:

• Scale Plan: [email protected]
• Enterprise Plan: [email protected] (Priority-Support)
• DNS-Probleme: Siehe Fehlerbehebungs-Leitfaden