Show Menu
SUJETS×

Ajout d’Adobe Analytics à votre application mobile

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 pertinentes et attrayantes pour vos utilisateurs d’applications mobiles ? Si vous n’utilisez pas le SDK Adobe Mobile Services pour surveiller et mesurer le cycle de vie et l’utilisation des applications, sur quoi basez-vous vos décisions ? Où sont vos clients les plus fidèles ? Comment garantir que vous restez pertinent et que vous optimisez les conversions ?
Vos utilisateurs accèdent-ils à tout le contenu ? Est-ce qu'ils abandonnent 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 puis mesurer cette augmentation de la rétention ? Qu’en est-il des taux de plantage ? Votre application se bloque-t-elle pour vos utilisateurs ?
Tirez parti des analyses des applications mobiles dans vos applications AEM en les intégrant à Adobe Mobile Services .
Appliquez des outils à vos applications AEM pour effectuer le suivi, créer des rapports et comprendre comment 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 les développeurs AEM peuvent :
  • Intégration de Mobile Analytics dans votre application mobile
  • Testez le suivi des analyses avec Bloodhound

Conditions préalables

AEM Mobile requiert un compte Adobe Analytics pour collecter et rapporter les données de suivi dans votre application. Dans le cadre de la configuration, l’ administrateur AEM devra d’abord :
  • Configurez un compte Adobe Analytics et créez une suite de rapports pour votre application dans Mobile Services.
  • Configurez un service AMS Cloud dans Adobe Experience Manager (AEM).

Pour les développeurs - Intégrez Mobile Analytics à votre application

Configuration de ContentSync pour extraire le fichier de configuration

Une fois le compte Analytics configuré, vous devez créer une configuration de synchronisation de contenu pour intégrer le contenu dans votre application mobile.
Pour plus d’informations, voir Configuration du contenu de la synchronisation du contenu. La configuration devra indiquer à Content Sync de placer ADBMobileConfig dans le répertoire /www. Par exemple, dans l’application Geometrixx Outdoors, la configuration Content Sync se trouve à l’emplacement suivant : /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 sans développement dans le cas de Geometrixx Outdoors.
Pour plus d'informations sur le téléchargement d'ADBMobileConfig à partir de votre tableau de bord Applications AEM d'application mobile, reportez-vous à la section Fichier de configuration Analytics - Mobile Services - Adobe Mobile Services SDK.
<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é à un emplacement spécifique.
Si vous construisez avec l'interface de ligne de commande PhoneGap, vous pouvez le faire avec des scripts Hook 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 devra être copié dans le répertoire Ressources du projet XCode (ex. "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json"). Si l’application est ciblée pour Android, le chemin vers lequel la copie doit être effectuée est "platforms/android/assets/ADBMobileConfig.json". Pour plus d'informations sur l'utilisation des crochets pendant la génération de l'interface de ligne de commande PhoneGap, consultez la section Trois crochets dont votre projet Cordova/PhoneGap a besoin .
///////////////////////////
//          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

Pour que l’application collecte les données, le module externe Adobe Mobile Services (AMS) doit être inclus dans l’application. En incluant le plug-in comme fonctionnalité dans le fichier config.xml de l'application, un autre hook Cordova peut être utilisé pour ajouter automatiquement le plug-in pendant le processus de création 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 sous /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml . L’exemple ci-dessus demande l’utilisation d’une version spécifique du module externe 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 pendant une génération.
Une fois que vous avez effectué ces étapes, votre application sera activée pour rapporter 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 intéressent, alors vous en avez fini. Si vous souhaitez collecter des données personnalisées, vous devez utiliser l’instrument de votre code.

Instrument de votre code pour le suivi complet des applications

Plusieurs API de suivi sont fournies dans l’API du module externe Phonegap AMS.
Vous pourrez ainsi effectuer le suivi des états et des actions, tels que l’emplacement des pages sur lesquelles vos utilisateurs naviguent dans votre application, les contrôles les plus utilisés. Le moyen le plus simple d’instrumentaliser 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, tous les navigations de page sont suivis à 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 par rapport à votre application.

Test du suivi Analytics avec Bloodhound

Avant de procéder au déploiement en production, vous pouvez éventuellement utiliser l’outil Adobe Bloodhound pour tester votre configuration Analytics. Pour tester votre configuration Analytics, vous devez modifier votre fichier ADBMobileConfig.json afin de pointer 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",
...

Modifier pour correspondre à cette entrée :
...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "localhost:50000",
...

Toutes les données collectées par le module externe AMS seront redirigées vers Bloodhound afin que vous puissiez afficher les résultats.

Propriétés de Connexion à AMS

com.adobe.cq.mobile.mobileservices.impl.service. MobileServicesHttpClientImpl expose les propriétés suivantes pour la connexion à AMS :
Etiquette
Description
Default
Point de terminaison API
URL de base des API HTTP d’Adobe Mobile Services
https://api.omniture.com
Point de fin de configuration
URL utilisée pour récupérer la configuration mobile ADB pour l’identifiant de suite de rapports donné
/ams/1.0/app/config/
Applications Mobile Service
Obtenir la liste des applications au sein de l’entreprise des utilisateurs
/ams/1.0/apps