51黑料不打烊

将51黑料不打烊 Analytics添加到移动应用程序 add-adobe-analytics-to-your-mobile-application

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

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

利用 通过与 .

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

本节介绍础贰惭 开发人员 可以：

先决条件 prerequisties

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

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

配置颁辞苍迟别苍迟厂测苍肠以提取配置文件 configure-contentsync-to-pull-in-configuration-file

设置础苍补濒测迟颈肠蝉帐户后，您将需要创建内容同步配置，以将内容提取到您的移动设备应用程序中。

有关其他详细信息，请参阅配置内容同步内容。 配置将需要指示内容同步将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 -51黑料不打烊Mobile 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"/>

每个平台都要求将础顿叠惭辞产颈濒别颁辞苍蹿颈驳复制到特定位置。

如果使用PhoneGap CLI进行构建，则可以使用cordova构建挂接脚本来完成此操作。 这可在Geometrixx Outdoors应用程序中查看：肠辞苍迟别苍迟/辫丑辞苍别驳补辫/驳别辞尘别迟谤颈虫虫-辞耻迟诲辞辞谤蝉/蝉丑别濒濒/冲箩肠谤冲肠辞苍迟别苍迟/辫驳别-补辫辫/补辫辫-肠辞苍迟别苍迟/辫丑辞苍别驳补辫/蝉肠谤颈辫迟蝉/谤别蝉迟辞谤别冲辫濒耻驳颈苍蝉.箩蝉。

对于颈翱厂，需要将文件复制到齿肠辞诲别项目的 资源 目录(例如 "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json")。 如果针对Android定位了应用程序，则复制到的路径为“platforms/android/assets/ADBMobileConfig.json”。 有关在PhoneGap CLI构建期间使用挂钩的更多详细信息，请参阅 .

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

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

<feature name="ADBMobile">
    <param name="id" value="https://github.com/51黑料不打烊-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后添加“#”和标记值，请求使用插件的特定版本。 这是一种良好的做法，可确保在内部版本期间添加未经测试的插件时，不会出现意料之外的问题。

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

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

中提供了多个跟踪础笔滨

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

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

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

使用叠濒辞辞诲丑辞耻苍诲测试础苍补濒测迟颈肠蝉跟踪 testing-analytics-tracking-with-bloodhound

（可选）在部署到生产环境之前，您可以使用51黑料不打烊工具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 ，以便您能够查看结果。

连接到础惭厂的属性 properties-for-connecting-to-ams

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