Show Menu
主题×

将Adobe Analytics添加到您的移动应用程序

Adobe建议对需要基于单页应用程序框架的客户端渲染(例如,React)的项目使用SPA编辑器。 了解更多 .
想要为移动应用程序用户构建引人入胜的相关体验? 如果您不使用Adobe Mobile Services SDK来监视和衡量应用程序生命周期和使用情况,那么您会根据自己的决策作出哪些决定? 您最忠诚的客户在哪里? 您如何确保保持相关性并优化转化率?
您的用户是否访问所有内容? 他们是否会放弃这款应用,如果是,会在哪里? 他们在应用程序中停留的频率以及他们回来使用应用程序的频率? 您可以引入哪些更改,然后衡量这些更改会提高保留率? 崩溃率如何?您的应用程序是否会为用户崩溃?
通过与 Adobe Mobile services集成 ,在AEM应用程序中利用 Mobile App Analytics
利用AEM应用程序跟踪、报告和了解用户如何使用您的移动应用程序和内容以及衡量关键生命周期指标(如启动次数、应用程序内时间和崩溃率)。
本节介绍AEM开发人 员如何 :
  • 将Mobile Analytics集成到您的移动应用程序中
  • 使用Bloodhound测试分析跟踪

先决条件

AEM mobile需要Adobe Analytics帐户来收集和报告应用程序中的跟踪数据。 作为配置的一部分,AEM Administrator 首先需要:
  • 在Mobile services中设置Adobe Analytics帐户并为应用程序创建报表包。
  • 在Adobe Experience Manager(AEM)中配置AMS云服务。

对于开发人员——将Mobile Analytics集成到您的应用程序中

配置ContentSync以导入配置文件

设置Analytics帐户后,您将需要创建内容同步配置以将内容引入您的移动应用程序。
有关其他详细信息,请参阅配置内容同步内容。 该配置需要指示“内容同步”将ADBMobileConfig放入/www目录中。 例如,在Geometrixx Outdoors应用程序中,内容同步配置位于: /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-config/ams-ADBMobileConfig 。 还有一种开发配置;但是,在Geometrixx Outdoors的情况下,它与非开发配置相同。
有关如何从Mobile Application AEM Apps控制面板下载ADBMobileConfig的更多详细信息,请参阅Analytics - Mobile Services - Adobe 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"/>

每个平台都需要将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构建过程中使用钩子的更多详细信息,请参阅 Three hooks your 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插件

要使应用程序收集数据,Adobe Mobile Services(AMS)插件需要作为应用程序的一部分包含在其中。 通过将插件作为功能包含在应用程序的config.xml中,可以在PhoneGap构建过程中使用另一个Cordova挂钩自动添加插件。
<feature name="ADBMobile">
    <param name="id" value="https://github.com/Adobe-Marketing-Cloud/mobile-services#0482f9cedf90c98a8d4b07219ece1933b2e46a60"/>
</feature>

Geometrixx Outdoors App config.xml位于 /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml 。 上面的示例通过在插件URL后添加“#”和标记值来请求要使用的插件的特定版本。 这是一种很好的做法,可确保由于在构建过程中添加未经测试的插件而不会出现意外的问题。
执行这些步骤后,您的应用程序将能够报告Adobe Analytics提供的所有生命周期指标。 这包括启动、崩溃和安装等数据。 如果这是您关心的唯一数据,那么您就完成了。 如果要收集自定义数据,则需要使用工具编写代码。

编写代码以实现完整的应用程序跟踪

AMS Phonegap插件API中提供 了多个跟踪API。
这些组件允许您跟踪状态和操作,如用户在应用程序中导航到的页面的位置(哪些控件使用最多)。 使用AMS插件提供的Analytics API来指导您的应用程序进行跟踪的最简单方法。
  • ADB.trackState()
  • ADB.trackAction()
要获得参考,您可以查看Geometrixx Outdoors应用程序中的代码。 在Geometrixx Outdoors应用程序中,使用ADB.trackState()方法跟踪所有页面导航。 有关更多详细信息,请查看/libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js的源代码
通过使用这些方法调用检测源代码,您可以针对您的应用程序收集完整指标。

使用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的属性

com.adobe.cq.mobile.mobileservices.impl.service. MobileServicesHttpClientImpl公开以下用于连接到AMS的属性:
标签
描述
默认
API端点
Adobe Mobile Services HTTP API的基本URL
https://api.omniture.com
配置端点
用于检索给定报表包ID的ADB移动配置的URL
/ams/1.0/app/config/
移动服务应用程序
获取用户公司内的应用程序列表
/ams/1.0/apps