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

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 Mobile App Analytics dans vos applications Adobe Experience Manager (AEM) en les intégrant à Adobe Mobile Services.

instrumentalisez vos applications AEM pour effectuer le suivi, créer des rapports et comprendre l’interaction de vos utilisateurs 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 d’entrée dans l’application et le taux de plantage.

Cette section décrit comment AEM développeurs peuvent :

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 Administrator doit d'abord :

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é, créez 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 est : /content/phonegap/geometrixx-outdoors/shell/jcr:content/page-app/app-config/ams-ADBMobileConfig. Il existe également une configuration pour le développement. Toutefois, il est identique à la configuration autre que le développement s’il existe des Geometrixx Outdoors.

Pour plus d’informations sur le téléchargement d’ADBMobileConfig à partir du tableau de bord de vos applications AEM d’application mobile, voir Analytics - Mobile Services - Fichier de configuration du SDK d’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 répertoire Resources du projet Xcode (par exemple, "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, voir Trois hooks your Cordova/PhoneGap project need.

///////////////////////////
//          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>

L’application Geometrixx Outdoors config.xml se trouve à l’emplacement suivant : /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 l' API du module externe AMS Phoneegap.

Vous pourrez ainsi effectuer le suivi des états et des actions, comme l’emplacement où se rendent les pages consultées par vos utilisateurs dans votre application, les contrôles 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.

À titre de référence, consultez le code de l’application Geometrixx Outdoors. Dans l’application Geometrixx Outdoors, toutes les pages de navigation sont suivies à l’aide de la méthode ADB.trackState() . Pour plus d’informations, voir 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.

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 :