O que a CrossUp decide

Você mostra; a CrossUp escolhe o quê, para quem e em que momento. Ela aprende com o catálogo, os pedidos e o que cada comprador faz, e devolve uma recomendação pronta para exibir.

O que entra

O catálogo e os pedidos chegam pelo app ou por um conector, traduzidos para um modelo comum. Os sinais chegam da sua loja, com o que o comprador fez.

O que sai

O que a CrossUp devolve é uma recomendação: os produtos para aquele momento, em ordem, com título, preço, estoque e imagem. Na API esse objeto se chama Decision, e decision_id é o id da recomendação.

Se não houver nada para recomendar, a recomendação volta vazia e com motivo.

O que a CrossUp decide, e o que fica do seu lado

A CrossUp decide	Fica do seu lado
Quais produtos mostrar, e em que ordem	Como eles aparecem: o design, o lugar, o texto
Quando uma resposta é vazia, e por quê	O que fazer com um vazio (quase sempre, nada)
A que recomendação pertence cada sinal	Avisar os sinais quando acontecem

Sua chave identifica sua loja

Com a chave de storefront que você gera no admin da CrossUp (Configurações → Chaves para o seu storefront) você pede as recomendações que vai mostrar no seu ecommerce. Não precisa dizer de qual loja você é: a chave já sabe. Por isso ninguém consegue pedir recomendações nem ler produtos de outra loja mudando um campo da requisição. Um produto de outra loja responde igual a um que não existe: 404.

O que você vai ver

Dados, não HTML. Cada product de results basta para exibi-lo sem outra chamada. Assim viaja a resposta de POST /v1/recommendations para uma página de produto, reduzida a um resultado. Os campos opcionais que o catálogo não tem não vêm.

Resposta

{
  "decision_id": "dec_demo_001",
  "request_id": "req_4f1c2a9b8d7e6f50",
  "store_id": "st_demo",
  "connection_id": "cn_demo",
  "placement_key": "pdp-related",
  "surface": "pdp",
  "visitor": {
    "visitor_id": "vis_Q2x9mT4pL7rK1sV8",
    "session_id": "ses_Hn3bW6yZ0cF5dJ2e"
  },
  "context": {
    "shooter": {
      "item_id": "itm_demo_remera"
    },
    "cart_items": []
  },
  "results": [
    {
      "item_id": "itm_demo_pantalon",
      "variant_id": "var_demo_pantalon_azul_m",
      "position": 1,
      "reason_codes": [
        "related_item"
      ],
      "product": {
        "item": {
          "item_id": "itm_demo_pantalon",
          "store_id": "st_demo",
          "connection_id": "cn_demo",
          "external_id": "1002",
          "title": {
            "es": "Pantalón Demo"
          },
          "status": "active",
          "primary_media": {
            "url": "https://cdn.example.test/pantalon-demo.jpg",
            "alt": {
              "es": "Pantalón Demo azul"
            }
          },
          "urls": {
            "es": "https://tienda.example.test/productos/pantalon-demo"
          },
          "source_version": "2026-08-26T09:00:00Z"
        },
        "variants": [
          {
            "variant_id": "var_demo_pantalon_azul_m",
            "item_id": "itm_demo_pantalon",
            "external_id": "2101",
            "sku": "PAN-AZU-M",
            "title": {
              "es": "Azul / M"
            },
            "status": "active",
            "price": {
              "amount": "18900",
              "currency": "ARS"
            }
          }
        ],
        "availability": [
          {
            "variant_id": "var_demo_pantalon_azul_m",
            "sellable": "in_stock",
            "quantity": 6,
            "as_of": "2026-08-26T09:00:00Z"
          }
        ],
        "refresh_revision": 3
      }
    }
  ],
  "reason_codes": [],
  "generated_at": "2026-08-26T09:00:01Z"
}

E assim a sua loja a lê:

decision.decision_id   // os sinais vão citá-lo
decision.results       // os produtos recomendados, em ordem
decision.results[0].product.item.title     // { pt: "Calça Demo" }: por idioma
decision.results[0].product.variants[0].price // { amount: "18900", currency: "BRL" }
decision.reason_codes  // por quê, se a lista veio vazia

type Decision struct {
    DecisionID  string   `json:"decision_id"`  // os sinais vão citá-lo
    Results     []Result `json:"results"`      // os produtos, em ordem
    ReasonCodes []string `json:"reason_codes"` // por quê, se veio vazia
}

Os cinco momentos

Onde aparece uma recomendação e o que cada momento precisa.

Como a sua loja se conecta

App ou conector: depende de onde está a sua loja.

Começar

Operar

O que a CrossUp decide

O que entra

O que sai

O que a CrossUp decide, e o que fica do seu lado

Sua chave identifica sua loja

O que você vai ver

Os cinco momentos

Como a sua loja se conecta

​O que entra

​O que sai

​O que a CrossUp decide, e o que fica do seu lado

​Sua chave identifica sua loja

​O que você vai ver

Os cinco momentos

Como a sua loja se conecta

O que entra

O que sai

O que a CrossUp decide, e o que fica do seu lado

Sua chave identifica sua loja

O que você vai ver