Qué decide CrossUp

Vos mostrás; CrossUp elige qué, a quién y en qué momento. Aprende de tu catálogo, tus órdenes y lo que hace cada comprador, y te devuelve una recomendación lista para mostrar.

Lo que entra

El catálogo y las órdenes llegan por la app o por un conector, traducidos a un modelo común. Las señales llegan desde tu tienda, con lo que hizo el comprador.

Lo que sale

Lo que devuelve CrossUp es una recomendación: los productos para ese momento, en orden, con título, precio, stock e imagen. En la API ese objeto se llama Decision, y decision_id es el id de la recomendación.

Si no hay nada que recomendar, la recomendación vuelve vacía y con motivo.

Lo que decide CrossUp, y lo que queda de tu lado

Decide CrossUp	Queda de tu lado
Qué productos mostrar, y en qué orden	Cómo se ven: el diseño, el lugar, el texto
Cuándo una respuesta es vacía, y por qué	Qué hacer con un vacío (casi siempre, nada)
A qué recomendación pertenece cada señal	Avisar las señales cuando pasan

Tu clave identifica tu tienda

Con la clave de storefront que generás en el admin de CrossUp (Configuración → Claves para tu storefront) pedís las recomendaciones que vas a mostrar en tu ecommerce. No hace falta decir de qué tienda sos: la clave ya lo sabe. Por eso nadie puede pedir recomendaciones ni leer productos de otra tienda cambiando un campo del pedido. Un producto de otra tienda responde igual que uno que no existe: 404.

Qué vas a ver

Datos, no HTML. Cada product de results alcanza para mostrarlo sin otra llamada. Así viaja la respuesta de POST /v1/recommendations para una página de producto, recortada a un resultado. Los campos opcionales que el catálogo no tiene no vienen.

Respuesta

{
  "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"
}

Y así la lee tu tienda:

decision.decision_id   // las señales lo van a citar
decision.results       // los productos recomendados, en orden
decision.results[0].product.item.title     // { es: "Pantalón Demo" }: por idioma
decision.results[0].product.variants[0].price // { amount: "18900", currency: "ARS" }
decision.reason_codes  // por qué, si la lista vino vacía

type Decision struct {
    DecisionID  string   `json:"decision_id"`  // las señales lo van a citar
    Results     []Result `json:"results"`      // los productos, en orden
    ReasonCodes []string `json:"reason_codes"` // por qué, si vino vacía
}

Los seis momentos

Dónde aparece una recomendación y qué necesita cada momento.

Cómo se conecta tu tienda

App o conector: depende de dónde está tu tienda.

Empezar

Operar

Qué decide CrossUp

Lo que entra

Lo que sale

Lo que decide CrossUp, y lo que queda de tu lado

Tu clave identifica tu tienda

Qué vas a ver

Los seis momentos

Cómo se conecta tu tienda

​Lo que entra

​Lo que sale

​Lo que decide CrossUp, y lo que queda de tu lado

​Tu clave identifica tu tienda

​Qué vas a ver

Los seis momentos

Cómo se conecta tu tienda

Lo que entra

Lo que sale

Lo que decide CrossUp, y lo que queda de tu lado

Tu clave identifica tu tienda

Qué vas a ver