Reportar señales

Cada track.* registra una señal y el SDK la manda solo. Nunca tira ni espera la red: llamalo sin await, desde el handler del clic.

Los métodos

Todos reciben la recomendación (en la API, Decision: la lista de productos recomendados para ese momento) o su decision_id. Salvo la impresión, también el resultado (o su item_id).

crossup.track.impression(decision);
crossup.track.click(decision, result);
crossup.track.addToCart(decision, result, { quantity: 2 });
crossup.track.removeFromCart(decision, result);
crossup.track.updateQuantity(decision, result, { quantity: 0 });
crossup.track.dismiss(decision, result);

// En la página de compra: los productos de la recomendación que entraron en la orden.
crossup.track.purchase(decision, { orderExternalId: order.id, items: [{ result, quantity: 2 }] });

Método	Señal	Cuándo, y lo que importa
`impression`	`impression`	Cuando entra en pantalla, no cuando se genera
`click`	`click`	Al abrir un producto, antes de navegar. El SDK se ocupa de que salga
`addToCart`	`add_to_cart`	`quantity`: las unidades que se suman, no el total
`removeFromCart`	`remove_from_cart`	Al sacarlo del carrito
`updateQuantity`	`update_quantity`	`quantity`: las unidades que quedan; 0 la saca
`purchase`	`purchase`	`orderExternalId` (el id de la orden en tu tienda) e `items[]`
`dismiss`	`dismiss`	Al cerrar la oferta sin tomarla. Sin resultado, va el primero

Cada método devuelve el id de la señal, o undefined si no se pudo armar (onSignalError dice por qué). Aceptan signalId, un id propio y estable, y occurredAt, por defecto ahora. Cada señal lleva sola el visitante y el contexto, sin datos personales: Visitante y contexto.

Escuchar los resultados

const crossup = createStorefront({
  apiKey: "spk_…",
  connectionId: "cn_…",
  onSignalResult: (result, signal) => {
    // result.status: "accepted" | "duplicate" | "rejected"; result.reason si fue rechazada
  },
  onSignalError: (error) => {
    // no se pudo armar o se rechazó.
  },
});

En tests, o antes de cerrar una sesión de compra en el servidor:

await crossup.flush();      // manda lo pendiente y espera. Nunca rechaza.

Si no lo ves

Lo que pasa	Qué hacer
Rechazada con `unknown_decision`	Pasá la recomendación tal como vino, o su `decision_id` exacto
`undefined` al llamar a `track.*`	La señal no se pudo armar: mirá `onSignalError`

Señales y atribución

Cuándo mandar cada señal y qué mide CrossUp con ellas.

Registrar señales por API

La operación, con playground.

​Los métodos

​Escuchar los resultados

​Si no lo ves

Señales y atribución

Registrar señales por API

Los métodos

Escuchar los resultados

Si no lo ves