腾讯罗盘数据上报说明

如果需要使用腾讯罗盘提供的高级分析模型(高级分析模型详见这里),则需要调用数据上报接口上报数据。
建议在应用上线前及完成腾讯罗盘的数据上报开发和联调,以便在应用上线后立即可以看到应用的业务数据。

目录

1. 接口说明

应用通过HTTP协议发送请求到罗盘数据上报接口,即可上报数据。
注:
数据上报时,不能使用长连接。

1.1 URL

请求URL的格式为:http://tencentlog.com/stat/[接口名称]

由于每种场景下必须上报的字段不同,为了使开发者更加快捷方便的调用接口,对7种细分场景提供了单独的接口。
此外,提供了通用接口,如果细分场景不能满足需求,则可以调用通用接口进行数据上报。

接口列表如下:

数据上报场景 接口 说明
登录 login 上报用户登录应用时的相关信息。
主动注册 register 上报用户主动注册应用时的相关信息。
接受邀请注册 accept 上报用户通过其他好友邀请去注册应用时的相关信息。
邀请他人注册 invite 上报用户邀请他人注册应用时的相关信息。
支付消费 consume 上报用户在应用中进行支付消费的相关信息。
支付充值 recharge 上报用户在应用中进行支付充值的相关信息。
退出 quit 上报用户退出应用时的相关信息。
通用 report 所有的场景都可以通过调用本接口来上报数据(包括上述场景),但需要根据实际的场景在基本必填字段基础上增加其他的上报字段。

如果应用需要上报自定义的操作信息,必须通过调用本接口来上报数据。

1.2 格式

json

1.3 HTTP请求方式

GET,POST

1.4 输入参数说明

输入参数即需要上报的字段。

不同场景下的上报字段不同,详情请参见上面1.1表格中各接口文档的说明。

1.5 请求示例

以登录场景(接口说明详见stat/report_login)为例,请求示例如下(仅作参考,实际上报时请根据实际情况传入参数值):

http://tencentlog.com/stat/report_login.php?version=1&appid=22322&userip=1245633332&
svrip=1434394239&time=1278922123&domain=1&worldid=1&opuid=123456789&
opopenid=00000000000000000000000000000001&level=3

1.6 返回参数说明

参数名称 描述
ret 返回码。

0表示成功;
1表示“必填”字段上报有误,请核对是否按照规定上报;
2表示系统内部错误,请通过企业QQ联系运维支持,进行问题定位。

msg 描述错误信息。

1.7 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret":0,
"msg":"成功"
}

1.8 错误返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret":1,
"msg":"必填项字段上报有误,请核对是否按照规定上报!"
}

2. 调试数据

腾讯罗盘提供数据上报调试工具,调试工具的入口位于数据展示页面左侧导航栏下方,如下图:
compass_01.png

通过调试工具,您可以实时地通过特定的测试用户UID(UID为应用自身的帐号体系中用户的ID),特定的商务平台,选择一个时间段,查询到你上报的该测试用户UID在这个时间段的行为流水,从而核对您的上报代码是否部署正确。
调试页面如下图:
compass_2.png

上报的数据一般30分钟后可以查询,如果查不到,请通过企业QQ联系支持人员,调查问题原因并获得解决方案。

以上信息是否解决您的问题?

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部