Domenii personalizate

Unele rețele și extensii de browser blochează cererile către domenii de analiză terțe: filtre corporative, blocare la nivel de DNS, restricții regionale, extensii de confidențialitate. Servit de pe propriul subdomeniu, scriptul este o cerere first-party pe site și continuă să funcționeze în astfel de medii.

Un domeniu personalizat este un subdomeniu pe care îl controlezi, de exemplu metrics.yoursite.com, direcționat către edge-ul TRACIO. După ce DNS-ul și certificatul sunt confirmate, scriptul, bundle-ul său și cererile de semnale sunt servite de pe acel subdomeniu. Nu trebuie să rulezi un proxy.

Cum funcționează activarea

1. Adaugi subdomeniul în dashboard și creezi la furnizorul tău de DNS înregistrările A pe care ți le arată.
2. TRACIO detectează înregistrările și emite automat un certificat TLS pentru subdomeniu.
3. Prima vizită pe o pagină care încarcă scriptul de pe subdomeniu cu cheia ta publică activează host-ul.

Dashboardul arată aceste trei etape — înregistrările A, certificatul și prima vizită cu cheia ta — și le reverifică automat. Check now forțează o reverificare.

Configurează un domeniu personalizat

1. Deschide Get Started și extinde Install the SDK and send your first event. Primul element de acolo te întreabă de unde se încarcă scriptul: alege Your own subdomain și introdu-l. Același asistent se găsește în Settings → Custom Hosts.
2. Adaugă la furnizorul tău de DNS înregistrările A afișate în dashboard. Dacă domeniul tău este pe Cloudflare, adaugă-le cu proxy-ul dezactivat (nor gri, DNS only): cu proxy-ul activat, Cloudflare înlocuiește adresele, iar cererile nu ajung la TRACIO.
3. Așteaptă până când etapa DNS și cea de certificat sunt confirmate. Propagarea și emiterea durează de la câteva minute la câteva ore.
4. Pune snippetul în paginile tale. Prima vizită cu cheia ta activează host-ul.

Dacă site-ul tău urmărește deja prin domeniul partajat, schimbă tag-ul abia după ce etapa DNS și cea de certificat sunt confirmate: până atunci scriptul nu se încarcă de pe noul subdomeniu.

Snippeturi

Tag de script:

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

Pachete npm: transmite subdomeniul ca endpoint. SDK-ul încarcă scriptul de pe el și trimite semnalele către el. Când endpoint este setat, opțiunea region este ignorată. Nu folosi scriptUrl pentru asta: el înlocuiește întregul URL al scriptului, inclusiv cheia publică.

import { Tracio } from "@tracio/sdk"

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

Pachetele pentru framework-uri acceptă aceeași opțiune endpoint — vezi paginile SDK.

Limite

• Folosește un subdomeniu pe care îl controlezi, de exemplu metrics.yoursite.com, care nu servește altceva.
• Pe Cloudflare, înregistrările trebuie să fie DNS only (nor gri).
• Un subdomeniu care este activ în alt workspace nu poate fi adăugat.

Pașii următori

• Pornire rapidă — instalează SDK-ul și citește primul rezultat
• Depanare — cereri blocate și probleme cu cookie-urile