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

NOTE
Adobe recommande d’utiliser l’éditeur SPA pour les projets nécessitant un rendu côté client, basé sur un framework, pour une application à une seule page (comme 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 Adobe Experience Manager (AEM) en 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 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 must first :

  • 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é, 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 Synchronisation du contenu 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, 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 fichier du projet Xcode Ressources (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 points d’extension pendant la génération de l’interface de ligne de commande PhoneGap, voir 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 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.

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

À 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 :

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
2eeeb575-8007-40cc-a72d-206fbc4ddd4b