analysis.getDailyVisitTrend

本接口应在服务器端调用,详细说明参见 服务端API

本接口支持 云调用 。 需开发者工具版本 >= 1.02.1904090( 最新稳定版下载 ),wx-server-sdk >= 0.4.0

获取用户访问小程序数据日趋势

HTTPS 调用

请求地址 api_datacube

POST getweanalysisappiddailyvisittrend
Query Parameters
Request JSON Object
  • begin_date (string) – 是 开始日期。格式为 yyyymmdd

  • end_date (string) – 是 结束日期,限定查询1天数据,允许设置的最大值为昨日。格式为 yyyymmdd

Response JSON Array of Objects
  • list (Array.<Object>) – 数据列表

  • .ref_date (string) – 日期,格式为 yyyymmdd

  • .session_cnt (number) – 打开次数

  • .visit_pv (number) – 访问次数

  • .visit_uv (number) – 访问人数

  • .visit_uv_new (number) – 新用户数

  • .stay_time_uv (number) – 人均停留时长 (浮点型,单位:秒)

  • .stay_time_session (number) – 次均停留时长 (浮点型,单位:秒)

  • .visit_depth (number) – 平均访问深度 (浮点型)

请求数据示例
POST getweanalysisappiddailyvisittrend
Host: https://api.weixin.qq.com/datacube/
Accept: application/json, text/javascript
{
  "begin_date": "20170313",
  "end_date": "20170313"
}
返回数据示例
HTTP/1.1 200 OK
Vary: Accept
Content-Type: text/javascript
{
  "list": [
    {
      "ref_date": "20170313",
      "session_cnt": 142549,
      "visit_pv": 472351,
      "visit_uv": 55500,
      "visit_uv_new": 5464,
      "stay_time_session": 0,
      "visit_depth": 1.9838
    }
  ]
}

云调用

云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力,需要在云函数中通过 wx-server-sdk 使用。

openapi.analysis.getDailyVisitTrend()

需在 config.json 中配置 analysis.getDailyVisitTrend API 的权限,详情

参数
  • beginDate (date()) – 是 开始日期。格式为 yyyymmdd

  • endDate (date()) – 是 结束日期,限定查询1天数据,允许设置的最大值为昨日。格式为 yyyymmdd

返回类型

Object

返回

返回的 JSON 数据包 list Array.<Object> 数据列表 list 的结构

  • refDate (string) 日期,格式为 yyyymmdd

  • sessionCnt: 打开次数

  • visitPv: 访问次数

  • visitUv: 访问人数

  • visitUvNew: 新用户数

  • stayTimeUv: 人均停留时长 (浮点型,单位:秒)

  • stayTimeSession: 次均停留时长 (浮点型,单位:秒)

  • visitDepth: 平均访问深度 (浮点型)

请求数据示例
const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.analysis.getDailyVisitTrend({
      beginDate: '20170313',
      endDate: '20170313'
    })
    console.log(result)
    return result
  } catch (err) {
    console.log(err)
    return err
  }
}
返回数据示例
{
  "list": [
    {
      "refDate": "20170313",
      "sessionCnt": 142549,
      "visitPv": 472351,
      "visitUv": 55500,
      "visitUvNew": 5464,
      "stayTimeSession": 0,
      "visitDepth": 1.9838
    }
  ],
  "errMsg": "openapi.analysis.getDailyVisitTrend:ok"
}