¿Cómo instalo el píxel de Decisa en mi sitio?

Crea un píxel en Píxeles, luego abre Custom Site (sitio personalizado) en Integraciones y pega el snippet de una sola línea en tu sitio — tu primera visita aparece como clic en cuestión de segundos.

Un píxel es el destino al que reporta tu sitio (Meta, TikTok o Google). El snippet es una sola etiqueta <script> que se carga en cada página, establece una cookie first-party y registra cada vista de página como un clic — el hilo que después conecta los pedidos con tus anuncios.

Antes de empezar

• Acceso a un workspace. Instalar el píxel es una de las acciones que activa el módulo de Atribución.
• De tu plataforma de anuncios: la credencial del píxel y su token de la API de Conversiones (puedes agregar o rotar el token más adelante). La credencial depende de la plataforma — un Pixel ID para Meta, un Pixel code para TikTok o un ID de cliente de Google Ads para Google.
• Una forma de modificar tu sitio — su HTML, tu tema de Shopify, Google Tag Manager — o un asistente de código con IA, como Claude o ChatGPT, que lo haga por ti.

Pasos

1. Crea un píxel

   Usa Barra lateral → Atribución → Píxeles y agrega un píxel: elige la plataforma (Meta, TikTok o Google), ponle un nombre fácil de reconocer y pega las credenciales y el token de la API de Conversiones de la plataforma. Meta pide un Pixel ID y TikTok un Pixel code; Google identifica por ID de cliente, así que el formulario agrega un campo Customer ID (tu ID de cliente de Google Ads) y deja el identificador externo como opcional. Un workspace puede tener varios píxeles — uno por sitio o por plataforma.

2. Abre Custom Site (sitio personalizado) y elige tus píxeles

   Usa Barra lateral → Integraciones → Custom Site (sitio personalizado — la tarjeta y el título de la página aparecen en inglés). El primer paso del asistente muestra tus píxeles habilitados — selecciona aquellos a los que este sitio debe reportar. El snippet de instalación se actualiza según tu selección.

3. Instala el snippet

   Elige un camino. La opción automática entrega un prompt que le pide a Claude, ChatGPT o Cursor leer primero la guía Markdown viva de instalación de Decisa, luego instalar el píxel y configurar conversiones/eventos server-side con los píxeles seleccionados y la clave del servidor. La opción manual muestra la misma URL de la guía técnica y snippets listos en las pestañas HTML, Next.js, Shopify y GTM; pega el snippet antes de la etiqueta de cierre </head> en cada página que quieras rastrear.

4. Verifica la instalación

   Abre tu sitio en un navegador y luego revisa Barra lateral → Atribución → Clics — tu visita aparece en cuestión de segundos, y el asistente marca el paso de instalación como completado. El paso final del asistente también ofrece una opción servidor a servidor con un panel Live events (eventos en vivo) que cambia de Waiting (en espera) a Receiving events (recibiendo eventos) y muestra los últimos cinco clics; Send test event (enviar evento de prueba) entrega un clic y una conversión de prueba al instante.

Qué sucede después

• Cada visita a tu sitio queda registrada en Clics, con su fuente, medio y campaña de UTM.
• Las compras y los registros que rastrees más adelante aparecen en Conversiones, vinculados al clic que trajo al visitante.
• La opción servidor a servidor también revela tu Site key (clave del sitio) — el secreto que tu backend usa para enviar conversiones directamente a Decisa. Mantenla en el servidor, nunca en el código de la página; solo los administradores del workspace pueden verla.
• La URL de la guía manual en producción es https://api.decisa.ai/v1/docs/attribution-installation.md. Cubre pixel.js, /identify, /events, /conversions, continuidad del visitante, señales de calidad, CSP y decoración segura de enlaces.

Cuidado con esto