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.
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.
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.
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.
En esta página
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.
<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.
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íoAPI 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.
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"}}]}'Integración del consentimiento
Usa una CMP compatible (TCF 2.2, GPP/GPC, Cookiebot, OneTrust, Usercentrics), que el tracker lee automáticamente, o llama a la API de consentimiento desde tu propio banner. Finalidades: necessary, analytics, marketing, personalization. La retirada lo detiene todo de inmediato.
tsq.push(["consent", { granted: ["necessary", "analytics", "marketing"], source: "api", policy_version: "2026-09" }]);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.
| Endpoint | Finalidad | Notas |
|---|---|---|
POST /v1/e | Lotes de navegador | ≤ 50 eventos por lote |
POST /v1/s | Lotes de servidor | ≤ 100 eventos por lote, clave de origen como Bearer |
POST /v1/affiliate/in/{trackingId}/{preset} | Postbacks entrantes de redes de afiliación | 13 presets de red |
GET /c/{trackingId}/manifest.json | Manifiesto de configuración y bundle firmado | Firmado con Ed25519, verificado por el SDK de navegador |