Eigene Domains

Manche Netzwerke und Browser-Erweiterungen blockieren Anfragen an Analytics-Domains von Drittanbietern: Unternehmensfilter, Blocker auf DNS-Ebene, regionale Einschränkungen, Datenschutz-Erweiterungen. Von Ihrer eigenen Subdomain ausgeliefert, ist das Skript eine First-Party-Anfrage auf Ihrer Website und funktioniert in solchen Umgebungen weiter.

Eine eigene Domain ist eine Subdomain, die Sie kontrollieren — etwa metrics.yoursite.com — und die auf die TRACIO-Edge zeigt. Sobald DNS und Zertifikat bestätigt sind, werden das Skript, sein Bundle und die Signalanfragen von dieser Subdomain ausgeliefert. Einen Proxy müssen Sie dafür nicht betreiben.

So läuft die Aktivierung ab

1. Sie fügen die Subdomain im Dashboard hinzu und legen die dort angezeigten A-Records bei Ihrem DNS-Anbieter an.
2. TRACIO erkennt die Records und stellt automatisch ein TLS-Zertifikat für die Subdomain aus.
3. Der erste Besuch einer Seite, die das Skript mit Ihrem Public Key von der Subdomain lädt, aktiviert den Host.

Das Dashboard zeigt diese drei Stufen — die A-Records, das Zertifikat und den ersten Besuch mit Ihrem Schlüssel — und prüft sie automatisch erneut. Check now erzwingt eine erneute Prüfung.

Eigene Domain einrichten

1. Öffnen Sie Get Started und klappen Sie Install the SDK and send your first event auf. Der erste Punkt darin fragt, von wo das Skript geladen wird: Wählen Sie Your own subdomain und tragen Sie sie ein. Derselbe Assistent liegt unter Settings → Custom Hosts.
2. Legen Sie die im Dashboard angezeigten A-Records bei Ihrem DNS-Anbieter an. Liegt Ihre Domain bei Cloudflare, legen Sie sie mit ausgeschaltetem Proxy an (graue Wolke, DNS only): Mit eingeschaltetem Proxy ersetzt Cloudflare die Adressen, und die Anfragen erreichen TRACIO nicht.
3. Warten Sie, bis die Stufen DNS und Zertifikat bestätigt sind. Propagierung und Ausstellung dauern von wenigen Minuten bis zu einigen Stunden.
4. Binden Sie das Snippet auf Ihren Seiten ein. Der erste Besuch mit Ihrem Schlüssel aktiviert den Host.

Wenn Ihre Website bereits über die gemeinsame Domain trackt, stellen Sie das Tag erst um, wenn die Stufen DNS und Zertifikat bestätigt sind: Bis dahin lädt das Skript nicht von der neuen Subdomain.

Snippets

Skript-Tag:

<script src="https://metrics.yoursite.com/s.js?k=PUBLIC_KEY" async></script>

npm-Pakete: Übergeben Sie die Subdomain als endpoint. Das SDK lädt das Skript von ihr und sendet die Signale an sie. Wenn endpoint gesetzt ist, wird die Option region ignoriert. Verwenden Sie dafür nicht scriptUrl: Es ersetzt die gesamte Skript-URL einschließlich des Public Keys.

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "PUBLIC_KEY",
  endpoint: "https://metrics.yoursite.com",
})

Die Framework-Pakete akzeptieren dieselbe Option endpoint — siehe die SDK-Seiten.

Einschränkungen

• Verwenden Sie eine Subdomain, die Sie kontrollieren — etwa metrics.yoursite.com — und die sonst nichts ausliefert.
• Bei Cloudflare müssen die Records DNS only sein (graue Wolke).
• Eine Subdomain, die in einem anderen Workspace aktiv ist, lässt sich nicht hinzufügen.

Nächste Schritte

• Schnellstart — SDK installieren und Ihr erstes Ergebnis auslesen
• Fehlerbehebung — Blockierte Anfragen und Cookie-Probleme