Migre para tracio.ai

Cadastre-se e obtenha sua chave de API. Seu plano Free inclui 2,500 chamadas de API grátis — suficiente para rodar uma comparação paralela completa contra seu provedor atual.

Adicione o @tracio/sdk ao lado do seu SDK de fingerprinting existente. Isso é uma mudança de código, não uma troca de endpoint — a tracio.ai traz o próprio cliente e o próprio formato de resultado. Rodar os dois ao mesmo tempo permite comparar em tráfego de produção sem interrompê-lo.

npm install @tracio/sdk

Os resultados de identificação são enviados ao seu servidor como webhooks assinados no momento em que um visitante é identificado, então a maioria das integrações aposenta de vez o laço de polling. Se você ainda precisar ler uma visita depois do fato, a Server API responde por requestId a partir do plano Pro. De qualquer forma, o payload é o nosso próprio documento plano em camelCase, então você mapeia os campos uma única vez.

// Before (competitor) — poll by requestId
const resp = await fetch("https://api.competitor.io/events/" + requestId, {
  headers: { "Auth-API-Key": COMPETITOR_API_KEY }
});

// After (tracio.ai) — receive a signed webhook per identification
app.post("/webhook/tracio", (req, res) => {
  // verify req.headers["x-tracio-signature"], then act on req.body
  const event = req.body; // { requestId, visitorId, bot, decision, ... }
  res.status(200).send("OK");
});

Rode os dois SDKs simultaneamente por 24–48 horas. Os IDs de visitante não vão coincidir entre os provedores — cada um é calculado a partir de uma base de dados diferente —, então compare o que realmente importa: se o mesmo dispositivo físico é reconhecido de forma consistente entre as visitas e como os vereditos de bot se alinham no seu tráfego.

Remova o SDK antigo e mantenha o seu handler de webhook como fonte da verdade no lado do servidor. Não há downtime — os dois SDKs rodam lado a lado até você desligar o antigo. Visitantes recorrentes começam do zero na nossa base de dados, então mapeie-os para as suas contas existentes com linkedId. Se algo der errado, o caminho de rollback é simplesmente reinstalar o SDK antigo.