Domaines personnalisés

Certains réseaux et certaines extensions de navigateur bloquent les requêtes vers les domaines d'analytique tiers : filtres d'entreprise, bloqueurs au niveau DNS, restrictions régionales, extensions de confidentialité. Servi depuis votre propre sous-domaine, le script est une requête de première partie sur votre site et continue de fonctionner dans ces environnements.

Un domaine personnalisé est un sous-domaine que vous contrôlez, par exemple metrics.yoursite.com, pointé vers l'edge TRACIO. Une fois le DNS et le certificat confirmés, le script, son bundle et les requêtes de signaux sont servis depuis ce sous-domaine. Vous n'avez pas besoin d'exploiter un proxy.

Fonctionnement de l'activation

1. Vous ajoutez le sous-domaine dans le tableau de bord et créez chez votre fournisseur DNS les enregistrements A qu'il affiche.
2. TRACIO détecte les enregistrements et émet automatiquement un certificat TLS pour le sous-domaine.
3. La première visite sur une page qui charge le script depuis le sous-domaine avec votre clé publique active l'hôte.

Le tableau de bord affiche ces trois étapes — les enregistrements A, le certificat et la première visite avec votre clé — et les revérifie automatiquement. Check now force une revérification.

Configurer un domaine personnalisé

1. Ouvrez Get Started et dépliez Install the SDK and send your first event. Son premier élément demande depuis où le script est chargé : choisissez Your own subdomain et saisissez-le. Le même assistant se trouve sous Settings → Custom Hosts.
2. Ajoutez chez votre fournisseur DNS les enregistrements A affichés dans le tableau de bord. Si votre domaine est chez Cloudflare, ajoutez-les avec le proxy désactivé (nuage gris, DNS only) : avec le proxy activé, Cloudflare remplace les adresses et les requêtes n'atteignent pas TRACIO.
3. Attendez que les étapes DNS et Certificat soient confirmées. La propagation et l'émission prennent de quelques minutes à quelques heures.
4. Placez le snippet sur vos pages. La première visite avec votre clé active l'hôte.

Si votre site effectue déjà le suivi via le domaine partagé, ne basculez la balise qu'une fois les étapes DNS et Certificat confirmées : jusque-là, le script ne se charge pas depuis le nouveau sous-domaine.

Snippets

Balise de script :

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

Paquets npm : passez le sous-domaine dans endpoint. Le SDK y charge le script et lui envoie les signaux. Lorsque endpoint est défini, l'option region est ignorée. N'utilisez pas scriptUrl pour cela : elle remplace l'URL complète du script, clé publique comprise.

import { Tracio } from "@tracio/sdk"

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

Les paquets pour frameworks acceptent la même option endpoint — voir les pages SDK.

Limites

• Utilisez un sous-domaine que vous contrôlez, par exemple metrics.yoursite.com, qui ne sert rien d'autre.
• Sur Cloudflare, les enregistrements doivent être en DNS only (nuage gris).
• Un sous-domaine actif dans un autre espace de travail ne peut pas être ajouté.

Étapes suivantes

• Démarrage rapide — Installez le SDK et lisez votre premier résultat
• Dépannage — Requêtes bloquées et problèmes de cookie