Visitante e contexto

O SDK monta o visitante e a sessão sozinho, e os envia com cada requisição de recomendação e cada sinal. Você não programa nada disso: cria a instância e pronto.

O que você precisa fazer

Com o SDK, só criar a instância. O visitor_id, o session_id e o contexto do navegador viajam sozinhos em cada tryGetRecommendations e cada track.*.

const crossup = createStorefront({ apiKey: "spk_…", connectionId: "cn_…" });

await crossup.tryGetRecommendations({ surface: "pdp", placementKey: "pdp-related", contextItemId });
crossup.track.click(decision, result); // o mesmo visitante, sem você passar

Se a sua loja pede consentimento de cookies, uma única opção:

createStorefront({ apiKey, connectionId, persistVisitor: consent.analytics });

Com a API, sem SDK, envie o visitante que você gerar no campo visitor da requisição e de cada sinal:

{
  "surface": "pdp",
  "placement_key": "pdp-related",
  "context_item_id": "itm_…",
  "visitor": { "visitor_id": "vis_…", "session_id": "ses_…" }
}

O que viaja

Dado	O que é
`visitor_id` (`vis_…`)	Um id inventado por navegador, que dura meses
`session_id` (`ses_…`)	Uma visita; renova após 30 minutos sem atividade
`client`	Página, de onde veio, campanha, idioma e tela

Para que a CrossUp usa

Com o visitante e a sessão, a CrossUp acompanha o percurso de cada comprador na sua loja: quais páginas vê, quais produtos olha, adiciona ou tira do carrinho, de qual campanha veio, quanto dura a visita e se volta dias depois. Com esse percurso o SalesPilot aprende o que recomendar a quem e em que momento, liga cada clique e cada compra à recomendação que os gerou, e mede a venda atribuída pedido por pedido. Nunca viaja um dado pessoal. O visitante é um id aleatório: não é um e-mail, um telefone nem o id de cliente da sua plataforma, e o contexto só descreve o navegador.

Reportar sinais

Os sinais viajam com o mesmo visitante.

Sinais e atribuição

Como esse percurso vira venda medida.

​O que você precisa fazer

​O que viaja

​Para que a CrossUp usa

Reportar sinais

Sinais e atribuição

O que você precisa fazer

O que viaja

Para que a CrossUp usa