Os cinco momentos

Uma recomendação pode aparecer em cinco momentos, da página de produto à de compra. Na API, cada momento é um surface com o seu próprio contexto.

Os cinco, com o que cada um precisa

Dois nomes enganam: cart é ao adicionar ao carrinho, o popup depois de somar um produto. carousel é a página do carrinho.

Momento	`surface`	O que a requisição precisa
	`pdp`	o produto que o comprador olha
	`cart`	o produto adicionado
	`carousel`	o carrinho
	`in-checkout`	o carrinho
	`success-page`	o carrinho

pdp e cart partem do produto de partida, aquele que o comprador olha ou acabou de adicionar. Os outros três leem o carrinho. Se faltar o que o momento precisa, volta um erro que diz qual campo.

O nome do lugar

Cada requisição leva também um placementKey: uma etiqueta que você define para saber de qual lugar da sua loja saiu cada requisição. Serve para a sua rastreabilidade e controle interno; não muda a recomendação.

pdp-related        cart-frequently-bought        in-checkout-last-chance

Como se pede

const decision = await crossup.tryGetRecommendations({
  surface: "pdp",              // o momento
  placementKey: "pdp-related", // sua etiqueta do lugar, para rastreabilidade
  contextItemId: item.id,      // o produto de partida; no carrinho vai cartItems
});

body := map[string]any{
    "connection_id":   connectionID,
    "surface":         "pdp",         // o momento
    "placement_key":   "pdp-related", // sua etiqueta do lugar, para rastreabilidade
    "context_item_id": itemID,        // o produto de partida; no carrinho vai cart_items
}
// POST {base}/v1/recommendations · Authorization: Bearer spk_…

O que você vai ver

Uma recomendação com results e, em context, o produto ou o carrinho do jeito que você mandou.

Se você não vê

O que acontece	Por quê	O que fazer
Vazia, “momento não ativado”	A loja não ativou esse momento	Ative no admin, em Momentos
Erro “falta o produto”	O momento parte de um produto	Mande o produto de partida
Produto num momento de carrinho	É registrado, mas não muda a recomendação	Mande o carrinho

Sua primeira recomendação

Da chave à primeira recomendação, em 20 minutos.

Pedir recomendações com o SDK

Cada momento, com a sua requisição.

Começar

Operar

Os cinco momentos

Os cinco, com o que cada um precisa

O nome do lugar

Como se pede

O que você vai ver

Se você não vê

Sua primeira recomendação

Pedir recomendações com o SDK

​Os cinco, com o que cada um precisa

​O nome do lugar

​Como se pede

​O que você vai ver

​Se você não vê

Sua primeira recomendação

Pedir recomendações com o SDK

Os cinco, com o que cada um precisa

O nome do lugar

Como se pede

O que você vai ver

Se você não vê