Intégrer Meta Ads avec Adapty Attribution

L’intégration d’Adapty Attribution avec Meta vous permet de suivre et d’optimiser les performances de vos campagnes sur Facebook, Instagram, Messenger et le réseau d’audience.

Étape 1. Connecter votre compte Facebook

Pour connecter Meta Ads à Adapty Attribution, accédez à Integrations > Meta depuis la barre latérale gauche. Vous avez deux options :

• Continue with Facebook : connexion via OAuth. Utilisez cette option si vous vous connectez à Meta Ads Manager avec votre compte Facebook personnel ou professionnel.
• Add system token : connexion via un jeton système permanent. Utilisez cette option si votre organisation gère des comptes publicitaires via un utilisateur système Meta Business.

Important

Assurez-vous que votre compte Facebook a accès aux campagnes et pixels dont vous avez besoin.

1. Cliquez sur Continue with Facebook.

2. Connectez-vous avec votre compte Facebook et cliquez sur Continue.

3. Vérifiez les permissions demandées et cliquez sur Save.

Générez un jeton d’accès utilisateur système dans Meta Business Settings, puis ajoutez-le à Adapty Attribution.

Important

Avant de commencer, vous avez besoin d’un utilisateur système dans votre portefeuille Meta Business, avec les comptes publicitaires que vous souhaitez suivre déjà assignés. Vous devez également avoir une application ajoutée au portefeuille — vous sélectionnez cette application lors de la génération du jeton.

Dans Meta Business Settings, générez le token :

1. Accédez à Business Settings.
2. Sous Users, sélectionnez System users.
3. Sélectionnez votre utilisateur système, puis cliquez sur Generate new token.
4. Sélectionnez votre application dans le menu déroulant.
5. Dans la liste des permissions, activez ads_read. C’est la seule permission dont Adapty Attribution a besoin pour lire les données de vos campagnes et annonces.
6. Cliquez sur Generate token.
7. Copiez le token et conservez-le en lieu sûr. Meta ne l’affiche qu’une seule fois.

Note

Le paramètre Token expiration contrôle la durée d’activité de la connexion. Un token avec une date d’expiration doit être régénéré et reconnecté avant son expiration, sinon l’attribution s’arrête. Un token sans expiration évite ce problème, mais constitue un identifiant de longue durée. Conservez-le en lieu sûr et révoquez-le s’il venait à être exposé.

Dans Adapty Attribution, ajoutez le token :

1. Cliquez sur Add system token.

2. Collez le token et cliquez sur Connect.

Après cela, tous vos comptes publicitaires seront ajoutés à Adapty Attribution. Vous pouvez poursuivre en ajoutant des campagnes.

Étape 2. Ajouter des campagnes

Pour ajouter une campagne Meta à Adapty Attribution et suivre les performances de vos publicités Meta dans Adapty :

1. Basculez vers l’onglet Web Campaigns et cliquez sur Create configuration.

2. Dans l’onglet General, développez la section iOS et/ou Android et collez les URLs de votre application sur l’App Store et/ou Google Play.

3. Copiez la valeur du champ Click link. Ensuite, dans Meta Ads Manager, ouvrez votre publicité et collez ce lien. Cela permettra à Adapty de relier les installations et les achats aux publicités Meta.

4. Pour renvoyer les événements de conversion vers Meta, vous pouvez également associer vos pixels Meta à des campagnes dans Adapty Attribution. Pour ce faire, sélectionnez l’un de vos pixels existants dans le menu déroulant Pixel. Après avoir sélectionné un pixel, vous pouvez cliquer sur Send test event pour vérifier la connexion.

Étape 3. Associer les événements

Pour renvoyer des événements de conversion à Meta et optimiser vos campagnes, vous devez configurer l’association des événements dans la section Events names. Cela permet à Adapty d’envoyer automatiquement les événements d’abonnement à votre pixel Meta lorsque les utilisateurs effectuent des actions dans votre application.

Dans la section Events names, activez les événements que vous souhaitez suivre dans Meta Ads Manager. Pour chaque événement activé, sélectionnez l’événement Meta correspondant dans le menu déroulant ou définissez-en un personnalisé. Par défaut, Adapty associe les événements Adapty aux événements standard de Meta.

Cliquez sur Save pour appliquer votre configuration d’association des événements.

Configuration supplémentaire

Paramètres supplémentaires

Le champ Additional parameter vous permet d’ajouter des données personnalisées pour les analyses effectuées en dehors d’Adapty. C’est utile lorsque vous devez transmettre des informations spécifiques sur une campagne ou un utilisateur à des outils d’analyse externes ou à des partenaires d’attribution.

Dans le champ Additional parameter, saisissez les données personnalisées que vous souhaitez inclure dans votre suivi d’attribution. Ce paramètre supplémentaire sera intégré à toutes les données d’attribution envoyées à Meta et pourra être utilisé pour une analyse et une optimisation avancées des campagnes.

Par exemple, si vous exécutez plusieurs variations de la même campagne, vous pouvez ajouter variant=A ou variant=B pour distinguer différentes approches créatives.

Paramètres

L’onglet Settings détermine comment Adapty associe les actions des utilisateurs à vos campagnes Meta Ads. Ces paramètres définissent les fenêtres temporelles pour la correspondance d’attribution déterministe et probabiliste.

Pour les configurer, accédez à l’onglet Settings dans la configuration de votre campagne. Vous y trouverez deux paramètres principaux à ajuster :

• Fenêtre de correspondance déterministe : cette méthode utilise des identifiants d’appareil exacts (comme l’IDFA sur iOS ou l’Advertising ID sur Android) pour associer les utilisateurs aux campagnes avec une grande précision. Réglez-la sur 168 heures (7 jours) pour une précision d’attribution maximale — c’est la valeur par défaut et recommandée. Lorsqu’un utilisateur clique sur votre annonce Meta et installe votre application dans cette fenêtre, Adapty peut attribuer l’installation de façon certaine à ce clic publicitaire précis grâce aux identifiants d’appareil.

• Probabilistic matching window : utilise la modélisation statistique et le fingerprinting d’appareil pour associer les utilisateurs lorsque la correspondance déterministe n’est pas possible. Réglez ce paramètre sur 6 heures pour la plupart des campagnes — c’est la valeur par défaut et elle convient à la majorité des cas d’usage. Pour les campagnes à fort volume de clics, vous pouvez le réduire à 1-2 heures. Pour les utilisateurs ne pouvant pas être associés de façon déterministe (en raison de paramètres de confidentialité ou d’autres facteurs), Adapty utilise la correspondance probabiliste dans cette fenêtre réduite.

Cliquez sur Save pour appliquer vos paramètres.

Remplacement de revenus

Si vous suivez les événements d’essai et souhaitez que Meta leur attribue des revenus, utilisez la section Revenue override. Elle apparaît lorsque l’événement Trial started est activé.

Pour chaque cible d’événement d’essai, définissez le pourcentage du prix d’abonnement à déclarer comme revenu. Par exemple, à 30 %, Adapty envoie 30 % du prix de l’abonnement comme valeur de conversion pour les événements d’essai.

Pour ajouter un remplacement :

1. Activez Trial started dans la section Events names.
2. Dans Revenue override, cliquez sur Add override.
3. Sélectionnez l’événement cible et saisissez un pourcentage de revenus (0–100).
4. Cliquez sur Save.

Essai qualifié

Un essai est qualifié lorsqu’il survit un certain nombre d’heures sans être annulé. Utilisez la section Qualified trial pour retenir les événements d’essai jusqu’à leur qualification, afin que Meta ne reçoive que les essais conservés par les utilisateurs.

Pour chaque cible d’événement d’essai, définissez le nombre d’heures à attendre. Adapty comptabilise les heures à partir du début de l’essai et envoie l’événement lorsque le délai est écoulé. Si l’utilisateur désactive le renouvellement automatique avant le délai, Adapty n’envoie jamais l’événement. Si l’utilisateur réactive le renouvellement automatique avant le délai, Adapty envoie l’événement comme prévu.

Pour retenir un événement d’essai jusqu’à ce qu’il soit qualifié :

1. Activez Trial started dans la section Events names.
2. Dans Qualified trial, cliquez sur Add event.
3. Sélectionnez l’événement cible et indiquez le nombre d’heures d’attente, de 1 à 24.
4. Cliquez sur Save.

Adapty envoie l’événement qualifié avec l’heure de début d’essai d’origine, ce qui permet à Meta de le reporter à la date de démarrage de l’essai.

Envoyer tous les événements

Par défaut, Adapty n’envoie des événements à votre pixel que pour les utilisateurs attribués à une campagne Meta. Activez Send all events pour transférer également les événements des utilisateurs organiques et non attribués vers le pixel.

Lorsque cette option est activée, chaque événement d’installation et de transaction est envoyé au pixel, quelle que soit l’attribution de campagne. Utilisez-la pour fournir à Meta des données de conversion plus larges pour la modélisation d’audience et l’optimisation des campagnes.

Pour activer cette option, dans les paramètres de la campagne, sélectionnez Send all events (forward organic/non-attributed events to this pixel) et cliquez sur Save.