Власні домени

Деякі мережі та розширення браузера блокують запити до сторонніх аналітичних доменів: корпоративні фільтри, блокувальники на рівні DNS, регіональні обмеження, розширення для приватності. Якщо скрипт віддається з вашого власного піддомену, він стає first-party-запитом на вашому сайті й далі працює в таких середовищах.

Власний домен — це підконтрольний вам піддомен, наприклад metrics.yoursite.com, спрямований на edge TRACIO. Щойно DNS і сертифікат підтверджено, скрипт, його бандл і запити сигналів віддаються з цього піддомену. Запускати проксі не потрібно.

Як відбувається активація

1. Ви додаєте піддомен у дашборді та створюєте показані ним A-записи у свого DNS-провайдера.
2. TRACIO виявляє записи й автоматично випускає TLS-сертифікат для піддомену.
3. Перший візит на сторінку, яка завантажує скрипт із піддомену з вашим публічним ключем, активує хост.

Дашборд показує ці три стадії — A-записи, сертифікат і перший візит з вашим ключем — і перевіряє їх повторно автоматично. Check now запускає повторну перевірку примусово.

Налаштування власного домену

1. Відкрийте Get Started і розгорніть Install the SDK and send your first event. Його перший пункт запитує, звідки завантажується скрипт: виберіть Your own subdomain і введіть його. Той самий майстер доступний у Settings → Custom Hosts.
2. Додайте показані в дашборді A-записи у свого DNS-провайдера. Якщо ваш домен на Cloudflare, додавайте їх із вимкненим проксі (сіра хмара, DNS only): з увімкненим проксі Cloudflare підміняє адреси, і запити не доходять до TRACIO.
3. Дочекайтеся підтвердження стадій DNS і Certificate. Поширення записів і випуск сертифіката тривають від кількох хвилин до кількох годин.
4. Розмістіть сніпет на своїх сторінках. Перший візит з вашим ключем активує хост.

Якщо ваш сайт уже відстежує трафік через спільний домен, перемикайте тег лише після підтвердження стадій DNS і Certificate: доти скрипт не завантажується з нового піддомену.

Сніпети

Тег script:

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

npm-пакети: передайте піддомен у endpoint. SDK завантажує з нього скрипт і надсилає на нього сигнали. Якщо задано endpoint, опція region ігнорується. Не використовуйте для цього scriptUrl: він замінює URL скрипта цілком, разом із публічним ключем.

import { Tracio } from "@tracio/sdk"

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

Пакети для фреймворків приймають ту саму опцію endpoint — див. сторінки SDK.

Обмеження

• Використовуйте підконтрольний вам піддомен, наприклад metrics.yoursite.com, на якому не обслуговується нічого іншого.
• На Cloudflare записи мають бути в режимі DNS only (сіра хмара).
• Піддомен, активний в іншому робочому просторі, додати не можна.

Наступні кроки

• Швидкий старт — установіть SDK і отримайте перший результат
• Усунення несправностей — заблоковані запити та проблеми з cookie