# analysis.getWeeklyRetain

Call this API at the server side. For more information, see Server API.

This API supports Cloud Calls. The WeChat DevTools version must be 1.02.1904090 or later (download the latest stable version here), and the wx-server-sdk version must be 0.4.0 or later.

Obtains the weekly retention of user visits to a Mini Program.

Calling methods:

• HTTPS call
• Cloud call

# HTTPS Call

# Request Address

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

# Request Parameters

# Return Value

# Object

JSON data package that is returned

visit_uv_new is composed as follows

visit_uv is composed as follows

# Notes

The format of the request JSON data packet and the returned JSON data packet must be yyyymmdd. Only the data of one natural week can be queried, and the time must be entered according to the natural week, for example, 20170306 (Monday) and 20170312 (Sunday).

# Request Data Example

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

# Return Data Example

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

# Cloud Call

Cloud call is a capability provided by Mini Program·Cloud Base that allows you to call WeChat APIs in a cloud function. It must be used via wx-server-sdk in the cloud function.

# API Calling Method

openapi.analysis.getWeeklyRetain

You need to configure the permissions for the analysis.getWeeklyRetain API via config.json. Details

# Request Parameters

# Return Value

# Object

JSON data package that is returned

visitUvNew is composed as follows

visitUv is composed as follows

# Request Data Example

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

# Return Data Example

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