stat/report

返回: 腾讯罗盘数据上报说明

目录

What's New?

2012年11月19日,修改了上报字段“actionid”的使用规则,登录等操作需要使用对应的接口上报。

1 功能说明

所有的场景都可以通过调用通用数据上报接口来上报数据,请根据实际的场景选择推荐项上报字段。
如果应用需要上报自定义的操作信息,必须通过调用本接口来上报数据。

2 接口调用说明

2.1 URL

http://tencentlog.com/stat/report.php

2.2 上报字段说明

字段名称 是否必填 类型 描述 说明
version 必填 int32 版本号 版本号。
appid 必填 uint32 应用的唯一标识 AppID在创建应用时分配。

可以通过APPID查找APP基本信息。
在调用OpenAPI的时候,AppID表明应用身份。

userip 必填 uint32 用户IP地址 用户机器的ip地址,请使用主机字节序

主机字节序:IP地址经过转化后的整数值。PHP语言可使用ip2long函数,其他语言请参考网络上相应的转化方法。

svrip 必填 uint32 CGI或者Server IP 这里的IP为当前处理用户请求的机器(cgi或者是server)IP, 请使用主机字节序,用来识别请求来源。

-hosting应用,请传内网IP;
-non-hosting应用,请传外网IP。

time 必填 uint32 操作时间 当前用户的操作时间,精确到秒,填入UNIX时间戳。
domain 必填 uint32 APP所在平台 APP所在平台,用于区分用户从哪个业务平台进入应用:

QQ空间为1;
腾讯朋友为2;
腾讯微博为3;
Q+平台为4;
手机QQ空间为8;
手机腾讯朋友为9;
QQGame为10;
3366为11;
QQGame官网为12;
漫游为15;
游戏人生为16;
游戏联盟为17;
例如:用户从腾讯朋友进入了该应用,则参数值应传2。

worldid 必填 uint32 多区多服应用的大区服务器ID 非多区多服应用,这里填1。

多区多服应用,这里填大区服务器ID。大区服务器ID即新建服务器时自动分配的域名中的serverid。
登录腾讯开放平台(open.qq.com)后进入“我的管理中心”,在“选区配置”tab下新增服务器成功后,即以自增方式自动为该服务器分配了一个域名,域名格式如下:
s$serverid$.app$appid$.qqopenapp.com
例如:
s3.app12345.qqopenapp.com
serverid即大区服务器的ID,这里s3后面的3即大区服务器ID。

actionid 必填 uint32 操作ID 操作ID,用来标识用户进行了哪种操作的ID。

规则1:ID的数字必须大于100(1~100为保留数字)。
例如:用户偷菜使用actionid=101,种菜actionid=102。
配置操作ID对应的中文名称的位置:自上报分析->管理设置->操作名称配置。
规则2:以下这些用户操作不能使用report接口上报,请使用对应接口上报,包括:
登录(login
主动注册(register
接受邀请注册(accept
邀请他人注册(invite
支付消费(consume
支付充值(recharge
退出(quit

opuid 必填 string(32) 操作用户UID 操作者的UID,例如A偷了B的菜,这里填A的UID。

UID为应用自身的帐号体系中用户的ID,需为string(32)型,以字符串格式传入。

opopenid 必填 string(32) 操作用户OpenID 操作者的OpenID,例如A偷了B的菜,这里填A的OpenID。

OpenID为与QQ号码一一对应的字符串。

optype 推荐项 uint32 操作类型 支付类操作为1;

留言发表类为2;
写操作类为3;
(写操作:修改或添加信息,并把信息保存到硬盘或内存。例如:修改用户休息即为写操作。)
读操作类为4;
(读操作:获取信息。例如:读取用户信息即为读操作。)
其它为5。

touid 推荐项 string(32) 被操作用户UID 被操作者的UID,例如B在农场里面偷了A的菜,这里填A的UID。

UID为应用自身的帐号体系中用户的ID,需为string(32)型,以字符串格式传入。

toopenid 推荐项 string(32) 被操作用户OpenID 被操作者的OpenID,例如B在农场里面偷了A的菜,这里填A的OpenID。

特别地,如果用户一次操作有多个被操作的用户,请上报多条数据。
OpenID为与QQ号码一一对应的字符串。

level 推荐项 uint32 操作用户的等级 操作用户的等级,即opuid的等级。
itemid 推荐项 string(32) 用户操作物品ID 用户操作物品ID。

例如用户A购买了物品X,这里填X的物品ID。
特别地,如果用户一次操作有多个被操作item,请上报多条数据。

itemtype 推荐项 string(32) 用户操作物品ID的分类 用户操作物品ID的分类。
itemcnt 推荐项 uint32 用户操作物品数量 用户操作物品的数量。

例如用户A购买了a个物品X,这里填a。

modifyexp 推荐项 uint32 经验值变化值 用户进行操作后,经验值的变化值。

例如偷菜后经验减少300,则填入-300。

totalexp 推荐项 uint32 经验值总量 用户进行操作后,经验值的总量。

例如用户经验1000,购买了某物品,经验值增加100,此处填入1100。

modifycoin 推荐项 uint32 虚拟金币变化值 用户进行操作后,游戏虚拟金币的变化值。

例如用户收菜后,虚拟金币增加3000,则填入3000。

totalcoin 推荐项 uint32 虚拟金币总量 用户进行操作后,虚拟金币的总量。

例如用户拥有虚拟金币100,购买了某物品,消耗虚拟金币10,此处填入90。

modifyfee 推荐项 int32 游戏币变化值 用户进行操作后,游戏币的变化值。上报单位为Q分(100Q分 = 10Q点 = 1Q币)。

游戏币为用户通过人民币或者Q点/Q 币兑换的游戏内等值货币(例如“点券/金币/元宝”等),在游戏内具有真实的价值,可用于购买游戏内商品。
例如:
(1)某用户通过Q币直购游戏内商品,消费10Q币,则记入1000。注:此类为消费记录,ActionId=5。
(2)某用户通过点券(游戏币)购买游戏内商品,消费10点券(1Q币=100点券),则记入100。注:此类为消费记录,ActionId=5。
(3)某用户通过Q币兑换点券(游戏币),消费10Q币,则记入1000。注:此类为充值记录,ActionId=15。

totalfee 推荐项 uint32 游戏币总量 用户进行操作后,游戏币的总量。

例如用户拥有游戏币100,购买了某物品,消耗游戏币10,此处填入90。

onlinetime 推荐项 uint32 在线时长 用户本次登录的在线时长。
key 推荐项 string(128) 登录key 用户登录的session key(即openkey)。
keycheckret 推荐项 int32 安全key校验结果 安全key校验结果,用于比较Key字段在前端flash和后端的值的差异。

例如进行某个农场操作之前,会进行farmkey、验证码等校验。

safebuf 推荐项 string(2000) 反外挂扩展数据 安全信息上报扩展数据,为binary类型。对于key-value类型的上报,为binary类型的16进制字符串表示。
remark 推荐项 string(2000) 备注信息 备注信息或用户留言,该字段编码时需要长度信息并将该信息编码进来。
user_num 推荐项 uint32 用户在线数量 用户在线数量。

请按照以下标准统计在线人数后上报数据:
1) 用户登录进入游戏,在线数据+1;
2) 用户关闭浏览器,退出游戏,在线数据-1;
3) 游戏服务器每5分钟保持与客户端的通信判断用户是否异常推出;
4) 游戏每5分钟上报一次在线数据。

reserve_1 uint32 预留字段1 预留字段,用作上报自定义数据使用。
reserve_2 uint32 预留字段2 预留字段,用作上报自定义数据使用。
reserve_3 uint32 预留字段3 预留字段,用作上报自定义数据使用。
reserve_4 uint32 预留字段4 预留字段,用作上报自定义数据使用。
reserve_5 string(128) 预留字段5 预留字段,用作上报自定义数据使用。
reserve_6 string(128) 预留字段6 预留字段,用作上报自定义数据使用。



1. 上表中的必填项是指该字段必须带值,如果没上报,有的会自动补齐,有的则会报错,具体以备注里的说明为准;
2. 推荐项字段,可根据实际情形选择性上报。

2.3 上报示例

请求示例如下(仅作参考,实际上报时请根据实际情况传入参数值):

http://tencentlog.com/stat/report.php?optype=4&actionid=1009&version=1&appid=22322&userip=1245633332&
svrip=1434394239&time=1278922123&domain=1&worldid=1&opuid=17809690&opopenid=17809690

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

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部