analysis_visit_trend.go

package weapp

import "github.com/ericnts/weapp/v3/request"

const (
	apiGetMonthlyVisitTrend = "/datacube/getweanalysisappidmonthlyvisittrend"
	apiGetWeeklyVisitTrend  = "/datacube/getweanalysisappidweeklyvisittrend"
	apiGetDailyVisitTrend   = "/datacube/getweanalysisappiddailyvisittrend"
)

// Trend 用户趋势
type Trend struct {
	RefDate         string  `json:"ref_date"`          // 时间，月格式为 yyyymm | 周格式为 yyyymmdd-yyyymmdd | 天格式为 yyyymmdd
	SessionCNT      uint    `json:"session_cnt"`       // 打开次数（自然月内汇总）
	VisitPV         uint    `json:"visit_pv"`          // 访问次数（自然月内汇总）
	VisitUV         uint    `json:"visit_uv"`          // 访问人数（自然月内去重）
	VisitUVNew      uint    `json:"visit_uv_new"`      // 新用户数（自然月内去重）
	StayTimeUV      float64 `json:"stay_time_uv"`      // 人均停留时长 (浮点型，单位：秒)
	StayTimeSession float64 `json:"stay_time_session"` // 次均停留时长 (浮点型，单位：秒)
	VisitDepth      float64 `json:"visit_depth"`       // 平均访问深度 (浮点型)
}

// VisitTrend 生物认证秘钥签名验证请求返回数据
type VisitTrend struct {
	request.CommonError
	List []Trend `json:"list"`
}

// GetMonthlyVisitTrend 获取用户访问小程序数据月趋势
// begin 开始日期，为自然月第一天。格式为 yyyymmdd
// end 结束日期，为自然月最后一天，限定查询一个月数据。格式为 yyyymmdd
func (cli *Client) GetMonthlyVisitTrend(begin, end string) (*VisitTrend, error) {
	api := baseURL + apiGetMonthlyVisitTrend

	accessToken, err := cli.AccessToken()
	if err != nil {
		return nil, err
	}

	return cli.getVisitTrend(accessToken, begin, end, api)
}

// GetWeeklyVisitTrend 获取用户访问小程序数据周趋势
// begin 开始日期，为自然月第一天。格式为 yyyymmdd
// end 结束日期，为周日日期，限定查询一周数据。格式为 yyyymmdd
func (cli *Client) GetWeeklyVisitTrend(begin, end string) (*VisitTrend, error) {
	api := baseURL + apiGetWeeklyVisitTrend

	accessToken, err := cli.AccessToken()
	if err != nil {
		return nil, err
	}

	return cli.getVisitTrend(accessToken, begin, end, api)
}

// GetDailyVisitTrend 获取用户访问小程序数据日趋势
// begin 开始日期，为自然月第一天。格式为 yyyymmdd
// end 结束日期，限定查询1天数据，允许设置的最大值为昨日。格式为 yyyymmdd
func (cli *Client) GetDailyVisitTrend(begin, end string) (*VisitTrend, error) {
	api := baseURL + apiGetDailyVisitTrend

	accessToken, err := cli.AccessToken()
	if err != nil {
		return nil, err
	}

	return cli.getVisitTrend(accessToken, begin, end, api)
}

func (cli *Client) getVisitTrend(accessToken, begin, end, api string) (*VisitTrend, error) {
	url, err := tokenAPI(api, accessToken)
	if err != nil {
		return nil, err
	}

	params := dateRange{
		BeginDate: begin,
		EndDate:   end,
	}

	res := new(VisitTrend)
	if err := cli.request.Post(url, params, res); err != nil {
		return nil, err
	}

	return res, nil
}