Eigen domeinen

Sommige netwerken en browserextensies blokkeren verzoeken aan analytics-domeinen van derden: bedrijfsfilters, blockers op DNS-niveau, regionale beperkingen, privacy-extensies. Geserveerd vanaf je eigen subdomein is het script een first-party-verzoek op je site en blijft het werken in zulke omgevingen.

Een eigen domein is een subdomein dat je zelf beheert, zoals metrics.yoursite.com, dat naar de TRACIO-edge wijst. Zodra DNS en het certificaat zijn bevestigd, worden het script, de bijbehorende bundle en de signaalverzoeken vanaf dat subdomein geserveerd. Je hoeft geen proxy te draaien.

Hoe activering werkt

1. Je voegt het subdomein toe in het dashboard en maakt de A-records die het toont aan bij je DNS-provider.
2. TRACIO detecteert de records en geeft automatisch een TLS-certificaat uit voor het subdomein.
3. Het eerste bezoek aan een pagina die het script met je public key vanaf het subdomein laadt, activeert de host.

Het dashboard toont deze drie fasen — de A-records, het certificaat en het eerste bezoek met je sleutel — en controleert ze automatisch opnieuw. Check now forceert een nieuwe controle.

Een eigen domein instellen

1. Open Get Started en klap Install the SDK and send your first event uit. Het eerste item daarin vraagt vanaf waar het script laadt: kies Your own subdomain en vul het in. Dezelfde wizard staat onder Settings → Custom Hosts.
2. Maak de in het dashboard getoonde A-records aan bij je DNS-provider. Staat je domein bij Cloudflare, voeg ze dan toe met de proxy uitgeschakeld (grijze wolk, DNS only): met de proxy aan vervangt Cloudflare de adressen en bereiken de verzoeken TRACIO niet.
3. Wacht tot de fasen DNS en Certificaat zijn bevestigd. Propagatie en uitgifte duren van enkele minuten tot enkele uren.
4. Plaats het snippet op je pagina's. Het eerste bezoek met je sleutel activeert de host.

Als je site al trackt via het gedeelde domein, zet de tag dan pas om nadat de fasen DNS en Certificaat zijn bevestigd: tot dan laadt het script niet vanaf het nieuwe subdomein.

Snippets

Scripttag:

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

npm-pakketten: geef het subdomein door als endpoint. De SDK laadt het script daarvandaan en stuurt de signalen ernaartoe. Wanneer endpoint is ingesteld, wordt de optie region genegeerd. Gebruik hiervoor geen scriptUrl: die vervangt de volledige script-URL, inclusief de public key.

import { Tracio } from "@tracio/sdk"

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

De framework-pakketten accepteren dezelfde optie endpoint — zie de SDK-pagina's.

Beperkingen

• Gebruik een subdomein dat je zelf beheert, zoals metrics.yoursite.com, en dat verder niets serveert.
• Bij Cloudflare moeten de records DNS only zijn (grijze wolk).
• Een subdomein dat in een andere workspace actief is, kan niet worden toegevoegd.

Volgende stappen

• Snelstart — Installeer de SDK en lees je eerste resultaat
• Problemen oplossen — Geblokkeerde verzoeken en cookieproblemen