tencentMTA

来自于:开发者立即使用

init onEvent onPageStart onPageEnd

概述

tencentMTA 封装了腾讯统计平台的SDK,使用此模块可实现APP统计的功能。 在使用前需要在腾讯统计平台进行注册账号http://mta.qq.com

config.xml参数配置

使用模块前可以配置相关key和channel参数,如不愿配置的,也可在初始化时传入参数进行配置。

  1. <feature name="tencentMTA">
  2. <param name="android_appkey" value="*********"/>
  3. <param name="android_channel" value="apicloud"/>
  4. <param name="ios_appkey" value="*********"/>
  5. <param name="ios_channel" value="appstore"/>
  6. </feature>

参数注明:

1、android_appkey:你申请的android平台应用的app key

2、android_chanel:你自定义的android渠道号

3、ios_appkey:你申请的ios平台应用的app key

4、ios_chanel:你自定义的ios渠道号

APPKEY申请步骤

image

用 QQ号登陆平台,申请新应用:

image

新建应用,记录相应的key

image

image

自定义事件

需要有事件统计的,请先进行事件定义:

image

页面统计

页面统计只要统计页面ID及时长,后台可预先定义页面id及页面名称,也可不定义,而通过pagename参数传入页面ID。

注意点:onPageStart与onPageEnd必须成对使用,pagename在一个页面中也必须一致,如不使用onPageStart,则后台不会自动统计页面

统计后台对页面统计的数据反映在12个小时左右,所以触发方法后隔天才能看到数据。

image

init

模块初始化.

init({params}, callback(ret, err));

params

appid:

  • 类型:字符串
  • 描述:(可选项)开发者在腾讯统计平台申请的APPKEY,若不传则读取config.xml里的参数

path:

  • 类型:字符串
  • 描述:(可选项)开发者自定义的通道号,若不传则读取config.xml里的参数

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: //布尔类型;是否成功
  3. msg: //JSON对象;初始化成功后得到消息
  4. }

示例代码

  1. var mta = api.require('tencentMTA');
  2. mta.init({
  3. appid: '申请的key',
  4. path: '自定义通道'
  5. }, function(ret) {
  6. if (ret.status) {
  7. alert(JSON.stringify(ret));
  8. }
  9. });

补充说明

开发者如在config.xml中配置了appkey和channel的,可不填写参数,直接init

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

onEvent

统计自定义事件的一次触发,使用前需要到统计后台定义时间id及详细参数。

onEvent(params,callback(ret, err));

params

eventid:

  • 类型:字符串
  • 描述:平台上自定义事件对应的事件ID

labelkey:

  • 类型:字符串
  • 描述:事件参数配置中的参数

labelvalue:

  • 类型:字符串
  • 描述:事件参数配置中的参数名称

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:ture //布尔类型;操作成功状态值
  3. }

示例代码

  1. var mta = api.require('tencentMTA');
  2. mta.onEvent({
  3. eventid: '1',
  4. labelkey: 'subit',
  5. labelvalue: '提交'
  6. }, function(ret) {
  7. if (ret.status) {
  8. alert(JSON.stringify(ret));
  9. }
  10. });

补充说明

事件ID(eventid)

image

事件参数(labelkey)和参数名称(labelvalue)

image

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

onPageStart

自定义页面统计触发开始,本方法与下面的onPageEnd方法成对使用,其中的pagename参数必须一致,否则无法统计页面使用时间。

onPageStart({params}, callback(ret, err));

params

pagename:

  • 类型: 字符串
  • 描述:自定义的页面名称,不需要预先在平台中定义,当然如果定义了也没问题

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: //布尔类型;是否获取用户信息成功
  3. msg: //JSON对象;页面统计开始
  4. }

示例代码

  1. var mta = api.require('tencentMTA');
  2. mta.onPageStart({
  3. pagename: '开始页面'
  4. }, function(ret) {
  5. if (ret.status) {
  6. alert(JSON.stringify(ret));
  7. }
  8. });

补充说明

页面统计为非实时性统计,一般在app调用方法后12小时内,统计后台反应统计数据,所以在短时间内页面统计数据无变化是正常现象。

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

onPageEnd

自定义页面统计结束,与onPageStart方法配对使用,其中pagename参数必须一致。

onPageEnd({params}, callback(ret, err));

params

pagename:

  • 类型: 字符串
  • 描述:自定义的页面名称,不需要预先在平台中定义,当然如果定义了也没问题

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: //布尔类型;是否获取用户信息成功
  3. msg: //JSON对象;页面统计开始
  4. }

示例代码

  1. var mta = api.require('tencentMTA');
  2. mta.onPageEnd({
  3. pagename: '开始页面'
  4. }, function(ret) {
  5. if (ret.status) {
  6. alert(JSON.stringify(ret));
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本