¿Cómo conecto un checkout personalizado a Decisa?

Si tu tienda o plataforma de pagos no tiene conexión nativa con el Decisa, abre Sitio personalizado en Integraciones: instala el píxel y haz que el backend de tu checkout reporte cada pedido a Decisa usando tu clave (Site key) — el asistente de prompts con IA de la página escribe ese código por ti.

Antes de empezar

• Un workspace con el módulo de Atribución activo.
• Acceso al sitio web al que llegan tus compradores (o alguien — una persona o un asistente de IA — que pueda pegar un fragmento de código en él).
• Alguien que pueda tocar el código del backend de tu checkout. La página genera un prompt listo para usar, así que un asistente de IA de programación es suficiente.
• El rol de Admin si necesitas ver la clave Site key — los demás miembros ven un aviso que les pide acudir a un admin.

Pasos

1. Abre Sitio personalizado

   Ve a Barra lateral → Integraciones → Sitio personalizado. La página es una guía de dos pasos: Elegir píxeles e Instalar y rastrear.

2. Elige tus píxeles

   Selecciona uno o más píxeles — los destinos a los que este sitio reporta. Todos los fragmentos de código y ejemplos de los pasos siguientes se actualizan según tu selección.

3. Usa Automático para la integración completa

   Mantén Automático (marcado como Recomendado), haz clic en Copiar prompt y pégalo en Claude, ChatGPT o Cursor. El prompt apunta al asistente a la guía Markdown viva de instalación de Decisa, incluye los píxeles seleccionados, API base y clave del servidor, y le pide instalar pixel.js, preservar el visitor id dcs_vid y enviar conversiones/eventos reales desde el backend.

4. Usa Manual cuando quieras programarlo tú

   Elige Manual para ver la URL de la guía técnica, snippets de browser, tu Site key, ejemplos de conversión y la referencia de señales en /events. Trata la Site key como contraseña; pertenece solo al servidor y va en cada solicitud de conversión/evento que envíe tu backend.

5. Confirma que los eventos están llegando

   En la tarjeta Live events, haz clic en Send test event. El estado cambia a Receiving events y la prueba aparece en la lista de abajo en cuestión de segundos.

Qué pasa después

• Cada pedido que reporta tu checkout aparece en tu lista de conversiones, vinculado al clic y a la campaña que lo generó.
• La tarjeta Live events sigue mostrando los últimos cinco clics capturados por tu píxel, con actualización automática.
• Tu reporte de ROAS empieza a acreditar ingresos reales a las campañas.
• La guía técnica en producción está en https://api.decisa.ai/v1/docs/attribution-installation.md y es la fuente de verdad para /conversions, /events, /identify, continuidad del visitante y campos de calidad del evento.

Cuidado con esto