# Intégration d'AppsFlyer ESP 2.0

<Aside type="caution" icon="setting" title="Assistance d'un développeur requise">
Vous aurez besoin de l'aide de votre équipe de développement pour configurer l'intégration. Partagez ce guide avec eux.
</Aside>

[AppsFlyer](https://www.appsflyer.com/) est une plateforme d'attribution mobile et d'analyse marketing. [AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide) est l'intégration d'AppsFlyer pour les fournisseurs de services de messagerie (ESP). Connectez Pushwoosh à ESP 2.0 pour activer le suivi des liens dans les campagnes par e-mail. Dans cette intégration, Pushwoosh enveloppe les URL, et la solution ESP 2.0 assure le bon fonctionnement du deep linking pour les Universal Links iOS et les App Links Android lorsque les liens sont enveloppés pour le suivi.

Cette intégration envoie également les données de clics sur les liens à AppsFlyer, vous offrant une visibilité complète sur les performances de vos e-mails aux côtés de vos autres canaux marketing et vous permettant de mesurer l'impact réel des e-mails sur l'acquisition et l'engagement des utilisateurs.

## Aperçu de l'intégration


### Prérequis

* Application Pushwoosh avec [l'envoi d'e-mails configuré](/fr/product/first-steps/start-with-your-project/configure-platforms/email-verification/)
* Compte AppsFlyer avec [l'intégration AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide). Il s'agit d'une fonctionnalité premium. Contactez votre CSM AppsFlyer ou le support AppsFlyer pour y avoir accès.



### Entités synchronisées

Les clics sur les liens d'e-mail via votre Domaine de suivi des clics sont enregistrés comme statistiques de clics dans Pushwoosh et comme événements de clics avec des données d'attribution dans AppsFlyer.

### Cas d'utilisation

*   **Suivi des clics d'e-mail :** Mesurez les clics sur les liens d'e-mail via AppsFlyer.
*   **Deep linking depuis un e-mail :** Assurez le fonctionnement des Universal Links (iOS) et des App Links (Android) lorsque les liens dans les e-mails sont enveloppés.

### Comment fonctionne l'intégration


Une fois l'intégration active, chaque clic passe par trois étapes :

1.  Pushwoosh remplace les liens dans vos e-mails par des URL de suivi sur votre CTD, par exemple :
    `https://clickpush.yourdomain.com/json/1.3/emailRedirect?d=...`

2.  Lorsqu'un utilisateur appuie sur le lien, la requête est envoyée à AppsFlyer via le CNAME configuré. AppsFlyer enregistre l'attribution, gère le deep linking et redirige l'utilisateur vers l'URL finale ou dans l'application via un Universal Link / App Link. Il envoie également une requête GET à Pushwoosh, en passant votre CTD dans l'en-tête Host, afin que Pushwoosh puisse enregistrer le clic :
```
   GET https://<Pushwoosh CNAME target>/json/1.3/emailRedirect
   Host: <your CTD>
```

3.  Pushwoosh reçoit la requête et enregistre le clic pour ses propres statistiques.

## Configuration de l'intégration

<Aside type="note" title="Pushwoosh vs AppsFlyer">
Pushwoosh n'intervient que dans la configuration initiale du CTD. Le reste de l'intégration se fait du côté d'AppsFlyer.
</Aside>

### Étape 1. Créer et activer un domaine de suivi des clics

Le **Domaine de suivi des clics (CTD)** est la partie du domaine d'une URL de lien suivi affichée dans un e-mail. Il combine un sous-domaine avec votre domaine principal, par exemple, `clickpush.esp-integrations1.com`. Le sous-domaine est créé dans les paramètres DNS de votre domaine auprès de votre fournisseur de domaine, généralement en ajoutant un enregistrement CNAME.
<Aside type="caution" title="Nouveau CTD requis">
La création d'un nouveau CTD est obligatoire pour l'intégration AppsFlyer ESP 2.0, même si vous utilisez déjà un domaine de suivi des clics existant. L'utilisation d'un nouveau domaine évite d'impacter le trafic de vos campagnes d'e-mail actuelles.

Pour plus de détails, consultez le guide d'AppsFlyer : [Configurer votre intégration ESP avec AppsFlyer](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-1-create-a-onelink-template-for-your-email-campaign).
</Aside>

1.  Décidez quel sous-domaine vous utiliserez comme CTD (par exemple, `clickpush.esp-integrations1.com`).
2.  Dans Pushwoosh, ouvrez **Settings**, puis sélectionnez **Configure Platforms**.
3.  Sur la page **Email channel configuration**, faites défiler jusqu'à **Custom tracking domain** et sélectionnez **Enable**.

<Aside type="note" >
La section **Custom tracking domain** n'est affichée qu'après la configuration du canal e-mail pour votre application. Si vous ne la voyez pas, terminez d'abord la [configuration de l'e-mail](/fr/product/first-steps/start-with-your-project/configure-platforms/email-verification/).
</Aside>

<img src="/integrations-appsflyer-esp2-email-integration-2.webp" alt="Panneau de contrôle Pushwoosh : Settings, Configure Platforms, Email channel configuration, Custom tracking domain avec Enable."/>

4.  Saisissez votre CTD dans le champ **Domain** et sélectionnez **Next**.

<img src="/integrations-appsflyer-esp2-email-integration-3.webp" alt="Boîte de dialogue Enable custom tracking domain : champ Domain, Cancel et Next."/>

5.  En dehors de Pushwoosh, ouvrez le service où vous gérez le DNS public pour le domaine de votre CTD (généralement votre registraire de domaine, un hébergeur DNS ou votre compte d'hébergement). Dans son éditeur DNS ou de zone pour ce domaine, ajoutez le **CNAME** que Pushwoosh affiche à cette étape pour que votre CTD pointe vers `api.pushwoosh.com`.

<Aside type="note" title="Propagation DNS">
Les modifications DNS prennent généralement effet en quelques minutes, mais peuvent prendre jusqu'à 48 heures.
</Aside>

6.  Dans Pushwoosh, sélectionnez **Verify**.

<img src="/integrations-appsflyer-esp2-email-integration-4.webp" alt="Étape DNS du domaine de suivi personnalisé : CNAME vers api.pushwoosh.com, Back, Verify et Save."/>

7.  Lorsque la vérification réussit, sélectionnez **Save**.
8.  Si vous devez modifier le **Domain** ou l'enregistrement DNS, sélectionnez **Back** et ajustez les étapes précédentes.

9.  Après avoir cliqué sur **Save**, votre CTD apparaît dans la liste **Custom tracking domain** dans **Email channel configuration**.

<img src="/integrations-appsflyer-esp2-email-integration-5.webp" alt="Configuration du canal e-mail : section Custom tracking domain affichant le CTD enregistré dans la liste."/>

Pour le désactiver plus tard, sélectionnez `...` à côté de votre CTD, puis sélectionnez **Disable custom tracking domain**.

<Aside type="tip">
Avant de continuer, envoyez un e-mail de test et confirmez que le lien utilise votre CTD.

**Exemple de lien suivi**

`https://clickpush.example.com/json/1.3/emailRedirect?d=...`
</Aside>

### Étape 2. Démarrer l'intégration dans AppsFlyer

Sur la [plateforme AppsFlyer](https://hq1.appsflyer.com/), démarrez l'intégration ESP 2.0. Suivez le [guide d'AppsFlyer pour configurer votre intégration ESP](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer).

AppsFlyer vous demandera les détails suivants :

*   **Domaine de suivi des clics :** votre CTD (par exemple, `clickpush.example.com`)
*   **Point de terminaison ESP :** `api.pushwoosh.com` (la cible CNAME affichée dans Pushwoosh lorsque vous activez le domaine de suivi personnalisé)

AppsFlyer validera la configuration. Maintenez le CNAME du CTD pointant vers **`api.pushwoosh.com`** jusqu'à ce que la validation soit terminée.

### Étape 3. Mettre à jour le CNAME vers AppsFlyer

Une fois qu'AppsFlyer a validé la configuration, il vous fournira un domaine de routage (par exemple, `jyvls.espclicks.appsflyer.com`).

Mettez à jour votre CNAME pour que le CTD pointe vers AppsFlyer au lieu de Pushwoosh :

**Avant :**

`clickpush.example.com` → `api.pushwoosh.com`

**Après :**

`clickpush.example.com` → `jyvls.espclicks.appsflyer.com` (utilisez le domaine fourni par AppsFlyer)

<Aside type="note" title="Temps de propagation">
Après avoir mis à jour le CNAME, l'intégration peut prendre jusqu'à 24 heures pour commencer à fonctionner.
</Aside> 

Après avoir changé le CNAME, envoyez un e-mail de test et vérifiez que les liens s'ouvrent correctement et que les clics apparaissent dans AppsFlyer.

## Prochaines étapes

Une fois le changement effectif, le trafic de clics passe par l'infrastructure d'AppsFlyer. AppsFlyer fournit la couche de routage, le SSL, l'AASA (Apple App Site Association) et les Android App Links.

Pushwoosh continue d'envelopper les liens et d'enregistrer les statistiques de clics. Aucune configuration supplémentaire n'est nécessaire dans Pushwoosh.

Pour en savoir plus sur la configuration et les tests du côté d'AppsFlyer, consultez :

<LinkCard title="Configurer votre intégration ESP avec AppsFlyer" href="https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-5-test-the-link" />

<LinkCard title="Guide d'intégration des fournisseurs de services de messagerie" href="https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide" />