Domini personalizzati

Alcune reti ed estensioni del browser bloccano le richieste verso i domini di analytics di terze parti: filtri aziendali, blocchi a livello di DNS, restrizioni regionali, estensioni per la privacy. Servito dal suo sottodominio, lo script è una richiesta first-party sul suo sito e continua a funzionare in quegli ambienti.

Un dominio personalizzato è un sottodominio sotto il suo controllo, ad esempio metrics.yoursite.com, puntato all'edge di TRACIO. Una volta confermati il DNS e il certificato, lo script, il suo bundle e le richieste di segnali vengono serviti da quel sottodominio. Non è necessario gestire un proxy.

Come funziona l'attivazione

1. Aggiunga il sottodominio nella dashboard e crei presso il suo provider DNS i record A che vengono mostrati.
2. TRACIO rileva i record ed emette automaticamente un certificato TLS per il sottodominio.
3. La prima visita a una pagina che carica lo script dal sottodominio con la sua chiave pubblica attiva l'host.

La dashboard mostra queste tre fasi — i record A, il certificato e la prima visita con la sua chiave — e le ricontrolla automaticamente. Check now forza un nuovo controllo.

Configurare un dominio personalizzato

1. Apra Get Started ed espanda Install the SDK and send your first event. Il primo elemento chiede da dove viene caricato lo script: scelga Your own subdomain e lo inserisca. La stessa procedura guidata si trova in Settings → Custom Hosts.
2. Aggiunga presso il suo provider DNS i record A mostrati nella dashboard. Se il suo dominio è su Cloudflare, li aggiunga con il proxy disattivato (nuvola grigia, DNS only): con il proxy attivo, Cloudflare sostituisce gli indirizzi e le richieste non raggiungono TRACIO.
3. Attenda che le fasi DNS e Certificato siano confermate. La propagazione e l'emissione richiedono da pochi minuti a qualche ora.
4. Inserisca lo snippet nelle sue pagine. La prima visita con la sua chiave attiva l'host.

Se il suo sito traccia già tramite il dominio condiviso, cambi il tag solo dopo che le fasi DNS e Certificato sono confermate: fino ad allora lo script non viene caricato dal nuovo sottodominio.

Snippet

Tag script:

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

Pacchetti npm: passi il sottodominio come endpoint. L'SDK carica lo script da lì e vi invia i segnali. Quando endpoint è impostato, l'opzione region viene ignorata. Non usi scriptUrl per questo: sostituisce l'intero URL dello script, inclusa la chiave pubblica.

import { Tracio } from "@tracio/sdk"

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

I pacchetti per i framework accettano la stessa opzione endpoint — veda le pagine degli SDK.

Limiti

• Usi un sottodominio sotto il suo controllo, ad esempio metrics.yoursite.com, che non serva nient'altro.
• Su Cloudflare i record devono essere DNS only (nuvola grigia).
• Un sottodominio attivo in un altro workspace non può essere aggiunto.

Prossimi passi

• Guida rapida — Installi l'SDK e legga il primo risultato
• Risoluzione dei problemi — Richieste bloccate e problemi con i cookie