report

package
v0.0.0-...-80d2d60 Latest Latest
Warning

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

 Go to latest Published: Aug 9, 2025 License: Apache-2.0 Imports: 2 Imported by: 0

Documentation

Overview

Package report 数据报表相关API结构体

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type AccountCostReportRequest 

type AccountCostReportRequest struct {
	ReportRequest
	// agentId 代理商ID，必填
	AgentID uint64 `json:"agentId,omitempty"`
}

AccountCostReportRequest 获取广告主消耗明细

func (AccountCostReportRequest) Encode 

func (r AccountCostReportRequest) Encode() []byte

Encode implement PostRequest interface

func (AccountCostReportRequest) Url 

func (r AccountCostReportRequest) Url() string

Url implement PostRequest interface

type AccountReportRequest 

type AccountReportRequest struct {
	ReportRequest
}

AccountReportRequest 广告主数据APIRequest

func (AccountReportRequest) Encode 

func (r AccountReportRequest) Encode() []byte

Encode implement PostRequest interface

func (AccountReportRequest) Url 

func (r AccountReportRequest) Url() string

Url implement PostRequest interface

type AgentReportRequest 

type AgentReportRequest struct {
	// AgentID 代理商ID（注：非账户快手ID），在获取accessToken时返回
	AgentID uint64 `json:"agent_id,omitempty"`
	// StartDate  过滤筛选条件，格式yyyy-MM-dd 可选时间范围参见文档上方说明
	StartDate string `json:"start_date,omitempty"`
	// EndDate 过滤筛选条件，格式yyyy-MM-dd 可选时间范围参见文档上方说明
	EndDate string `json:"end_date,omitempty"`
	// Page 请求的页码，默认为 1
	Page int `json:"page,omitempty"`
	// PageSize 每页行数，默认为20，最大支持1000
	PageSize int `json:"page_size,omitempty"`
}

AgentReportRequest 代理商数据APIRequest

func (AgentReportRequest) Encode 

func (r AgentReportRequest) Encode() []byte

Encode implement PostRequest interface

func (AgentReportRequest) Url 

func (r AgentReportRequest) Url() string

Url implement PostRequest inferface

type AgentReportResponse 

type AgentReportResponse struct {
	// TotalCount 数据的总行数
	TotalCount int `json:"total_count,omitempty"`
	// Details 数据明细信息
	Details []AgentStat `json:"details,omitempty"`
}

AgentReportResponse 代理商数据APIResponse

type AgentStat 

type AgentStat struct {
	// DateTime 数据日期，格式：YYYY-MM-DD
	DateTime string `json:"date_time,omitempty"`
	// AccountID 广告主ID
	AccountID uint64 `json:"account_id,omitempty"`
	// UserID 快手id
	UserID uint64 `json:"user_id,omitempty"`
	// AccountName 广告主名称
	AccountName string `json:"account_name,omitempty"`
	// TotalChargedInYuan 总消耗（元）
	TotalChargedInYuan int64 `json:"total_charged_in_yuan,omitempty"`
	// TotalBalanceInYuan 总余额（元）
	TotalBalanceInYuan int64 `json:"total_balance_in_yuan,omitempty"`
	// RealChargedInYuan 现金消耗（元）
	RealChargedInYuan int64 `json:"real_charged_in_yuan,omitempty"`
	// TotalRebateRechargedInYuan 返点消耗（元）
	TotalRebateRechargedInYuan int64 `json:"total_real_recharged_in_yuan,omitempty"`
	// ContractRebateRealChargedInYuan 框返消耗（元）
	ContractRebateRealChargedInYuan int64 `json:"contract_rebate_real_recharged_in_yuan,omitempty"`
	// DirectRebateRealChargedInYuan 激励消耗（元）
	DirectRebateRealChargedInYuan int64 `json:"direct_rebate_real_charged_in_yuan,omitempty"`
	// CreditRealChargedInYuan 信用消耗（元）
	CreditRealChargedInYuan int64 `json:"credit_real_charged_in_yuan,omitempty"`
	// ChargeDayOnDayPercent 消耗环比
	ChargeDayOnDayPercent string `json:"charge_day_on_day_percent,omitempty"`
	// AdPhotoImpression 封面曝光数
	AdPhotoImpression int64 `json:"ad_photo_impression,omitempty"`
	// AdPhotoClick 封面点击数
	AdPhotoClick int64 `json:"ad_photo_click,omitempty"`
	// AdItemClick 行为数
	AdItemClick int64 `json:"ad_item_click,omitempty"`
	// PhotoClickRatio 封面点击率
	PhotoClickRatio string `json:"photo_click_ratio,omitempty"`
	// ItemClickRatio 行为点击率
	ItemClickRatio string `json:"item_click_ratio,omitempty"`
	// ChargedCampaignCount 有消费计划数
	ChargedCampaignCount int64 `json:"charged_campaign_count,omitempty"`
	// ProductName 产品名
	ProductName string `json:"product_name,omitempty"`
	// CorporationName 企业名称
	CorporationName string `json:"corporation_name,omitempty"`
	// FirstCostDay 首次消耗日期
	FirstCostDay int64 `json:"first_cost_day,omitempty"`
	// Industry 一级行业
	Industry string `json:"industry,omitempty"`
	// SecondIndustry 二级行业
	SecondIndustry string `json:"second_industry,omitempty"`
}

AgentStat 代理商数据

type AudienceReportRequest 

type AudienceReportRequest struct {
	ReportRequest
	// CampaignIDs 广告计划ID集，过滤筛选条件，单次查询数量不超过5000
	CampaignIDs []uint64 `json:"campaign_ids,omitempty"`
	// UnitIDs 广告组ID集，过滤筛选条件，单次查询数量不超过5000
	UnitIDs []uint64 `json:"unit_ids,omitempty"`
}

AudienceReportRequest 人群分析数据APIRequest

func (AudienceReportRequest) Encode 

func (r AudienceReportRequest) Encode() []byte

Encode implement PostRequest interface

func (AudienceReportRequest) Url 

func (r AudienceReportRequest) Url() string

Url implement PostRequest interface

type CampaignReportRequest 

type CampaignReportRequest struct {
	ReportRequest
	// CampaignIDs 广告计划ID集，过滤筛选条件，单次查询数量不超过5000
	CampaignIDs []uint64 `json:"campaignIdList,omitempty"`
}

CampaignReportRequest 广告计划数据APIRequest

func (CampaignReportRequest) Encode 

func (r CampaignReportRequest) Encode() []byte

Encode implement PostRequest interface

func (CampaignReportRequest) Url 

func (r CampaignReportRequest) Url() string

Url implement PostRequest interface

type Cost 

type Cost struct {
	// 账单日期
	// 格式为YYYYMM，如202301表示2023年1月
	ChargeDay string `json:"chargeday"`

	// 代理商ID
	// 唯一标识一个代理商
	AgentId int64 `json:"agentId"`

	// 广告主公司名称
	// 投放广告的公司名称
	CorpName string `json:"corpName"`

	// 账户ID
	// 广告账户的唯一标识
	AccountId int64 `json:"accountId"`

	// 投放国家代码
	// 使用ISO 3166-1标准国家代码，参见https://www.iban.com/country-codes
	CountryCode int64 `json:"countryCode"`

	// 总消耗金额
	// 以代理商币种为单位的广告总消耗
	TotalCost int64 `json:"totalCost"`

	// 现金消耗金额
	// 使用现金支付部分的广告消耗
	CashCost int64 `json:"cashCost"`

	// 前返消耗金额
	// 使用前返金额支付部分的广告消耗
	TopUpRebateCost int64 `json:"topUpRebateCost"`

	// 框返消耗金额
	// 使用框返金额支付部分的广告消耗
	AdvertiserRebateCost int64 `json:"advertiserRebateCost"`

	// 后返消耗金额
	// 使用后返金额支付部分的广告消耗
	DeliveryRebateCost int64 `json:"deliveryRebateCost"`

	// 激励消耗金额
	// 使用激励金额支付部分的广告消耗
	CompensationCost int64 `json:"compensationCost"`

	// 信用消耗金额
	// 使用信用额度支付部分的广告消耗
	CreditCost int64 `json:"creditCost"`
}

Cost 包含广告数据的详细指标

type CreativeReportRequest 

type CreativeReportRequest struct {
	ReportRequest
	// CampaignIDs 广告计划ID集，过滤筛选条件，单次查询数量不超过5000
	CampaignIDs []uint64 `json:"campaignIds,omitempty"`
	// UnitIDs 广告组ID集，过滤筛选条件，单次查询数量不超过5000
	UnitIDs []uint64 `json:"unitIds,omitempty"`
	// CreativeIDs 广告创意ID集，过滤筛选条件，单次查询数量不超过5000
	CreativeIDs []uint64 `json:"creativeIds,omitempty"`
}

CreativeReportRequest 广告创意数据APIRequest

func (CreativeReportRequest) Encode 

func (r CreativeReportRequest) Encode() []byte

Encode implement PostRequest interface

func (CreativeReportRequest) Url 

func (r CreativeReportRequest) Url() string

Url implement PostRequest interface

type MaterialReportRequest 

type MaterialReportRequest struct {
	ReportRequest
	// CampaignIDs 广告计划ID集，过滤筛选条件，单次查询数量不超过5000
	CampaignIDs []uint64 `json:"campaign_ids,omitempty"`
	// CampaignType 计划类型，过滤筛选条件1 - 作品推广；2 - 提升应用安装；3 - 获取电商下单；4 - 推广品牌活动；5 - 收集销售线索；6 - 保量广告；7 - 提高应用活跃。
	CampaignType int `json:"campaign_type,omitempty"`
	// UnitIDs 广告组ID集，过滤筛选条件，单次查询数量不超过5000
	UnitIDs []uint64 `json:"unit_ids,omitempty"`
	// CreativeIDs 广告创意ID集，过滤筛选条件，单次查询数量不超过5000
	CreativeIDs []uint64 `json:"creative_ids,omitempty"`
	// PhotoIDs 视频ID集，过滤筛选条件，单次查询数量不超过5000
	PhotoIDs []string `json:"photo_ids,omitempty"`
	// CoverIDs 封面ID集，过滤筛选条件，单次查询数量不超过5000
	CoverIDs []string `json:"cover_ids,omitempty"`
	// CreativeMaterialType 素材类型：1 - 竖版视频; 2 - 横版视频; 3 - 便利贴;5 -竖版图片; 6- 横版图片; 9-小图；10-组图
	CreativeMaterialType int `json:"creative_material_type,omitempty"`
	// ViewType 报表类型：5 - 视频报表 7 - 封面报表 8 - 便利贴报表;16-图片报表；
	ViewType int `json:"view_type,omitempty"`
}

MaterialReportRequest 广告素材数据API Request

func (MaterialReportRequest) Encode 

func (r MaterialReportRequest) Encode() []byte

Encode implement PostRequest interface

func (MaterialReportRequest) Url 

func (r MaterialReportRequest) Url() string

Url implement PostRequest interface

type MaterialReportResponse 

type MaterialReportResponse struct {
	Code      int    `json:"code,omitempty"`       // 返回码
	Message   string `json:"message,omitempty"`    // 返回信息
	RequestId string `json:"request_id,omitempty"` // 请求id
	ReportResponse
}

MaterialReportResponse 广告素材数据API Response

func (MaterialReportResponse) Error 

func (r MaterialReportResponse) Error() string

Error implement error interface

func (MaterialReportResponse) IsError 

func (r MaterialReportResponse) IsError() bool

IsError detect if the response is an error

type MerchantDetailReportRequest 

type MerchantDetailReportRequest struct {
	// AdvertiserID 广告主 ID（注：非账户快手 ID），在获取 accessToken 时返回
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// ViewType 数据类型：1：账户；2：广告计划；3：广告组；4：广告创意
	ViewType int `json:"view_type,omitempty"`
	// GroupType 汇总方式：1：天 （默认值）；2：小时 此时 start_date 只能是当天，end_date 只能是下一天
	GroupType int `json:"group_type,omitempty"`
	// StartDate 过滤筛选条件，格式 yyyy-MM-dd
	StartDate string `json:"start_date,omitempty"`
	// EndDate 过滤筛选条件，格式 yyyy-MM-dd
	EndDate string `json:"end_date,omitempty"`
	// CampaignIDs 计划 id 列表，以英文逗号分割，查询计划转化数据 viewType=2 时必填，否则不用填写
	CampaignIDs []uint64 `json:"campaign_ids,omitempty"`
	// UnitIDs 单元 id 列表，以英文逗号分割，查询单元转化数据 viewType=3 时必填，否则不用填写
	UnitIDs []uint64 `json:"unit_ids,omitempty"`
	// CreativeIDs 创意 id 列表，以英文逗号分割，查询创意转化数据 viewType=4 时必填，否则不用填写
	CreativeIDs []uint64 `json:"creative_ids,omitempty"`
	// ProgramedCreativeIDs 程序化创意 id 列表，以英文逗号分割，查询程序化创意转化数据 viewType=4 时必填，，否则不用填写
	ProgramedCreativeIDs []uint64 `json:"programed_creative_ids,omitempty"`
	// Page 请求的页码，默认为 1
	Page int `json:"page,omitempty"`
	// PageSize 每页行数，默认为 20，最大支持 2000
	PageSize int `json:"page_size,omitempty"`
}

MerchantDetailReportRequest 小店通转化数据APIRequest

func (MerchantDetailReportRequest) Encode 

func (r MerchantDetailReportRequest) Encode() []byte

Encode implement PostRequest interface

func (MerchantDetailReportRequest) Url 

func (r MerchantDetailReportRequest) Url() string

Url implement PostRequest inteface

type MerchantDetailReportResponse 

type MerchantDetailReportResponse struct {
	// TotalCount 数据的总行数
	TotalCount int `json:"total_count,omitempty"`
	// Details 数据明细信息
	Details []MerchantStat `json:"details,omitempty"`
}

MerchantDetailReportResponse 小店通转化数据APIResponse

type MerchantStat 

type MerchantStat struct {
	// ReportDate 日期
	ReportDate string `json:"report_date,omitempty"`
	// ReportHour 小时
	ReportHour int `json:"report_hour,omitempty"`
	// ReportDateHour 日期+小时
	ReportDateHour string `json:"report_date_hour,omitempty"`
	// CampaignName 计划名称
	CampaignName string `json:"campaign_name,omitempty"`
	// CampaignID 计划 ID
	CampaignID uint64 `json:"campaign_id,omitempty"`
	// UnitName 广告组名称
	UnitName string `json:"unit_name,omitempty"`
	// UnitID 广告组 ID
	UnitID uint64 `json:"unit_id,omitempty"`
	// CreativeName 创意名称
	CreativeName string `json:"creative_name,omitempty"`
	// CreativeID 创意 id
	CreativeID uint64 `json:"creative_id,omitempty"`
	// CostTotal 花费
	CostTotal int64 `json:"cost_total,omitempty"`
	// Impression 封面曝光数
	Impression int64 `json:"impression,omitempty"`
	// PhotoClick 封面点击数
	PhotoClick int64 `json:"photo_click,omitempty"`
	// PhotoClickRatio 封面点击率
	PhotoClickRatio float64 `json:"photo_click_ratio,omitempty"`
	// Click 素材曝光数
	Click int64 `json:"click,omitempty"`
	// ActionbarClick 行为数
	ActionbarClick int64 `json:"actionbar_click,omitempty"`
	// ActionRatio 行为率
	ActionRatio float64 `json:"action_ratio,omitempty"`
	// MerchantPhotoImpression1kCost 平均千次封面曝光花费(元)
	MerchantPhotoImpression1kCost float64 `json:"merchant_photo_impression_1k_cost,omitempty"`
	// MerchantPhotoClickCost 平均封面点击单价(元)
	MerchantPhotoClickCost float64 `json:"merchant_photo_click_cost,omitempty"`
	// MerchantImpression1kCost 平均千次素材曝光花费(元)
	MerchantImpression1kCost float64 `json:"merchant_impression_1k_cost,omitempty"`
	// MerchantClickCost 平均行为单价(元)
	MerchantClickCost float64 `json:"merchant_click_cost,omitempty"`
	// Play3sRatio 3s 播放率
	Play3sRatio float64 `json:"play_3s_ratio,omitempty"`
	Play5sRatio float64 `json:"play_5s_ratio,omitempty"`
	// Play5sRatio 5s 播放率
	// PlayEndRatio 完播率
	PlayEndRatio float64 `json:"play_end_ratio,omitempty"`
	// Share 分享数
	Share int64 `json:"share,omitempty"`
	// Comment 评论数
	Comment int64 `json:"comment,omitempty"`
	// Likes 点赞数
	Likes int64 `json:"likes,omitempty"`
	// Report 举报数
	Report int64 `json:"report,omitempty"`
	// Block 拉黑数
	Block int64 `json:"block,omitempty"`
	// Negative 减少此类作品数
	Negative int64 `json:"negative,omitempty"`
	// MerchantRecoFans 涨粉量
	MerchantRecoFans int64 `json:"merchant_reco_fans,omitempty"`
	// RecoFansCost 涨粉成本（元）
	RecoFansCost float64 `json:"reco_fans_cost,omitempty"`
	// PaidOrder 支付订单数
	PaidOrder int64 `json:"paid_order,omitempty"`
	// OrderCost 下单成本
	OrderCost float64 `json:"order_cost,omitempty"`
	// Gmv GMV
	Gmv float64 `json:"gmv,omitempty"`
	// T0Gmv 当日累计 GMV
	T0Gmv int64 `json:"t0_gmv,omitempty"`
	// T1Gmv 投后 1 日累计 GMV
	T1Gmv int64 `json:"t1_gmv,omitempty"`
	// T3Gmv 投后 3 日累计 GMV
	T3Gmv int64 `json:"t3_gmv,omitempty"`
	// T7Gmv 投后 7 日累计 GMV
	T7Gmv int64 `json:"t7_gmv,omitempty"`
	// T15Gmv 投后 15 GMV
	T15Gmv int64 `json:"t15_gmv,omitempty"`
	// T30Gmv 投后 30 GMV
	T30Gmv int64 `json:"t30_gmv,omitempty"`
	// Roi ROI
	Roi float64 `json:"roi,omitempty"`
	// T0Roi 当日累计 ROI
	T0Roi float64 `json:"t0Roi,omitempty"`
	// T1Roi 投后 1 日累计 ROI
	T1Roi float64 `json:"t1Roi,omitempty"`
	// T3Roi 投后 3 日累计 ROI
	T3Roi float64 `json:"t3Roi,omitempty"`
	// T7Roi 投后 7 日累计 ROI
	T7Roi float64 `json:"t7Roi,omitempty"`
	// T15Roi 投后 15 日累计 ROI
	T15Roi float64 `json:"t15Roi,omitempty"`
	// T30Roi 投后 30 日累计 ROI
	T30Roi float64 `json:"t30Roi,omitempty"`
	// T7Retention 投后 7 日涨粉留存量
	T7Retention int64 `json:"t7_retention,omitempty"`
	// T30Retention 投后 30 日涨粉留存量
	T30Retention int64 `json:"t30_retention,omitempty"`
	// T7RetentionRatio 投后 7 日涨粉留存率
	T7RetentionRatio float64 `json:"t7_retention_ratio,omitempty"`
	// T30RetentionRatio 投后 30 日涨粉留存率
	T30RetentionRatio float64 `json:"t30_retention_ratio,omitempty"`
	// T0OrderCnt 当日累计订单成交量
	T0OrderCnt int64 `json:"t0_order_cnt,omitempty"`
	// T1OrderCnt 投后 1 日累计订单成交量
	T1OrderCnt int64 `json:"t1_order_cnt,omitempty"`
	// T30OrderCnt 投后 3 日累计订单成交量
	T3OrderCnt int64 `json:"t3_order_cnt,omitempty"`
	// T7OrderCnt 投后 7 日累计订单成交量
	T7OrderCnt int64 `json:"t7_order_cnt,omitempty"`
	// T15OrderCnt 投后 15 日累计订单成交量
	T15OrderCnt int64 `json:"t15_order_cnt,omitempty"`
	// T30OrderCnt 投后 30 日累计订单成交量
	T30OrderCnt int64 `json:"t30_order_cnt,omitempty"`
}

MerchantStat 小店通转化数据

type ProgramCreativeReportRequest 

type ProgramCreativeReportRequest struct {
	ReportRequest
	CampaignIDs []uint64 `json:"campaign_ids,omitempty"` // CampaignIDs 广告计划ID集，过滤筛选条件，单次查询数量不超过5000
	UnitIDs     []uint64 `json:"unit_ids,omitempty"`     // UnitIDs 广告组ID集，过滤筛选条件，单次查询数量不超过5000
}

ProgramCreativeReportRequest 程序化创意数据APIRequest

func (ProgramCreativeReportRequest) Encode 

func (r ProgramCreativeReportRequest) Encode() []byte

Encode implement PostRequest interface

func (ProgramCreativeReportRequest) Url 

func (r ProgramCreativeReportRequest) Url() string

Url implement PostRequest interface

type QueryWordReportRequest 

type QueryWordReportRequest struct {
	ReportRequest
	// UnitID 广告组 ID，过滤筛选条件。不可同时筛选unit_id和word_info_ids
	UnitID uint64 `json:"unit_id,omitempty"`
	// UnitIDs 广告组 ID 集，过滤筛选条件，单次查询数量不超过 5000
	UnitIDs []uint64 `json:"unit_ids,omitempty"`
	// WordInfoIDs 推广关键词ID集，过滤筛选条件，单次查询数量不超过 5000。推广关键词ID集可通过获取关键词列表接口获取
	WordInfoIDs []uint64 `json:"word_ids,omitempty"`
	// Query 搜索词，过滤筛选条件，单次查询数量不超过5000
	Query string `json:"query,omitempty"`
	// ExtendInfo 	扩展查询选项,输入extendSearch可以查询智能扩词数据
	ExtendInfo []string `json:"extend_info,omitempty"`
}

QueryWordReportRequest 搜索词报表 API Request

func (QueryWordReportRequest) Encode 

func (r QueryWordReportRequest) Encode() []byte

Encode implement PostRequest interface

func (QueryWordReportRequest) Url 

func (r QueryWordReportRequest) Url() string

Url implement PostRequest interface

type ReportCostResponse 

type ReportCostResponse struct {
	// Total 数据的总行数
	Total int `json:"total_count,omitempty"`
	// Details 数据明细信息
	List []Cost `json:"data,omitempty"`
}

ReportCostResponse 数据报表APIResponse公用数据

type ReportRequest 

type ReportRequest struct {
	// AdvertiserID 广告主ID（注：非账户快手ID），在获取accessToken时返回
	AccountId uint64 `json:"accountId,omitempty"`
	// StartDateMin 起始时间 请求时间戳请使用毫秒 标准UTC时间戳 sample:1632873600000
	DataBeginTime int64 `json:"dataBeginTime,omitempty"`
	// EndDateMin 结束日期 请求时间戳请使用毫秒，标准UTC时间戳
	DataEndTime int64 `json:"dataEndTime,omitempty"`
	// TemporalGranularity 天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据 时间粒度。3:按天（daily）/ 2:小时粒度（hourly）。默认按天
	TemporalGranularity TemporalGranularityType `json:"granularity,omitempty"`

	TimeZoneIana string `json:"timeZoneIana,omitempty"` // UTC-5 ，UTC-4 ，UTC-3 ，UTC+0 ，UTC+1 ，UTC+2 ，UTC+3 ，UTC+5 ，UTC+6 ，UTC+7 ，UTC+8

	// PageNo 请求的页码，默认为 1
	PageNo int `json:"pageNo,omitempty"`
	// PageSize 每页行数，默认20，支持范围1-500
	PageSize int `json:"pageSize,omitempty"`
}

ReportRequest 数据报表APIRequest公用数据

type ReportResponse 

type ReportResponse struct {
	// Total 数据的总行数
	Total int `json:"total,omitempty"`
	// Details 数据明细信息
	List []Stat `json:"data,omitempty"`
}

ReportResponse 数据报表APIResponse公用数据

type Stat 

type Stat struct {
	// 基础信息
	Time         int64  `json:"time"`         // 时间戳
	AccountID    int64  `json:"accountId"`    // 广告账户ID
	AccountName  string `json:"accountName"`  // 广告账户名称
	CampaignID   int64  `json:"campaignId"`   // 广告计划ID
	CampaignName string `json:"campaignName"` // 广告计划名称
	UnitId       int64  `json:"unitId"`       // 广告组ID
	UnitName     string `json:"unitName"`     // 广告组名称

	CreativeId   int    `json:"creativeId"`   // 广告创意ID
	CreativeName string `json:"creativeName"` // 广告创意名称

	ID int64 `json:"id"` // 主ID(与campaignId,unitId,creativeId相同)

	// 核心指标
	Cost     int64 `json:"cost"`     // 消耗，单位：账户币种的1/1000000 规则监控需要
	Exposure int   `json:"exposure"` // 展现数
	Click    int   `json:"click"`    // 点击数
	Action   int   `json:"action"`   // 转化数

	// 效果指标
	Cpm float64 `json:"cpm"` // 千次曝光消耗(CPM)
	Cpc float64 `json:"cpc"` // 单次点击成本(CPC)
	Ctr float64 `json:"ctr"` // 点击率(CTR)
	Cvr float64 `json:"cvr"` // 转化率(CVR)
	Cpa float64 `json:"cpa"` // 平均转化成本(CPA)  规则监控需要

	// 视频播放指标
	Play3s       int `json:"play3s"`       // 3秒播放数
	Play5s       int `json:"play5s"`       // 5秒播放数
	PlayFinished int `json:"playFinished"` // 完播数

	// 注册相关指标
	Registration        int     `json:"registration"`        // 注册数
	CostPerRegistration float64 `json:"costPerRegistration"` // 注册转化成本
	RegistrationRate    float64 `json:"registrationRate"`    // 注册转化率

	// 购物车相关指标
	AddToCart        int     `json:"addToCart"`        // 加入购物车数
	CostPerAddToCart float64 `json:"costPerAddToCart"` // 加入购物车转化成本
	AddToCartRate    float64 `json:"addToCartRate"`    // 加入购物车转化率

	// 应用启动相关指标
	AppLaunch        int     `json:"appLaunch"`        // 唤端数
	CostPerAppLaunch float64 `json:"costPerAppLaunch"` // 唤端转化成本
	AppLaunchRate    float64 `json:"appLaunchRate"`    // 唤端转化率

	// 激活相关指标
	Activation        int     `json:"activation"`        // 激活数
	CostPerActivation float64 `json:"costPerActivation"` // 激活转化成本 规则监控需要
	ActivationRate    float64 `json:"activationRate"`    // 激活转化率

	// 页面浏览相关指标
	PageView        int     `json:"pageView"`        // 页面浏览数
	CostPerPageView float64 `json:"costPerPageView"` // 页面浏览转化成本
	PageViewRate    float64 `json:"pageViewRate"`    // 页面浏览转化率

	//去重付费数（转化时间）
	UniquePurchase float64 `json:"uniquePurchase"`
	//去重付费数（转化时间）
	CostUniquePurchase float64 `json:"CostUniquePurchase"`
	//去重付费率（转化时间）规则监控需要
	UniquePurchaseRate float64 `json:"uniquePurchaseRate"`
	//去重关键行为数（转化时间）
	UniqueKeyInAppAction int `json:"uniqueKeyInAppAction"`
	//去重关键行为成本（转化时间） 规则监控需要
	CostUniqueKeyInAppAction float64 `json:"costUniqueKeyInAppAction"`
}

Stat 包含广告数据的详细指标

type TemporalGranularityType 

type TemporalGranularityType string

TemporalGranularityType 时间粒度 

const (
	// TemporalGranularityType_DAILY 天粒度
	TemporalGranularityType_DAILY TemporalGranularityType = "DAY"
	// TemporalGranularityType_HOURLY 小时粒度
	TemporalGranularityType_HOURLY TemporalGranularityType = "HOURLY"
)

type UnitReportRequest 

type UnitReportRequest struct {
	ReportRequest
	// CampaignIDs 广告计划ID集，过滤筛选条件，单次查询数量不超过5000
	CampaignIDs []uint64 `json:"campaignIds,omitempty"`
	// UnitIDs 广告组ID集，过滤筛选条件，单次查询数量不超过5000
	UnitIDs []uint64 `json:"unitIds,omitempty"`
}

UnitReportRequest 广告单元数据APIRequest

func (UnitReportRequest) Encode 

func (r UnitReportRequest) Encode() []byte

Encode implement PostRequest interface

func (UnitReportRequest) Url 

func (r UnitReportRequest) Url() string

Url implement PostRequest interface

type WordInfoReportRequest 

type WordInfoReportRequest struct {
	ReportRequest
	// UnitID 广告组 ID，过滤筛选条件。不可同时筛选unit_id和word_info_ids
	UnitID uint64 `json:"unit_id,omitempty"`
	// UnitIDs 广告组 ID 集，过滤筛选条件，单次查询数量不超过 5000
	UnitIDs []uint64 `json:"unit_ids,omitempty"`
	// WordInfoIDs 推广关键词ID集，过滤筛选条件，单次查询数量不超过 5000。推广关键词ID集可通过获取关键词列表接口获取
	WordInfoIDs []uint64 `json:"word_ids,omitempty"`
	// ExtendInfo 	扩展查询选项,输入extendSearch可以查询智能扩词数据
	ExtendInfo []string `json:"extend_info,omitempty"`
}

WordInfoReportRequest 关键词报表 API Request

func (WordInfoReportRequest) Encode 

func (r WordInfoReportRequest) Encode() []byte

Encode implement PostRequest interface

func (WordInfoReportRequest) Url 

func (r WordInfoReportRequest) Url() string

Url implement PostRequest interface

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.