Conceptos
Atribución web: del clic en el anuncio al registro
Cómo vincula Traqio los registros y compras de un sitio al clic en el anuncio: el trackID en la URL, el almacenamiento first-party y tu backend.
En un sitio web, la conversión que cuenta — un registro, una suscripción, una compra — ocurre en tu backend, donde se conoce el id de usuario, a menudo minutos o días después del clic en el anuncio y a varias páginas de distancia. Traqio une ambos con el trackID, el id del propio clic: viaja en la URL de llegada, espera en almacenamiento first-party en tu propio dominio y llega a tu backend con la petición de registro, que lo reporta junto con el id del usuario. La conversión queda vinculada al clic que designa — de forma determinista, nunca emparejando dispositivos que se parecen.
La cadena, paso a paso#
| Paso | Dónde | Qué ocurre |
|---|---|---|
| 1. El clic | El host de seguimiento de Traqio | El anuncio apunta a un enlace de seguimiento con un destino web. Traqio registra el clic y redirige a tu página con traq_click=<trackID> en la URL. |
| 2. La llegada | El navegador del visitante | @traqio/web lee traq_click de la URL y lo guarda: en localStorage y en una cookie traq_click en tu dominio registrable. |
| 3. El registro | Tu backend | La petición de registro lleva la cookie. Tu backend crea la cuenta y luego llama a signup() de un SDK de servidor con el id de usuario y el trackID. |
| 4. El vínculo | Traqio | El clic queda vinculado a ese usuario, una sola vez. El registro es la captación; el último clic válido anterior se lleva el crédito. |
| 5. Las conversiones | Tu backend | Las compras y suscripciones se reportan con el mismo id de usuario. Siguen al usuario hasta la campaña que lo captó. |
El trackID en la URL de llegada#
Un enlace de seguimiento con un destino web envía cualquier dispositivo — móvil u ordenador — a esa página y añade los parámetros de Traqio a su query string: traq_click (el trackID) y, cuando el enlace los tiene, traq_source, traq_campaign, traq_adset y traq_ad. Tus propios parámetros — utm_* incluidos — y el #fragment de la página se conservan tal como los escribiste; el prefijo traq_ nunca choca con ellos. Un enlace sin destino web sigue enviando a la gente a App Store y Google Play, como antes.
Almacenamiento first-party#
@traqio/web lee traq_click en cuanto arranca, antes que nada, así que un visitante que se va enseguida lo conserva. Lo guarda dos veces, ambas en tu dominio:
- localStorage, con su caducidad — sobrevive a la navegación y vuelve en el mismo origen;
- una cookie
traq_clicken tu dominio registrable (example.com), para quewww.,app.y tu backend en el mismo dominio la vean — el backend la recibe con la petición de registro, sin JavaScript.
Se conserva 30 días por defecto (trackIdDays). Sin cookies de terceros, sin fingerprinting, sin identificador publicitario. Con waitForConsent, no se escribe nada en el dispositivo antes de que el visitante dé su consentimiento.
Vincular la conversión a un usuario, en tu servidor#
Tu backend reporta el registro con un SDK de servidor — Node.js, PHP / Laravel o Python — con dos datos: tu id de usuario y el trackID. Se autentica con una clave de servidor, un secreto que nunca sale de tu backend. Ese secreto es lo que permite aceptar con seguridad un id de clic aportado por quien llama: la clave web de tu página podría usarla cualquiera, así que nunca puede atribuir nada.
Las reglas que aplica Traqio#
- Un clic, una identidad. Un clic vinculado a un usuario no puede reclamarlo otro usuario, ni una instalación de app — la respuesta es
claimed. Reportar de nuevo el mismo clic para el mismo usuario no tiene efecto. - La ventana. Un clic más antiguo que la ventana de atribución del producto es
expired. - Antifraude. Un clic que pasó por una red de anonimización es
refusedy se contabiliza, igual que para una instalación de app. - La captación es el registro. Se conserva el primer registro reportado; el último clic anterior, dentro de la ventana, se lleva el crédito. Un clic posterior no acredita nada.
- Las conversiones siguen al usuario. Una compra reportada más tarde con el mismo id de usuario son ingresos de la campaña que captó a ese usuario — deduplicada por su id de evento y su id de pago.
Cada llamada responde con lo que ha decidido: el estado del trackID y la campaña acreditada ahora para el usuario.
En la consola, el informe de ROAS cuenta las conversiones web de una campaña como una cifra propia, junto a sus instalaciones y nunca dentro de ellas, y una compra hecha en tu sitio es ingreso de la campaña de su usuario. El generador de informes tiene conversiones web, conversiones web atribuidas y coste por conversión web; un producto solo web tiene un KPI de conversiones web en su Resumen y una plantilla de panel Adquisición del sitio.
Un producto con una app y un sitio web#
El id de usuario es la identidad. Cuando tu app y tu backend reportan el mismo id de usuario, Traqio ve una sola persona: gana el último clic válido antes de la captación, venga de la superficie que venga. Una instalación de app conserva la atribución que recibió, y una conversión enviada desde tu servidor nunca se vincula a una instalación de app, así que las instalaciones, los ingresos y el ROAS de las apps siguen siendo exactamente lo que reportan las apps.
Límites#
- Otro navegador, sin iniciar sesión. Un clic en el navegador integrado de una app seguido de un registro en Safari no lleva trackID: el registro es orgánico, nunca adivinado.
- Safari conserva 7 días el almacenamiento escrito por JavaScript en los sitios que clasifica como rastreadores: un trackID puede caducar antes allí.
- Un backend en otro dominio no recibe la cookie: el formulario debe enviar
Traqio.getTrackId()por sí mismo.
Todavía no
Preguntas frecuentes#
- ¿Qué es el trackID?
- El id de un clic en un anuncio. Cuando alguien hace clic en un enlace de seguimiento de Traqio cuyo destino es una página de tu sitio web, Traqio registra el clic y añade su id a la URL de llegada en el parámetro traq_click. Ese id es el trackID: designa ese clic exacto, así que la conversión a la que viaja queda vinculada a él sin ninguna suposición.
- ¿La atribución web es probabilística?
- No. El trackID viaja del clic a la conversión en almacenamiento first-party en tu propio dominio, y luego tu backend se lo entrega a Traqio con el id del usuario. La conversión queda vinculada al clic que designa. Una conversión que llega sin trackID es orgánica — nunca se asigna a una campaña por parecido.
- ¿Por qué el SDK de navegador no puede enviar el trackID por sí mismo?
- Porque su clave es pública: está en tu página, donde cualquiera puede leerla y enviar peticiones con ella. Una clave que cualquiera puede usar no debe poder acreditar una campaña, así que vincular una conversión a un clic requiere la clave de servidor secreta, que solo tiene tu backend.
- ¿Qué pasa cuando la misma persona usa la app y el sitio web?
- Si tu backend y tu app usan el mismo id de usuario, es la misma identidad en Traqio: el último clic válido antes de captar al usuario — en la web o en la app — se lleva el crédito. Una instalación de app conserva su propia atribución, y una conversión web nunca se vincula a una instalación de app.