Intégrer Meta Ads avec Adapty Attribution

L’intégration Meta d’Adapty Attribution vous permet de suivre et d’optimiser les performances de vos campagnes sur Facebook, Instagram, Messenger et Audience Network.

Étape 1. Connecter votre compte Facebook

Pour connecter Meta Ads à Adapty Attribution, rendez-vous dans Integrations > Meta depuis le menu de gauche. Deux options s’offrent à vous :

• 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 token système permanent. Utilisez cette option si votre organisation gère des comptes publicitaires via un utilisateur système Meta Business.

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 autorisations demandées et cliquez sur Save.

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

Avant de commencer, vous devez disposer d’un utilisateur système dans votre portfolio Meta Business, avec les comptes publicitaires à suivre déjà associés. Vous devez également avoir ajouté une application au portfolio — c’est cette application que vous sélectionnez lors de la génération du token.

Dans les paramètres Meta Business, 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. Choisissez votre application dans le menu déroulant.
5. Dans la liste des autorisations, activez ads_read. C’est la seule autorisation dont Adapty Attribution a besoin pour lire vos données de campagne et d’annonce.
6. Cliquez sur Generate token.
7. Copiez le token et conservez-le en lieu sûr. Meta ne l’affiche qu’une seule fois.

Le paramètre Token expiration détermine la durée de validité de la connexion. Un token avec une date d’expiration doit être régénéré et reconnecté avant son expiration, faute de quoi 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 compromis.

Dans Adapty Attribution, ajoutez le token :

1. Cliquez sur Add system token.

2. Collez le token et cliquez sur Connect.

Une fois cette étape terminée, tous vos comptes publicitaires seront ajoutés à Adapty Attribution. Vous pouvez ensuite passer à l’ajout de 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. Passez à 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 annonce et collez ce lien. Cela permettra à Adapty de relier les installations et achats aux annonces 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. Mapper les événements

Pour renvoyer les événements de conversion vers Meta afin d’optimiser vos campagnes, vous devez configurer la correspondance 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 ses événements aux événements standard de Meta.

Cliquez sur Save pour appliquer votre configuration de correspondance des événements.

Configuration avancée

Paramètres supplémentaires

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

Dans le champ Additional parameter, saisissez les données personnalisées à inclure dans votre suivi d’attribution. Le paramètre supplémentaire sera inclus dans 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 variantes d’une même campagne, vous pouvez ajouter variant=A ou variant=B pour distinguer différentes approches créatives.

Paramètres

L’onglet Settings contrôle la façon dont 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 :

• Deterministic matching window : utilise des identifiants d’appareils 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 cette valeur 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 définitivement l’installation à ce clic d’annonce spécifique grâce aux identifiants d’appareils.

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

Cliquez sur Save pour appliquer vos paramètres.

Remplacement de revenus

Si vous suivez des é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 de l’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 revenu (0-100).
4. Cliquez sur Save.

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 également transmettre les événements des utilisateurs organiques et non attribués au 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 cette option 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.