TrackAny.Click — Documentación

Getting Started

1. Crea y verifica una única cuenta de Cloud. 2. Selecciona o crea la organización propietaria de la integración. 3. Crea un proyecto para el sitio, tienda o marca cuyos datos deban permanecer juntos. 4. Abre el espacio del producto y confirma que está habilitado antes de copiar credenciales o enviar tráfico de producción.

Con esto termina la configuración de la cuenta. Las secciones siguientes son guías de implementación. Las credenciales siempre pertenecen a un proyecto; los secretos de servidor nunca deben aparecer en código del navegador, repositorios públicos ni variables del cliente.

Antes de integrar

La recopilación de TrackAny.Click se activa por proyecto. Envía datos productivos solo cuando el espacio muestre una clave pública, el fragmento de instalación y una URL activa del collector. Una URL preparada o un script de otro proyecto no activa la recopilación.

Claves pública y secreta del proyecto

La clave pública pub_tac_ pertenece al navegador y está limitada a los dominios activos del proyecto. La clave sec_tac_ se muestra una vez al crear el proyecto, pertenece solo a un gestor de secretos del servidor y autentica eventos de servidor y llamadas identify.

Si no guardaste la clave secreta, no sustituyas la pública ni expongas una clave de servidor en el navegador. Solicita un reemplazo controlado antes de integrar eventos del backend; la rotación autoservicio de la clave secreta aún no está disponible.

Instalar el tracker en el navegador

Copia el fragmento específico del proyecto en TrackAny.Click → Instalación. Carga https://trackany.click/v1/t.js, envía a https://connect.trackany.click y empieza con consentimiento denegado. data-spa=true añade la vista inicial y cambios de History API; omítelo para navegación tradicional o envía pageview manualmente.

<script>
  window.trackany = window.trackany || function () {
    (window.trackany.q = window.trackany.q || []).push(arguments);
  };
</script>
<script async
  src="https://trackany.click/v1/t.js"
  data-project="PUBLIC_PROJECT_KEY"
  data-consent="denied"
  data-spa="true">
</script>

Conectar correctamente el consentimiento

Antes del consentimiento el tracker no crea identificadores, no accede a almacenamiento persistente ni envía eventos. Llama consent=granted solo cuando el gestor de consentimiento autorice analytics. En una retirada llama consent=denied; borra el estado local de TrackAny.Click y detiene eventos nuevos, pero no es una solicitud de borrado del servidor.

Evita datos personales en URLs, UTM y propiedades. Se eliminan querystrings y fragmentos de las URLs, se reduce el referrer y el SDK no usa fingerprinting.

Medir páginas, leads y conversiones

Usa nombres de evento snake_case en minúsculas. Marca objetivos reales con conversion=true y envía valor y moneda de tres letras siempre juntos. Las llamadas del navegador incluyen automáticamente el contexto consentido de visitante, sesión y atribución.

Usa un evento para un hecho de negocio. No informes la misma compra en navegador y servidor salvo que ambos eventos representen deliberadamente hechos distintos.

window.trackany("consent", "granted");
window.trackany("pageview");
window.trackany(
  "event",
  "qualified_lead",
  { form: "demo_request" },
  { conversion: true }
);

Enviar un evento confiable desde el servidor

Haz POST de JSON a /v1/events con la clave secreta como Bearer token. Los eventos de servidor pueden incluir contactId o externalId y se informan separados de los del navegador. Conserva eventId al reintentar: contenido idéntico se deduplica; contenido cambiado bajo la misma ID devuelve HTTP 409 event_id_conflict.

curl --request POST "https://connect.trackany.click/v1/events" \
  --header "Authorization: Bearer $TRACKANY_SECRET_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "eventId": "evt_01JZ8J2K9M7P4Q6R8S1T3V5W7X",
  "event": "purchase",
  "timestamp": "2026-09-08T17:00:00Z",
  "contactId": "crm_123",
  "value": 49.9,
  "currency": "USD",
  "conversion": true,
  "properties": {
    "plan": "pro"
  }
}'

Conectar un visitante con tu sistema

Tras un formulario o login, lee la visitorId consentida mediante window.trackany.getContext() y envíala desde el backend a POST /v1/identify con contactId, externalId o ambos. El endpoint exige la clave secreta; las claves públicas se rechazan.

curl --request POST "https://connect.trackany.click/v1/identify" \
  --header "Authorization: Bearer $TRACKANY_SECRET_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "visitorId": "vis_01JZ8J2K9M7P4Q6R8S1T3V5W7X",
  "contactId": "crm_123"
}'

Definir el modelo de eventos

Define un vocabulario pequeño antes de implementar, por ejemplo page_view → form_submitted → qualified_lead → purchase. Mantén actividad de adquisición y resultados posteriores como eventos distintos para que los informes muestren orden observado y nivel de confianza.

Conservar la atribución de campaña

Usa utm_source, utm_medium y utm_campaign coherentes e IDs estables como utm_id, utm_adgroup_id y utm_ad_id. TrackAny.Click separa primer touch, touch de sesión actual y último touch no directo; el nombre de campaña por sí solo no es una clave de unión fiable.

Lotes y resultados

Envía 1–100 eventos a /v1/events/batch cuando un proceso tenga varios hechos independientes. El servicio valida primero el lote completo y puede devolver HTTP 207 con resultados por evento si solo algunas escrituras funcionan. Conserva ID y payload para reintentos seguros.

Leer recorridos y tratar errores

HTTP 202 indica evento aceptado. Trata 400 como error de contrato o fecha, 401 como clave inválida, 402 como cuota o saldo requerido, 403 como origen bloqueado, 409 como reutilización cambiada de eventId y 429 como rate limit. Reintenta fallos transitorios con la misma ID y payload.

Los informes de recorridos y funnels son vistas limitadas, no un grafo de identidad. Muestran cobertura y truncamiento, separan monedas y fuentes de confianza y no afirman certeza entre dispositivos.