stat/report_consume

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

目录

1 功能说明

上报用户在应用中进行支付消费的相关信息。
支付消费:
用户通过Q点/Q币直接购买游戏内商品的行为;
或用户通过游戏内的等值货币(例如“点券/金币/元宝”等)来购买游戏内商品的行为。

2 接口调用说明

2.1 URL

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

2.2 上报字段说明

字段名称 是否必填 类型 描述
version int32 版本号。

若未上报,则自动补齐为:1。

appid 必填 uint32 应用的唯一标识。AppID在创建应用时分配。

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

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

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

svrip 必填 uint32 CGI或者Server IP。

这里的IP为当前处理用户请求的机器(cgi或者是server)IP, 请使用主机字节序,用来识别请求来源。
-hosting应用,请传内网IP;
-non-hosting应用,请传外网IP。

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

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

worldid 必填 uint32 非多区多服应用,这里填1。

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

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

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

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

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

modifyfee 必填 int32 游戏币变化值。

用户进行操作后,游戏币的变化值。如果没有变化,则填0。上报单位为Q分(100Q分 = 10Q点 = 1Q币)。
游戏币为用户通过人民币或者Q点/Q 币兑换的游戏内等值货币(例如“点券/金币/元宝”等),在游戏内具有真实的价值,可用于购买游戏内商品。
例如:
(1)某用户通过Q币直购游戏内商品,消费10Q币,则记入1000。
(2)某用户通过点券(游戏币)购买游戏内商品,消费10点券(1Q币=100点券),则记入100。
(3)某用户通过Q币兑换点券(游戏币),消费10Q币,则记入1000。

touid 推荐项 string(32) 在赠送支付时对方的UID,例如A给B用户购买某个道具,则填写B用户的UID。

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

toopenid 推荐项 string(32) 在赠送支付时对方的OpenID,例如A给B用户购买某个道具,则填写B用户的OpenID。

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

itemid 推荐项 string(32) 用户操作物品ID。

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

itemtype 推荐项 string(32) 用户操作物品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。

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

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

level 推荐项 uint32 操作用户的等级,即opuid的等级。


1. 上表中的必填项是指该字段必须带值,如果没上报,有的会自动补齐,有的则会报错,具体以备注里的说明为准;
2. 推荐项是指字段的值最好上报,会有其他用途。

2.3 上报示例

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

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

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部