Inicio rápido web: tu primer registro atribuido

Esta guía vincula los registros de un sitio web a los anuncios que los trajeron. Hacen falta cuatro piezas: dos claves, el SDK de navegador en el sitio, un SDK de servidor en el backend y un enlace de seguimiento que lleve al sitio. Al final, un clic en tu enlace seguido de un registro llega atribuido a la campaña del enlace — por el id de ese clic, no por una suposición. Para una app, la guía que hay que seguir es el inicio rápido de apps.

Pasos#

1. Crea las dos claves#

   En la consola, abre tu producto y luego Integraciones → SDK. Crea:

   • una clave web (tq_web_…), con cada origen que ejecuta el sitio — https://www.example.com, https://app.example.com. Es pública: va en tus páginas y solo funciona desde esos orígenes;
   • una clave de servidor (tq_sk_…). Es secreta y se muestra una sola vez: ponla en el entorno de tu backend como TRAQIO_SECRET_KEY.

2. Añade @traqio/web al sitio#

   npm install @traqio/web

   import { Traqio } from "@traqio/web";
   
   Traqio.init({ sdkKey: "YOUR_WEB_KEY" }); // tq_web_… — a WEB key, not the app key

   Una vez, lo antes posible, en cada página — la página del SDK web lo muestra para React, Vue, Angular y una etiqueta <script> simple. Cuando un visitante llega desde tu enlace, guarda el trackID en una cookie first-party en tu dominio.

3. Reporta el registro desde el backend#

   Node.jsPHP / LaravelPython

   npm install @traqio/node

   Node.jsPHP / LaravelPython

   import { Traqio, trackIdFromRequest } from "@traqio/node";
   
   const traqio = new Traqio({ secretKey: process.env.TRAQIO_SECRET_KEY! });
   
   // where the account is created
   const result = await traqio.signup({ userId: user.id, trackId: trackIdFromRequest(req) });
   console.log(result.trackId, result.attribution); // "matched" { network: "meta", campaignId: "…", … }

   Donde se crea la cuenta, una vez. La petición de registro lleva la cookie, así que el trackID se lee de ella. Cada página de SDK — Node.js, PHP / Laravel, Python — cubre sus frameworks, sus errores y las compras.

4. Crea un enlace de seguimiento hacia tu sitio#

   En Enlaces, crea un enlace: la red publicitaria, el id de campaña que te da la red — es lo que une los clics con el gasto — y, como Destino web, la página que debe abrir el anuncio. Pon la URL de clic del enlace en el anuncio. Un clic llega a esa página, en cualquier dispositivo, con el trackID añadido:

   https://www.example.com/pricing?traq_click=3f7c…&traq_source=meta&traq_campaign=summer

5. Haz clic, regístrate, lee la respuesta#

   Abre la URL de clic del enlace en un navegador y regístrate en el sitio con una cuenta nueva. La llamada signup de tu backend responde matched, y su atribución indica la red y la campaña del enlace.

   Dónde leerlo

   La respuesta de la llamada al servidor da la atribución al instante. En la consola, el informe de ROAS cuenta el registro como una conversión web de la campaña del enlace, junto a sus instalaciones.

Siguientes pasos#

• Reporta las compras y suscripciones con track, con su valor, su moneda y su id de pago — siguen al usuario hasta la campaña que lo captó.
• Lee atribución web para las reglas: un clic por identidad, la ventana de atribución, el último clic antes del registro.

Preguntas frecuentes#

¿Por qué mi registro de prueba llega sin trackID?

La visita no empezó desde el enlace de seguimiento, la página no ejecutó @traqio/web, o tu backend está en otro dominio que el sitio, así que la cookie traq_click no le llega. En este último caso, envía Traqio.getTrackId() desde el navegador con el formulario de registro.

¿Por qué un segundo registro de prueba responde claimed?

Un clic acredita una sola identidad: una vez vinculado a un usuario, otro usuario no puede reclamarlo. Vuelve a hacer clic en el enlace para cada usuario de prueba — cada clic es un nuevo trackID.