Show Menu
主题×

迁移到4.x SDK

本节介绍如何从先前的Windows移动SDK的3.x版本迁移到Windows 8.1通用App Store 4.x SDK forExperience Cloud解决方案。
升级到4.x版后,现在可通过静态方法访问所有功能,因此无需再跟踪您自己的对象。
以下部分将指导您从3.x版迁移到4.x版。

删除未使用的属性

您可能注意到下载 ADBMobileConfig.json 中包含一个新文件。 此文件包含特定于应用程序的全局设置,并替换先前版本中使用的大多数配置变量。 以下是 ADBMobileConfig.json 文件的示例:
{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 300, 
        "privacyDefault" : "optedin", 
        "poi" : [ 
                    ["san francisco",37.757144,-122.44812,7000], 
                    ["santa cruz",36.972935,-122.01725,600] 
                ] 
    }, 
 "target" : { 
  "clientCode" : "myTargetClientCode", 
  "timeout" : 5 
 }, 
 "audienceManager" : { 
  "server" : "myServer.demdex.com" 
 } 
}

下表列出了需要移到配置文件的配置变量。将第一列中变量的设置值移动到第二列中的变量,然后从代码中删除旧配置变量。

从3.x迁移

配置变量/方法
Variable in the ADBMobileConfig.json file.
offlineTrackingEnabled
"offlineEnabled"
reportSuiteID
"rsids"
trackingServer
"server"
charSet
"charset"
currencyCode
“货币”
ssl
"ssl"
setOfflineHitLimit
删除,不再使用。
linkTrackVars
删除,不再使用。
linkTrackEvents
删除,不再使用。

更新跟踪调用和跟踪变量

版本4 SDK不使用 Track TrackLink Web为中心的调用,而是使用两种在移动世界中更有意义的方法:
  • TrackState 状态是您的应用程序中可用的视图,如“主仪表板”、“应用程序设置”、“购物车”等。 这些状态与网站中的页面类似,而且 trackState 调用会使页面查看次数递增。
  • TrackAction 操作是您要衡量的应用程序中发生的事情,如“登录”、“横幅点击”、“源订阅”和其他指标。 这些调用不会增加页面视图。
The contextData parameter for both of these methods contains name-value pairs that are sent as context data.

事件、Prop、eVar

如果您已经研究过SDK 方法 ,您可能会想知道在哪里设置事件、eVar、prop、继承人和列表。 在版本4中,您无法再直接在应用程序中分配这些类型的变量。 相反,SDK使用上下文数据和处理规则将应用程序数据映射到Analytics变量以进行报告。
处理规则为您提供了几个优势:
  • 您无需向App Store提交更新即可更改数据映射。
  • 您可以对数据使用有意义的名称,而不是设置特定于报表包的变量。
  • 发送额外数据几乎没有影响。 这些值只有在使用处理规则映射后才会显示在报告中。
For more information, see Processing Rules in Analytics .
您直接分配给变量的任何值都应添加到上下文数据中。 This means that calls to SetProp , SetEvar , and assignments to persistent context data should all be removed and the values added to context data.
AppSection/Server、GeoZip、事务ID、活动和其他标准变量
您在测量对象上设置的任何其他数据(包括上面列出的变量)应改为添加到上下文数据。
简言之,随或调用发送的唯一数 TrackState TrackAction 是参数中的有效负 data 荷。

替换跟踪调用

Throughout your code, replace the following methods with a call to trackState or trackAction :

从3.x迁移

  • TrackAppState (TrackState)
  • TrackEvents (TrackAction)
  • Track (TrackAction)
  • TrackLinkURL (TrackAction)

自定义访客 ID

visitorID 变量替换为对 setUserIdentifier 的调用。

离线跟踪

Offline tracking is enabled in the ADBMobileConfig.json file. All other offline configuration is done automatically.
在整个代码中,删除对以下方法的调用:

从3.x迁移

  • SetOnline
  • SetOffline

产品变量

由于产品变量在处理规则中不可用,因此可以使用以下语法设置 products
// create a processing rule to set the corresponding product event. 
// for example, set the Product Views event when context data a.action = "product view" 
var cdata = new Windows.Foundation.Collections.PropertySet(); 
cdata["&&products"] = ";Cool Shoe"; 
ADB.Analytics.trackAction("product view", cdata);

在此示例中,值 "&&products" 为“ ";Cool Shoe ”,并应遵循您所跟踪的事件类型的产品字符串语法。