微信小程序 访问趋势

analysis.getDailyVisitTrend

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

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

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

调用方式：

• HTTPS 调用
• 云调用

HTTPS 调用

请求地址

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

请求参数

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
begin_date	string		是	开始日期。格式为 yyyymmdd
end_date	string		是	结束日期，限定查询1天数据，允许设置的最大值为昨日。格式为 yyyymmdd

返回值

Object

返回的 JSON 数据包

属性	类型	说明
list	Array.<Object>	数据列表

list 的结构

属性	类型	说明
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	平均访问深度 (浮点型)

请求数据示例

{
  "begin_date" : "20170313",
  "end_date" : "20170313"
}

返回数据示例

{
  "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	string		是	开始日期。格式为 yyyymmdd
endDate	string		是	结束日期，限定查询1天数据，允许设置的最大值为昨日。格式为 yyyymmdd

返回值

Object

返回的 JSON 数据包

属性	类型	说明
list	Array.<Object>	数据列表

list 的结构

属性	类型	说明
refDate	string	日期，格式为 yyyymmdd
sessionCnt	number	打开次数
visitPv	number	访问次数
visitUv	number	访问人数
visitUvNew	number	新用户数
stayTimeUv	number	人均停留时长 (浮点型，单位：秒)
stayTimeSession	number	次均停留时长 (浮点型，单位：秒)
visitDepth	number	平均访问深度 (浮点型)

请求数据示例

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'
      })
    return result
  } catch (err) {
    return err
  }
}

返回数据示例

{
  "list": [
    {
      "refDate": "20170313",
      "sessionCnt": 142549,
      "visitPv": 472351,
      "visitUv": 55500,
      "visitUvNew": 5464,
      "stayTimeSession": 0,
      "visitDepth": 1.9838
    }
  ],
  "errMsg": "openapi.analysis.getDailyVisitTrend:ok"
}

---

analysis.getMonthlyVisitTrend

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

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

获取用户访问小程序数据月趋势(能查询到的最新数据为上一个自然月的数据)

调用方式：

• HTTPS 调用
• 云调用

HTTPS 调用

请求地址

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

请求参数

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
begin_date	string		是	开始日期，为自然月第一天。格式为 yyyymmdd
end_date	string		是	结束日期，为自然月最后一天，限定查询一个月的数据。格式为 yyyymmdd

返回值

Object

返回的 JSON 数据包

属性	类型	说明
list	Array.<Object>	数据列表

list 的结构

属性	类型	说明
ref_date	string	时间，格式为 yyyymm，如："201702"
session_cnt	number	打开次数（自然月内汇总）
visit_pv	number	访问次数（自然月内汇总）
visit_uv	number	访问人数（自然月内去重）
visit_uv_new	number	新用户数（自然月内去重）
stay_time_uv	number	人均停留时长 (浮点型，单位：秒)
stay_time_session	number	次均停留时长 (浮点型，单位：秒)
visit_depth	number	平均访问深度 (浮点型)

访问周期说明

限定查询一个自然月的数据，时间必须按照自然月的方式输入： 如：20170301, 20170331

请求数据示例

{
  "begin_date" : "20170301",
  "end_date" : "20170331"
}

返回数据示例

{
  "list": [
    {
      "ref_date": "201703",
      "session_cnt": 126513,
      "visit_pv": 426113,
      "visit_uv": 48659,
      "visit_uv_new": 6726,
      "stay_time_session": 56.4112,
      "visit_depth": 2.0189
    }
  ]
}

云调用

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

接口方法

openapi.analysis.getMonthlyVisitTrend

需在 config.json 中配置 analysis.getMonthlyVisitTrend API 的权限，详情

请求参数

属性	类型	默认值	必填	说明
beginDate	string		是	开始日期，为自然月第一天。格式为 yyyymmdd
endDate	string		是	结束日期，为自然月最后一天，限定查询一个月的数据。格式为 yyyymmdd

返回值

Object

返回的 JSON 数据包

属性	类型	说明
list	Array.<Object>	数据列表

list 的结构

属性	类型	说明
refDate	string	时间，格式为 yyyymm，如："201702"
sessionCnt	number	打开次数（自然月内汇总）
visitPv	number	访问次数（自然月内汇总）
visitUv	number	访问人数（自然月内去重）
visitUvNew	number	新用户数（自然月内去重）
stayTimeUv	number	人均停留时长 (浮点型，单位：秒)
stayTimeSession	number	次均停留时长 (浮点型，单位：秒)
visitDepth	number	平均访问深度 (浮点型)

请求数据示例

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.analysis.getMonthlyVisitTrend({
        beginDate: '20170301',
        endDate: '20170331'
      })
    return result
  } catch (err) {
    return err
  }
}

返回数据示例

{
  "list": [
    {
      "refDate": "201703",
      "sessionCnt": 126513,
      "visitPv": 426113,
      "visitUv": 48659,
      "visitUvNew": 6726,
      "stayTimeSession": 56.4112,
      "visitDepth": 2.0189
    }
  ],
  "errMsg": "openapi.analysis.getMonthlyVisitTrend:ok"
}

---

analysis.getWeeklyVisitTrend

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

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

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

调用方式：

• HTTPS 调用
• 云调用

HTTPS 调用

请求地址

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

请求参数

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
begin_date	string		是	开始日期，为周一日期。格式为 yyyymmdd
end_date	string		是	结束日期，为周日日期，限定查询一周数据。格式为 yyyymmdd

返回值

Object

返回的 JSON 数据包

属性	类型	说明
list	Array.<Object>	数据列表

list 的结构

属性	类型	说明
ref_date	string	时间，格式为 yyyymmdd-yyyymmdd，如："20170306-20170312"
session_cnt	number	打开次数（自然周内汇总）
visit_pv	number	访问次数（自然周内汇总）
visit_uv	number	访问人数（自然周内去重）
visit_uv_new	number	新用户数（自然周内去重）
stay_time_uv	number	人均停留时长 (浮点型，单位：秒)
stay_time_session	number	次均停留时长 (浮点型，单位：秒)
visit_depth	number	平均访问深度 (浮点型)

访问周期说明

限定查询一个自然周的数据，时间必须按照自然周的方式输入： 如：20170306(周一), 20170312(周日)

请求数据示例

{
  "begin_date" : "20170306",
  "end_date" : "20170312"
}

返回数据示例

{
  "list": [
    {
      "ref_date": "20170306-20170312",
      "session_cnt": 986780,
      "visit_pv": 3251840,
      "visit_uv": 189405,
      "visit_uv_new": 45592,
      "stay_time_session": 54.5346,
      "visit_depth": 1.9735
    }
  ]
}

云调用

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

接口方法

openapi.analysis.getWeeklyVisitTrend

需在 config.json 中配置 analysis.getWeeklyVisitTrend API 的权限，详情

请求参数

属性	类型	默认值	必填	说明
beginDate	string		是	开始日期，为周一日期。格式为 yyyymmdd
endDate	string		是	结束日期，为周日日期，限定查询一周数据。格式为 yyyymmdd

返回值

Object

返回的 JSON 数据包

属性	类型	说明
list	Array.<Object>	数据列表

list 的结构

属性	类型	说明
refDate	string	时间，格式为 yyyymmdd-yyyymmdd，如："20170306-20170312"
sessionCnt	number	打开次数（自然周内汇总）
visitPv	number	访问次数（自然周内汇总）
visitUv	number	访问人数（自然周内去重）
visitUvNew	number	新用户数（自然周内去重）
stayTimeUv	number	人均停留时长 (浮点型，单位：秒)
stayTimeSession	number	次均停留时长 (浮点型，单位：秒)
visitDepth	number	平均访问深度 (浮点型)

请求数据示例

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.analysis.getWeeklyVisitTrend({
        beginDate: '20170306',
        endDate: '20170312'
      })
    return result
  } catch (err) {
    return err
  }
}

返回数据示例

{
  "list": [
    {
      "refDate": "20170306-20170312",
      "sessionCnt": 986780,
      "visitPv": 3251840,
      "visitUv": 189405,
      "visitUvNew": 45592,
      "stayTimeSession": 54.5346,
      "visitDepth": 1.9735
    }
  ],
  "errMsg": "openapi.analysis.getWeeklyVisitTrend:ok"
}