HTTPS 调用

获取用户访问小程序月留存

调用本 API 可以获取用户访问小程序月留存。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

请求地址

POST https://api.weixin.qq.com/datacube/getweanalysisappidmonthlyretaininfo?access_token=ACCESS_TOKEN

请求参数说明

属性 类型 默认值 必填 说明
access_token string 第三方平台接口调用令牌authorizer_access_token
begin_date string 开始日期,为自然月第一天。格式为 yyyymmdd
end_date string 结束日期,为自然月最后一天,限定查询一个月数据。格式为 yyyymmdd

返回参数说明

Object

返回的 JSON 数据包

属性 类型 说明
ref_date string 时间,格式为 yyyymm,如:"201702"
visit_uv_new Object 新增用户留存
visit_uv Object 活跃用户留存

visit_uv_new 的结构

属性 类型 说明
key number 标识,0开始,表示当月,1表示1月后。key取值分别是:0,1
value number key对应日期的新增用户数/活跃用户数(key=0时)或留存用户数(k>0时)

visit_uv 的结构

属性 类型 说明
key number 标识,0开始,表示当月,1表示1月后。key取值分别是:0,1
value number key对应日期的新增用户数/活跃用户数(key=0时)或留存用户数(k>0时)

注意

请求json和返回json与天的一致,这里限定查询一个自然月的数据,时间必须按照自然月的方式输入: 如:20170201(月初), 20170228(月末)

请求数据示例

{
  "begin_date" : "20170201",
  "end_date" : "20170228"
}

返回数据示例

{
  "ref_date": "201702",
  "visit_uv_new": [
    {
      "key": 0,
      "value": 346249
    }
  ],
  "visit_uv": [
    {
      "key": 0,
      "value": 346249
    }
  ]
}

返回码说明

错误码 英文描述 中文描述
0 ok 成功
其他错误码 请查看全局错误码