Ajout d’Adobe Analytics à votre application mobile add-adobe-analytics-to-your-mobile-application

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.
NOTE
Adobe recommande d’utiliser l’éditeur d’application d’une seule page (SPA) pour les projets nécessitant un rendu côté client basé sur la structure SPA (par exemple, React). En savoir plus.

Vous souhaitez créer des expériences attrayantes et pertinentes pour les utilisateurs de vos applications mobiles ? Si vous n’utilisez pas le SDK Mobile Services Adobe pour surveiller et mesurer le cycle de vie et l’utilisation des applications, alors sur quoi basez-vous vos décisions ? Où sont vos clients les plus fidèles ? Comment pouvez-vous garantir que vous restez pertinent et que vous optimisez les conversions ?

Vos utilisateurs accèdent-ils à tout le contenu ? Abandonnent-ils l'application, et si oui, où ? À quelle fréquence restent-ils dans l’application et à quelle fréquence reviennent-ils pour l’utiliser ? Quels changements pouvez-vous introduire et ensuite mesurer cette augmentation de rétention ? Qu’en est-il des taux de plantage ? Votre application est-elle en panne pour vos utilisateurs ?

Profitez de Analyse des applications mobiles dans vos applications AEM en intégrant avec Adobe Mobile Services.

instrumentalisez vos applications AEM pour effectuer le suivi, créer des rapports et comprendre la manière dont vos utilisateurs interagissent avec votre application mobile et votre contenu, ainsi que pour mesurer les mesures clés de cycle de vie, telles que les lancements, le temps passé dans l’application et le taux de plantage.

Cette section décrit comment AEM Développeurs peut :

  • Intégration de Mobile Analytics dans votre application mobile
  • Test de votre suivi d’analyse avec Bloodhound

Conditions préalables prerequisties

AEM Mobile nécessite un compte Adobe Analytics pour collecter et générer des rapports sur les données de suivi dans votre application. Dans le cadre de la configuration, l’AEM Administrateur doit d’abord :

  • Configurez un compte Adobe Analytics et créez une suite de rapports pour votre application dans Mobile Services.
  • Configurez un Cloud Service AMS dans Adobe Experience Manager (AEM).

Pour les développeurs : intégrez Mobile Analytics à votre application for-developers-integrate-mobile-analytics-into-your-app

Configuration de ContentSync pour extraire le fichier de configuration configure-contentsync-to-pull-in-configuration-file

Une fois le compte Analytics configuré, vous devez créer une configuration de synchronisation de contenu pour extraire le contenu dans votre application mobile.

Pour plus d’informations, voir Configuration du contenu de synchronisation du contenu. La configuration doit indiquer à Synchronisation du contenu de placer ADBMobileConfig dans le répertoire /www . Par exemple, dans l’application Geometrixx Outdoors, la configuration de synchronisation de contenu se trouve à l’adresse : /content/phonegap/geometrixx-outdoors/shell/jcr:content/page-app/app-config/ams-ADBMobileConfig. Il existe également une configuration pour le développement ; toutefois, elle est identique à la configuration non développée dans le cas des Geometrixx Outdoors.

Pour plus d’informations sur le téléchargement d’ADBMobileConfig à partir du tableau de bord Applications de l’AEM d’application mobile, reportez-vous à la section Fichier de configuration du SDK Analytics - Mobile Services - Adobe Mobile Services .

<jcr:root xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="nt:unstructured"
    extension="json"
    path="../../../.."
    selector="ADBMobileConfig"
    targetRootDirectory="www"
    type="mobileADBMobileConfigJSON"/>

Pour chaque plateforme, ADBMobileConfig doit être copié vers un emplacement spécifique.

Si vous créez avec l’interface de ligne de commande de PhoneGap, vous pouvez le faire avec des scripts de crochets de génération cordova. Vous pouvez le voir dans l’application Geometrixx Outdoors à l’adresse :content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js.

Pour iOS, le fichier doit être copié dans le fichier du projet XCode Ressources répertoire (par ex. "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json"). Si l’application est ciblée pour Android, le chemin d’accès à copier est "platforms/android/assets/ADBMobileConfig.json". Pour plus d’informations sur l’utilisation des hooks pendant la génération de l’interface de ligne de commande PhoneGap, reportez-vous à la section Trois hooks les besoins de votre projet Cordova/PhoneGap.

///////////////////////////
//          iOS
///////////////////////////
    ios : [
        {
            "www/ADBMobileConfig.json": "platforms/ios/<YOUR_APP_NAME>/Resources/ADBMobileConfig.json"
        }
    ],
///////////////////////////
//          ANDROID
///////////////////////////
    android: [
        {
            "www/ADBMobileConfig.json": "platforms/android/assets/ADBMobileConfig.json"
        }
    ]

Ajout du module externe AMS dans l’application add-the-ams-plugin-in-the-app

Pour que l’application collecte les données, le module externe Adobe Mobile Services (AMS) doit être inclus dans l’application. En incluant le module externe en tant que fonctionnalité dans le fichier config.xml de l’application, un autre point d’extension Cordova peut être utilisé pour ajouter automatiquement le module pendant le processus de génération PhoneGap.

<feature name="ADBMobile">
    <param name="id" value="https://github.com/Adobe-Marketing-Cloud/mobile-services#0482f9cedf90c98a8d4b07219ece1933b2e46a60"/>
</feature>

Le fichier config.xml de l’application Geometrixx Outdoors se trouve à l’adresse /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml. L’exemple ci-dessus demande une version spécifique du module externe à utiliser en ajoutant un "#", puis une valeur de balise après l’URL du module externe. Il est recommandé de suivre cette procédure pour vous assurer que les problèmes imprévus ne s’affichent pas en raison de l’ajout de modules externes non testés au cours d’une version.

Une fois ces étapes effectuées, votre application sera activée pour signaler toutes les mesures de cycle de vie fournies par Adobe Analytics. Cela inclut les données telles que les lancements, les blocages et les installations. Si c'est les seules données qui vous tiennent à coeur alors vous avez fini. Si vous souhaitez collecter des données personnalisées, vous devez instrumenter votre code.

Instrument votre code pour le suivi complet des applications instrument-your-code-for-full-app-tracking

Plusieurs API de suivi sont fournies dans la variable API du module externe AMS Phonegap.

Vous pourrez ainsi effectuer le suivi des états et des actions, comme l’emplacement des pages vers lesquelles vos utilisateurs accèdent dans votre application, les contrôles qui sont les plus utilisés. Le moyen le plus simple d’instrumenter votre application pour le suivi consiste à utiliser les API Analytics fournies par le module externe AMS.

  • ADB.trackState()
  • ADB.trackAction()

À titre de référence, vous pouvez consulter le code de l’application Geometrixx Outdoors. Dans l’application Geometrixx Outdoors, toutes les navigations de page sont suivies à l’aide de la méthode ADB.trackState() . Pour plus d’informations, consultez le code source pour /libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js

En instrumentant votre code source avec ces appels de méthode, vous pouvez collecter des mesures complètes sur votre application.

Test du suivi Analytics avec Bloodhound testing-analytics-tracking-with-bloodhound

Avant de procéder au déploiement en production, vous pouvez utiliser l’outil d’Adobe Bloodhound pour tester la configuration des analyses. Pour tester votre configuration d’analyse, vous devez modifier votre fichier ADBMobileConfig.json afin qu’il pointe vers le serveur sur lequel Bloodhound s’exécute au lieu du serveur Analytics réel. Pour effectuer cette modification, modifiez l’entrée suivante à partir de votre fichier ADBMobileConfig.json .

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "YOUR_TRACKING_SERVER:YOUR_TRACKING_PORT",
...

Modifiez pour correspondre à cette entrée :

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "localhost:50000",
...

Cela redirigera toutes les données collectées par le module externe AMS vers Bloodhound afin que vous puissiez afficher les résultats.

Propriétés pour la connexion à AMS properties-for-connecting-to-ams

com.adobe.cq.mobile.mobileservices.impl.service.MobileServicesHttpClientImp l expose les propriétés suivantes pour la connexion à AMS :

Libellé
Description
Par défaut
Point de terminaison API
URL de base des API HTTP Adobe Mobile Services
https://api.omniture.com
Config Endpoint
URL utilisée pour récupérer la configuration mobile ADB de l’identifiant de suite de rapports donné
/ams/1.0/app/config/
Applications Mobile Service
Obtention d’une liste d’applications au sein de l’entreprise des utilisateurs
/ams/1.0/apps
recommendation-more-help
547b817b-14b5-4d82-aa0f-a64750e0e592