English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

Configurer le pixel web Adapty

Si vous acquérez des utilisateurs via un tunnel web ou une page d’atterrissage, le pixel web Adapty relie chaque visite à la publicité qui l’a générée. Le pixel attribue un click ID à chaque visiteur. Lorsque le visiteur effectue un achat, vous transmettez ce click ID avec la transaction, et Adapty Attribution associe l’achat à la campagne, au groupe d’annonces et à la publicité exacts.

Le pixel est disponible pour les campagnes Meta Ads et TikTok for Business.

Note

Si votre funnel fonctionne sur FunnelFox, vous n’avez pas besoin du pixel. Consultez Intégrer FunnelFox avec Adapty Attribution.

Comment ça fonctionne

Au chargement de la page, le pixel :

  • Attribue au visiteur un click_id et le stocke dans le navigateur pendant 7 jours.
  • Capture les signaux publicitaires depuis l’URL de la page : les identifiants de clic Meta (fbclid) et TikTok (ttclid), les identifiants et noms de campagne, d’ensemble de publicités et de publicité, ainsi que les paramètres utm_*.
  • Envoie le click_id et les signaux capturés à Adapty en arrière-plan.

Au moment du paiement, vous n’associez que le click_id à la transaction. Adapty le fait correspondre aux signaux déjà envoyés par le pixel et détermine automatiquement le canal publicitaire.

Tip

Le pixel ne comptabilise que les visites sur les publicités. Pour intégrer les achats eux-mêmes dans Adapty Attribution, connectez Stripe ou Paddle.

Avant de commencer

Connectez Meta Ads ou TikTok for Business à Adapty Attribution et ajoutez une configuration de campagne. Adapty génère le snippet pixel par configuration de campagne, vous devez donc en créer une pour pouvoir copier le snippet.

Le pixel lit les données publicitaires depuis l’URL de votre page de destination, vos publicités doivent donc inclure les paramètres de suivi d’Adapty. Sans eux, Adapty attribue l’achat au réseau, mais pas à la campagne, au groupe d’annonces ou à l’annonce. Consultez Taguer vos URL d’annonces pour les web funnels.

Installer le pixel

  1. Dans Adapty Attribution, ouvrez la configuration de votre campagne Meta Ads ou TikTok.
  2. Dans l’onglet General, développez la section Web funnel et copiez la valeur du champ Pixel snippet.
Pixel snippet field in the Web funnel section of a campaign configuration in Adapty Attribution
  1. Collez le snippet dans le <head> de chaque page de votre funnel :
<script async src="https://api-ua.adapty.io/pixel/loader.js" data-code="YOUR_CODE"></script>

La valeur data-code identifie votre application et votre campagne. C’est un identifiant public, pas un secret.

Le pixel écrit un cookie propriétaire et une entrée localStorage, et lit les identifiants de clic publicitaire au chargement de la page. Vous êtes le responsable du traitement des données pour votre funnel et vous détenez la base légale correspondante.

Par défaut, le pixel s’exécute au chargement de la page. Pour le conditionner au consentement, ajoutez data-consent="denied" au snippet — le pixel ne stocke et n’envoie rien tant que vous n’accordez pas le consentement depuis votre bannière de cookies :

window.adaptyPixel.grantConsent();  // start capture
window.adaptyPixel.revokeConsent(); // clear stored state and stop
window.adaptyPixel.getConsent();    // 'granted' | 'denied'
Warning

Conditionnez le pixel au consentement pour le trafic UE/EEE. Les règles ePrivacy exigent un consentement préalable pour le stockage dans le navigateur, et un pixel d’attribution first-party n’est pas exempté.

Le snippet se charge de manière asynchrone, donc window.adaptyPixel n’existe pas à la ligne juste après la balise <script>. Appelez l’API de consentement depuis le callback de votre bannière de consentement, ou protégez un appel anticipé avec if (window.adaptyPixel) { ... }.

Notes d’utilisation

  • Funnels mono-page : La navigation côté client conserve le même click_id, donc un funnel construit comme une application mono-page fonctionne sans configuration supplémentaire.
  • Stabilité du Click ID : La lecture du click_id au chargement de la page ou au moment du paiement renvoie la même valeur. Si le visiteur accède à nouveau au funnel depuis une nouvelle publicité, le clic publicitaire le plus récent l’emporte.
  • Renouvellements : Associez le click_id uniquement à la transaction initiale. Adapty attribue les conversions d’essai et les renouvellements d’abonnement via l’abonnement lui-même.