Розгортання в хмарі

Огляд

tracio.ai — це повністю керована хмарна платформа. Ваш застосунок надсилає сигнали з браузера, а хмара повертає результат ідентифікації. Платформа бере на себе масштабування, резервування та керування інфраструктурою.

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

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

Як це працює

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

Text

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

Браузерний SDK завантажує агент і збирає сигнали.
Сигнали надсилаються до хмари tracio.ai.
Хмара повертає результат: visitorId та інформацію про bot.

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

Початок роботи

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

TypeScript

import { Tracio } from "@tracio/sdk"

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

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

Опція SDK region визначає, з яким регіоном даних взаємодіє SDK. Вона приймає "us" або "eu". Якщо її не задано, SDK використовує загальний endpoint https://edge.tracio.ai — задайте її явно, щоб закріпити регіон.

Регіон	Опис
не задано	Загальний endpoint `edge.tracio.ai` (регіон не закріплено)
`us`	Регіон даних US
`eu`	Регіон даних EU

Керування API-ключами

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

Ключ	Де застосовується	Який вигляд має
Публічний	Браузер — його безпечно постачати в клієнтському коді	40 символів, без префікса
Секретний	Лише ваш бекенд — автентифікує Data API	`tracio_sk_` плюс 43 символи

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

Отримувати результати на боці сервера можна двома способами, і вони добре поєднуються:

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

Webhooks

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