Los seis momentos

Una recomendación puede aparecer en seis momentos, de la página de producto a la de compra. En la API cada momento es un surface con su propio contexto.

Los seis, con lo que cada uno necesita

Dos nombres engañan: cart es al agregar al carrito, el popup después de sumar un producto. carousel es la página del carrito.

Momento	`surface`	Qué necesita el pedido
	`pdp`	el producto que mira
	`cart`	el producto agregado
	`carousel`	el carrito
	`checkout`	el producto, o el carrito
	`in-checkout`	el carrito
	`success-page`	el carrito

pdp, cart y checkout parten del producto de partida, el que el comprador mira o acaba de agregar. Los otros tres leen el carrito. Si falta lo que el momento necesita, vuelve un error que nombra el campo.

El nombre del lugar

Cada pedido lleva también un placementKey: una etiqueta que definís vos para saber de qué lugar de tu tienda salió cada pedido. Es para tu trazabilidad y tu control interno; no cambia la recomendación.

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

Cómo se pide

const decision = await crossup.tryGetRecommendations({
  surface: "pdp",              // el momento
  placementKey: "pdp-related", // tu etiqueta del lugar, para trazabilidad
  contextItemId: item.id,      // el producto de partida; en carrito va cartItems
});

body := map[string]any{
    "connection_id":   connectionID,
    "surface":         "pdp",         // el momento
    "placement_key":   "pdp-related", // tu etiqueta del lugar, para trazabilidad
    "context_item_id": itemID,        // el producto de partida; en carrito va cart_items
}
// POST {base}/v1/recommendations · Authorization: Bearer spk_…

Qué vas a ver

Una recomendación con results y, en context, el producto o el carrito tal como los mandaste.

Si no lo ves

Lo que pasa	Por qué	Qué hacer
Vacía, «momento no activado»	La tienda no activó ese momento	Activalo en el admin, en Momentos
Error «falta el producto»	El momento parte de un producto	Mandá el producto de partida
Producto en un momento de carrito	Se registra pero no cambia la recomendación	Mandá el carrito

Tu primera recomendación

De la clave a la primera recomendación, en 20 minutos.

Pedir recomendaciones con el SDK

Cada momento, con su pedido.

Empezar

Operar

Los seis momentos

Los seis, con lo que cada uno necesita

El nombre del lugar

Cómo se pide

Qué vas a ver

Si no lo ves

Tu primera recomendación

Pedir recomendaciones con el SDK

​Los seis, con lo que cada uno necesita

​El nombre del lugar

​Cómo se pide

​Qué vas a ver

​Si no lo ves

Tu primera recomendación

Pedir recomendaciones con el SDK

Los seis, con lo que cada uno necesita

El nombre del lugar

Cómo se pide

Qué vas a ver

Si no lo ves