CPS服务商API-获取推广数据
向服务商开放分析数据接口 。 通过分析数据接口,服务商可以获取服务商相关的数据,服务商按需做进一步处理。
请注意:
1.接口限制:当时间粒度为自然日/自然周/自然月,仅允许查询单个粒度时长;当时间粒度为1分钟/5分钟/1小时,仅允许查询最大时长为24小时的时间范围;接口访问频率限制为50次/min;
2.因计算资源限制,自然日/自然周/自然月粒度的数据结果计算时间不固定,建议开发者间隔6小时采集1次;
3.建议开发者在调用接口获取数据后,将数据保存在自身数据库中,以最大化访问的效率,也降低微信侧接口调用的不必要损耗;
4.部分维度取值范围是动态的,维度定义板块不会给出固定的枚举值列表,需要通过接口获取实际数据;
5.部分指标的计算会进行时间偏移,如次日留存/七日留存,需要根据指标定义对查询时间做相应的偏移;
概念说明
数据包含若干列,按列属性可划分为时间、维度、指标。
1.时间:不同数据可能支持多种粒度,指标按粒度进行聚合计算得到;
2.维度:事物的属性特征,多个属性间有层次/组合关系,例如省份/城市、平台×性别;
3.指标:事物的度量,按维度聚合统计得到,例如DAU、ARPPU等;
查询示例
假设有DAU数据如下,包含平台×性别的维度:
1.要查询2020-10-02,不区分具体平台的男性用户数(即红框数据),请求参数如下:
{
"metric": "1000006:4", // 指标id
"granularity": 24, // 自然天的枚举值
"start_time": 1601568000, // 数据起始时间,北京时间2020-10-02 00:00:00的时间戳
"end_time": 1601654400, // 数据结束时间,北京时间2020-10-03 00:00:00的时间戳
"filter_list": [
{
"dimension": "3", // 性别维度id
"value": "1" // 性别维度男性的枚举值
}
// 不区分平台,可不设置平台维度的filter
]
}
CURL命令示例:
curl -d '{
"metric": "1000006:4", // 指标id
"granularity": 24, // 自然天的枚举值
"start_time": 1601568000, // 数据起始时间,北京时间2020-10-02 00:00:00的时间戳
"end_time": 1601654400, // 数据结束时间,北京时间2020-10-03 00:00:00的时间戳
"filter_list": [
{
"dimension": "3", // 性别维度id
"value": "1" // 性别维度男性的枚举值
}
// 不区分平台,可不设置平台维度的filter
]}' \
-H "Content-Type: application/json" \
-X POST \
'https://api.weixin.qq.com/wxa/servicemarket/game/getservicefirmstatapi?access_token=${access_token}'
查询结果:
{
"errcode":0,
"errmsg":"ok",
"data":
{
"data_list": [
{
"timestamp": 1601568000, // 数据时间,北京时间2020-10-02 00:00:00的时间戳
"time_label": "2020-10-02",
"metric_value": 51
}
]
}
}
2.要查询2020-10-02,指定iPhone平台下的性别用户数分布(即蓝框数据),请求参数如下:
{
"metric": "1000006:4", // 指标id
"granularity": 24, // 自然天的枚举值
"start_time": 1601568000, // 数据起始时间,北京时间2020-10-02 00:00:00的时间戳
"end_time": 1601654400, // 数据结束时间,北京时间2020-10-03 00:00:00的时间戳
"filter_list": [
{
"dimension": "5", // 平台维度id
"value": "1" // 平台维度iPhone的枚举值
}
],
"group_list": [
"3" // 按性别维度分组
]
}
CURL命令示例:
curl -d '{
"metric": "1000006:4",
"granularity": 24,
"start_time": 1601568000,
"end_time": 1601654400,
"filter_list": [{
"dimension": "5",
"value": "1"
}],
"group_list": ["3"]
}' \
-H "Content-Type: application/json" \
-X POST \
'https://api.weixin.qq.com/wxa/servicemarket/game/getservicefirmstatapi?access_token=${access_token}'
查询结果:
{
"errcode":0,
"errmsg":"ok",
"data":
{
"data_list": [
{
"timestamp": 1601568000, // 数据时间,北京时间2020-10-02 00:00:00的时间戳
"time_label": "2020-10-02",
"group_dimension_list": [
{
"value": "-9999",
"label": "全部" // 汇总值
}
],
"metric_value": 52
},
{
"timestamp": 1601568000, // 数据时间,北京时间2020-10-02 00:00:00的时间戳
"time_label": "2020-10-02",
"group_dimension_list": [
{
"value": "1",
"label": "iPhone"
}
],
"metric_value": 25
},
{
"timestamp": 1601568000, // 数据时间,北京时间2020-10-02 00:00:00的时间戳
"time_label": "2020-10-02",
"group_dimension_list": [
{
"value": "2",
"label": "Android"
}
],
"metric_value": 27
}
]
}
}
备注:推荐使用方式2,group_list字段填当前查询指标的所有可用维度,一次性拉取所有维度结果
指标定义
更多数据指标建设中,敬请期待
服务商CPS分成前广告注册数据
服务商CPS分成前广告回流数据
服务商CPS分成前内购注册数据
服务商CPS分成前内购回流数据
维度定义
平台
微信公众平台帐号
动态取值范围,无固定枚举值列表
微信公众平台账号,即游戏的appid
服务端API
获取服务商相关的数据
本接口应在服务器端调用,服务商可以调用该接口获取服务商相关的数据。
HTTPS调用
请求地址
POST
https://api.weixin.qq.com/wxa/servicemarket/game/getservicefirmstatapi?access_token=ACCESS_TOKEN
请求参数
● Query参数
● POST Body
POST的JSON数据包 Object(请求参数)
granularity的合法值
filter_list的结构
返回值
返回的JSON数据包的结构
data_list的结构
group_dimension_list的结构
errcode的合法值
示例
curl请求
curl -d '{
"metric": "1000006:4", // 指标id
"granularity": 24, // 自然天的枚举值
"start_time": 1601568000, // 数据起始时间,北京时间2020-10-02 00:00:00的时间戳
"end_time": 1601654400, // 数据结束时间,北京时间2020-10-03 00:00:00的时间戳
"filter_list": [
{
"dimension": "3", // 性别维度id
"value": "1" // 性别维度男性的枚举值
}
// 不区分平台,可不设置平台维度的filter
]}' \
-H "Content-Type: application/json" \
-X POST \
'https://api.weixin.qq.com/wxa/servicemarket/game/getservicefirmstatapi?access_token=62_so84Zyl5MuPCjXGiR3eb1ysa1lr6aRpcprEnNpZ9ds8676ivjqRn5Zroi2Rxxx9-Yvh2zIl9oEt1hIzK0x2OrMCT5zk8nB_TG98obD_ad3tFPftfFmB7xXtcZv4PVPcbFATZT'
成功返回
{
"errcode":0,
"errmsg":"ok",
"data":
{
"data_list": [
{
"timestamp": 1601568000, // 数据时间,北京时间2020-10-02 00:00:00的时间戳
"time_label": "2020-10-02",
"metric_value": 51
}
]
}
}
失败返回
{"errcode":-10094012,"errmsg":"system error"}
你好,请问 怎么拉取 分销 人员的数据。
所有流程已经跑通,有问题可加我v nj19797,也可出源码
所有问题均已解决,有问题可以VX联系,13121821002,添加时请备注cps服务商
做好各种方式 推广 有兴趣可以交流 -> 1.(APP) 提供二次封装接口 , 无需研究直接调用 2.(小程序 / 网站) 提供代码案例或直接全部代码 3. (协助开发)有经验程序员在线交流,减少开发时间 vx + 18752586032
注意: 这里他给的demo 直接请求会报错
所有环节已经全部打通,有问题可加我v,13106557172,备注腾讯小游戏,无关人员勿扰,上班忙
你好,请问 怎么拉取 分销 人员的数据。
请求参数:
{
"metric": "1000342:4", // 指标id
"granularity": 24, // 自然天的枚举值
"start_time": 1728489600, // 数据起始时间,北京时间2020-10-02 00:00:00的时间戳
"end_time": 1728835200 // 数据结束时间,北京时间2020-10-03 00:00:00的时间戳
}
接口返回错误:
{
"errcode": -10000502,
"errmsg": "system busy traceid: 33563242 rid: 670cc9c4-6a2ab85c-5eebe214"
}