talkingData

来自于:北京腾云天下科技有限公司立即使用

getDeviceID onPageStart onPageEnd onEvent setGlobalKV removeGlobalKV setLocation

概述

  talkingData封装了TalkingData App Analytics数据统计平台的SDK,使用此模块可轻松实现移动App的数据统计功能。

使用此模块之前需先配置config文件的Feature,方法如下:

  1. 名称:talkingData
  2. 参数:logEnableexceptionReportEnabledchannel
  3. 描述:设置talkingDatalog开关,是否收集异常信息的开关,和发包的渠道。

配置示例:

  1. <feature name="TalkingData">
  2. <param name="logEnable" value="false" />
  3. <param name="exceptionReportEnabled" value="true" />
  4. <param name="channel" value="AppStore" />
  5. </feature>

字段描述:

  1. 1. logEnable:配置是否显示log,默认值“false”。
  2. 2. exceptionReportEnabled:配置是否捕获异常,默认值“true”。
  3. 3. channel:配置渠道标识符,无默认值。

getDeviceID

获取TalkingData维护的设备ID

getDeviceID(callback(ret, err))

callback(ret, err)
ret:

  • 类型:字符串

err:

  • 类型:JSON 对象
  • 内部字段:

    1. {
    2. msg:"" //错误描述,字符串
    3. }

示例代码

  1. var td = api.require('talkingData');
  2. td.getDeviceID(function(ret, err) {
  3. if (ret) {
  4. api.alert({ msg: ret });
  5. }
  6. });

补充说明

可用性

iOS系统,Android系统

可提供的1.2.0及更高版本

onPageStart

进入一个页面

onPageStart({params})
params
pageName:

  • 类型:字符串
  • 默认值:无
  • 描述:页面的名称,不能为空

示例代码:

  1. var td = api.require('talkingData');
  2. td.onPageStart({pageName:'首页'});

补充说明

调用此接口后,确保在同一页面调用onPageEnd方法。    可用性

iOS系统,Android系统
可提供的1.2.0及更高版本

onPageEnd

离开一个页面

onPageEnd({params})

params

pageName:

  • 类型:字符串
  • 默认值:无
  • 描述:页面的名称,不能为空

示例代码

  1. var td = api.require('talkingData');
  2. td.onPageEnd({pageName:'首页'});

补充说明

调用此接口前,确保已调用过onPageStart方法。

可用性

iOS系统,Android系统
可提供的1.2.0及更高版本

onEvent

自定义事件

onEvent({params})

params

eventId:

  • 类型:字符串
  • 默认值:无
  • 描述:自定义事件的ID,不能为空

eventLabel:

  • 类型:字符串
  • 默认值:无
  • 描述:自定义事件的标签,可以为空

parameters:

  • 类型:JOSN对象
  • 默认值:无
  • 描述:自定义事件的参数,可以为空

示例代码

  1. var td = api.require('talkingData');
  2. td.onEvent({
  3. eventId: '首页推荐位点击',
  4. eventLabel: '第一广告位',
  5. parameters: {
  6. category: '服装',
  7. price: 10
  8. }
  9. });

补充说明

eventId无需提前在数据平台中定义,可自行定义名称,直接加入到应用中需要跟踪的位置即可生效。
格式:32个字符以内的中文、英文、数字、下划线,注意eventId中不要加空格或其他的转义字符。
TalkingData最多支持10000个不同的Event ID。

可用性

iOS系统,Android系统
可提供的1.2.0及更高版本

setGlobalKV

设置全局Key-Value

setGlobalKV({params})

params

key:

  • 类型:字符串
  • 默认值:无
  • 描述:全局参数的key,不能为空

value:

  • 类型:字符串或Number
  • 默认值:无
  • 描述:全局参数的value,不能为空

示例代码

  1. var td = api.require('talkingData');
  2. td.setGlobalKV({
  3. key: 'brand',
  4. value: 'vl'
  5. });

补充说明

如果所有事件都需要传输相同的参数,可以设置全局的Key-Value,这些Key-Value会自动添加到所有自定义事件。
如果onEvent里传入的Key-Value里的key和全局Key-Value里的key冲突,以onEvent里传入的为准。

可用性

iOS系统,Android系统
可提供的1.2.0及更高版本

removeGlobalKV

移除全局Key-Value

removeGlobalKV({params})

params

key:

  • 类型:字符串
  • 默认值:无
  • 描述:全局参数的key,不能为空

示例代码

  1. var td = api.require('talkingData');
  2. td.removeGlobalKV({
  3. key: 'brand'
  4. });

补充说明

可用性

iOS系统,Android系统
可提供的1.2.0及更高版本

setLocation

设置用户位置信息

setLocation({params}}

params

latitude:

  • 类型:float
  • 默认值:0
  • 描述:纬度

longitude:

  • 类型:float
  • 默认值:0
  • 描述:经度

示例代码

  1. var td = api.require('talkingData');
  2. td.setLocation({
  3. latitude: 39.94,
  4. longitude: 116.43
  5. });

补充说明

talkingData默认使用设备中收取的MCC(移动国家码)和用户联网IP来判定用户的地区,与地区相关的数据会有一定误差。
如果您的应用会使用用户的位置信息,可通过接口将信息提交至TalkingData数据中,可使您获得更加精准的数据报表。

可用性

iOS系统
可提供的1.2.0及更高版本