Démarrage rapide web : première inscription attribuée

Ce guide rattache les inscriptions d’un site web aux publicités qui les ont amenées. Il faut quatre éléments : deux clés, le SDK navigateur sur le site, un SDK serveur sur le backend, et un lien de tracking qui arrive sur le site. À la fin, un clic sur votre lien suivi d’une inscription revient attribué à la campagne du lien — par l’id de ce clic, pas par une estimation. Pour une app, c’est le démarrage rapide app qu’il faut suivre.

Étapes#

1. Créez les deux clés#

   Dans la console, ouvrez votre produit, puis Intégrations → SDK. Créez :

   • une clé web (tq_web_…), listant chaque origine qui sert le site — https://www.example.com, https://app.example.com. Elle est publique : elle va dans vos pages, et ne fonctionne que depuis ces origines ;
   • une clé serveur (tq_sk_…). C’est un secret, affiché une seule fois : placez-la dans l’environnement de votre backend sous TRAQIO_SECRET_KEY.

2. Ajoutez @traqio/web au site#

   npm install @traqio/web

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

   Une fois, le plus tôt possible, sur chaque page — la page du SDK web le montre pour React, Vue, Angular et une simple balise <script>. Quand un visiteur arrive depuis votre lien, il garde le trackID dans un cookie first-party sur votre domaine.

3. Signalez l’inscription depuis le 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: "…", … }

   Là où le compte est créé, une seule fois. La requête d’inscription porte le cookie : le trackID y est lu. Chaque page SDK — Node.js, PHP / Laravel, Python — couvre ses frameworks, ses erreurs et les achats.

4. Créez un lien de tracking vers votre site#

   Dans Liens, créez un lien : la régie publicitaire, l’id de campagne que la régie vous donne — c’est lui qui relie les clics aux dépenses — et, en Destination site web, la page que la publicité doit ouvrir. Placez l’URL de clic du lien dans la publicité. Un clic arrive sur cette page, sur tous les appareils, avec le trackID ajouté :

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

5. Cliquez, inscrivez-vous, lisez la réponse#

   Ouvrez l’URL de clic du lien dans un navigateur, puis inscrivez-vous sur le site avec un nouveau compte. L’appel signup de votre backend répond matched, et son attribution indique le réseau et la campagne du lien.

   Où le lire

   La réponse de l’appel serveur donne l’attribution tout de suite. Dans la console, le rapport ROAS compte l’inscription comme une conversion web de la campagne du lien, à côté de ses installations.

Ensuite#

• Signalez les achats et les abonnements avec track, avec leur valeur, leur devise et leur id de paiement — ils suivent l’utilisateur jusqu’à la campagne qui l’a acquis.
• Lisez l’attribution web pour les règles : un clic par identité, la fenêtre d’attribution, le dernier clic avant l’inscription.

Questions fréquentes#

Pourquoi mon inscription de test revient-elle sans trackID ?

La visite n’a pas commencé par le lien de tracking, la page n’a pas exécuté @traqio/web, ou votre backend est sur un autre domaine que le site, si bien que le cookie traq_click ne lui parvient pas. Dans ce dernier cas, envoyez Traqio.getTrackId() depuis le navigateur avec le formulaire d’inscription.

Pourquoi une deuxième inscription de test répond-elle claimed ?

Un clic crédite une seule identité : une fois un clic lié à un utilisateur, un autre utilisateur ne peut plus le revendiquer. Cliquez à nouveau sur le lien pour chaque utilisateur de test — chaque clic est un nouveau trackID.