---
title: "Intégrer Meta Ads avec Adapty Attribution"
description: "Connectez Meta Ads à Adapty Attribution pour suivre et optimiser les performances de vos campagnes sur Facebook, Instagram, Messenger et Audience Network."
---

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.

:::tip
Consultez notre [guide de configuration des publicités dans Meta Ads Manager](meta-create-campaign).
:::

## Étape 1. Connecter votre compte Facebook \{#step-1-connect-your-facebook-account\}

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.

<Tabs>
<TabItem value="oauth" label="Continue with Facebook">

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

</TabItem>
<TabItem value="system" label="Add system token">

Générez un [token d'accès utilisateur système](https://developers.facebook.com/documentation/ads-commerce/marketing-api/collaborative-ads/managed-partner-ads/api-guide/prerequisites/generate-access-token-system-user) dans les paramètres Meta Business, puis ajoutez-le à Adapty Attribution.

:::important
Avant de commencer, vous devez disposer d'un [utilisateur système](https://www.facebook.com/business/help/503306463479099) 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.

:::note
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**.

</TabItem>
</Tabs>

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 \{#step-2-add-campaigns\}

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 \{#step-3-map-events\}

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 \{#additional-configuration\}

### Paramètres supplémentaires \{#additional-parameters\}

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.

:::important
Les paramètres supplémentaires modifient le **Click link** que vous collez dans Meta Ads Manager. Si vous avez déjà copié ce lien et ajouté un paramètre personnalisé par la suite, veillez à copier et coller le lien mis à jour contenant le paramètre personnalisé.
:::

<br/>

### Paramètres \{#settings\}

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 \{#revenue-override\}

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 \{#send-all-events\}

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**.