Развёртывание в облаке

Обзор

tracio.ai — это полностью управляемая облачная платформа. Ваше приложение отправляет сигналы из браузера, а облако возвращает результат идентификации. Платформа берёт на себя масштабирование, резервирование и управление инфраструктурой.

Начать можно за считаные минуты: создайте аккаунт, получите публичный ключ, установите SDK и приступайте к идентификации посетителей.

Только управляемое облако. TRACIO не поставляет self-hosted- или on-premise-развёртывание — устанавливаемого серверного компонента не существует. Под вашим контролем остаются регион данных, из которого обслуживается ваш трафик (см. ниже), и — если агент должен отдаваться с вашего собственного домена — first-party-прокси перед управляемым эндпоинтом через опции endpoint / scriptUrl.

Как это работает

Ваше приложение взаимодействует с облаком через клиентский JavaScript SDK. SDK загружает агента в браузере, собирает сигналы и возвращает результат идентификации:

Browser (JS SDK)  ──▶  tracio.ai Cloud
                  ◀──  (identification result)

1. Браузерный SDK загружает агента и собирает сигналы.
2. Сигналы отправляются в облако tracio.ai.
3. Облако возвращает результат: visitorId и информацию о bot.

Чтобы реагировать на результаты на собственном сервере, получайте каждую идентификацию как подписанный webhook или читайте их по запросу через Data API.

Начало работы

1. Зарегистрируйтесь и откройте панель управления.
2. Выберите регион данных (см. ниже).
3. Скопируйте публичный ключ — его безопасно включать в клиентский код.
4. Установите SDK и инициализируйте его:

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  region: "eu",
})

Регионы данных

Параметр SDK region выбирает, с каким регионом данных взаимодействует SDK. Он принимает значения "us" или "eu". Если параметр не задан, SDK использует общий эндпоинт https://edge.tracio.ai — задайте его явно, чтобы закрепить регион.

Управление API-ключами

В вашем воркспейсе используются два вида ключей, и они не взаимозаменяемы:

• Оба вида создаются и управляются в панели управления, в разделе API Keys. Секретные ключи доступны на тарифе Pro и выше.
• Секретный ключ показывается один раз, при создании — на нашей стороне хранится только хеш. Если вы его потеряли, ключ не восстанавливают, а ротируют.
• При ротации секретного ключа предыдущий продолжает работать 7 дней, чтобы вы успели выкатиться без простоя. Публичные ключи не ротируются: это не секрет, и по замыслу они видны в исходном коде страницы.

Получать результаты на стороне сервера можно двумя способами, и они хорошо сочетаются:

• Настройте webhook — каждая идентификация доставляется на ваш эндпоинт, подписанная заголовком X-Tracio-Signature.
• Вызывайте Data API со своим секретным ключом, чтобы по запросу читать историю посетителя, отдельные сессии или счётчики velocity.

Webhooks

Вы можете настроить webhooks, чтобы получать события идентификации из облака на свой сервер. Webhooks доступны на тарифе Pro и выше — подробности о настройке, структуре payload и проверке подписи см. в разделе Webhooks.