# Intégration AppsFlyer

<Aside type="caution" icon="setting" title="Aide des développeurs requise">
 Vous aurez besoin de l'aide de votre équipe de développement pour configurer l'intégration. Veuillez partager ce guide avec eux.
</Aside>

## Aperçu de l'intégration

[AppsFlyer](https://www.appsflyer.com/) est une plateforme d'attribution mobile et d'analyse marketing qui vous aide à analyser l'acquisition et l'engagement des utilisateurs. Elle fournit des données complètes sur le comportement des utilisateurs au sein de l'application et vous permet de suivre les sources d'acquisition des utilisateurs. En utilisant les informations obtenues d'AppsFlyer, vous pouvez créer des campagnes marketing efficaces dans Pushwoosh.

Une fois l'intégration configurée, AppsFlyer enverra les informations suivantes à Pushwoosh :

*   Le comportement in-app de l'utilisateur sous forme d'Events et leurs attributs ;
*   Les sources d'acquisition d'utilisateurs en tant que valeurs du Tag _Acquisition Source_.

### Cas d'utilisation

En utilisant ces données, vous pouvez créer des segments d'utilisateurs et réaliser des campagnes précisément ciblées et personnalisées dans Pushwoosh. Vous trouverez ci-dessous deux exemples d'utilisation des données d'AppsFlyer pour créer des parcours clients (customer journeys) efficaces dans Pushwoosh.

**1. Créez des campagnes très ciblées dans Pushwoosh en utilisant les événements suivis par AppsFlyer.**

Supposons que vous ayez une application d'actualités. Vous avez configuré AppsFlyer pour suivre l'événement _SubscribedToNews_, qui se déclenche chaque fois qu'un utilisateur s'abonne à une chaîne d'information. Cet événement a l'attribut de catégorie indiquant le type de nouvelles auquel l'utilisateur s'abonne : _politics_, _business_ ou _sports_.

Pushwoosh reçoit les informations sur cet événement avec les valeurs de ses attributs. Vous pouvez créer trois segments d'utilisateurs basés sur trois valeurs possibles :

<img src="/integrations-appsflyer-integration-1.webp" alt="Segments d'utilisateurs basés sur les attributs de catégorie de nouvelles"/>

Vous pouvez maintenant créer des campagnes ciblées sur les utilisateurs intéressés par un type particulier de nouvelles :

<img src="/integrations-appsflyer-integration-2.webp" alt="Campagnes ciblées pour les utilisateurs intéressés par des catégories de nouvelles spécifiques"/>

**2. Personnalisez les messages en fonction des données de comportement des utilisateurs d'AppsFlyer.**

Dans cet exemple, nous utiliserons une application d'achat en ligne. Supposons qu'AppsFlyer suive l'événement _AddToWishlist_ qui se déclenche chaque fois qu'un utilisateur ajoute un article à sa liste de souhaits. Cet événement a l'attribut item indiquant le nom de l'article ajouté à la liste de souhaits.

AppsFlyer envoie les données de l'événement _AddToWishlist_ à Pushwoosh, où vous pouvez personnaliser les messages en fonction des choix des utilisateurs. Par exemple, vous pouvez créer un préréglage de push offrant une réduction sur un article qu'un utilisateur a ajouté à sa liste de souhaits. Au lieu du nom de l'article, ajoutez un [placeholder de Contenu Dynamique](/fr/developer/guides/personalization/dynamic-content/#personalizing-messages-sent-via-api-with-dynamic-content) avec l'attribut _item_ :

<img src="/integrations-appsflyer-integration-3.webp" alt="Placeholder de contenu dynamique dans un préréglage push Pushwoosh"/>

Si un utilisateur ajoute un article à sa liste de souhaits, il recevra un push contenant des informations à ce sujet. Par exemple, ceux qui sélectionnent l'iPhone 14 Pro Max verront ce message :

<img src="/integrations-appsflyer-integration-4.webp" alt="Aperçu de la notification push pour l'offre de l'article iPhone 14 Pro Max" width="375"/>

## Configuration de l'intégration

<Aside type="note">
Le processus d'intégration est identique pour les plateformes Android et iOS.
</Aside>

1.  Intégrez le SDK Pushwoosh dans votre application si vous ne l'avez pas déjà fait. Pour des instructions plus détaillées, [lisez le guide](/fr/developer/pushwoosh-sdk/pushwoosh-sdk-overview).

<Aside type="caution">
Pour un fonctionnement correct, la version 6.5.7 ou ultérieure du SDK Pushwoosh pour iOS et la version 6.6.16 ou ultérieure du SDK Pushwoosh pour Android sont requises.
</Aside>

2.  Pour vous assurer que les bonnes données sont envoyées à AppsFlyer, intégrez cet extrait de code dans votre code. Assurez-vous qu'il est exécuté après l'initialisation du SDK Pushwoosh et du SDK AppsFlyer.

<Tabs>
<TabItem label="Java">
```
String pwhwid = Pushwoosh.getInstance().getHwid();
String pwuserid = Pushwoosh.getInstance().getUserId();
Map<String, Object> customData = new HashMap<String, Object>();
customData.put("pushwoosh_hwid", pwhwid);
customData.put("pushwoosh_user_id", pwuserid);
AppsFlyerLib.getInstance().setAdditionalData(customData);
```
</TabItem>

<TabItem label="Objective-C">
```
NSString *pwhwid = [[Pushwoosh sharedInstance] getHWID];
NSString *pwuserid = [[Pushwoosh sharedInstance] getUserId];
NSDictionary *customData = [[NSDictionary alloc] initWithObjectsAndKeys:pwuserid, @"pushwoosh_user_id", pwhwid, @"pushwoosh_hwid", nil];
[[AppsFlyerLib shared] setAdditionalData:customData];
```
</TabItem>
</Tabs>

<Aside type="danger">
Lorsque vous utilisez des valeurs UserID Pushwoosh personnalisées pour identifier et cibler les utilisateurs, assurez-vous d'exécuter le code après avoir appelé la méthode **setUserId()** dans le SDK Pushwoosh avec la valeur personnalisée.

Suivez les changements du UserID Pushwoosh selon la logique de votre application mobile et envoyez rapidement les valeurs mises à jour à AppsFlyer. Ceci est important pour le mappage correct des données envoyées avec les utilisateurs dans votre base de données Pushwoosh.
</Aside>

3.  Configurez l'intégration de Pushwoosh dans AppsFlyer. Pour cela, dans votre [compte AppsFlyer](https://hq1.appsflyer.com/auth/login), allez dans **Collaborate** > **Partner Marketplace**. Dans la liste des partenaires, localisez et choisissez Pushwoosh.

<img src="/integrations-appsflyer-integration-5.webp" alt="Localisation de Pushwoosh dans AppsFlyer"/>

4.  Cliquez sur **Set up integration**. Vous serez alors dirigé vers la page de configuration de l'intégration. Là, activez le bouton **Activate partner**.

<img src="/integrations-appsflyer-integration-6.webp" alt="Activation du bouton Activer le partenaire dans AppsFlyer"/>

<Aside type="note">
Pour les applications iOS, le mode de confidentialité avancé est activé par défaut, ce qui permet de contrôler la disponibilité des données d'attribution au niveau de l'utilisateur via la plateforme AppsFlyer. Bien qu'AppsFlyer n'envoie pas ce type de données à Pushwoosh, le maintien du bouton de confidentialité avancé activé peut interférer avec la transmission des données.

Pour vous assurer que Pushwoosh reçoit toutes les données, nous vous recommandons de désactiver le mode de confidentialité avancé dans les **Paramètres de l'application**. Cela ne compromettra pas la confidentialité des données des utilisateurs. Pushwoosh s'engage à gérer les données de manière sécurisée et responsable, en utilisant des protocoles de sécurité conformes aux normes de l'industrie pour protéger la confidentialité.
</Aside>

<img src="/integrations-appsflyer-integration-7.webp" alt="Désactivation du mode de confidentialité avancé dans AppsFlyer"/>

5.  Dans la section **General settings**, saisissez vos identifiants Pushwoosh :

*   **Jeton d'accès à l'API**. Pour obtenir le jeton, dans votre compte Pushwoosh, allez dans **Settings > API Access** et copiez le code. Vous pouvez en apprendre plus sur le jeton d'accès à l'API [dans ce guide](/fr/developer/api-reference/api-access-token).
*   **Code d'application** (XXXXX-XXXXX) que vous pouvez trouver sous le nom de votre application dans votre compte Pushwoosh.

<img src="/integrations-appsflyer-integration-8.webp" alt="Ajout des identifiants Pushwoosh dans les paramètres généraux d'AppsFlyer"/>

6.  Dans la section **Default postback**, sélectionnez **All media sources, including organic**.

<img src="/integrations-appsflyer-integration-9.webp" alt="Configuration de la section Postback par défaut"/>

7.  Dans la section **In-app event settings**, saisissez votre **Code d'application** Pushwoosh et votre **Jeton d'accès à l'API**.

<img src="/integrations-appsflyer-integration-10.webp" alt="Section des paramètres d'événements in-app avec le code d'application et le jeton d'API"/>

8.  Activez le bouton **In-app event postback** et configurez les événements et les données à inclure dans les postbacks envoyés à Pushwoosh.

<img src="/integrations-appsflyer-integration-11.webp" alt="Configuration du bouton de postback d'événement in-app dans AppsFlyer"/>

Choisissez un ou plusieurs événements AppsFlyer à envoyer à Pushwoosh depuis le menu déroulant, et complétez les paramètres nécessaires.

| Paramètre                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **l'événement mappé au partenaire** | Même si ce champ est obligatoire, ne vous inquiétez pas de ce que vous tapez car cela ne changera pas la façon dont les événements sont nommés. Pushwoosh recevra toujours les événements avec les mêmes noms que ceux qui apparaissent dans AppsFlyer.                                                                                                                                                                                                                                                                                          |
| **pour les utilisateurs de**      | Dans ce champ, sélectionnez si les postbacks sont envoyés exclusivement pour les utilisateurs attribués à ce partenaire ou pour toutes les sources de médias, y compris organiques.                                                                                                                                                                                                                                                                                                                                                   |
| **y compris**                     | <p>Choisissez comment les données d'événement sont partagées avec Pushwoosh :</p><ul><li><strong>No values & no revenue :</strong> N'envoyez que l'événement lui-même sans aucun paramètre (valeurs ou revenus).</li><li><strong>Values & no revenue :</strong> Envoyez tous les paramètres sauf la valeur des revenus.</li><li><strong>Values & revenue :</strong> Envoyez tous les paramètres de l'événement, y compris la valeur des revenus (si elle existe dans l'événement).<br/>Pour recevoir des événements avec des attributs supplémentaires envoyés à Pushwoosh, sélectionnez Values and Revenue.</li></ul> |

9.  Une fois l'intégration configurée, cliquez sur **Save**.

<Aside type="note">
Avant de lancer vos campagnes, assurez-vous de tester l'intégration. Des erreurs se produisent souvent lors de la configuration, un test rapide permet donc d'éviter de gaspiller des ressources sur des campagnes avec des données manquantes ou incorrectes.
</Aside>

## Suivi des clics d'e-mails avec AppsFlyer ESP 2.0

Pour utiliser le suivi des clics d'e-mails et préserver les Universal Links / App Links lors de l'envoi d'e-mails via Pushwoosh, vous pouvez configurer l'[intégration e-mail AppsFlyer ESP 2.0](/fr/product/integrations/appsflyer-esp2-email-integration).