Server-side tracking para CCV Shop
Conecta tus claves de API de CCV Shop y pulsa Create webhook. CCV informa entonces de cada pedido pagado a ROASaurus, que lo envía a tus plataformas publicitarias desde el servidor.
| CCV Shop de un vistazo | |
|---|---|
| Los pedidos llegan por | Webhook (pedido pagado) más consulta periódica cada 5 minutos |
| Configuración del webhook | Automática, con el botón Create webhook |
| Credenciales | Clave pública y clave secreta de API gegevens |
| Firma de solicitudes | HMAC-SHA512 en cada llamada a la API |
| Fragmento de la página de agradecimiento | Página de éxito del pedido, usando Vertoshop.getOrder().getId() |
Cómo se conecta CCV Shop
- Añade el script de ROASaurus a todas las páginas: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, o un bloque de código de una app en la cabecera.
- Añade el fragmento de la página de agradecimiento a la página de éxito del pedido.
- Mijn webshop › Instellingen › Algemeen › API gegevens: copia la clave pública y la clave secreta. Si no ves API gegevens, instala primero la app de API.
- Introduce ambas claves en ROASaurus, guarda y pulsa Create webhook.
Qué hace Create webhook
ROASaurus registra un webhook de CCV para el evento order paid. CCV informa entonces de cada pedido pagado de inmediato. Cuando CCV devuelve un secreto de webhook, ROASaurus comprueba la firma HMAC-SHA512 de cada entrega; además, cada entrega debe llevar el token único de tu tienda. ROASaurus obtiene entonces el pedido completo y sus filas de pedido de la API.
Cada llamada a la API que hace ROASaurus se firma como exige CCV: un hash HMAC-SHA512 de tu clave pública, el método, la dirección, el cuerpo y una marca de tiempo.
La comprobación de 5 minutos
ROASaurus también pide a CCV los pedidos pagados cada 5 minutos. CCV solo filtra por fecha de creación, así que un pedido que se marca como pagado días después de haberse realizado lo recoge el webhook, no la comprobación.
Qué lee ROASaurus de cada pedido
El número de pedido completo, el total, la moneda, el email del cliente, el número de móvil o teléfono, el nombre, la ciudad, el código postal y el país de facturación, el id de cliente y cada fila de pedido con su número de producto, cantidad y precio.
Límites
- Los pedidos de CCV no incluyen la dirección IP del comprador, así que la alternativa por IP no está disponible. Añade el fragmento de la página de agradecimiento.
- Mantén el webhook activo: los pagos tardíos dependen de él.
- El conector está construido a partir de la documentación oficial de la API de la plataforma. Pulsa Test connection tras guardar tus credenciales, luego haz un pedido de prueba y comprueba el Event log.
Relacionado
Tus preguntas, resueltas
¿Dónde encuentro mis claves de API de CCV Shop?
En Mijn webshop › Instellingen › Algemeen › API gegevens. Si falta ese menú, instala primero la app de API de CCV.
¿Qué hace el fragmento de la página de éxito del pedido?
Lee el id del pedido con Vertoshop.getOrder().getId() y dispara con él la compra de ROASaurus, lo que vincula el pedido con el visitante y su clic en el anuncio.
¿Se envían también los pedidos pagados más tarde?
Sí, mediante el webhook de pedido pagado. La comprobación de 5 minutos solo mira los pedidos creados recientemente, así que mantén activo el webhook.
Cada venta, rastreada hasta el anuncio que la generó
Server-side tracking, beneficio y valor de vida del cliente en una sola app. Prueba gratuita de 14 días, sin tarjeta de crédito.
Empieza tu prueba gratuita →