Track

Documentación

Documentación

Todo lo necesario para instalar Track, enviar eventos de servidor, integrar el consentimiento y configurar destinos. El asistente del panel enlaza aquí en cada paso.

Tres pasos para una configuración operativa

Instala una vez, envía tus eventos y conecta las plataformas que usas. Cada paso se puede verificar en el panel antes de continuar.

  1. Instala el snippet

    Añade una etiqueta script asíncrona a tus páginas. Carga la configuración firmada de tu ID de tracking y respeta el consentimiento desde la primera vista de página.

    Puedes comprobarLas vistas de página aparecen en el depurador de eventos.

  2. Envía tus eventos

    Usa los eventos estándar desde el navegador, un plugin de tienda o tu servidor. Las compras llevan un ID de pedido para que las copias de navegador y de servidor se dedupliquen.

    Puedes comprobarCada evento muestra su estado de consentimiento y el motivo por el que se entregó o se retuvo.

  3. Conecta un destino

    El asistente paso a paso valida las credenciales, mapea los eventos, envía un evento de prueba real y publica solo tras tu aprobación.

    Puedes comprobarLa salud de entrega y la última entrega correcta se muestran por destino.

Cómo viaja un evento

Todos los eventos siguen la misma ruta, vengan del navegador, de un plugin de tienda o de tu servidor: Track los valida y deduplica, evalúa la política de consentimiento y los enruta a los destinos que hayas configurado.

Cómo viaja un eventoSitio web → Track → Consentimiento/Políticas → Destinos. Un evento sin la finalidad de consentimiento requerida se detiene en el control: ni se almacena ni se reenvía.Sitio webnavegador · servidorTrackvalidar · deduplicar · enrutarConsentimientoretenido: sin finalidadfinalidad concedidaMetaGoogle AdsGA4Destinos
Sitio web → Track → Consentimiento/Políticas → Destinos. Un evento sin la finalidad de consentimiento requerida se detiene en el control: ni se almacena ni se reenvía.

Guías

Instala el snippet

Añade el script asíncrono a todas las páginas, idealmente en el head. Carga la configuración firmada de tu ID de tracking, respeta el consentimiento y nunca bloquea el renderizado. Sustituye TRACKING_ID por el ID de seis caracteres de tu panel.

Snippethtml
<script async src="https://cdn.track.site/v1/tracker.js" data-site-id="TRACKING_ID"></script>

Envía eventos de navegador

Los eventos estándar (page_view, view_item, add_to_cart, begin_checkout, purchase, generate_lead, sign_up, subscribe, start_trial, contact, book_appointment, download, search, login) llevan parámetros validados; los eventos personalizados usan nombres en snake_case en minúsculas.

Navegadorjs
window.tsq = window.tsq || [];
tsq.push(["track", "purchase", { order_id: "A1001", currency: "EUR", value: 129.9, items: [{ item_id: "SKU-1", price: 99.9, quantity: 1 }] }]);
tsq.push(["identify", { user_id: "u_42", email: "customer@example.com" }]); // hash en el cliente antes del envío

API de servidor y conversiones offline

Crea una clave de origen en Ajustes → Claves de origen del servidor y envía eventos desde tu backend, CRM o TPV. Indica el mismo ID de pedido que el evento de navegador para la deduplicación; añade props.offline para las conversiones offline.

POST /v1/sbash
curl -X POST https://api.track.site/v1/s \
  -H "Authorization: Bearer tsk_..." -H "Content-Type: application/json" \
  -d '{"events":[{"name":"purchase","ts":1767225600000,"props":{"offline":true},"commerce":{"order_id":"A1001","currency":"EUR","value":129.9},"user_data":{"email":"customer@example.com"},"click_ids":{"gclid":"Cj0K..."},"consent":{"granted":["necessary","marketing"],"source":"crm"}}]}'

Destinos

Cada destino tiene un asistente paso a paso: identificadores, credenciales en el almacén cifrado u OAuth, validación del proveedor, mapeo de eventos con valores por defecto verificados, un evento de prueba real, lint, diff y publicación con aprobación. Navegador y servidor comparten un ID de evento; las compras añaden el ID de pedido.

  • Meta, Google Ads/YouTube, GA4, TikTok, Microsoft, LinkedIn, Reddit, Pinterest, Snapchat
  • X, Taboola, Outbrain, Amazon Ads, Spotify, Quora
  • Yahoo DSP, The Trade Desk, Google Marketing Platform, AdRoll, Criteo, postbacks de afiliación (13 presets), webhooks

Plataformas de e-commerce

Shopify (app con webhooks de pedidos y web pixel), WooCommerce (plugin con webhooks de pedidos firmados) y Shopware 6 (app con script de storefront y webhooks de pedidos) envían eventos verificados de compra y reembolso con ID de pedido. Instala el plugin, pega el ID de tracking y la clave de origen, y listo.

  • Fuente verificada: los eventos se marcan como source_verified y se usan como conversión autorizada
  • Los reembolsos generan eventos de valor negativo en los proveedores que los admiten
  • Las compras de navegador del tema se deduplican por ID de pedido

Centro de privacidad y solicitudes de los interesados (DSAR)

Los plazos de retención por tipo de datos, las versiones de la política de consentimiento por sitio y las solicitudes de los interesados (exportación, supresión, limitación, rectificación, oposición, portabilidad) se gestionan en Consentimiento y privacidad. Las solicitudes usan solo identificadores con hash y generan un informe auditado.

Endpoints de un vistazo

Todas las respuestas son JSON; 202 significa que el lote se ha encolado de forma duradera.

Endpoints de un vistazo
EndpointFinalidadNotas
POST /v1/eLotes de navegador≤ 50 eventos por lote
POST /v1/sLotes de servidor≤ 100 eventos por lote, clave de origen como Bearer
POST /v1/affiliate/in/{trackingId}/{preset}Postbacks entrantes de redes de afiliación13 presets de red
GET /c/{trackingId}/manifest.jsonManifiesto de configuración y bundle firmadoFirmado con Ed25519, verificado por el SDK de navegador