Integración

Registrar pedidos

Con un fragmento de JavaScript en la página de pedido confirmado, Koply te enseña cuántos ingresos y pedidos llegan desde el buscador. Sirve para cualquier tienda, también las desarrolladas a medida.

Qué necesitas

  • El widget de Koply cargado en la página de pedido confirmado (si ya está en todas las páginas, no hay que hacer nada más).
  • Los datos del pedido: referencia, total y líneas con el identificador del producto, la cantidad y el precio unitario.

1. Añade el fragmento en la página de confirmación

Colócalo una sola vez en la página que ve el cliente cuando termina de pagar, rellenando los datos reales del pedido:

<script>
  (window.Koply = window.Koply || { q: [] });
  (window.Koply.q = window.Koply.q || []).push(['trackOrder', {
    order_id: '000123',          // referencia única del pedido
    total:    129.90,            // total del pedido
    currency: 'EUR',             // moneda del pedido; si falta se asume EUR, indícala siempre en otras monedas
    items: [
      { id: '77', qty: 2, price: 30.00 },   // id del producto, cantidad y precio unitario
      { id: '88', qty: 1, price: 69.90 }
    ]
  }]);
</script>

Funciona esté o no cargado ya el widget: si aún no ha cargado, la llamada se ejecuta cuando arranque.

2. Usa el mismo identificador que el feed

Koply relaciona el pedido con los clics en los resultados por el identificador del producto. Debe ser el mismo valor que el widget envía en cada clic: el campo entity_id de tu feed si existe y, si no, id. Si no coinciden, el pedido se registra pero no se atribuye a ninguna búsqueda.

Precios: envía el precio unitario con el mismo criterio (con o sin impuestos) que el total. Koply suma cantidad × precio de las líneas que el visitante clicó o añadió al carrito desde los resultados; no usa el total del pedido para ese cálculo.

3. Comprueba que llega

  1. Busca un producto en tu tienda, haz clic en un resultado y cómpralo.
  2. En las herramientas del navegador (pestaña Red) verás una petición POST a /api/v1/events/order con respuesta 202.
  3. En Estadísticas aparecen los ingresos y pedidos en la hora siguiente.

Recargar la página de confirmación no duplica el pedido: Koply lo reconoce por su referencia.

Cómo se calcula

Cifra Qué cuenta
Ingresos desde el buscador Las líneas del pedido que el visitante clicó, o añadió al carrito, desde los resultados de Koply en las 24 horas anteriores.
Pedidos desde el buscador Pedidos con al menos una de esas líneas.
Conversión tras buscar Sesiones que buscaron y acabaron en pedido, entre las sesiones que buscaron. Se compara con las sesiones que no buscaron; es una correlación, no el efecto del buscador por sí solo.

Privacidad y consentimiento

Los pedidos se unen al identificador aleatorio de la sesión; Koply no recibe ningún dato del comprador. Si activas el modo con consentimiento, el pedido solo se registra cuando tu banner de cookies lo autoriza. Detalle en Privacidad, cookies y consentimiento.

Configuración del Widget Privacidad y cookies