收藏
评论

微信小游戏CPS服务商-获取推广数据官方

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"}



4462浏览
最后一次编辑于  03-26
收藏

6 个评论

  • 毅阳
    毅阳
    08-16

    你好,请问 怎么拉取 分销 人员的数据。

    08-16
    赞同 2
    回复 2
    • 佞臣
      佞臣
      09-06
      解决了嘛
      09-06
      回复
    • Leo Ho
      Leo Ho
      09-17回复佞臣
      有相关问题可以加V聊聊: han1008688
      09-17
      回复
  • AAA
    AAA
    1天前

    所有流程已经跑通,有问题可加我v nj19797,也可出源码

    1天前
    赞同
    回复
  • 云代码科技
    云代码科技
    10-30

    所有问题均已解决,有问题可以VX联系,13121821002,添加时请备注cps服务商

    10-30
    赞同
    回复
  • 南京天码行空科技有限公司
    南京天码行空科技有限公司
    10-28

    做好各种方式 推广 有兴趣可以交流 -> 1.(APP) 提供二次封装接口 , 无需研究直接调用 2.(小程序 / 网站) 提供代码案例或直接全部代码 3. (协助开发)有经验程序员在线交流,减少开发时间 vx + 18752586032

    注意: 这里他给的demo 直接请求会报错


    10-28
    赞同
    回复
  • 半城烟雨半城沙
    半城烟雨半城沙
    10-18

    所有环节已经全部打通,有问题可加我v,13106557172,备注腾讯小游戏,无关人员勿扰,上班忙

    10-18
    赞同
    回复
  • 许亚威
    许亚威
    10-14

    你好,请问 怎么拉取 分销 人员的数据。

    请求参数:

    {

      "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"

    }


    10-14
    赞同
    回复
登录 后发表内容