버전용 도움말 콘텐츠:

Want to build engaging and relevent 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 gurantee you're staying relevent and 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 AEM Apps by integrating with Adobe Mobile Services.

Instrument your AEM Apps to track, report and understand how you 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:

  • Integrate Mobile Analytics into your mobile application
  • Test your analytics tracking with Bloodhound

Prerequisties

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

  • Setup an Adobe Analytics account and create a report suite for your application in Mobile Services.
  • Configure an AMS Cloud Service in Adobe Experience Manager (AEM).

For Developers - Integrate Mobile Analytics into your app

Configure ContentSync to pull in configuration file

After the Analytics account is setup you will need to create a Content Sync configuration to pull in the content into your Mobile Application. 

For additional details refer to Configuring the Content Sync Content. The configuration will need to instruct Content Sync to put the ADBMobileConfig into the /www directory. For example in the Geometrixx Outdoors App the Content Sync configuration is located 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 in the case of Geometrixx Outdoors.

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

<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://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 in the the Geometrixx Outdoors App at:content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js. 

For iOS the file will need to be copied to the XCode project's Resources directory (eg. "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 refer to 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

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 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 will need to instrument you code.

Instrument your code for full App tracking

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

These will allow you to 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 you app for tracking is to make use of the Analytics APIs provided by the AMS plugin. 

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

For reference you can take a look at the code in the Geometrixx Outdoors app. In the Geometrixx Outdoors app all of the page navigations are tracked using the ADB.trackState() method. For further details take a look at the source code for /libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js

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

Testing Analytics tracking with Bloodhound

chlImage_1

Optionally before deploying to production you can use the Adobe tool Bloodhound to test your analytics configuration. In order to test you analytics configuration you will need to edit your ADBMobileConfig.json file to point to the server where Bloodhound is running instead of the actual Analytics server. To make this change, from your ADBMobileConfig.json change the following entry.

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "YOUR_TRACKING_SERVER:YOUR_TRACKING_PORT",
...

Change to match this entry:

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "localhost:50000",
...

This will redirect all the data collected by the AMS plugin to Bloodhound so that you can view the results.

Properties for Connecting to AMS

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

Label Description Default
API Endpoint The base URL of the Adobe Mobile Services HTTP APIs https://api.omniture.com
Config Endpoint The URL used to retrieve the ADB Mobile Config for the given report suite id /ams/1.0/app/config/
Mobile Service Apps Get a list of apps within the users company /ams/1.0/apps

이 작업에는 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License의 라이센스가 부여되었습니다.  Twitter™ 및 Facebook 게시물은 Creative Commons 약관을 적용받지 않습니다.

법적 고지 사항   |   온라인 개인 정보 보호 정책