微信小程序 getUserPortrait

analysis.getUserPortrait

本接口應在服務器端調(diào)用，詳細說明參見服務端API。

本接口支持云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090（最新穩(wěn)定版下載）
wx-server-sdk >= 0.4.0

獲取小程序新增或活躍用戶的畫像分布數(shù)據(jù)。時間范圍支持昨天、最近7天、最近30天。其中，新增用戶數(shù)為時間范圍內(nèi)首次訪問小程序的去重用戶數(shù)，活躍用戶數(shù)為時間范圍內(nèi)訪問過小程序的去重用戶數(shù)。

調(diào)用方式：

• HTTPS 調(diào)用
• 云調(diào)用

HTTPS 調(diào)用

請求地址

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

請求參數(shù)

返回值

Object

返回的 JSON 數(shù)據(jù)包

visit_uv_new 的結(jié)構(gòu)

province 的結(jié)構(gòu)

city 的結(jié)構(gòu)

genders 的結(jié)構(gòu)

platforms 的結(jié)構(gòu)

devices 的結(jié)構(gòu)

ages 的結(jié)構(gòu)

visit_uv 的結(jié)構(gòu)

province 的結(jié)構(gòu)

city 的結(jié)構(gòu)

genders 的結(jié)構(gòu)

platforms 的結(jié)構(gòu)

devices 的結(jié)構(gòu)

ages 的結(jié)構(gòu)

請求數(shù)據(jù)示例

{
  "begin_date" : "20170611",
  "end_date" : "20170617"
}

返回數(shù)據(jù)示例

{
  "ref_date": "20170611",
  "visit_uv_new": {
    "province": [
      {
        "id": 31,
        "name": "廣東省",
        "value": 215
      }
    ],
    "city": [
     {
        "id": 3102,
        "name": "廣州",
        "value": 78
      }
    ],
    "genders": [
      {
        "id": 1,
        "name": "男",
        "value": 2146
      }
    ],
    "platforms": [
      {
        "id": 1,
        "name": "iPhone",
        "value": 27642
      }
    ],
    "devices": [
      {
        "name": "OPPO R9",
        "value": 61
      }
    ],
    "ages": [
      {
        "id": 1,
        "name": "17歲以下",
        "value": 151
      }
    ]
  },
  "visit_uv": {
    "province": [
      {
        "id": 31,
        "name": "廣東省",
        "value": 1341
      }
    ],
    "city": [
     {
        "id": 3102,
        "name": "廣州",
        "value": 234
      }
    ],
    "genders": [
      {
        "id": 1,
        "name": "男",
        "value": 14534
      }
    ],
    "platforms": [
      {
        "id": 1,
        "name": "iPhone",
        "value": 21750
      }
    ],
    "devices": [
      {
        "name": "OPPO R9",
        "value": 617
      }
    ],
    "ages": [
      {
        "id": 1,
        "name": "17歲以下",
        "value": 3156
      }
    ]
  }
}

云調(diào)用

云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力，需要在云函數(shù)中通過 wx-server-sdk 使用。

接口方法

openapi.analysis.getUserPortrait

需在 config.json 中配置 analysis.getUserPortrait API 的權(quán)限，詳情

請求參數(shù)

返回值

Object

返回的 JSON 數(shù)據(jù)包

visitUvNew 的結(jié)構(gòu)

province 的結(jié)構(gòu)

city 的結(jié)構(gòu)

genders 的結(jié)構(gòu)

platforms 的結(jié)構(gòu)

devices 的結(jié)構(gòu)

ages 的結(jié)構(gòu)

visitUv 的結(jié)構(gòu)

province 的結(jié)構(gòu)

city 的結(jié)構(gòu)

genders 的結(jié)構(gòu)

platforms 的結(jié)構(gòu)

devices 的結(jié)構(gòu)

ages 的結(jié)構(gòu)

請求數(shù)據(jù)示例

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

返回數(shù)據(jù)示例

{
  "refDate": "20170611",
  "visitUvNew": {
    "province": [
      {
        "id": 31,
        "name": "廣東省",
        "value": 215
      }
    ],
    "city": [
      {
        "id": 3102,
        "name": "廣州",
        "value": 78
      }
    ],
    "genders": [
      {
        "id": 1,
        "name": "男",
        "value": 2146
      }
    ],
    "platforms": [
      {
        "id": 1,
        "name": "iPhone",
        "value": 27642
      }
    ],
    "devices": [
      {
        "name": "OPPO R9",
        "value": 61
      }
    ],
    "ages": [
      {
        "id": 1,
        "name": "17歲以下",
        "value": 151
      }
    ]
  },
  "visitUv": {
    "province": [
      {
        "id": 31,
        "name": "廣東省",
        "value": 1341
      }
    ],
    "city": [
      {
        "id": 3102,
        "name": "廣州",
        "value": 234
      }
    ],
    "genders": [
      {
        "id": 1,
        "name": "男",
        "value": 14534
      }
    ],
    "platforms": [
      {
        "id": 1,
        "name": "iPhone",
        "value": 21750
      }
    ],
    "devices": [
      {
        "name": "OPPO R9",
        "value": 617
      }
    ],
    "ages": [
      {
        "id": 1,
        "name": "17歲以下",
        "value": 3156
      }
    ]
  },
  "errMsg": "openapi.analysis.getUserPortrait:ok"
}