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 y el checkout, 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);
crossup.track.checkoutStarted(decision);

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
`checkoutStarted`	`checkout_started`	Al ir al checkout, una vez. Registra el momento, no la venta
`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; cartId, que pisa el de la instancia; y occurredAt, por defecto ahora.

La compra no es una señal

Que una venta se cerró lo dice la orden de tu tienda, no el navegador. Para que CrossUp la ate a la recomendación, pasale el id del carrito una vez, al crear la instancia; viaja solo en cada pedido y cada señal:

const crossup = createStorefront({
  apiKey: "spk_…",
  connectionId: "cn_…",
  cartId: () => cart?.id, // una función: el carrito consigue su id con el primer producto
});

Cómo se cruza con la orden: Señales y atribución.

checkoutStarted y cartId todavía no están en la versión publicada en npm (0.1.0), que trae un track.purchase que el contrato ya no acepta. Hasta la próxima versión, mandá checkout_started y cart_id por la API.

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`
Ninguna venta atribuida	Falta `cartId`: sin él la orden no se puede atar a la recomendación

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

​La compra no es una señal

​Escuchar los resultados

​Si no lo ves

Señales y atribución

Registrar señales por API

Los métodos

La compra no es una señal

Escuchar los resultados

Si no lo ves