Skip to main content
Le Tracking ID (ta_tid) est l’identifiant central qui relie un clic sur un deeplink Taapit à une conversion future (lead ou vente).

​
Prérequis

Pour que le tracking de conversion fonctionne, vous avez uniquement besoin de deux choses :
1

Créer un deeplink Taapit

Dans votre dashboard Taapit, créez un deeplink pointant vers votre site ou landing page (ex. taap.it/ma-campagne → https://votresite.com/landing).Assurez-vous que le Conversion Tracking est activé sur le lien.
2

Installer le SDK Taapit sur votre site

Ajoutez soit la balise script soit le package NPM à votre site web ou application. C’est ce qui lit le ta_tid depuis l’URL et le stocke automatiquement dans un cookie.Option A — Balise script (la plus simple, sans étape de build) :
<script src="https://taap.it/api/sdk" data-publishable-key="pk_..."></script>
Option B — Package NPM (React / Next.js / Vue…) :
npm install taapit-sdk
C’est tout. Une fois le SDK en place et l’utilisateur arrivé via un lien Taapit, le ta_tid est capturé et persisté automatiquement — aucun code supplémentaire n’est nécessaire pour cette partie.
Le ta_tid est uniquement généré lorsqu’un utilisateur clique sur un deeplink Taapit. Si un utilisateur navigue directement vers votre site, il n’y a pas de tracking ID et aucune conversion ne sera attribuée.

​
Qu’est-ce que c’est ?

Lorsqu’un utilisateur clique sur un deeplink Taapit (ex. taap.it/abc), notre système génère un ta_tid unique et l’ajoute à l’URL de destination : 
https://votresite.com/landing?ta_tid=rLnWe1uz9t282v7g
Cet identifiant est ensuite utilisé pour attribuer tout événement lead ou sale ultérieur au clic d’origine — avec toutes ses métadonnées : paramètres UTM, géolocalisation, type d’appareil, identifiant du lien et workspace.

​
Comment est-il généré ?

Le tracking ID est une chaîne hexadécimale de 24 caractères générée côté serveur via la cryptographie Node.js : 
const trackingId = crypto.randomBytes(12).toString("hex");
// Exemple : "rLnWe1uz9t282v7g4a3b1c2d"
Il ne contient aucune donnée personnelle — il est purement aléatoire et ne peut pas être reconstitué.

​
Comment est-il persisté ?

Une fois l’utilisateur arrivé sur votre site, le SDK Taapit effectue automatiquement :
  1. La lecture du ta_tid depuis le paramètre d’URL
  2. Son stockage dans un cookie first-party sur votre domaine
Nom du cookie :   ta_tid
Durée :           365 jours
Portée :          Domaine racine (ex. .votresite.com)
Comme il s’agit d’un cookie first-party défini sur votre propre domaine, il n’est pas bloqué par les navigateurs ni par les extensions de confidentialité.

​
Comment le récupérer

​
Depuis le SDK Taapit (recommandé)

Si vous utilisez le script ou le package NPM Taapit, le SDK gère tout automatiquement. Vous pouvez accéder au tracking ID via : 
// Vanilla JS / Script tag
const trackingId = window.taapit?.getTrackingId();

// Package NPM — browser
import { getTrackingId } from "taapit-sdk/browser";

const trackingId = getTrackingId();
Si vous n’utilisez pas le SDK, vous pouvez lire le cookie directement : 
function getTrackingId() {
  const match = document.cookie.match(/(?:^|;\s*)ta_tid=([^;]+)/);
  return match ? match[1] : null;
}

​
Depuis le paramètre URL (au chargement de la page)

const params = new URLSearchParams(window.location.search);
const trackingId = params.get("ta_tid");
Si le paramètre URL et le cookie sont tous les deux présents, le paramètre URL a priorité et écrase le cookie — garantissant que le clic le plus récent est toujours attribué.

​
Le transmettre à votre backend

Une fois récupéré côté client, transmettez le ta_tid à votre backend lors d’une conversion (ex. soumission de formulaire ou paiement) : 
// Exemple : envoi du ta_tid avec un formulaire d'inscription
await fetch("/api/signup", {
  method: "POST",
  body: JSON.stringify({
    email: userEmail,
    trackingId: getTrackingId(), // depuis le SDK ou le cookie
  }),
});
Votre backend le transmet ensuite à Taapit lors de l’appel à /api/events/lead ou /api/events/sale.

​
Propriétés

PropriétéValeur
Nom du paramètreta_tid
Nom du cookieta_tid
FormatChaîne hexadécimale, 24 caractères
Généré parcrypto.randomBytes(12).toString("hex")
Durée du cookie365 jours
Contient des données personnellesNon
First-partyOui — défini sur votre domaine

​
Étapes suivantes

Tracker des leads

Utilisez le ta_tid pour suivre les conversions de type lead.

Tracker des ventes

Utilisez le ta_tid pour suivre les conversions de type sale côté serveur.