codecamp

微信小程序 访问留存

analysis.getDailyRetain

本接口应在服务器端调用，详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载）
wx-server-sdk >= 0.4.0

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

调用方式：

  • HTTPS 调用
  • 云调用

HTTPS 调用

请求地址

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

请求参数

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

返回值

Object

返回的 JSON 数据包

属性 类型 说明
ref_date string 日期
visit_uv_new Object 新增用户留存
visit_uv Object 活跃用户留存

visit_uv_new 的结构

属性 类型 说明
key number 标识，0开始，表示当天，1表示1天后。依此类推，key取值分别是：0,1,2,3,4,5,6,7,14,30
value number key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）

visit_uv 的结构

属性 类型 说明
key number 标识，0开始，表示当天，1表示1天后。依此类推，key取值分别是：0,1,2,3,4,5,6,7,14,30
value number key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）

请求数据示例

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

返回数据示例

{
  "ref_date": "20170313",
  "visit_uv_new": [
    {
      "key": 0,
      "value": 5464
    }
  ],
  "visit_uv": [
    {
      "key": 0,
      "value": 55500
    }
  ]
}

云调用

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

接口方法

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

请求参数

属性 类型 默认值 必填 说明
beginDate string 是 开始日期。格式为 yyyymmdd
endDate string 是 结束日期，限定查询1天数据，允许设置的最大值为昨日。格式为 yyyymmdd

返回值

Object

返回的 JSON 数据包

属性 类型 说明
refDate string 日期
visitUvNew Object 新增用户留存
visitUv Object 活跃用户留存

visitUvNew 的结构

属性 类型 说明
key number 标识，0开始，表示当天，1表示1天后。依此类推，key取值分别是：0,1,2,3,4,5,6,7,14,30
value number key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）

visitUv 的结构

属性 类型 说明
key number 标识，0开始，表示当天，1表示1天后。依此类推，key取值分别是：0,1,2,3,4,5,6,7,14,30
value number key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）

请求数据示例

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

返回数据示例

{
  "refDate": "20170313",
  "visitUvNew": [
    {
      "key": 0,
      "value": 5464
    }
  ],
  "visitUv": [
    {
      "key": 0,
      "value": 55500
    }
  ],
  "errMsg": "openapi.analysis.getDailyRetain:ok"
}

analysis.getMonthlyRetain

本接口应在服务器端调用，详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载）
wx-server-sdk >= 0.4.0

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

调用方式：

  • HTTPS 调用
  • 云调用

HTTPS 调用

请求地址

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

请求参数

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

返回值

Object

返回的 JSON 数据包

属性 类型 说明
ref_date string 时间，如："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
    }
  ]
}

云调用

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

接口方法

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

请求参数

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

返回值

Object

返回的 JSON 数据包

属性 类型 说明
refDate string 时间，如："201702"
visitUvNew Object 新增用户留存
visitUv Object 活跃用户留存

visitUvNew 的结构

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

visitUv 的结构

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

请求数据示例

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

返回数据示例

{
  "refDate": "201702",
  "visitUvNew": [
    {
      "key": 0,
      "value": 346249
    }
  ],
  "visitUv": [
    {
      "key": 0,
      "value": 346249
    }
  ],
  "errMsg": "openapi.analysis.getMonthlyRetain:ok"
}

analysis.getWeeklyRetain

本接口应在服务器端调用，详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载）
wx-server-sdk >= 0.4.0

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

调用方式：

  • HTTPS 调用
  • 云调用

HTTPS 调用

请求地址

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

请求参数

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

返回值

Object

返回的 JSON 数据包

属性 类型 说明
ref_date string 时间，如："20170306-20170312"
visit_uv_new Object 新增用户留存
visit_uv Object 活跃用户留存

visit_uv_new 的结构

属性 类型 说明
key number 标识，0开始，表示当周，1表示1周后。依此类推，取值分别是：0,1,2,3,4
value number key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）

visit_uv 的结构

属性 类型 说明
key number 标识，0开始，表示当周，1表示1周后。依此类推，取值分别是：0,1,2,3,4
value number key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）

注意

请求json和返回json与天的一致，这里限定查询一个自然周的数据，时间必须按照自然周的方式输入： 如：20170306(周一), 20170312(周日)

请求数据示例

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

返回数据示例

{
  "ref_date": "20170306-20170312",
  "visit_uv_new": [
    {
      "key": 0,
      "value": 0
    },
    {
      "key": 1,
      "value": 16853
    }
  ],
  "visit_uv": [
    {
      "key": 0,
      "value": 0
    },
    {
      "key": 1,
      "value": 99310
    }
  ]
}

云调用

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

接口方法

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

请求参数

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

返回值

Object

返回的 JSON 数据包

属性 类型 说明
refDate string 时间，如："20170306-20170312"
visitUvNew Object 新增用户留存
visitUv Object 活跃用户留存

visitUvNew 的结构

属性 类型 说明
key number 标识，0开始，表示当周，1表示1周后。依此类推，取值分别是：0,1,2,3,4
value number key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）

visitUv 的结构

属性 类型 说明
key number 标识，0开始，表示当周，1表示1周后。依此类推，取值分别是：0,1,2,3,4
value number key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）

请求数据示例

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

返回数据示例

{
  "refDate": "20170306-20170312",
  "visitUvNew": [
    {
      "key": 0,
      "value": 0
    },
    {
      "key": 1,
      "value": 16853
    }
  ],
  "visitUv": [
    {
      "key": 0,
      "value": 0
    },
    {
      "key": 1,
      "value": 99310
    }
  ],
  "errMsg": "openapi.analysis.getWeeklyRetain:ok"
}


微信小程序 getAccessToken
微信小程序 getDailySummary
温馨提示
下载编程狮App，免费阅读超1000+编程语言教程
取消
确定
目录
微信小程序开发教程手册文档
体验微信小程序

微信小程序 指南

起步

目录结构

配置小程序

小程序框架

小程序运行时

自定义组件

插件

基础能力

硬件能力

开放能力

微信小程序 用户信息

微信小程序 消息

微信小程序 微信物流助手接口文档

微信小程序 快递接口(商家查看)

微信小程序 即时配送接口(商家查看)

微信小程序 广告

微信小程序 安全指引

微信小程序 调试

微信小程序 性能与体验

基础库

微信小程序 实时日志

微信小程序 小程序测速

微信小程序 小程序搜索

微信小程序 小程序直播

微信小程序 行业能力

微信小程序 城市服务

微信小程序 框架（MINA）

小程序配置

框架接口

微信小程序框架逻辑层(App Service)

微信小程序框架视图层(View)

性能

微信小程序 基础组件

视图容器

基础内容

微信小程序表单组件

导航

媒体组件

地图

画布

开放数据

客服会话

无标题文章

原生组件说明

无障碍访问

微信小程序 API

微信小程序API 网络

媒体

微信小程序API 地图

微信小程序API 图片

微信小程序API 视频

微信小程序API 音频

微信小程序API 背景音频

微信小程序API 实时音视频

微信小程序API 录音

微信小程序API 相机

微信小程序API 富文本

微信小程序API 音视频合成

微信小程序API 实时语音

微信小程序API 画面录制器

微信小程序API 视频解码器

文件

数据

微信小程序API 位置

微信小程序 设备

微信小程序API NFC

界面

微信小程序API 绘图

WXML节点信息

第三方平台

开放接口

微信小程序API 登录

微信小程序API 客服消息

微信小程序API 性能

数据

更新

拓展接口

多线程

调试接口

广告

路由

微信小程序 服务端

登录

用户信息

接口调用凭证

数据分析

客服消息

统一服务消息

动态消息

插件管理

附近的小程序

小程序码

内容安全

物流助手

微信小程序 小程序使用

微信小程序 运力方使用

广告

图像处理

即时配送

微信小程序 小程序使用

微信小程序 运力方使用

微信小程序 OCR

微信小程序 运维中心

微信小程序 小程序搜索

微信小程序 服务市场

微信小程序 生物认证

微信小程序 订阅消息

微信小程序 工具

微信小程序 云开发

基础

开发指引

小程序端

微信小程序云开发 数据库API

服务端

微信小程序云开发服务端API 数据库

微信小程序云开发服务端API 存储

计费相关

无标题文章

SDK文档

微信小程序云开发SDK文档 文件存储

微信小程序云开发SDK文档 微信支付

微信小程序云开发SDK文档 SDK数据库

SDK数据库 Collection

SDK数据库 Aggregate

SDK数据库 Command

SDK数据库 聚合操作符$

微信小程序云开发 SDK文档·HTTP API文档

微信小程序 扩展能力

WeUI组件库

扩展组件

框架扩展

工具库类

插件服务

服务平台

微信小程序开发文档-腾讯云支持
微信小程序 联系我们
微信小程序 Q&A

微信小程序设计规范

微信小程序源码分享
微信小游戏开发文档

关闭

 MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }