将Adobe Analytics添加到移动应用程序 add-adobe-analytics-to-your-mobile-application

想要为您的移动应用程序用户构建引人入胜的相关体验？ 如果您没有使用Mobile Services SDK来监控和测量应用程序生命周期和使用情况，那么您的决策依据是什么？ 您最忠诚的客户在哪里？ 如何确保保持相关性并优化转化？

您的用户是否访问了所有内容？ 他们会放弃应用吗？如果是，会在哪里？ 他们在应用程序中停留的频率是多久？他们回来使用该应用程序的频率是多久？ 您可以引入哪些更改，然后测量这些更改会提高保留率？ 那么崩溃率呢，您的应用程序是否会对用户造成崩溃？

利用 移动设备应用程序分析 通过与 AdobeMobile Services.

利用AEM应用程序，可跟踪、报告和了解用户如何与您的移动设备应用程序和内容交互，以及如何测量关键生命周期量度，如启动次数、应用程序内时间和崩溃率。

本节介绍AEM 开发人员 可以：

先决条件 prerequisties

AEM Mobile需要Adobe Analytics帐户才能收集和报告应用程序中的跟踪数据。 在配置中，AEM 管理员 将首先需要：

对于开发人员 — 将Mobile Analytics集成到您的应用程序中 for-developers-integrate-mobile-analytics-into-your-app

配置ContentSync以提取配置文件 configure-contentsync-to-pull-in-configuration-file

设置Analytics帐户后，您将需要创建内容同步配置，以将内容提取到您的移动设备应用程序中。

有关其他详细信息，请参阅配置内容同步内容。 配置将需要指示内容同步将ADBMobileConfig放入/www目录中。 例如，在Geometrixx Outdoors应用程序中，内容同步配置位于： /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-config/ams-ADBMobileConfig. 还有开发配置；但是，它与Geometrixx Outdoors中的非开发配置相同。

有关如何从Mobile Application AEM应用程序功能板下载ADBMobileConfig的更多详细信息，请参阅Analytics - Mobile Services -AdobeMobile Services SDK配置文件。

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

每个平台都要求将ADBMobileConfig复制到特定位置。

如果使用PhoneGap CLI进行构建，则可以使用cordova构建挂接脚本来完成此操作。 这可在Geometrixx Outdoors应用程序中查看：content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js。

对于iOS，需要将文件复制到Xcode项目的 资源 目录(例如 "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json")。 如果针对Android定位了应用程序，则复制到的路径为“platforms/android/assets/ADBMobileConfig.json”。 有关在PhoneGap CLI构建期间使用挂钩的更多详细信息，请参阅 三个挂钩，可满足您的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"
        }
    ]

在应用程序中添加AMS插件 add-the-ams-plugin-in-the-app

AdobeMobile Services(AMS)插件需要作为应用程序的一部分包含，才能让应用程序收集数据。 通过将插件作为功能包含在应用程序config.xml中，另一个Cordova挂接可用于在PhoneGap构建过程中自动添加插件。

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

Geometrixx Outdoors应用程序config.xml位于 /content/phonegap/geometrixx-outdoors/shell/jcr/content/pge-app/app-content/phonegap/www/config.xml. 以上示例通过在插件URL后添加“#”和标记值，请求使用插件的特定版本。 这是一种良好的做法，可确保在内部版本期间添加未经测试的插件时，不会出现意料之外的问题。

执行这些步骤后，您的应用程序将被启用以报告由Adobe Analytics提供的所有生命周期量度。 这包括启动次数、崩溃次数和安装次数等数据。 如果这是您唯一关心的数据，那么您就完成了。 如果要收集自定义数据，则需要设置代码。

设置代码以进行完整的应用程序跟踪 instrument-your-code-for-full-app-tracking

中提供了多个跟踪API AMS Phonegap插件API。

这些功能允许您跟踪状态和操作，例如用户在应用程序中导航到的页面位置（最常使用的控件）。 使用应用程序进行跟踪的最简单方法是利用AMS插件提供的Analytics API。

要获取参考，您可以查看Geometrixx Outdoors应用程序中的代码。 在Geometrixx Outdoors应用程序中，使用ADB.trackState()方法跟踪所有页面导航。 有关更多详细信息，请参阅/libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js的源代码

通过使用这些方法调用检测源代码，您可以针对应用程序收集完整量度。

使用Bloodhound测试Analytics跟踪 testing-analytics-tracking-with-bloodhound

（可选）在部署到生产环境之前，您可以使用Adobe工具Bloodhound来测试分析配置。 要测试您的分析配置，您需要编辑ADBMobileConfig.json文件，以指向运行Bloodhound的服务器，而不是实际的Analytics服务器。 要进行此更改，请从ADBMobileConfig.json中更改以下条目。

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

更改以匹配此条目：

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

这会将AMS插件收集的所有数据重定向到Bloodhound ，以便您能够查看结果。

连接到AMS的属性 properties-for-connecting-to-ams

com.adobe.cq.mobile.mobileservices.impl.service.MobileServicesHttpClientImp l公开了以下用于连接到AMS的属性：