Tester l'intégration

Avant de commencer


Pour réussir les tests évoqués dans ce document, vous devez :

Tester l'intégration du SDK Android


Le test repose sur les points suivants :

  1. Simuler un clic sur une publicité et une conversion.
  2. Inspection des données de conversion de l'installation.

Simulate a conversion

Simuler un utilisateur qui clique sur une publicité et installe l'app.

Étape 1 : simuler un clic sur une publicité
Simulez un clic sur une publicité via un lien d'attribution. Structurez le lien d'attribution comme suit :

https://app.appsflyer.com/<app_id>?pid=<media_source>
&advertising_id=<registered_device_gaid>

Où :

  • app_id est votre ID d'app AppsFlyer.
  • pid est la source média à laquelle l'installation doit être attribuée.
  • advertising_id est le GAID de l'appareil enregistré.

The advertising_id paramètre requis pour attribuer en fonction de l'ID. En son absence, l'attribution se fera sur une base probabiliste.

Exemple : si votre ID d'app est com.my.app, le lien d'attribution ressemblera à :

https://app.appsflyer.com/com.my.app?pid=devtest&c=test1

ou, avec GAID :

https://app.appsflyer.com/com.my.app?pid=devtest&c=test1&advertising_id=********-****-****-****-************

👍

Astuce

Souvent, les tests impliquant des liens d'attribution sont effectués plus d'une fois. C'est la raison pour laquelle il est recommandé d'utiliser l'un des paramètres d'attribution pour « trier » vos tests. Il est ainsi plus facile de comprendre quel lien a déclenché quelle conversion.

Dans l'exemple ci-dessus, la valeur de c is test1. Pour les suites de tests, donnez la valeur c to test2, test3, etc.

Étape 2 : installer l'application
Activez le mode débogage et installez l'app sur un appareil de test enregistré.

Étape 3 : lancer le test
Procédez à l'inspection des données de conversion.

Inspect conversion data

Après avoir simulé une conversion, procédez comme suit pour inspecter les données de conversion de l'installation.

Étape 1  : récupérer l'UID de l'installation
Une fois l'app installée, dans les journaux de débogage localisez conversions.appsflyer

Étape 2 : inspecter les données de conversion
Dans l'API de test des données de conversion, renseignez les champs suivants :

  1. app-id: votre ID d'app
  2. device_id: collez la valeur de uid obtenue à l'étape 1.
  3. devkey - Application's devkey. Learn here how to get it.

Ensuite, cliquez sur Tester ! pour lancer le test.

Résultat attendu
Réponse 200 contenant les données de conversion de l'installation ( tronquée à des fins de lisibilité) :

{
  ...
  "campaign": "test1",
  ...
  "media_source": "devtest",
  ...
  "af_status": "Non-organic"
  ...
}

📘

Remarque

L'installation peut prendre jusqu'à 30 minutes pour apparaître dans le tableau de bord.

Dépannage des problèmes d'intégration du SDK Android


Install always attributed to organic

Scénario
Vous testez l'attribution à l'aide de liens d'attribution. Vous avez implémenté le port d'écoute de conversion du SDK, mais le journal indique toujours que l'installation est organique. De plus, aucune installation non organique n'est enregistrée dans le tableau de bord.

Possibles raisons

  1. Votre clé dev est incorrecte. Si vous spécifiez une clé dev incorrecte, l'installation ne peut pas être attribuée.
  2. Le lien d'attribution que vous utilisez est invalide. Vous pouvez consulter notre guide des liens d'attribution.
  3. Assurez-vous que l'appareil de test est enregistré
  4. Un canal non approprié est défini dans le manifeste

Install not detected or attributed

Scénario
Vous testez l'attribution de l'installation, mais le journal ne contient aucune donnée relative à l'installation, telle que le type, le premier lancement, etc.

Possibles raisons

  1. Les méthodes start and init doivent être appelées dans la classe Application class.
  2. Assurez-vous que l'appareil de test est enregistré

I'm getting a 404 on install or event recording

Scénario
Vous testez des évènements in-app pour vous assurer qu'ils sont attribués à la source média appropriée. Cependant, la réponse 404 apparaît pour l'installation et les envois d'évènements in-app. Ni l'installation ni les évènements in-app n'apparaissent dans le tableau de bord.

Possibles raisons
Une réponse 404 indique que l'ID d'app est invalide. Vérifiez que l'ID d'app du paramètre applicationId dans build.gradle est identique à celui de votre tableau de bord.

Revenue is not recorded properly

Scénario
Vous testez des évènements in-app avec des revenus. Les évènements apparaissent dans le tableau de bord mais les revenus ne sont pas enregistrés

Possibles raisons
Le paramètre de revenu n'est pas formaté correctement. Veillez à ne PAS formater la valeur de revenu. Elle ne doit pas contenir de séparateurs sous forme de virgules, de symbole monétaire ou de texte. Un événement de revenu doit être similaire à 1234.56, par exemple.

The log shows "AppsFlyer's SDK cannot send any event without providing devkey" when I test in-app events

Scénario
Vous essayez de voir les évènements in-app dans le journal. Lorsque vous déclenchez des événements, le journal indique uniquement « Le SDK AppsFlyer ne peut envoyer aucun événement sans DevKey ».

Possibles raisons
Vous appelez start sans passer la clé dev en tant que paramètre. Transmettez la clé dev à la méthode.

The log shows "not sending data yet, waiting for dev key" in the log when I test in-app events

Scénario
Vous essayez de tester les événements in-app dans le journal. Lorsque vous déclenchez des événements, le journal indique uniquement « Envoi des données en attente de la clé dev ».

Possibles raisons
Vous appelez init et vous passez la clé dev sous forme de chaîne vide. Transmettez la clé dev à la méthode.

I get response 400 when I test in-app events

Scénario
Vous essayez de tester les événements in-app. Lorsque vous déclenchez des événements, vous recevez une réponse Erreur 400 dans les journaux.

Possibles raisons
Cela pourrait indiquer un problème avec la clé dev. Vérifiez que la clé dev est correcte. Assurez-vous également que la clé dev ne contient que des caractères alphanumériques.

The log shows "warning: Google play services is missing"

Scénario
Le logcat affiche le message d'avertissement « AVERTISSEMENT : les Google Play Services sont manquants »

Possibles raisons
Les dépendances des Google Play Services sont absentes de l'application. Cela pourrait empêcher le SDK de collecter le GAID, ce qui pourrait poser des problèmes d'attribution.

Ajouter les dépendances suivantes au niveau de l’app build.gradle file:

implementation 'com.google.android.gms:play-services-base:15.0.1'
implementation 'com.google.android.gms:play-services-ads:15.0.1'

I get response 403 on install or event recording

Scénario
Vous voulez tester les installations et les autres évènements de conversion dans le journal. Lorsque vous déclenchez ces événements, vous voyez s'afficher la réponse 403 (interdit) dans les journaux.

Possibles raisons
This might be because you have the Zero package, which does not include attribution data; only data on clicks and impressions. To start receiving attribution data, learn more about the different AppsFlyer packages, and update as needed. You can also contact our customer engagement team at [email protected] if you have questions about our packages.

Création d'une app de débogage Android


OPTIONNELLE
Vous pouvez utiliser les différents builds d'Android Studio pour configurer une app de débogage qui simplifiera vos tests.

L'ensemble des tests peuvent être effectués tant pour les apps de production que de débogage.

Étape 1 : configurer le type de build de Gradle debug
au niveau de votre application build.gradle , configurez le fichier debug type de build et ajoutez applicationIdSuffix au nom de l'app test (dans le cas présent, .debug).

android {
    // ...
    buildTypes {
        // Prevents a signing error when building the production app
        release {
            signingConfig signingConfigs.debug
        } 
        debug {
            applicationIdSuffix ".debug"
        }
    }
}

Étape 2 : ajouter une nouvelle app à AppsFlyer
Lorsque vous ajoutez l'app au tableau de bord AppsFlyer, utilisez le nom du package comme ID d'app, ou demandez à un membre d'équipe qui a accès au tableau de bord de l'ajouter.

Exemple : si votre application a comme nom de package com.your.app et que vous utilisez la configuration Gradle ci-dessus, alors le nom de l'app test sera com.your.app.debugUtilisez ce nom comme ID d'app pour ajouter cette dernière à AppsFlyer.