Intégration AppsFlyer

Assistance d'un développeur requise

Vous aurez besoin de l’aide de votre équipe de développement pour configurer l’intégration. Veuillez partager ce guide avec eux.

Aperçu de l’intégration

AppsFlyer 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 dans 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’Événements et leurs attributs ;
• Les sources d’acquisition des 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.

Imaginons 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 category qui indique le type d’actualités 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 :

Vous pouvez maintenant créer des campagnes ciblant les utilisateurs intéressés par un type d’actualités particulier :

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 qui indique 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 avec l’attribut item :

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 :

Configuration de l’intégration

Note

Le processus d’intégration est identique pour les plateformes Android et iOS.

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.

Attention

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.

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.

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);

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];

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. C’est important pour le mappage correct des données envoyées avec les utilisateurs dans votre base de données Pushwoosh.

3. Configurez l’intégration Pushwoosh dans AppsFlyer. Pour ce faire, dans votre compte AppsFlyer, allez dans Collaborate > Partner Marketplace. Dans la liste des partenaires, localisez et choisissez Pushwoosh.

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

Note

Pour les applications iOS, le mode de confidentialité avancé (Advanced Privacy Mode) 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ée 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 (App Settings). 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é.

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

• API Access Token. Pour obtenir le jeton, dans votre compte Pushwoosh, allez dans Settings > API Access et copiez le code. Vous pouvez en savoir plus sur l’API Access Token dans ce guide.
• Application Code (XXXXX-XXXXX) que vous pouvez trouver sous le nom de votre application dans votre compte Pushwoosh.

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

7. Dans la section In-app event settings, saisissez votre Application Code et votre API Access Token Pushwoosh.

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

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 médias, y compris organiques.
y compris	Choisissez comment les données d’événement sont partagées avec Pushwoosh : Aucune valeur et aucun revenu : N’envoyez que l’événement lui-même sans aucun paramètre (valeurs ou revenu). Valeurs et aucun revenu : Envoyez tous les paramètres sauf la valeur du revenu. Valeurs et revenu : Envoyez tous les paramètres de l’événement, y compris la valeur du revenu (si elle existe dans l’événement). Pour recevoir des événements avec des attributs supplémentaires envoyés à Pushwoosh, sélectionnez Valeurs et Revenu.

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

Note

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

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.