Despliegue en la nube

Visión general

tracio.ai es una plataforma cloud totalmente gestionada. Su aplicación envía señales desde el navegador, y la nube devuelve un resultado de identificación. La plataforma se encarga del escalado, la redundancia y la gestión de la infraestructura.

Empezar lleva minutos: cree una cuenta, obtenga su clave pública, instale el SDK y empiece a identificar visitantes.

Solo nube gestionada. TRACIO no ofrece un despliegue self-hosted ni on-premise: no existe ningún componente de servidor instalable. Lo que sí puede controlar es la región de datos desde la que se sirve su tráfico (ver abajo) y el dominio desde el que se sirve el script: conecte su propio subdominio en el panel, consulte Dominios personalizados.

Cómo funciona

Su aplicación se comunica con la nube a través del SDK de JavaScript del lado del cliente. El SDK carga un agente en el navegador, recopila señales y devuelve el resultado de identificación:

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

1. El SDK del navegador carga el agente y recopila señales.
2. Las señales se envían a la nube de tracio.ai.
3. La nube devuelve el resultado: información de visitorId y bot.

Para actuar sobre los resultados en su propio servidor, reciba cada identificación como un webhook firmado, o léalos bajo demanda a través de la Data API.

Primeros pasos

1. Regístrese y abra su panel.
2. Elija su región de datos (ver abajo).
3. Copie su clave pública: es seguro incluirla en el código del cliente.
4. Instale el SDK e inicialícelo:

import { Tracio } from "@tracio/sdk"

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

Regiones de datos

La opción region del SDK selecciona con qué región de datos se comunica el SDK. Acepta "us" o "eu". Si no se establece, el SDK usa el endpoint genérico https://edge.tracio.ai — establézcala explícitamente para fijar una región.

Gestión de claves de API

Su workspace utiliza dos tipos de clave, y no son intercambiables:

• Cree y gestione ambas en el panel, en la sección API Keys. Las claves secretas requieren el plan Pro o superior.
• Una clave secreta se muestra una sola vez, al crearla: de nuestro lado solo se guarda un hash. Si la pierde, no se recupera, se rota.
• Al rotar una clave secreta, la anterior sigue funcionando durante 7 días para que pueda desplegar sin interrupciones. Las claves públicas no se rotan: no son secretas y, por diseño, están visibles en el código fuente de su página.

Para consumir los resultados en el servidor tiene dos opciones, y se combinan bien:

• Configure un webhook: cada identificación se entrega a su endpoint, firmada con X-Tracio-Signature.
• Llame a la Data API con su clave secreta para leer bajo demanda el historial de un visitante, sesiones individuales o los contadores de velocity.

Webhooks

Puede configurar webhooks para recibir eventos de identificación desde la nube en su propio servidor. Los webhooks están disponibles a partir del plan Pro — consulte Webhooks para los detalles de configuración, payload y verificación de firma.