Add Adobe Analytics to your Mobile Application add-adobe-analytics-to-your-mobile-application

Want to build engaging and relevant experiences for your mobile application users? If you’re not using the Adobe Mobile Services SDK to monitor and measure application lifecycle and usage, then on what are you basing your decisions? Where are your most loyal customers? How can you guarantee you’re staying relevant and optimizing conversions?

Are your users accessing all the content? Are they abandoning the app, and if so, where? How often do they stay in the app and how often to they come back to use the app? What changes can you introduce and then measure that increase retention? What about crash rates, is your app crashing for your users?

Take advantage of Mobile App Analytics in your Adobe Experience Manager (AEM) Apps by integrating with Adobe Mobile Services.

Instrument your AEM Apps to track, report, and understand how your users engage with your mobile app and content and to measure key lifecycle metrics such as launches, time in app, and crash rate.

This section describes how AEM Developers can:

Prerequisites prerequisties

AEM Mobile requires an Adobe Analytics account to collect and report tracking data in your app. As part of the configuration, the AEM Administrator must first:

For Developers - Integrate Mobile Analytics into your app for-developers-integrate-mobile-analytics-into-your-app

Configure ContentSync to pull in configuration file configure-contentsync-to-pull-in-configuration-file

After the Analytics account is set up, create a Content Sync configuration to pull in the content into your Mobile Application.

For additional details, see Configuring the Content Sync Content. The configuration must instruct Content Sync to put the ADBMobileConfig into the /www directory. For example, in the Geometrixx Outdoors App, the Content Sync configuration is at: /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-config/ams-ADBMobileConfig. There is a configuration for development as well. However, it is identical to the non-development configuration if there is Geometrixx Outdoors.

For further details on how to download the ADBMobileConfig from your Mobile Application AEM Apps dashboard, see Analytics - Mobile Services - Adobe Mobile Services SDK Config File.

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

Each platform requires the ADBMobileConfig to be copied to a specific location.

If building with the PhoneGap CLI this can be done with an cordova build hook scripts. This can be seen intheGeometrixx Outdoors App at:content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js.

For iOS the file must be copied to the XCode project’s Resources directory (for example, “platforms/ios/Geometrixx/Resources/ADBMobileConfig.json”). If the App is targeted for Android™, then the path to copy to is “platforms/android/assets/ADBMobileConfig.json”. For further details on using hooks during the PhoneGap CLI build, see Three hooks your Cordova/PhoneGap project needs.

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

Add the AMS plugin in the App add-the-ams-plugin-in-the-app

For the App to collect the data the Adobe Mobile Services (AMS) plugin needs to be included as part of the app. By including the plugin as a feature in the app’s config.xml another Cordova hook can be used to automatically add the plugin during the PhoneGap build process.

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

The Geometrixx Outdoors App config.xml is located at /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml. The example above requests a specific version of the plugin to be used by adding a ‘#’ and then a tag value after the plugin URL. This is a good practice to follow to ensure that unanticipated issues do not appear due to untested plugins being added during a build.

After performing these steps, your app will be enabled to report all the lifecycle metrics provide by Adobe Analytics. This includes data such as launches, crashes and installs. If that’s the only data which you care about, then you are done. If you want to collect custom data, then you must instrument your code.

Instrument your code for full App tracking instrument-your-code-for-full-app-tracking

There are several tracking APIs provided in the AMS Phonegap Plugin API.

These will let you track states and actions such as where pages your users are navigating to in your app, which controls are being used the most. The easiest way to instrument your app for tracking is to use the Analytics APIs provided by the AMS plugin.

For reference, look at the code in the Geometrixx Outdoors app. In the Geometrixx Outdoors app, all page navigation is tracked using the ADB.trackState() method. For further details, see the source code for /libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js

By instrumenting your source code with this method calls, you are able to collect full metrics against your application.

Properties for Connecting to AMS properties-for-connecting-to-ams

com.adobe.cq.mobile.mobileservices.impl.service.MobileServicesHttpClientImp l exposes the following properties for connecting to AMS: