Talkingdata：集成文档WindowsPhone

适用范围

talkingdata App Analytics WindowsPhone SDK适用于WindowsPhone8.0和8.1系统。

集成准备-创建应用并获取App ID

App ID是TalkingData分析平台标识一款独立应用/游戏的唯一标识，集成SDK前需要在TalkingData报表中创建应用/游戏并获取相应的App ID。 步骤： 1）注册并登录https://www.talkingdata.com/ ，选择App Analytics产品线 2）创建应用并获取App ID 3）如果已创建的应用，请从“应用管理->基本信息”中查看App ID。 说明： TalkingData支持多平台使用相同的App ID。

集成准备-统计标准说明

基础统计指标定义： 1）新增用户：WindowsPhone平台中“用户”指一个独立设备。 2）用户的一次使用：指用户从打开应用到退出应用的全过程，如果用户按“Home”键将切出应用后30s内再次返回应用，则认为是上一次使用的延续，不会算作新的应用使用。 3）自定义事件：指用户在HTML5中进行了特定的操作或达成了特定的条件。例如：用户点击了广告栏、用户进行付费等。 自定义事件用于收集任意您期望跟踪的数据。

快速集成-导入SDK

1）右键点击 解决方案 中需要集成 SDK 的项目工程，展开 References。

2）右键点击 References 选择 Add Reference...。

3）在弹出的 Reference Manager 窗口中选择 Browse 页。

4）点击右下角的 Browser 按钮并选择 TalkingDataAnalytics.dll。

快速集成-配置应用权限

在工程 Properties 目录下，找到 WMAppManifest.xml 文件并打开，添加下面的权限：

权限	用途

ID_CAP_NETWORKING：| 允许应用程序联网，发送统计数据的权限。 ID_CAP_IDENTITY_DEVICE：|用来读取标示唯一设备的 Device Unique ID

或者，在 Manifest 的 Designer 中，选择这两个权限：

快速集成-初始化SDK

在 App.xaml.cs 文件中的 Application_Launching 和 Application_Activated 方法中初始化 App Analytics SDK:

    private void Application_Launching(object sender, LaunchingEventArgs e)
 {
 // App ID: 在 App Analytics 创建应用后，进入数据报表页中，在 `系统设置` - `编辑应用` 页面里查看 App ID。 
 // 渠道 ID: 是渠道标识符，可通过不同渠道单独追踪数据。
 TalkingdataWp7SDK.Analytics.StartAnalytics("Your_app_id", "Your_channel_id");
 }
 private void Application_Activated(object sender, ActivatedEventArgs e)
 {
 TalkingdataWp7SDK.Analytics.StartAnalytics("Your_app_id", "Your_channel_id");
 }

基础-基础统计

正确完成初始化调用后，自动完成应用启动的统计，详见集成步骤：SDK初始化。

基于应用启动，后台自动计算独立设备，并计算新增、活跃、留存、升级等指标。

基础-渠道统计

1、用途和用法

给应用的安装包打入特殊的渠道标记，用户安装并使用后，就可以在报表中分不同渠道来源单独查询相应的数据。

在您为应用商店、下载站等分发渠道提供应用安装包时，可以加入渠道标记；在进行特别的活动时也可加入特殊渠道标记便于单独分析效果。

注意事项：

用户的渠道归属：每台设备仅记录到首次安装激活的渠道，同一用户在更替渠道包使用后不会重复计算新增，使用数据归入首次激活渠道。如果未添加渠道标记，或渠道标记是示例代码中的默认值，用户将会归入为“未知渠道”。

2、集成方式说明

各个平台的快速集成中，初始化方法中已说明如何传入渠道 ID，集成方式参考各个平台的快速集成文档。

此外Android平台我们提供了更优的渠道标记方式：

1）配置AndroidManifest.xml

在 AndroidManifest.xml里添加 meta-data段，用您定义的渠道名替换value中的 Your_channel_id

2）多渠道打包工具

以帮助您快速生成多个不同渠道包，支持V1.2.74版本及以上。该工具修改的渠道ID会优先于手动修改的渠道ID被读取。

下载地址：http://doc.talkingdata.com/posts/194

渠道ID获取的优先顺序： 1）多渠道打包工具

2）AndroidManifest.xml

3）TCAgent.init 代码

基础-错误报告

1、用途和用法

收集应用的错误日志可帮助您来修正Bug、改善产品。报表中，我们除了提供错误次数的数据外，还提供错误的详细信息：错误发生时间，堆栈调用情况，并会对错误进行合理分类。

注意事项：

1）异常信息收集会损耗最终用户流量，因此自动捕获默认为关闭状态，您可根据需要开启此功能。

2）方法调用须在各个平台初始化后尽早调用。

2、接口及参数

主动传送异常信息，调用以下方法（自动获取关闭状态下，此方法依然有效）：

TalkingData.Analytics.setEnableExceptionReport(true); 

3、示例

try {
 File file = new File("filePath");
 if(!file.exists()){
 file.createNewFile();
 }
 } catch (IOException e) {
 TCAgent.onError(this, e);
}

高级-页面访问

1、用途和用法

此功能用于帮助开发者统计应用中各个页面的访问次数和停留时长，并可以追踪用户从某个页面离开后所访问的其他页面，为产品优化提供依据。

注意事项： 1）进入页面和离开页面的接口必须同时调用；

2）尽可能对所有页面都进行追踪，以免因部分页面为追踪而导致分析用户跳转路径时分析结果异常。

3）当Android应用内部分页面以Fragment方式实现，需要区分hide-show模式和replace模式：

3.1）hide-show模式

fragment：f1、f2…fn中，所有被追踪的fi都以前一页（假定为A）为来源页，则A作为来源页的次数可能会大于A的访问次数。

同时，跳出到下一页C时，会以这组fragment组中最后一个结束的fi做为C的来源页，如果fi固定，那其余的fx的跳出率为100%，此时该值仅表示跳出了页面操作的主流程，不表示用户从这里100%退出应用。

3.2）replace模式

在phone上展示时每个fi的效果都近似一个独立activity，统计效果也与activity一样。在Pad中则类似hide-show模式。

2、接口及参数

接口： step1：进入页面时调用：

TCAgent.onPageStart(Context ctx, String pageName);

Step2：离开页面时调用：

TCAgent.onPageEnd(Context ctx, String pageName);

注意事项：

1）onPageStart 和 onPageEnd 必须成对调用；

参数：

参数	类型	描述
pageName	String	页面名称。 最多包含64个字符，支持中文、英文、数字、下划线，但不能包含空格或其他的转义字符

3、示例

用户访问页面A，然后跳转到页面B继续使用应用。对A页面的统计，调用方法如下：

public class A extends Activity {
 @Override
 protected void onPause() {
 super.onPause();
 TCAgent.onPageEnd(this,"A");
 }
 @Override
 protected void onResume() {
 super.onResume(); 
 TCAgent.onPageStart(this,"A");
}
}

高级-自定义事件

1、用途和用法

自定义事件用于追踪任何需要了解的用户行为，如：用户点击某功能按钮、填写某个输入框、触发了某个广告等。

1）自定义事件ID（EventID）

在TalkingData分析平台，无需提前在报表中定义自定义事件名称，通过灵动事件配置或调用追踪代码时直接写入事件ID即可。报表中事件管理页面支持对EventID重命名。

2）自定义事件数量限制

A）系统默认计算前1000个代码事件。超过这个限制后，新追踪到的代码事件均记录在“待处理事件“中，需要手动打开计算开关，系统才会开始计算。目前不支持批量打开计算开关，且最多支持同时计算10,000个代码事件；

B）“待处理事件”位置：“应用管理”->“事件管理” ->“待处理事件”。保留在“待处理事件”中的数据不参与计算。目前最多能支持同时记录100,000个待处理事件。但是某些开发者在自定义事件名称中引入变量，而且变量取值非常离散时可能导致自定义事件的总量超过这个限制，系统将无法记录更多事件名称，导致无法找到这些事件并打开计算开关。

C）对于不需要继续统计或待处理事件中不需要开始计算的代码事件，请及时删除。删除后的事件保留在“事件回收站”，支持重新开始计算，但是保留在回收站期间的数据不参与计算。

3）自定义事件Label及其数量限制

Label可用于对所追踪的事件进行归类。给多个要追踪的同类型或类似的事件使用相同的EventID，并给他们分配不同Label，就可以达到区分追踪多个事件的目的。EventID+Label形成了一个具体事件名称。对事件做好分类，有利于管理和分析事件数据，但并非必须调用。

每个代码事件下默认计算前1000个不同Label，超出的部分会进入待处理列表，需要在待处理Label管理页面打开计算开关。最多可以支持2000个不同Label。

4）自定义事件参数及其数量限制

事件参数可用于为事件添加详尽的描述信息，如描述行为发生时场景、状态或事件触发条件等。非必须调用。

每个代码事件下最多同时支持50对参数（Android v2.2.15及以下、iOS v2.2.27及以下版本仅同时支持10对）。如果同一代码事件因不同版本等原因上传的key不相同，报表最多显示100个key。每个Key最多支持1000个不同Value。

2、接口及参数

接口： 1）仅统计自定义事件，无需设置Label及参数时，调用以下方法：

TalkingData.Analytics.beginTrackEvent("event_id");

2）使用相同EventID，对类似场景的事件进行统计，并通过Label区分具体场景时，调用以下方法：

TalkingData.Analytics. beginTrackEvent("event_id", "event_label");

3）增加Label、事件参数，对事件做更为详细的追踪时，调用以下方法：

TalkingData.Analytics. beginTrackEvent (string eventID, string label, Dictionary param); 

参数：

参数	类型	描述
event_id	String	自定义事件名称。 最多包含64个字符，支持中文、英文、数字、下划线，但不能包含空格或其他的转义字符
event_label	String	自定义事件Label。 最多包含64个字符，支持中文、英文、数字、下划线，但不能包含空格或其他的转义字符。
param	Dictionary	自定义事件的参数及参数取值。 其中的Key为String，Value仅支持字符串（String）和数字（Number）类型，其他类型会自动调用toString()方法转换为String进行处理。报表中将给出事件发生时每种value出现的频次。 在value取值较离散情况下（如示例中收集的促销价格信息），不要直接填充具体数值，而应划分区间后传入（如9.9元，可定义5～10元的价格区间，传入5～10元），否则value不同取值很可能超过平台最大数目限制，离散数据也对分析人员阅览数据造成影响。

3、示例

示例1：

追踪某电商应用中首页的5个不同推广位置的点击次数，并收集宣传品的品类、促销价格等信息。因为是5个近似场景，所以使用了Label，添加了事件参数，而且对参数取值做了分组处理（如9.9元，可定义5～10元的价格区间，传入5～10元），避免取值太离散而影响分析甚至超过分析平台所支持的数量限制。调用如下：

// 可定义eventId=点击首页推荐位；event_LABEL=具体的位置编
Dictionary dic = new Dictionary(); 
dic.add("服装","商品类别");
dic.add("5～10","price");
TalkingData.Analytics.beginTrackEvent("点击首页推荐位", "位置1", dic);

示例2： 在一款休闲游戏中记录玩家在各关卡中的失败数据，并收集玩家具体信息。调用如下：

// 可定义eventId=战斗失败 
Dictionary dic = new Dictionary(); 
dic.add("20-30", "等级");//级别区间 
dic.add("沼泽地阿卡村", "关卡名"); //关卡名称 
dic.add("主动退出", "失败原因"); //失败原因 
dic.add("10000～12000", "coin"); //携带金币数量 
TalkingData.Analytics.beginTrackEvent ("战斗失败", "", dic); 

高级-标准事件（应用内交易）

暂不支持

高级-用户质量评估

暂不支持

高级-推送营销

暂不支持

高级-易认证

暂不支持