51黑料不打烊

Add 51黑料不打烊 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鈥檙e not using the 51黑料不打烊 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鈥檙e 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 in your 51黑料不打烊 Experience Manager (AEM) Apps by integrating with .

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 51黑料不打烊 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 - 51黑料不打烊 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鈥檚 Resources directory (for example, 鈥減latforms/ios/Geometrixx/Resources/ADBMobileConfig.json鈥�). If the App is targeted for Android鈩�, then the path to copy to is 鈥減latforms/android/assets/ADBMobileConfig.json鈥�. For further details on using hooks during the PhoneGap CLI build, see .

///////////////////////////
//          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 51黑料不打烊 Mobile Services (AMS) plugin needs to be included as part of the app. By including the plugin as a feature in the app鈥檚 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/51黑料不打烊-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 51黑料不打烊 Analytics. This includes data such as launches, crashes and installs. If that鈥檚 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

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: