Talkingdata:集成文档WindowsPhone

2018-09-30 17:32:10 |发布者: 安智宝

适用范围

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

 15022458745378.jpg

快速集成-配置应用权限

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

权限用途

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

或者,在 Manifest 的 Designer 中,选择这两个权限:

 15022464204331.jpg

快速集成-初始化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 必须成对调用;

参数:

参数类型描述
pageNameString页面名称。

最多包含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_idString自定义事件名称。

最多包含64个字符,支持中文、英文、数字、下划线,但不能包含空格或其他的转义字符

event_labelString自定义事件Label。

最多包含64个字符,支持中文、英文、数字、下划线,但不能包含空格或其他的转义字符。

paramDictionary自定义事件的参数及参数取值。

其中的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);

高级-标准事件(应用内交易)

暂不支持

高级-用户质量评估

暂不支持

高级-推送营销

暂不支持

高级-易认证

暂不支持


关于安智宝

    安智宝是主打效果的安卓应用推广平台。通过安智宝,用户可以通过自助方式 进行应用推广。作为效果性的推广平台,安智宝利用云技术智能的进行渠道匹 配,对渠道的高效利用,节约用户的每一分钱。用户可以精确的控制应用投放 每天的投放量、渠道质量(留存率等),做到覆盖广、活跃度高、控制精准。

联系客服

Copyright © 2016 - 2020 anzhibao.com . All Right Reserved.

安智宝  版权所有