En bref : mesurez les campagnes de notification push sur iOS et sur Android.
Présentation
AppsFlyer prend en charge la mesure des campagnes de notification push pour l'ensemble des fournisseurs de push, ainsi que la mesure des campagnes implémentées directement sur Firebase Cloud Messaging ou Apple Push Notification Services (APNS).
L'intégration peut être implémentée de deux manières :
- En utilisant les templates OneLink (recommandé).
- En envoyant un objet JSON avec une clé
afdans la charge utile de la notification push (ancienne méthode).
Les conversions s'affichent dans la vue d'ensemble du tableau de bord, dans les vues retargeting et unifiée.
Comment fonctionne l'API de test ?
Une fois les étapes décrites dans cet article terminées, votre application fonctionnera comme suit :
- Vous déclenchez une notification push qui contient un template OneLink ou une clé
afau sein de sa charge utile. - L'utilisateur de l'app reçoit la notification push, il clique dessus.
- L'app se charge et le SDK AppsFlyer se lance.
- Le SDK traite la charge utile de la notification push qui a permis d'ouvrir l’application.
- Le SDK extrait puis transfère les données d'attribution à AppsFlyer.
Dans le cas d'utilisation du OneLink, si le OneLink est configuré pour diriger l'utilisateur vers un lieu précis dans l'app, le flux de deep link est déclenché.
Conditions préalables
Avant de continuer, vérifiez que le SDK AppsFlyer est bien intégré à l'app et que cette dernière peut recevoir les notifications push.
Étapes
Pour configurer la mesure des notifications push, vous devez suivre les étapes suivantes :
-
Créez une notification push qui contient une clé de données personnalisée avec le template OneLink ou une clé
afdont la valeur est un objet JSON. - Configurez le SDK pour qu'il finalise la clé personnalisée (action effectuée par un développeur).
- Testez l'intégration en déclenchant une notification push.
- Consultez les performances des campagnes de notification push dans le tableau de bord.
1. Créer une notification push
Commencez par créer une notification push contenant des données d'attribution en suivant l'une des méthodes ci-dessous.
Note
Dans l'exemple suivant, nous utilisons Firebase comme fournisseur push. Les instructions doivent s’adresser à l'ensemble des fournisseurs push, avec très peu d'exceptions (si possible aucune). Consultez les documents relatifs à chaque fournisseur push pour en savoir plus.
Avec OneLink (recommandé)
Il s’agit de la méthode recommandée pour intégrer AppsFlyer aux notifications push.
- Créez un lien OneLink et configurez-le pour le retargeting.
Remarque : les URL OneLink courtes et longues sont toutes deux prises en charge. - Dans les données personnalisées de notification push, ajoutez le OneLink qui contient les données d'attribution que vous souhaitez transmettre à AppsFlyer.
Exemple avec Firebase
Dans Firebase :
Avec JSON (ancienne méthode)
Note
Les instructions suivantes concernent l'ancienne méthode d’intégration des notifications push AppsFlyer, elles s'adressent aux personnes qui se confrontent à des problèmes de compatibilité. Si vous configurez une nouvelle application, mieux vaut utiliser la solution OneLink recommandée.
Dans les données personnalisées de la notification push, ajoutez une clé personnalisée que vous nommez af et qui contient les données d'attribution au format JSON que vous souhaitez transmettre à AppsFlyer. Veuillez suivre les paramètres d’attribution suivants :
PIDis_retargetingC
Exemple avec Firebase
Dans Firebase :
2. Configurer le SDK
Cette étape nécessite de modifier le code de l'app. Veuillez suivre les instructions pour configurer le SDK :
- Pour implémenter la solution OneLink recommandée :
- Transmettez au développeur de l'app le nom de la clé personnalisée que vous avez ajoutée à la notification. Dans cet exemple, le nom est
af_push_link. - Demandez au développeur de suivre ces instructions.
- Transmettez au développeur de l'app le nom de la clé personnalisée que vous avez ajoutée à la notification. Dans cet exemple, le nom est
- Pour implémenter l'ancienne solution (via JSON), demandez à vos développeurs de suivre ces instructions.
3. Tester l'intégration
Pour vérifier si la mesure des notifications push est correctement intégrée, il suffit de déclencher une notification push dans la campagne que vous avez configurée lors de l'étape 1.
Si tout a bien été configuré, le SDK réalise les actions suivantes :
- Il écoute les notifications push.
- Il traite les données d'attribution intégrées à la notification push avant de les transmettre à AppsFlyer.
- Il continue à suivre le processus de deep linking, dans le cas où la mesure de notification push a été implémentée avec OneLink.
4. Consulter les campagnes de notification push dans le tableau de bord
Vous pouvez voir s'afficher les données issues des notifications push dans le tableau de bord de retargeting.
Remarque : AppsFlyer supprime les doublons des données de notification push. Si les mêmes charges utiles sont reçues plus d'une fois, une seule sera donc comptabilisée.