Vlastní domény

Některé sítě a rozšíření prohlížečů blokují požadavky na domény analytiky třetích stran: firemní filtry, blokátory na úrovni DNS, regionální omezení, rozšíření pro ochranu soukromí. Když je skript doručován z vaší vlastní subdomény, jde o first-party požadavek na vašem webu a v takových prostředích funguje dál.

Vlastní doména je subdoména, kterou spravujete, například metrics.yoursite.com, nasměrovaná na edge TRACIO. Jakmile jsou DNS a certifikát potvrzeny, skript, jeho bundle i požadavky se signály jsou doručovány z této subdomény. Nemusíte provozovat proxy.

Jak probíhá aktivace

1. V dashboardu přidáte subdoménu a u svého poskytovatele DNS vytvoříte A záznamy, které se vám zobrazí.
2. TRACIO záznamy detekuje a automaticky vystaví pro subdoménu TLS certifikát.
3. Hosta aktivuje první návštěva stránky, která načte skript ze subdomény s vaším veřejným klíčem.

Dashboard zobrazuje tyto tři fáze — A záznamy, certifikát a první návštěvu s vaším klíčem — a automaticky je znovu kontroluje. Check now vynutí novou kontrolu.

Nastavení vlastní domény

1. Otevřete Get Started a rozbalte Install the SDK and send your first event. První položka se ptá, odkud se skript načítá: zvolte Your own subdomain a zadejte ji. Stejný průvodce je i v Settings → Custom Hosts.
2. Přidejte u svého poskytovatele DNS A záznamy zobrazené v dashboardu. Pokud je vaše doména na Cloudflare, přidejte je s vypnutou proxy (šedý mrak, DNS only): se zapnutou proxy Cloudflare adresy nahradí a požadavky se k TRACIO nedostanou.
3. Počkejte, než budou fáze DNS a Certificate potvrzeny. Propagace a vystavení trvají od několika minut po několik hodin.
4. Umístěte snippet na své stránky. Hosta aktivuje první návštěva s vaším klíčem.

Pokud váš web už měří přes sdílenou doménu, přepněte tag až poté, co budou fáze DNS a Certificate potvrzeny: do té doby se skript z nové subdomény nenačte.

Snippety

<script> tag:

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

npm balíčky: předejte subdoménu jako endpoint. SDK z ní načte skript a posílá do ní signály. Když je endpoint nastaven, volba region se ignoruje. Nepoužívejte k tomu scriptUrl: nahrazuje celou URL skriptu včetně veřejného klíče.

import { Tracio } from "@tracio/sdk"

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

Frameworkové balíčky přijímají stejnou volbu endpoint — viz stránky SDK.

Omezení

• Použijte subdoménu, kterou spravujete, například metrics.yoursite.com, a která neslouží k ničemu jinému.
• Na Cloudflare musí být záznamy DNS only (šedý mrak).
• Subdoménu, která je aktivní v jiném workspace, nelze přidat.

Další kroky

• Rychlý start — nainstalujte SDK a přečtěte si svůj první výsledek
• Řešení problémů — blokované požadavky a problémy s cookies