Évaluation de l’acquisition d’un lien marketing

Les instructions suivantes expliquent comment gérer une campagne d’acquisition avec un lien marketing sur un appareil Android.

Si l’application mobile n’est pas encore sur Google Play, vous pouvez sélectionner n’importe quelle destination lors de la création du lien marketing. Cela a uniquement une incidence sur l’application vers laquelle le serveur d’acquisition vous redirige lorsque vous cliquez sur le lien d’acquisition. Le lien d’acquisition pourra toujours être testé. Les paramètres de chaîne de requête sont transmis à la boutique Google Play, qui sont transmis à l’application lors de l’installation dans le cadre d’une diffusion de campagne. Les tests d’acquisition d’applications mobiles nécessitent la simulation de ce type de diffusion.

Chaque fois qu’un test est exécuté, l’application doit avoir été installée depuis peu ou ses données doivent être effacées sous Paramètres. Ainsi, les mesures initiales de cycle de vie associées aux paramètres des chaînes de requête de la campagne sont envoyées lorsque l’application est lancée pour la première fois.

1. Effectuez les tâches préalables requises dans Acquisition des applications mobiles et assurez-vous que vous avez correctement mis en œuvre le récepteur de diffusion pour INSTALL_REFERRER.

2. Dans l’interface utilisateur d’Adobe Mobile Services, cliquez sur Acquisition > Générateur de liens marketing, puis générez une URL de lien marketing d’acquisition qui définit Google Play comme destination des appareils Android.

   Pour obtenir plus d’informations, voir Générateur de liens marketing.

   Par exemple :

   https://c00.adobe.com/v3/da120731d6c09658b82d8fac78da1d5fc2d09c48e21b3a55f9e2d7344e08425d/start?a_dl=573e5bb3248a501360c2890b

3. Ouvrez le lien généré sur l’appareil Android.

   Vous devez être redirigé vers une page dont l’URL est similaire à l’exemple suivant :

   https://play.google.com/store/apps/details?id=com.adobe.android&referrer=utm_campaign%3Dadb_acq_v3%26utm_source%3Dadb_acq_v3%26utm_content%3D91b52ce097b1464b9b47cb2995c493cc6ab2c3a3

4. Copiez l’identifiant unique après utm_content%3D.

   Dans l’exemple précédent, l’ID est 91b52ce097b1464b9b47cb2995c493cc6ab2c3a3.

   Si vous ne parvenez pas à obtenir l’identifiant unique sur l’appareil, exécutez la commande CURL suivante sur votre ordinateur pour obtenir l’identifiant unique depuis la chaîne de réponse.

   curl -A "Mozilla/5.0 (Linux; Android 5.0.2; SAMSUNG SM-T815Y Build/LRX22G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/44.0.2403.133 Safari/537.36" <Your Marketing Link>

   Par exemple :

   curl -A "Mozilla/5.0 (Linux; Android 5.0.2; SAMSUNG SM-T815Y Build/LRX22G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/44.0.2403.133 Safari/537.36" https://c00.adobe.com/v3/da120731d6c09658b82d8fac78da1d5fc2d09c48e21b3a55f9e2d7344e08425d/start?a_dl=573e5bb3248a501360c2890b

5. Créez le lien de fin de l’acquisition en utilisant l’identifiant unique de l’étape 3, avec le format suivant :

   https://c00.adobe.com/v3/<appid>/end?a_ugid=<unique id>

   Par exemple : https://c00.adobe.com/v3/<appid>/end?a_ugid=91b52ce097b1464b9b47cb2995c493cc6ab2c3a3.

6. Ouvrez le lien dans un navigateur.

   contextData devrait apparaître dans la réponse JSON :

   {"fingerprint":"44b2f88a062df7e727c047f006deb9971304617b","endCallbacks":["***"],"timestamp":1464301282,"appguid":"da120731d6c09658b82d8fac78da1d5fc2d09c48e21b3a55f9e2d7344e08425d","contextData": 
   {"a.launch.campaign.trackingcode":"trymttvm","a.referrer.campaign.name":"Android Demo","a.referrer.campaign.trackingcode":"trymttvm"} 
   ,"adobeData":{"unique_id":"9a2be52764a8db125c29a8c10f3b1b3d5d8ed915","deeplinkid":"57476c26072932ec6d3a470b"}}.
   

7. Répétez l’étape 3 pour obtenir un nouvel identifiant unique.

8. Vérifiez que les paramètres suivants du fichier de configuration sont corrects :

   Paramètre	Valeur
   acquisition	Le serveur doit être c00.adobe.com, et appid doit être égal à l’appid de votre lien d’acquisition.
   analytics	À des fins de test, définissez le délai d’expiration du parrain pour permettre l’envoi manuel de la diffusion pendant une durée suffisante (60 secondes ou plus). Vous pouvez restaurer le paramètre d’expiration d’origine après le test.

9. Connectez l’appareil à un ordinateur, désinstallez puis réinstallez l’application.

10. Lancez l’interpréteur de commandes ADB, puis l’application sur l’appareil.

    adb shell
    

11. Envoyez une diffusion en utilisant la commande adb suivante :

    am broadcast -a com.android.vending.INSTALL_REFERRER -n com.adobe.android/com.adobe.android.YourBroadcastReceiver --es "referrer" "utm_source=adb_acq_v3&utm_campaign=adb_acq_v3&utm_content=<unique id get on step 5>"
    

12. Remplacez com.adobe.android par le nom de module de votre application, remplacez la référence du récepteur par celle de l’emplacement du récepteur de suivi de la campagne dans l’application, puis remplacez les valeurs associées par utm_content.

    Si la diffusion est réussie, vous pouvez vous attendre à une réponse similaire à l’exemple suivant :

    Broadcasting: Intent 
    { act=com.android.vending.INSTALL_REFERRER cmp=com.adobe.adms.tests/.ReferralReceiver (has extras) } 
    Broadcast completed: result=0 
    

13. (Facultatif) Vous pouvez activer la journalisation du débogage du SDK pour obtenir des informations supplémentaires.

    Si tout fonctionne correctement, les journaux suivants devraient être disponibles :

    "Analytics - Received referrer information(<referrer content>)" 
    "Analytics - Trying to fetch referrer data from (acquisition end url)"; 
    "Analytics - Received Referrer Data(<A JSON Response>)"
    

    Si ces journaux ne s’affichent pas, vérifiez que vous avez bien effectué les étapes 6 à 10 de la procédure.

    Le tableau suivant contient des informations supplémentaires sur les erreurs possibles :

    Erreur	Description
    Analytics - Unable to decode response(<string>).	La réponse est incorrecte.
    Analytics - Unable to parse response (a JSON Response).	La chaîne JSON est incorrecte.
    Analytics - Unable to parse acquisition service response (no contextData parameter in response).	Absence du paramètre contextData dans la réponse.
    Analytics - Acquisition referrer data was not complete (no a.referrer.campaign.name in context data), ignoring.	a.referrer.campaign.name n’est pas inclus dans contextData.
    Analytics - Acquisition referrer timed out.	Échec d’obtention de la réponse dans la durée définie par referrerTimeout. Augmentez la valeur et réessayez. Assurez-vous également d’avoir ouvert le lien d’acquisition avant d’installer l’application.

Gardez à l’esprit les informations suivantes :

• Les accès envoyés depuis l’application peuvent être surveillés à l’aide d’outils de surveillance HTTP afin de vérifier l’attribution de l’acquisition.
• Pour obtenir plus d’informations sur le mode de diffusion de INSTALL_REFERRER, voir Test de la mesure des campagnes Google Play dans le guide des développeurs Google.
• Vous pouvez utiliser l’outil Java acquisitionTest.jar fourni pour vous aider à obtenir l’identifiant unique et le référent d’installation de la diffusion qui, en retour, vous aident à obtenir les informations des étapes 3 à 10.

Installation de l’outil Java

Pour installer l’outil Java, procédez comme suit :

1. Téléchargez le fichier acquistionTester.zip.

2. Extrayez le fichier .jar.

   Vous pouvez exécuter le fichier .jar sur la ligne de commande.

Par exemple :

java -jar acquisitionTester.jar -a com.adobe.test -r com.adobe.test.ReferrerReceiver -l "https://c00.adobe.com/v3/appid/start?a_i_id=123456&a_g_id=com.adobe.test&a_dd=i&ctxa.referrer.campaign.name=name&ctxa.referrer.campaign.trackingcode=1234

Les liens marketing sont mis en mémoire cache côté serveur et ont un délai d’expiration de 10 minutes. Lorsque vous modifiez les liens marketing, vous devez attendre environ 10 minutes que les modifications soient prises en compte pour pouvoir à nouveau utiliser les liens.