Test de l'intégration du SDK pour les spécialistes du marketing

Le visualiseur d'événements en direct est un outil de test affichant les données en temps réel envoyées depuis le SDK vers AppsFlyer, telles que les événements d'installation et d'autres événements in-app. Pour chaque événement capturé, vous pouvez voir le journal des événements et les détails.

Pour afficher les événements dans le visualiseur d'événements en direct :

1. Dans AppsFlyer, dans le menu latéral, sélectionnez Paramètres > Tests d'intégration SDK.

2. Cliquez sur Événements en direct.

   altalt

3. Dans la liste App, sélectionnez l’application que vous souhaitez tester.
4. Dans la liste appareils de test, sélectionnez l'appareil que vous souhaitez utiliser pour tester votre application. Si vous n'avez pas d'appareil de test, vous pouvez en enregistrer un en cliquant sur le lien Ajouter un appareil de test.
5. Cliquez sur Continuer pour commencer l'enregistrement des événements de votre application.

6. Lancez l'application et interagissez avec elle pour générer des sessions et des événements in-app.

7. Cliquez sur un élément d'événement pour afficher les détails de l'événement dans le panneau de droite.
8. Si vous souhaitez arrêter l'enregistrement des événements, cliquez sur Arrêter. Cliquez à nouveau sur Démarrer lorsque vous voulez continuer.

Pour tester les installations non organiques :

1. Dans AppsFlyer, dans le menu latéral, sélectionnez Paramètres > Tests d'intégration SDK. 

   altalt

2. Cliquez sur le test Installations non organiques.

   altalt

3. Dans la liste App, sélectionnez l’application que vous souhaitez tester.
4. Dans la liste appareils de test, sélectionnez l'appareil que vous souhaitez utiliser pour tester votre application. Si vous n'avez pas d'appareil de test, vous pouvez en enregistrer un en cliquant sur le lien Ajouter un appareil de test.
5. Si l'application testée est installée sur votre appareil de test, supprimez-la.
6. Cochez la case J'ai supprimé l'application de l'appareil testé.
7. Cliquez sur Continuer et suivez les étapes de l'assistant.

Si l'application n'enregistre pas une installation non organique, les raisons possibles peuvent être :

• L'IDFA est disponible mais l'appareil de test n'a pas été enregistré avec cet identifiant sur la page Appareils de test.
• Vous avez plus d'une app, en plus de l'application de test, installées sur l'appareil de test, mais cet appareil n'a pas été enregistré avec l'IDFV sur la page Appareils de test.
• Une installation organique a été enregistrée.
• Le test a été effectué sur une version de l'application qui n'inclut pas le SDK.

Pour des erreurs d'intégration, contactez votre développeur.

Avant de commencer :

• Lancez l'application de test au moins trois fois.
• Pour tester le deep linking (retargeting), OneLink doit être configuré pour votre application. Pour plus d'informations, consultez le Guide de configuration OneLink.
• Vérifiez que le retargeting est activé.

Pour tester les liens profonds :

1. Dans AppsFlyer, dans le menu latéral, sélectionnez Paramètres > Tests d'intégration SDK.

   altMoteur de clavier Maestro 2024-10-06 10.00.47.pngalt

2. Cliquez sur Retargeting.

   altalt

3. Dans la liste App, sélectionnez l’application que vous souhaitez tester.
4. Dans la liste appareils de test, sélectionnez l'appareil que vous souhaitez utiliser pour tester votre application. Si vous n'avez pas d'appareil de test, vous pouvez en enregistrer un en cliquant sur le lien Ajouter un appareil de test.
5. Cliquez sur Continuer et suivez les étapes de l'assistant.

Les tests d'installation vous permettent de vérifier que le SDK d'AppsFlyer attribue correctement les installations à différentes sources média.

Pour tester l'attribution des installations :

1. Copiez le lien suivant (Android ou iOS) et effectuez ces modifications :

   1. Valeur de app_id : Ajoutez votre ID d'application dans AppsFlyer. 
   2. Paramètre pid : Indiquez le nom de la source média à laquelle l'installation est attribuée.
   3. Paramètre c : Indiquez le nom de la campagne.
   4. Si vous testez une application disponible via une boutique Android tierce, ajoutez le paramètre af_r au lien d'attribution. 
   5. Remplacez le GAID, l'IDFA ou l'IDFV par l'identifiant spécifique de votre appareil.
   Android iOS

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

   IDFA

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

   IDFV

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfv=<IDFV>

   Voici des exemples de liens d'attribution avec des valeurs spécifiques :

   Android iOS

   https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*

   https://app.appsflyer.com/id123456789?pid=Test&c=Test&idfa=1A2B****-9128-4***-123*-04E***654321

   Note

   Si vous testez une application iOS sans enregistrer un appareil de test, votre clic de test peut être signalé comme frauduleux par Fraud 360.

   Pour éviter que cet événement ne soit détecté comme une fraude, ajoutez le paramètre de requête suivant à votre lien : pid=”ios_testing”

2. Copiez votre lien mis à jour, envoyez-le à l'appareil de test, puis cliquez sur le lien.

   Note

   Sous iOS, utilisez iMessage ou email pour envoyer le lien à l'appareil. Ne collez pas le lien dans l'application Notes iOS et ne cliquez pas sur le lien. Cette action peut provoquer la rupture du lien.

3. Effectuez l'une des actions suivantes :

   • Si l'application est en ligne, procédez à son installation.
   • Si l'application est en attente, le message suivant s'affiche : «L'application que vous recherchez n'est pas encore disponible sur le marché.» C'est le résultat attendu. Étant donné que l'application n'est pas en ligne, le lien d'attribution ne mène à aucun app store. Cependant, le lien d'attribution reste valide à des fins d'attribution et vous devez installer l'application comme suit :
     • Pour Android : À partir d'un fichier APK (ou Android Studio pour les développeurs)
     • Pour iOS : Depuis TestFlight (ou Xcode pour les développeurs)

   Vous devriez voir une installation attribuée à la campagne de test sous la source média appelée Test. Attendez jusqu'à 30 minutes pour que l'installation apparaisse dans le tableau de bord de l'application.

   altLien_d'attribution_d'installation_de_testalt

Le test des événements in-app vous permet de vérifier que les revenus associés à un événement sont affichés et que les événements in-app sont attribués à la source média qui a généré l'installation.

Pour tester l'attribution des événements in-app :

1. Lancez l’application, puis générez quelques événements in-app.

2. Ouvrez le tableau de bord de l'application et cliquez sur Événements.

   Vous devriez voir les événements, leurs revenus (si des revenus leur sont associés) et la source média à laquelle ils sont attribués. Prévoyez jusqu'à 60 à 70 minutes pour que les événements apparaissent dans le tableau de bord.

   

Astuce ! Pensez à télécharger le rapport de données brutes sur les événements in-app pour vérifier que les événements sont correctement attribués. Le téléchargement de ce rapport peut prendre plusieurs minutes.

Pour télécharger le rapport :

1. Dans AppsFlyer, depuis le menu latéral, sélectionnez Rapport > Exportation de données brutes.
2. Dans la section Rapports de données brutes, téléchargez le rapport de données brutes des événements in-app.

OneLink vous permet de définir un lien d'attribution unique pour Android et iOS. OneLink reconnaît l'appareil de l'utilisateur et le redirige vers l'app store approprié.

De plus, OneLink permet la création de liens profonds. Le Deep Linking vous permet d'ouvrir l'application dans une activité spécifique tout en fournissant du contenu personnalisé.

Pour plus d'informations, consultez notre guide sur le test des URL OneLink.

L'attribution de retargeting se produit lorsqu'un utilisateur interagit avec une campagne de retargeting en cliquant sur un lien d'attribution de retargeting. Cela déclenche un événement de réattribution ou de réengagement. Pour plus d'informations, consultez le guide d'attribution du retargeting.

Les tests de retargeting incluent les éléments suivants :

• Pour la réattribution : Désinstaller et réinstaller l'application. Ensuite, vérifiez dans le tableau de bord qu'une installation a été enregistrée.
• Pour le réengagement : Cliquez sur un lien d'attribution de retargeting ou sur un lien profond, puis vérifiez qu'un réengagement est attribué à la bonne source média.

Avant de procéder à des tests de retargeting, la configuration suivante est requise :

• Le retargeting doit être activé pour l'application que vous testez.
• Créez un lien spécifique à l'application ou récupérez un lien personnalisé OneLink. Ces liens doivent inclure le paramètre de retargeting.

Pour configurer des tests de retargeting :

1. Activez le retargeting dans les paramètres de l'application.

   Dans le tableau de bord de l'application, cliquez sur Paramètres de l'application et activez Activer l'attribution de retargeting.

   

2. Effectuez l'une des actions suivantes : 
   • Créez un lien d’attribution spécifique à l’application. Assurez-vous d'inclure le paramètre de retargeting, is_retargeting=true, et l'ID publicitaire. Pour afficher le GAID, l'IDFA ou l'IDFV, suivez les instructions Enregistrement d'un appareil de test.
     Voici un exemple de lien d’attribution qui inclut un paramètre spécifique à Android comme identifiant de l'appareil (GAID). Pour plus d'informations sur l'ajout d'autres paramètres d'identification de l'appareil, tels que l'IDFA ou l'IDFV, consultez Structure et paramètres du lien d'attribution. 

     https://app.appsflyer.com/<app_id>?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>

   • Récupérez l'URL longue du lien personnalisé à partir d'un modèle OneLink. Assurez-vous d'activer la campagne de retargeting. L'image suivante montre un exemple d'URL longue personnalisée :

Vous pouvez maintenant procéder au test de réattribution et de réengagement.

Avant de commencer :

• Suivez les instructions pour configurer des tests de retargeting.
• Assurez-vous que votre appareil de test n'est pas enregistré.

Pour tester la réattribution :

1. Désinstallez l'application de l'appareil. Si vous venez d'installer l'application, attendez quelques minutes.
2. Copiez le lien d'attribution que vous avez créé précédemment, soit le lien d'attribution spécifique à l'application, soit le lien long personnalisé du modèle OneLink, envoyez-le à l'appareil de test, puis cliquez sur le lien.

   Note

   Sous iOS, utilisez iMessage ou email pour envoyer le lien à l'appareil. Ne collez pas le lien dans l'application Notes iOS et ne cliquez pas sur le lien. Cette action peut entraîner la rupture du lien.

3. Effectuez l'une des actions suivantes :
   • Si l'application est en ligne, procédez à son installation.
   • Si l'application est en attente, installez-la comme suit :
     • Pour Android : Installez depuis Android Studio ou un fichier APK.
     • Pour iOS : Installez depuis TestFlight.
4. Ouvrez le tableau de bord de l'application et dans la zone Type d'affichage, sélectionnez Retargeting.

5. Dans la case Type d'attribution, sélectionnez Réattributions.

   Vous devriez voir l'installation attribuée à la source média et à la campagne. Attendez jusqu'à 30 minutes pour que l'installation reciblée apparaisse dans le tableau de bord.

   altTesting_SDK_Reattributionalt

Avant de commencer :

• Suivez les instructions pour configurer des tests de retargeting. 
• À des fins de test, définissez le temps minimum entre les conversions sur Aucun. Cela permet d'enregistrer et d'attribuer toutes les conversions de réengagement pendant les tests. alt
• Assurez-vous que l'application est installée sur votre appareil de test et qu'elle a été lancée plusieurs fois. Si vous venez d'installer l'application, attendez quelques minutes.

Pour tester le réengagement (lien profond direct) :

Assurez-vous que votre application est configurée pour les liens profonds, puis suivez cette procédure pour les tests.

Pour tester le réengagement (lien profond indirect) :

1. Copiez le lien d'attribution que vous avez créé précédemment, soit le lien d'attribution spécifique à l'application, soit le lien long personnalisé du modèle OneLink.
2. Envoyez le lien à votre appareil de test, puis cliquez sur le lien.

3. Pour ouvrir l’application, effectuez l’une des opérations suivantes :

   • Dans l'app store, cliquez sur Ouvrir.
   • Lancez l'application depuis votre appareil.

   Dans le tableau de bord, vous devriez voir un réengagement attribué à la source média et à la campagne. Prévoyez jusqu'à 30 minutes pour que le réengagement apparaisse.

   altTesting_SDK_Re-engagementalt

Astuce ! Envisagez de télécharger le rapport de données brutes de conversions pour vérifier que le réengagement a été attribué à la bonne source média. Le téléchargement de ce rapport peut prendre plusieurs minutes.

Pour télécharger le rapport :

1. Dans AppsFlyer, dans le menu latéral, sélectionnez Rapport > Exportation de données brutes.
2. Dans la section Retargeting, téléchargez le rapport Conversions (réengagements et réattributions).