DecisaDocumentación

Documentación · Primeros pasos

De cero a la primera conversión atribuida.

Calcula unos diez minutos. Si te atascas, la cadena tiene exactamente tres eslabones que pueden romperse y te mostraremos cómo depurar cada uno.

01

Crea un workspace

Regístrate en decisa.ai/register. El primer workspace está en el plan gratuito: 100 pedidos rastreados por mes, para siempre.

Una vez dentro, copia tu ID de workspace desde la URL (/workspaces/<slug>) y tu site key desde Configuración → Claves de API. Mantén la site key fuera del código del lado del cliente.

02

Coloca el pixel en tu sitio

Agrega una sola línea al <head> de cada página que quieras rastrear:

<script src="https://api.decisa.ai/pixel.js"
        data-workspace="WORKSPACE_ID" async></script>

El pixel establece una cookie propia (first-party) dcs_vid, captura los parámetros UTM y reenvía gclid, fbclid y ttclid a /collect. Sin cookies de terceros. Sin fingerprinting.

03

Envía tu primera conversión

Desde tu backend —en el registro, el inicio de la prueba, la suscripción o la compra— haz un POST a /v1/conversions. A continuación está la forma canónica con curl; los fragmentos idiomáticos en Node, Python, PHP y Ruby están en la referencia de la API.

curl -X POST https://api.decisa.ai/v1/conversions \
  -H "Authorization: Bearer YOUR_SITE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "signup",
    "external_id": "user-1234",
    "visitor_id": "VALUE_OF_dcs_vid_COOKIE",
    "customer_email": "[email protected]"
  }'

external_id es lo que tu sistema ya use para identificar el registro. Decisa deduplica por (workspace_id, external_id), así que los reintentos seguros no tienen costo.

04

Verifica la cadena

Abre la página Install en tu workspace y haz clic en Enviar evento de prueba. Deberías ver el clic y la conversión aparecer en el feed de actividad en vivo en unos ~2 segundos. Si el clic nunca aparece, el pixel no se cargó o tu CSP bloquea api.decisa.ai. Si el clic aparece pero la conversión no se une, tu visitor_id no coincide con el valor de la cookie: verifica que estés leyendo req.cookies.dcs_vid y no un derivado limitado a la sesión.

05

Mira el panel de ROAS a la mañana siguiente

Una vez que tu tráfico real fluye a través del pixel, la página de ROAS agrupa los ingresos atribuidos por fuente, campaña, medio y contenido. Cambia entre modelos de atribución desde la barra de filtros: los resultados anteriores siguen siendo consultables, así que tus reportes históricos no cambian en silencio.

A continuación