forked from golang/hotime
318 lines
12 KiB
Go
318 lines
12 KiB
Go
package analysis
|
||
|
||
import (
|
||
"encoding/json"
|
||
"fmt"
|
||
|
||
"github.com/silenceper/wechat/v2/miniprogram/context"
|
||
|
||
"github.com/silenceper/wechat/v2/util"
|
||
)
|
||
|
||
const (
|
||
// 获取用户访问小程序日留存
|
||
getAnalysisDailyRetainURL = "https://api.weixin.qq.com/datacube/getweanalysisappiddailyretaininfo?access_token=%s"
|
||
// 获取用户访问小程序月留存
|
||
getAnalysisMonthlyRetainURL = "https://api.weixin.qq.com/datacube/getweanalysisappidmonthlyretaininfo?access_token=%s"
|
||
// 获取用户访问小程序周留存
|
||
getAnalysisWeeklyRetainURL = "https://api.weixin.qq.com/datacube/getweanalysisappidweeklyretaininfo?access_token=%s"
|
||
// 获取用户访问小程序数据概况
|
||
getAnalysisDailySummaryURL = "https://api.weixin.qq.com/datacube/getweanalysisappiddailysummarytrend?access_token=%s"
|
||
// 获取用户访问小程序数据日趋势
|
||
getAnalysisDailyVisitTrendURL = "https://api.weixin.qq.com/datacube/getweanalysisappiddailyvisittrend?access_token=%s"
|
||
// 获取用户访问小程序数据月趋势
|
||
getAnalysisMonthlyVisitTrendURL = "https://api.weixin.qq.com/datacube/getweanalysisappidmonthlyvisittrend?access_token=%s"
|
||
// 获取用户访问小程序数据周趋势
|
||
getAnalysisWeeklyVisitTrendURL = "https://api.weixin.qq.com/datacube/getweanalysisappidweeklyvisittrend?access_token=%s"
|
||
// 获取小程序新增或活跃用户的画像分布数据
|
||
getAnalysisUserPortraitURL = "https://api.weixin.qq.com/datacube/getweanalysisappiduserportrait?access_token=%s"
|
||
// 获取用户小程序访问分布数据
|
||
getAnalysisVisitDistributionURL = "https://api.weixin.qq.com/datacube/getweanalysisappidvisitdistribution?access_token=%s"
|
||
// 访问页面
|
||
getAnalysisVisitPageURL = "https://api.weixin.qq.com/datacube/getweanalysisappidvisitpage?access_token=%s"
|
||
)
|
||
|
||
// Analysis analyis 数据分析
|
||
type Analysis struct {
|
||
*context.Context
|
||
}
|
||
|
||
// NewAnalysis new
|
||
func NewAnalysis(ctx *context.Context) *Analysis {
|
||
return &Analysis{ctx}
|
||
}
|
||
|
||
// fetchData 拉取统计数据
|
||
func (analysis *Analysis) fetchData(urlStr string, body interface{}) (response []byte, err error) {
|
||
var accessToken string
|
||
accessToken, err = analysis.GetAccessToken()
|
||
if err != nil {
|
||
return
|
||
}
|
||
urlStr = fmt.Sprintf(urlStr, accessToken)
|
||
response, err = util.PostJSON(urlStr, body)
|
||
return
|
||
}
|
||
|
||
// RetainItem 留存项结构
|
||
type RetainItem struct {
|
||
Key int `json:"key"` // 标识，0开始表示当天，1表示1甜后，以此类推
|
||
Value int `json:"value"` // key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）
|
||
}
|
||
|
||
// ResAnalysisRetain 小程序留存数据返回
|
||
type ResAnalysisRetain struct {
|
||
util.CommonError
|
||
RefDate string `json:"ref_date"` // 日期
|
||
VisitUVNew []RetainItem `json:"visit_uv_new"` // 新增用户留存
|
||
VisitUV []RetainItem `json:"visit_uv"` // 活跃用户留存
|
||
}
|
||
|
||
// getAnalysisRetain 获取用户访问小程序留存数据(日、月、周)
|
||
func (analysis *Analysis) getAnalysisRetain(urlStr string, beginDate, endDate string) (result ResAnalysisRetain, err error) {
|
||
body := map[string]string{
|
||
"begin_date": beginDate,
|
||
"end_date": endDate,
|
||
}
|
||
response, err := analysis.fetchData(urlStr, body)
|
||
if err != nil {
|
||
return
|
||
}
|
||
err = json.Unmarshal(response, &result)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if result.ErrCode != 0 {
|
||
err = fmt.Errorf("getAnalysisRetain error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
|
||
return
|
||
}
|
||
return
|
||
}
|
||
|
||
// GetAnalysisDailyRetain 获取用户访问小程序日留存
|
||
func (analysis *Analysis) GetAnalysisDailyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error) {
|
||
return analysis.getAnalysisRetain(getAnalysisDailyRetainURL, beginDate, endDate)
|
||
}
|
||
|
||
// GetAnalysisMonthlyRetain 获取用户访问小程序月留存
|
||
func (analysis *Analysis) GetAnalysisMonthlyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error) {
|
||
return analysis.getAnalysisRetain(getAnalysisMonthlyRetainURL, beginDate, endDate)
|
||
}
|
||
|
||
// GetAnalysisWeeklyRetain 获取用户访问小程序周留存
|
||
func (analysis *Analysis) GetAnalysisWeeklyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error) {
|
||
return analysis.getAnalysisRetain(getAnalysisWeeklyRetainURL, beginDate, endDate)
|
||
}
|
||
|
||
// ResAnalysisDailySummary 小程序访问数据概况
|
||
type ResAnalysisDailySummary struct {
|
||
util.CommonError
|
||
List []struct {
|
||
RefDate string `json:"ref_date"` // 日期
|
||
VisitTotal int `json:"visit_total"` // 累计用户数
|
||
SharePV int `json:"share_pv"` // 转发次数
|
||
ShareUV int `json:"share_uv"` // 转发人数
|
||
} `json:"list"`
|
||
}
|
||
|
||
// GetAnalysisDailySummary 获取用户访问小程序数据概况
|
||
func (analysis *Analysis) GetAnalysisDailySummary(beginDate, endDate string) (result ResAnalysisDailySummary, err error) {
|
||
body := map[string]string{
|
||
"begin_date": beginDate,
|
||
"end_date": endDate,
|
||
}
|
||
response, err := analysis.fetchData(getAnalysisDailySummaryURL, body)
|
||
if err != nil {
|
||
return
|
||
}
|
||
|
||
err = json.Unmarshal(response, &result)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if result.ErrCode != 0 {
|
||
err = fmt.Errorf("GetAnalysisDailySummary error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
|
||
return
|
||
}
|
||
return
|
||
}
|
||
|
||
// ResAnalysisVisitTrend 小程序访问数据趋势(日、月、周)
|
||
type ResAnalysisVisitTrend struct {
|
||
util.CommonError
|
||
List []struct {
|
||
RefDate string `json:"ref_date"` // 日期
|
||
SessionCnt int `json:"session_cnt"` // 打开次数
|
||
VisitPV int `json:"visit_pv"` // 访问次数
|
||
VisitUV int `json:"visit_uv"` // 访问人数
|
||
VisitUVNew int `json:"visit_uv_new"` // 新用户数
|
||
StayTimeUV float64 `json:"stay_time_uv"` // 人均停留时长
|
||
StayTimeSession float64 `json:"stay_time_session"` // 次均停留时常
|
||
VisitDepth float64 `json:"visit_depth"` // 平均访问深度
|
||
} `json:"list"`
|
||
}
|
||
|
||
// getAnalysisRetain 获取小程序访问数据趋势(日、月、周)
|
||
func (analysis *Analysis) getAnalysisVisitTrend(urlStr string, beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
|
||
body := map[string]string{
|
||
"begin_date": beginDate,
|
||
"end_date": endDate,
|
||
}
|
||
response, err := analysis.fetchData(urlStr, body)
|
||
if err != nil {
|
||
return
|
||
}
|
||
err = json.Unmarshal(response, &result)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if result.ErrCode != 0 {
|
||
err = fmt.Errorf("getAnalysisVisitTrend error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
|
||
return
|
||
}
|
||
return
|
||
}
|
||
|
||
// GetAnalysisDailyVisitTrend 获取用户访问小程序数据日趋势
|
||
func (analysis *Analysis) GetAnalysisDailyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
|
||
return analysis.getAnalysisVisitTrend(getAnalysisDailyVisitTrendURL, beginDate, endDate)
|
||
}
|
||
|
||
// GetAnalysisMonthlyVisitTrend 获取用户访问小程序数据月趋势
|
||
func (analysis *Analysis) GetAnalysisMonthlyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
|
||
return analysis.getAnalysisVisitTrend(getAnalysisMonthlyVisitTrendURL, beginDate, endDate)
|
||
}
|
||
|
||
// GetAnalysisWeeklyVisitTrend 获取用户访问小程序数据周趋势
|
||
func (analysis *Analysis) GetAnalysisWeeklyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
|
||
return analysis.getAnalysisVisitTrend(getAnalysisWeeklyVisitTrendURL, beginDate, endDate)
|
||
}
|
||
|
||
// UserPortraitItem 用户画像项目
|
||
type UserPortraitItem struct {
|
||
ID int `json:"id"` // 属性值id
|
||
Name string `json:"name"` // 属性值名称
|
||
AccessSourceVisitUV int `json:"access_source_visit_uv"` // 该场景访问uv
|
||
}
|
||
|
||
// UserPortrait 用户画像
|
||
type UserPortrait struct {
|
||
Index int `json:"index"` // 分布类型
|
||
Province []UserPortraitItem `json:"province"` // 省份，如北京、广东等
|
||
City []UserPortraitItem `json:"city"` // 城市，如北京、广州等
|
||
Genders []UserPortraitItem `json:"genders"` // 性别，包括男、女、未知
|
||
Platforms []UserPortraitItem `json:"platforms"` // 终端类型，包括iPhone, android, 其他
|
||
Devices []UserPortraitItem `json:"devices"` // 机型，如苹果iPhone 6, OPPO R9等
|
||
Ages []UserPortraitItem `json:"ages"` // 年龄，包括17岁以下、18-24对等区间
|
||
}
|
||
|
||
// ResAnalysisUserPortrait 小程序新增或活跃用户的画像分布数据返回
|
||
type ResAnalysisUserPortrait struct {
|
||
util.CommonError
|
||
RefDate string `json:"ref_date"` // 日期
|
||
VisitUVNew UserPortrait `json:"visit_uv_new"` // 新用户画像
|
||
VisitUV UserPortrait `json:"visit_uv"` // 活跃用户画像
|
||
}
|
||
|
||
// GetAnalysisUserPortrait 获取小程序新增或活跃用户的画像分布数据
|
||
func (analysis *Analysis) GetAnalysisUserPortrait(beginDate, endDate string) (result ResAnalysisUserPortrait, err error) {
|
||
body := map[string]string{
|
||
"begin_date": beginDate,
|
||
"end_date": endDate,
|
||
}
|
||
response, err := analysis.fetchData(getAnalysisUserPortraitURL, body)
|
||
if err != nil {
|
||
return
|
||
}
|
||
err = json.Unmarshal(response, &result)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if result.ErrCode != 0 {
|
||
err = fmt.Errorf("GetAnalysisUserPortrait error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
|
||
return
|
||
}
|
||
return
|
||
}
|
||
|
||
// VisitDistributionIndexItem 访问分数数据结构
|
||
type VisitDistributionIndexItem struct {
|
||
Key int `json:"key"` // 场景id
|
||
Value int `json:"value"` // 该场景id访问pv
|
||
AccessSourceVisitUV int `json:"access_source_visit_uv"` // 该场景id访问uv
|
||
}
|
||
|
||
// VisitDistributionIndex 访问分布单分布类型数据
|
||
type VisitDistributionIndex struct {
|
||
Index string `json:"index"` // 分布类型
|
||
ItemList []VisitDistributionIndexItem `json:"item_list"` // 分布数据列表
|
||
}
|
||
|
||
// ResAnalysisVisitDistribution 小程序访问分布数据返回
|
||
type ResAnalysisVisitDistribution struct {
|
||
util.CommonError
|
||
RefDate string `json:"ref_date"` // 日期
|
||
List []VisitDistributionIndex `json:"list"` // 数据列表
|
||
}
|
||
|
||
// GetAnalysisVisitDistribution 获取用户小程序访问分布数据
|
||
func (analysis *Analysis) GetAnalysisVisitDistribution(beginDate, endDate string) (result ResAnalysisVisitDistribution, err error) {
|
||
body := map[string]string{
|
||
"begin_date": beginDate,
|
||
"end_date": endDate,
|
||
}
|
||
response, err := analysis.fetchData(getAnalysisVisitDistributionURL, body)
|
||
if err != nil {
|
||
return
|
||
}
|
||
err = json.Unmarshal(response, &result)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if result.ErrCode != 0 {
|
||
err = fmt.Errorf("GetAnalysisVisitDistribution error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
|
||
return
|
||
}
|
||
return
|
||
}
|
||
|
||
// VisitPageItem 访问单个页面的数据结构
|
||
type VisitPageItem struct {
|
||
PagePath string `json:"page_path"` // 页面路径
|
||
PageVisitPV int `json:"page_visit_pv"` // 访问次数
|
||
PageVisitUV int `json:"page_visit_uv"` // 访问人数
|
||
PageStaytimePV float64 `json:"page_staytime_pv"` // 次均停留时常
|
||
EntrypagePV int `json:"entrypage_pv"` // 进入页次数
|
||
ExitpagePV int `json:"exitpage_pv"` // 退出页次数
|
||
PageSharePV int `json:"page_share_pv"` // 转发次数
|
||
PageShareUV int `json:"page_share_uv"` // 转发人数
|
||
}
|
||
|
||
// ResAnalysisVisitPage 访问小程序页面访问数据返回
|
||
type ResAnalysisVisitPage struct {
|
||
util.CommonError
|
||
RefDate string `json:"ref_date"` // 日期
|
||
List []VisitPageItem `json:"list"` // 数据列表
|
||
}
|
||
|
||
// GetAnalysisVisitPage 获取小程序页面访问数据
|
||
func (analysis *Analysis) GetAnalysisVisitPage(beginDate, endDate string) (result ResAnalysisVisitPage, err error) {
|
||
body := map[string]string{
|
||
"begin_date": beginDate,
|
||
"end_date": endDate,
|
||
}
|
||
response, err := analysis.fetchData(getAnalysisVisitPageURL, body)
|
||
if err != nil {
|
||
return
|
||
}
|
||
err = json.Unmarshal(response, &result)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if result.ErrCode != 0 {
|
||
err = fmt.Errorf("GetAnalysisVisitPage error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
|
||
return
|
||
}
|
||
return
|
||
}
|