Proxy einrichten

Adblocker und Privacy-Tools blockieren häufig Anfragen an bekannte Analytics- und Tracking-Domains. Wenn Sie usertrax über Ihre eigene Domain routen (First-Party-Proxy), sehen Tracking-Anfragen wie normaler Traffic Ihrer Website aus.

Empfohlene Anleitung

Was wird geproxied?

Sie müssen zwei Endpunkte proxien:

Pfad auf Ihrer Domain	Proxied zu	Zweck
`/cvs.js`	`https://usertrax.io/cvs.js`	Tracking-Script
`/api/usertrax/events`	`https://api.usertrax.io/api/events`	Session- und Conversion-Events

Wir empfehlen /api/usertrax/events statt /api/events, um Konflikte mit eigenen API-Routen zu vermeiden. Sie können jeden Pfad verwenden — setzen Sie denselben Wert in usertraxConfig.endpoint. Einige Filterlisten blockieren Pfade, die „usertrax“ enthalten; wer das vermeiden will, nimmt neutrale Pfade wie /p/c.js und /p/e.

Script-Tag anpassen

Nach dem Proxy-Setup laden Sie das Script von Ihrer Domain und zeigen Events auf den geproxied Endpunkt:

<script>
  window.usertraxConfig = {
    endpoint: "/api/usertrax/events",
  };
</script>
<script src="/cvs.js" data-key="IHR_API_SCHLÜSSEL" defer></script>

data-key bleibt unverändert. Der Proxy muss den Header X-Auth-Key an api.usertrax.io weiterleiten.

Besucher-IP weitergeben

Hinter einem Proxy kommen alle Events von der IP Ihres Servers. Damit usertrax die echte IP der Besucher:innen speichert (wichtig u. a. für den Abgleich in der Meta Conversions API und für das Rate-Limit), setzt der Proxy den Header X-Usertrax-Client-Ip auf die IP der Besucher:in. usertrax übernimmt den Wert nur zusammen mit einem gültigen X-Auth-Key.

Läuft Ihre Seite hinter einem CDN oder Load Balancer, ist $remote_addr bzw. request.ip dessen IP. Nehmen Sie dann den Header des CDN, z. B. CF-Connecting-IP bei Cloudflare, oder konfigurieren Sie die vertrauenswürdigen Proxies Ihres Frameworks.

Verifizierung

Besuchen Sie Ihre Live-Website
Öffnen Sie den Network-Tab in den DevTools
Prüfen Sie, dass cvs.js von Ihrer Domain geladen wird (nicht usertrax.io)
Prüfen Sie, dass POST-Requests an /api/usertrax/events auf Ihrer Domain gehen
Kontrollieren Sie im usertrax Dashboard neue Sessions und Conversions

Fehlerbehebung

401 Unauthorized bei Event-Requests

Ihr Proxy leitet den Header X-Auth-Key nicht weiter. Stellen Sie sicher, dass der Header an api.usertrax.io durchgereicht wird.

Events werden weiterhin blockiert

Vermeiden Sie offensichtliche Pfade wie /tracking/ oder /analytics/
Nutzen Sie neutrale Pfade wie /cvs.js und /api/usertrax/events
Bei Content Security Policy: script-src und connect-src für Ihre eigene Domain erlauben

Script lädt, aber keine Conversions

Prüfen Sie, dass usertraxConfig.endpoint exakt mit Ihrem geproxied Events-Pfad übereinstimmt (inkl. führendem Slash).