Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.taap.it/llms.txt

Use this file to discover all available pages before exploring further.

Le suivi de conversions Taapit vous permet d’attribuer les leads et les ventes aux liens courts qui les ont générés. Cela vous permet de mesurer le véritable ROI de vos campagnes marketing.

​
Le flux de conversion

Taapit Visual manual integration

​
Concepts clés

​
1. ID de suivi (ta_tid)

Quand un utilisateur clique sur un deeplink Taapit, nous générons un ID de suivi unique et l’ajoutons à votre URL de destination : 
https://votresite.com/landing?ta_tid=rLnWe1uz9t282v7g
Cet ID lie le clic à toute conversion future. Il est :
  • Unique par clic – Chaque clic a son propre ID
  • Persistant – Stocké dans un cookie pendant 365 jours
  • Respectueux de la vie privée – Ne contient aucune information personnelle
En savoir plus sur l’ID de suivi.

​
2. Événements Lead

Un lead est un client potentiel qui a montré de l’intérêt. Exemples :
  • L’utilisateur crée un compte
  • L’utilisateur soumet un formulaire de contact
  • L’utilisateur commence un essai gratuit
  • L’utilisateur s’abonne à une newsletter
Le suivi de lead nécessite :
  • trackingId – Le ta_tid du cookie
  • customer.externalId – Votre ID utilisateur interne

​
3. Événements Sale

Une vente est une transaction complétée. Exemples :
  • Achat unique
  • Paiement d’abonnement
  • Mise à niveau vers un plan payant
  • Achat in-app
Le suivi de vente nécessite :
  • trackingId – Le ta_tid du cookie
  • customer.externalId – Votre ID utilisateur interne
  • amount – Montant de la transaction en unités de devise (ex: 29.99)
  • currency – Code devise ISO 4217 (ex: eur, usd)

​
4. Objet Customer

Les événements lead et sale incluent un objet customer pour identifier l’utilisateur : 
{
  "customer": {
    "externalId": "user_123", // Requis: Votre ID utilisateur interne
    "email": "john@example.com", // Optionnel: Email de l'utilisateur
    "firstname": "John", // Optionnel: Prénom
    "lastname": "Doe", // Optionnel: Nom
    "phoneNumber": "+33612345678", // Optionnel: Téléphone
    "avatarUrl": "https://..." // Optionnel: URL de l'avatar
  }
}
L’externalId est requis et doit être votre ID utilisateur interne. Il est utilisé pour dédupliquer les conversions et suivre la valeur vie client.

​
Modèle d’attribution

Taapit utilise l’attribution au dernier clic :
  • Si un utilisateur clique sur plusieurs liens Taapit avant de convertir, la conversion est attribuée au clic le plus récent
  • La fenêtre de cookie de 365 jours assure que les cycles de vente longs sont capturés
  • Chaque nouveau clic met à jour l’ID de suivi

​
Comparaison des types de conversion

FonctionnalitéLeadSale
ID de suiviRequisRequis
ID clientRequisRequis
MontantNon applicableRequis
DeviseNon applicableRequis
MétadonnéesOptionnelOptionnel
Cas d’usageInscriptions, essaisAchats, paiements

​
Méthodes d’intégration

Choisissez la méthode d’intégration qui convient le mieux à votre stack :

​
Intégrations natives (Zéro Code)

IntégrationIdéal pourTemps de config
StripeSaaS, abonnements2 minutes
ShopifyBoutiques e-commerce2 minutes

​
Intégrations SDK

MéthodeIdéal pourFiabilité
SDK côté clientConfigurations simplesBonne
SDK côté serveurPrécision maximaleExcellente

​
Intégrations API

MéthodeIdéal pourFlexibilité
API RESTIntégrations personnaliséesMaximale

​
Flux de données

​
Flux côté client

Navigateur → API Taapit → Votre Dashboard
  1. Le navigateur lit le ta_tid depuis le cookie
  2. Le SDK envoie l’événement à l’API Taapit
  3. Les données apparaissent dans votre dashboard
Avantages : Configuration simple, pas de changements backend
Inconvénients : Peut être bloqué par les bloqueurs de publicités

​
Flux côté serveur

Navigateur → Votre Backend → API Taapit → Votre Dashboard
  1. Le navigateur envoie le ta_tid à votre backend (cookie ou champ de formulaire)
  2. Votre backend envoie l’événement à l’API Taapit
  3. Les données apparaissent dans votre dashboard
Avantages : Ne peut pas être bloqué, plus fiable
Inconvénients : Nécessite une intégration backend

​
Confidentialité & Conformité

Taapit est conçu avec la confidentialité à l’esprit :
  • Aucune donnée personnelle dans l’ID de suivi – ta_tid est une chaîne aléatoire
  • Cookies first-party – Définis sur votre domaine, non bloqués par les navigateurs
  • Conforme au RGPD – Pas de tracking cross-site
  • Propriété des données – Vous êtes propriétaire de vos données de conversion

​
Prochaines étapes

Obtenir l'ID de suivi

Apprenez comment récupérer le ta_tid dans votre application.

Suivre les Leads

Commencez à suivre les conversions de leads.