Собственные домены

Некоторые сети и расширения браузера блокируют запросы к сторонним аналитическим доменам: корпоративные фильтры, блокировщики на уровне 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