datacube

package
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 12, 2023 License: Apache-2.0 Imports: 3 Imported by: 0

README

数据统计接口

Documentation

Overview

数据统计接口.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type ArticleBaseData

type ArticleBaseData struct {
	IntPageReadUser  int `json:"int_page_read_user"`  // 图文页(点击群发图文卡片进入的页面)的阅读人数
	IntPageReadCount int `json:"int_page_read_count"` // 图文页的阅读次数
	OriPageReadUser  int `json:"ori_page_read_user"`  // 原文页(点击图文页"阅读原文"进入的页面)的阅读人数, 无原文页时此处数据为0
	OriPageReadCount int `json:"ori_page_read_count"` // 原文页的阅读次数
	ShareUser        int `json:"share_user"`          // 分享的人数
	ShareCount       int `json:"share_count"`         // 分享的次数
	AddToFavUser     int `json:"add_to_fav_user"`     // 收藏的人数
	AddToFavCount    int `json:"add_to_fav_count"`    // 收藏的次数
}

type ArticleSummaryData

type ArticleSummaryData struct {
	RefDate    string `json:"ref_date"`    // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!

	// 这里的msgid实际上是由msgid(图文消息id)和index(消息次序索引)组成,
	// 例如12003_3,  其中12003是msgid, 即一次群发的id消息的;
	// 3为index, 假设该次群发的图文消息共5个文章(因为可能为多图文),  3表示5个中的第3个
	MsgId string `json:"msgid"`
	Title string `json:"title"` // 图文消息的标题
	ArticleBaseData
}

图文群发每日数据

func GetArticleSummary

func GetArticleSummary(clt *core.Client, req *Request) (list []ArticleSummaryData, err error)

获取图文群发每日数据.

type ArticleTotalData

type ArticleTotalData struct {
	RefDate    string `json:"ref_date"`    // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	MsgId      string `json:"msgid"`       // 同 ArticleSummaryData.MsgId
	Title      string `json:"title"`
	Details    []struct {
		StatDate   string `json:"stat_date"`   // 统计的日期, 在getarticletotal接口中, ref_date指的是文章群发出日期,  而stat_date是数据统计日期
		TargetUser int    `json:"target_user"` // 送达人数, 一般约等于总粉丝数(需排除黑名单或其他异常情况下无法收到消息的粉丝)
		ArticleBaseData
	} `json:"details"`
}

图文群发总数据

func GetArticleTotal

func GetArticleTotal(clt *core.Client, req *Request) (list []ArticleTotalData, err error)

获取图文群发总数据.

type InterfaceSummaryData

type InterfaceSummaryData struct {
	RefDate       string `json:"ref_date"`        // 数据的日期, YYYY-MM-DD 格式
	CallbackCount int    `json:"callback_count"`  // 通过服务器配置地址获得消息后, 被动回复用户消息的次数
	FailCount     int    `json:"fail_count"`      // 上述动作的失败次数
	TotalTimeCost int64  `json:"total_time_cost"` // 总耗时, 除以callback_count即为平均耗时
	MaxTimeCost   int64  `json:"max_time_cost"`   // 最大耗时
}

接口分析数据

func GetInterfaceSummary

func GetInterfaceSummary(clt *core.Client, req *Request) (list []InterfaceSummaryData, err error)

获取接口分析数据.

type InterfaceSummaryHourData

type InterfaceSummaryHourData struct {
	RefHour int `json:"ref_hour"` // 数据的小时, 包括从000到2300, 分别代表的是[000,100)到[2300,2400), 即每日的第1小时和最后1小时
	InterfaceSummaryData
}

func GetInterfaceSummaryHour

func GetInterfaceSummaryHour(clt *core.Client, req *Request) (list []InterfaceSummaryHourData, err error)

获取接口分析分时数据.

type Request

type Request struct {
	// 获取数据的起始日期, YYYY-MM-DD 格式;
	// begin_date 和 end_date 的差值需小于"最大时间跨度"(比如最大时间跨度为1时,
	// begin_date 和 end_date 的差值只能为0, 才能小于1), 否则会报错.
	BeginDate string `json:"begin_date,omitempty"`

	// 获取数据的结束日期, YYYY-MM-DD 格式;
	// end_date 允许设置的最大值为昨日.
	EndDate string `json:"end_date,omitempty"`
}

获取统计数据通用的请求结构.

func NewRequest

func NewRequest(BeginDate, EndDate time.Time) *Request

NewRequest 创建一个 Request.

请注意 BeginDate, EndDate 的 Location.

type UpstreamMsgData

type UpstreamMsgData struct {
	RefDate    string `json:"ref_date"`    // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!

	// 消息类型, 代表含义如下:
	// 1代表文字
	// 2代表图片
	// 3代表语音
	// 4代表视频
	// 6代表第三方应用消息(链接消息)
	MsgType  int `json:"msg_type"`
	MsgUser  int `json:"msg_user"`  // 上行发送了(向公众号发送了)消息的用户数
	MsgCount int `json:"msg_count"` // 上行发送了消息的消息总数
}

消息发送概况数据

func GetUpstreamMsg

func GetUpstreamMsg(clt *core.Client, req *Request) (list []UpstreamMsgData, err error)

获取消息发送概况数据.

type UpstreamMsgDistData

type UpstreamMsgDistData struct {
	RefDate       string `json:"ref_date"`       // 数据的日期, YYYY-MM-DD 格式
	UserSource    int    `json:"user_source"`    // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	CountInterval int    `json:"count_interval"` // 当日发送消息量分布的区间, 0代表 "0", 1代表"1-5", 2代表"6-10", 3代表"10次以上"
	MsgUser       int    `json:"msg_user"`       // 上行发送了(向公众号发送了)消息的用户数
}

消息发送分布数据

func GetUpstreamMsgDist

func GetUpstreamMsgDist(clt *core.Client, req *Request) (list []UpstreamMsgDistData, err error)

获取消息发送分布数据.

type UpstreamMsgDistMonthData

type UpstreamMsgDistMonthData UpstreamMsgDistData

消息发送分布月数据

func GetUpstreamMsgDistMonth

func GetUpstreamMsgDistMonth(clt *core.Client, req *Request) (list []UpstreamMsgDistMonthData, err error)

获取消息发送分布月数据.

type UpstreamMsgDistWeekData

type UpstreamMsgDistWeekData UpstreamMsgDistData

消息发送分布周数据

func GetUpstreamMsgDistWeek

func GetUpstreamMsgDistWeek(clt *core.Client, req *Request) (list []UpstreamMsgDistWeekData, err error)

获取消息发送分布周数据.

type UpstreamMsgHourData

type UpstreamMsgHourData struct {
	RefHour int `json:"ref_hour"` // 数据的小时, 包括从000到2300, 分别代表的是[000,100)到[2300,2400), 即每日的第1小时和最后1小时
	UpstreamMsgData
}

消息分送分时数据

func GetUpstreamMsgHour

func GetUpstreamMsgHour(clt *core.Client, req *Request) (list []UpstreamMsgHourData, err error)

获取消息分送分时数据.

type UpstreamMsgMonthData

type UpstreamMsgMonthData UpstreamMsgData

消息发送月数据

func GetUpstreamMsgMonth

func GetUpstreamMsgMonth(clt *core.Client, req *Request) (list []UpstreamMsgMonthData, err error)

获取消息发送月数据.

type UpstreamMsgWeekData

type UpstreamMsgWeekData UpstreamMsgData

消息发送周数据

func GetUpstreamMsgWeek

func GetUpstreamMsgWeek(clt *core.Client, req *Request) (list []UpstreamMsgWeekData, err error)

获取消息发送周数据.

type UserCumulateData

type UserCumulateData struct {
	RefDate      string `json:"ref_date"`      // 数据的日期, YYYY-MM-DD 格式
	UserSource   int    `json:"user_source"`   // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	CumulateUser int    `json:"cumulate_user"` // 总用户量
}

累计用户数据

func GetUserCumulate

func GetUserCumulate(clt *core.Client, req *Request) (list []UserCumulateData, err error)

获取累计用户数据.

type UserReadData

type UserReadData struct {
	RefDate    string `json:"ref_date"` // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"`
	ArticleBaseData
}

图文统计数据

func GetUserRead

func GetUserRead(clt *core.Client, req *Request) (list []UserReadData, err error)

获取图文统计数据.

type UserReadHourData

type UserReadHourData struct {
	RefHour         int   `json:"ref_hour"`          // 数据的小时, 包括从000到2300, 分别代表的是[000,100)到[2300,2400), 即每日的第1小时和最后1小时
	TotalOnlineTime int64 `json:"total_online_time"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	UserReadData
}

图文统计分时数据

func GetUserReadHour

func GetUserReadHour(clt *core.Client, req *Request) (list []UserReadHourData, err error)

获取图文统计分时数据.

type UserShareData

type UserShareData struct {
	RefDate    string `json:"ref_date"`    // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	ShareScene int    `json:"share_scene"` // 分享的场景, 1代表好友转发 2代表朋友圈 3代表腾讯微博 255代表其他
	ShareCount int    `json:"share_count"` // 分享的次数
	ShareUser  int    `json:"share_user"`  // 分享的人数
}

图文分享转发数据

func GetUserShare

func GetUserShare(clt *core.Client, req *Request) (list []UserShareData, err error)

获取图文分享转发数据.

type UserShareHourData

type UserShareHourData struct {
	RefHour int `json:"ref_hour"` // 数据的小时, 包括从000到2300, 分别代表的是[000,100)到[2300,2400), 即每日的第1小时和最后1小时
	UserShareData
}

图文分享转发分时数据

func GetUserShareHour

func GetUserShareHour(clt *core.Client, req *Request) (list []UserShareHourData, err error)

获取图文分享转发分时数据.

type UserSummaryData

type UserSummaryData struct {
	RefDate string `json:"ref_date"` // 数据的日期, YYYY-MM-DD 格式

	// 用户的渠道, 数值代表的含义如下:
	// 0  代表其他
	// 1  xxx(文档没有说明)
	// 2  xxx(文档没有说明)
	// 3  代表扫二维码
	// 4  xxx(文档没有说明)
	// 5  xxx(文档没有说明)
	// 17 代表名片分享
	// 35 代表搜号码(即微信添加朋友页的搜索)
	// 39 代表查询微信公众帐号
	// 43 代表图文页右上角菜单
	UserSource int `json:"user_source"`

	NewUser    int `json:"new_user"`    // 新增的用户数量
	CancelUser int `json:"cancel_user"` // 取消关注的用户数量, new_user 减去 cancel_user即为净增用户数量
}

用户增减数据

func GetUserSummary

func GetUserSummary(clt *core.Client, req *Request) (list []UserSummaryData, err error)

获取用户增减数据.

Directories

Path Synopsis
卡券数据统计接口
卡券数据统计接口

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL