小程序文档整理之 -- API（数据分析）

论坛 › 期权论坛 › 脚本     
匿名网站用户   2020-12-20 17:46   84   0

开发者通过数据分析接口，可获取到小程序的各项数据指标，便于进行数据存储和整理。数据分析详细功能介绍及指标解释参见数据分析文档。

常规分析

概况

用户访问小程序的详细数据可从访问分析中获取，概况中提供累计用户数等部分指标数据。

概况趋势

接口地址

https://api.weixin.qq.com/datacube/getweanalysisappiddailysummarytrend?access_token=ACCESS_TOKEN
获取 access_token 详见文档

POST 请求参数说明：

参数 是否必填 说明
begin_date 是 开始日期
end_date 是 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日 
{
  "begin_date" : "20170313",
  "end_date" : "20170313"
}

返回参数说明：

参数 说明
visit_total 累计用户数
share_pv 转发次数
share_uv 转发人数 
返回数据示例：
{
  "list": [
    {
      "ref_date": "20170313",
      "visit_total": 391,
      "share_pv": 572,
      "share_uv": 383
    }
  ]
}

访问分析

访问趋势

日趋势

接口地址
https://api.weixin.qq.com/datacube/getweanalysisappiddailyvisittrend?access_token=ACCESS_TOKEN
POST 请求参数说明：

参数 是否必填 说明
begin_date 是 开始日期
end_date 是 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日 
{
  "begin_date" : "20170313",
  "end_date" : "20170313"
}

返回参数说明：

参数 说明
ref_date 时间： 如： “20170313”
session_cnt 打开次数
visit_pv 访问次数
visit_uv 访问人数
visit_uv_new 新用户数
stay_time_uv 人均停留时长 (浮点型，单位：秒)
stay_time_session 次均停留时长 (浮点型，单位：秒)
visit_depth 平均访问深度 (浮点型)

周趋势

接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidweeklyvisittrend?access_token=ACCESS_TOKEN

POST 请求参数说明：

参数 是否必填 说明
begin_date 是 开始日期，为周一日期
end_date 是 结束日期，为周日日期，限定查询一周数据

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

返回参数说明：

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

月趋势

接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidmonthlyvisittrend?access_token=ACCESS_TOKEN

参数 是否必填 说明
begin_date 是 开始日期，为自然月第一天
end_date 是 结束日期，为自然月最后一天，限定查询一个月数据

注意：请求json和返回json与天的一致，这里限定查询一个自然月的数据，时间必须按照自然月的方式输入： 如：20170201(月初), 20170228(月末)

返回参数说明：

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

访问分布

接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidvisitdistribution?access_token=ACCESS_TOKEN

POST 请求参数说明：

参数 是否必填 说明
begin_date 是 开始日期
end_date 是 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日

返回参数说明：

参数 说明
ref_date 时间，如：”20170313”
list 存入所有类型的指标情况 
返回数据示例：
{
  "ref_date": "20170313", //时间
  "list": [//存入所有类型的指标情况
    {
    //分布类型
      "index": "access_source_session_cnt"//访问来源分布
      "item_list": [//分布数据列表
        {
          "key": 1, //小程序历史列表
          "value": 5
        },
        1：小程序历史列表
        2：搜索
        3：会话
        4：二维码
        5：公众号主页
        6：聊天顶部
        7：系统桌面
        8：小程序主页
        9：附近的小程序
        10：其他
        11：模板消息
        12：客服消息
        13: 公众号菜单
        14: APP分享
        15: 支付完成页
        16: 长按识别二维码
        17:相册选取二维码
        18: 公众号文章
      ]
    },
    {
      "index": "access_staytime_info",//访问时长分布
      "item_list": [
        {
         "key": 1,//访问时长 0-2s
          "value": 4511
        },
        1: 0-2s
        2: 3-5s
        3: 6-10s
        4: 11-20s
        5: 20-30s
        6: 30-50s
        7: 50-100s
        8: > 100s
      ]
    },
    {
      "index": "access_depth_info",//访问深度的分布
      "item_list": [
        {
          "key": 1,//平均访问深度 1页
          "value": 43201
        },
        1: 1页
        2: 2页
        3: 3页
        4: 4页
        5: 5页
        6: 6-10页
        7: >10页
      ]
    }
  ]
}

访问留存

日留存

接口地址
https://api.weixin.qq.com/datacube/getweanalysisappiddailyretaininfo?access_token=ACCESS_TOKEN

POST 请求参数说明：

参数 是否必填 说明
begin_date 是 开始日期
end_date 是 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日

返回参数说明：

参数 说明
visit_uv_new 新增用户留存
visit_uv 活跃用户留存 
返回数据示例：

{
  "ref_date": "20170313",
  "visit_uv_new": [
    {
      "key": 0,//标识，0开始，0表示当天，1表示1天后，依此类推，key取值分别是：0,1,2,3,4,5,6,7,14,30
      "value": 5464//key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）
    }
  ],
  "visit_uv": [
    {
      "key": 0,
      "value": 55500
    }
  ]
}

周留存

接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidweeklyretaininfo?access_token=ACCESS_TOKEN

POST 请求参数说明：

参数 是否必填 说明
begin_date 是 开始日期，为周一日期
end_date 是 结结束日期，为周日日期，限定查询一周数据

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

返回参数说明：

参数 说明
ref_date 时间，如：”20170306-20170312”
visit_uv_new 新增用户留存
visit_uv 活跃用户留存 
返回数据示例：

{
  "ref_date": "20170313",
  "visit_uv_new": [
    {
      "key": 0,//标识，0开始，0表示当周，1表示1周后，依此类推，key取值分别是：0,1,2,3,4
      "value": 5464//key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）
    }
  ],
  "visit_uv": [
    {
      "key": 0,
      "value": 55500
    }
  ]
}

月留存

接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidmonthlyretaininfo?access_token=ACCESS_TOKEN

POST 请求参数说明：

参数 是否必填 说明
begin_date 是 开始日期，为自然月第一天
end_date 是 结束日期，为自然月最后一天，限定查询一个月数据

注意：请求json和返回json与天的一致，这里限定查询一个自然月的数据，时间必须按照自然月的方式输入： 如：20170201(月初), 20170228(月末)

返回参数说明：

参数 说明
ref_date 时间，如：”201702”
visit_uv_new 新增用户留存
visit_uv 活跃用户留存 
返回数据示例：

{
  "ref_date": "20170313",
  "visit_uv_new": [
    {
      "key": 0,//标识，0开始，0表示当月，1表示1月后，key取值分别是：0,1
      "value": 5464//key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）
    }
  ],
  "visit_uv": [
    {
      "key": 0,
      "value": 55500
    }
  ]
}

访问页面

接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidvisitpage?access_token=ACCESS_TOKEN

POST 请求参数说明：

参数 是否必填 说明
begin_date 是 开始日期
end_date 是 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日

注意：请求json和返回json与天的一致，这里限定查询一个自然月的数据，时间必须按照自然月的方式输入： 如：20170201(月初), 20170228(月末)

返回参数：

返回数据示例：
{
  "ref_date": "20170313",
  "list": [
    {
      "page_path": "pages/main/main.html",//页面路径
      "page_visit_pv": 213429,//访问次数
      "page_visit_uv": 55423,//访问人数
      "page_staytime_pv": 8.139198,//次均停留时长
      "entrypage_pv": 117922,//进入页次数
      "exitpage_pv": 61304,//退出页次数
      "page_share_pv": 180,//转发次数
      "page_share_uv": 166//转发人数
    },
    {
      "page_path": "pages/linedetail/linedetail.html",
      "page_visit_pv": 155030,
      "page_visit_uv": 42195,
      "page_staytime_pv": 35.462395,
      "entrypage_pv": 21101,
      "exitpage_pv": 47051,
      "page_share_pv": 47,
      "page_share_uv": 42
    }
  ]
}

用户画像

获取小程序新增或活跃用户的画像分布数据。时间范围支持昨天、最近7天、最近30天。其中，新增用户数为时间范围内首次访问小程序的去重用户数，活跃用户数为时间范围内访问过小程序的去重用户数。画像属性包括用户年龄、性别、省份、城市、终端类型、机型。

接口地址： https://api.weixin.qq.com/datacube/getweanalysisappiduserportrait?access_token=ACCESS_TOKEN

POST 请求参数说明：

{
    "begin_date" : "2017-06-11",//(必要)开始日期
    "end_date" : "2017-06-17"//(必要)结束日期，开始日期与结束日期相差的天数限定为0/6/29，分别表示查询最近1/7/30天数据，end_date允许设置的最大值为昨日
}

返回参数说明：

{
  "ref_date": "20170611",//时间范围,如： "20170611-20170617"
  "visit_uv_new": { //新用户,visit_uv 活跃用户
    "province": [//省份
      {//每个属性下包括的数据项：
        "id": 31,//属性值id
        "name": "广东省",//属性值名称，与id一一对应。如属性为province时，返回的属性值名称包括“广东”等
        "value": 215//属性值对应的指标值，如指标为visit_uv,属性为province,属性值为"广东省”，value对应广东地区的活跃用户数
      }
    ],
    "city": [//城市
     {
        "id": 3102,
        "name": "广州",
        "value": 78
      }
    ],
    "genders": [//性别
      {
        "id": 1,
        "name": "男",
        "value": 2146
      }
    ],
    "platforms": [//终端类型，包括iPhone, android,其他
      {
        "id": 1,
        "name": "iPhone",
        "value": 27642
      }
    ],
    "devices": [//机型，如苹果iPhone6, OPPO R9等
      {
        "name": "OPPO R9",
        "value": 61
      }
    ],
    "ages": [//年龄，包括17岁以下、18-24岁等区间
      {
        "id": 1,
        "name": "17岁以下",
        "value": 151
      }
    ]
  }
}

1、由于部分用户属性数据缺失，属性值可能出现 “未知”。
2、机型数据无 id 字段，暂只提供用户数最多的 top20。

自定义分析

wx.reportAnalytics(eventName, data)自定义数据上报

自定义分析数据上报接口。使用前，需要在小程序管理后台自定义分析中新建事件，配置好事件名与字段。

wx.reportAnalytics('purchase', //eventNamef(必要)，事件名
{//data(必要)上报的自定义数据。key为配置中的字段名，value为上报的数据
  price: 120,
  color: 'red'
})
回复
分享到 :
0 人收藏
返回列表
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

16级独孤
匿名网站用户

积分:1136255
帖子:227251
精华:0
+ 关注 私信
期权论坛 期权论坛
期权网络科技版权所有
关于我们
联系我们
加入我们
反馈问题
免责声明
积分充值
统一社会信用代码
积分规则
网站地图
爱文库
下属网站
官方
新浪微博
微信公众号
◆
下载
表情包
App下载
期权论坛 期权论坛

QQ咨询|关于我们|Archiver|手机版|小黑屋|( 辽ICP备15012455号-4 ) Powered by 期权论坛 X3.2 © 2001-2016 期权工具网&期权论坛 Inc.

发布
内容

下载期权论坛手机APP