v3

Documentation

Overview

Package v3 体验版数据报表

Index

• type CustomGetFilter
• type CustomGetListItem
• type CustomGetRequest
  • func (r CustomGetRequest) Encode() string
• type CustomGetResponse
• type CustomGetResult
• type Dimensions
• type Material
• type MaterialGetFilter
• type MaterialGetListItem
• type MaterialGetRequest
  • func (r MaterialGetRequest) Encode() string
• type MaterialGetResponse
• type MaterialGetResult
• type Metrics
• type OrderBy
• type ProjectGetFilter
• type ProjectGetListItem
• type ProjectGetRequest
  • func (r ProjectGetRequest) Encode() string
• type ProjectGetResponse
• type ProjectGetResult
• type PromotionGetFilter
• type PromotionGetListItem
• type PromotionGetRequest
  • func (r PromotionGetRequest) Encode() string
• type PromotionGetResponse
• type PromotionGetResult
• type Stat

Types

type CustomGetFilter

type CustomGetFilter struct {
	// Field 过滤的消耗指标字段
	Field string `json:"field,omitempty"`
	// Type 字段类型。允许值：
	// 1 -固定枚举值
	// 2 - 固定输入值
	// 3 -数值类型
	Type int `json:"type,omitempty"`
	// Operator 处理方式。 允许值：
	// 1 -等于
	// 2 -小于
	// 3 -小于等于
	// 4 -大于
	// 5 -大于等于
	// 6 -不等于
	// 7-包含
	// 8 -不包含
	// 9 -范围查询
	// 10 -多个值匹配包含
	// 11 -多个值匹配都要包含
	Operator int `json:"operator,omitempty"`
	// Values 过滤字段具体值
	Values []string `json:"values,omitempty"`
}

CustomGetFilter 数据报表过滤条件

type CustomGetListItem

type CustomGetListItem struct {
	// Metrics 指标数据
	Metrics *Metrics `json:"metrics,omitempty"`
	// Dimensions 维度数据
	Dimensions *Dimensions `json:"dimensions,omitempty"`
}

CustomGetListItem 数据详情

type CustomGetRequest

type CustomGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Dimensions 维度列表。获取方式：巨量引擎体验版—>报表—>新建/编辑自定义报表—>API参数生成。该字段从前端自定义报表中获取，建议不要修改。
	Dimensions []string `json:"dimensions,omitempty"`
	// Metrics 指标列表 。获取方式：巨量引擎体验版—>报表—>新建/编辑自定义报表—>API参数生成。该字段从前端自定义报表中获取，建议不要修改。
	Metrics []string `json:"metrics,omitempty"`
	// StartTime 起始日期,格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期
	StartTime time.Time `json:"start_time,omitempty"`
	// EndTime 结束日期,格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期，时间跨度不能超过30天
	EndTime time.Time `json:"end_time,omitempty"`
	// OrderBy 排序
	OrderBy []OrderBy `json:"order_by,omitempty"`
	// Page 页码；默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小，即每页展示的数据量；默认值: 20；取值范围: 1-1000
	PageSize int `json:"page_size,omitempty"`
	// Filters 过滤字段，json格式，支持字段如下
	Filters []CustomGetFilter `json:"filters,omitempty"`
}

CustomGetRequest 自定义报表 API Request

func (CustomGetRequest) Encode

func (r CustomGetRequest) Encode() string

Encode implement GetRequest interface

type CustomGetResponse

type CustomGetResponse struct {
	model.BaseResponse
	// Data json返回值
	Data *CustomGetResult `json:"data,omitempty"`
}

CustomGetResponse 自定义数据报表 API Response

type CustomGetResult

type CustomGetResult struct {
	// Rows 数据列表
	Rows []CustomGetListItem `json:"rows,omitempty"`
	// TotalMetrics 指标汇总数据
	TotalMetrics *Metrics `json:"total_metrics,omitempty"`
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
}

CustomGetResult 返回值

type Dimensions

type Dimensions struct {
	// ProjectID 项目ID，分组条件包含 STAT_GROUP_BY_APP_PROJECT_ID 时返回
	ProjectID uint64 `json:"project_id,omitempty"`
	// PromotionID 广告ID，分组条件包含 STAT_GROUP_BY_APP_PROMOTION_ID 时返回
	PromotionID uint64 `json:"promotion_id,omitempty"`
	// StatTimeHour 细分到每个小时的数据
	StatTimeHour int `json:"stat_time_hour,omitempty"`
	// StatTimeDay 细分到自然天的数据
	StatTimeDay int `json:"stat_time_day,omitempty"`
	// StatTimeWeek 细分到自然周的数据，周一到周日为一整周
	StatTimeWeek int `json:"stat_time_week,omitempty"`
	// StatTimeMonth 细分到自然月的数据，例如2022-3，表示是3月1日到3月31日
	StatTimeMonth time.Month `json:"stat_time_month,omitempty"`
	// CdpProjectID 项目ID
	CdpProjectID uint64 `json:"cdp_project_id,omitempty"`
	// CdpProjectName 项目的名称
	CdpProjectName string `json:"cdp_project_name,omitempty"`
	// LandingType 对应项目的推广目的
	LandingType string `json:"landing_type,omitempty"`
	// ExternalAction 对应项目的转化目标
	ExternalAction string `json:"external_action,omitempty"`
	// Pricing 对应项目的计费类型
	Pricing int `json:"pricing,omitempty"`
	// DeepExternalAction 对应项目的深度转化目标
	DeepExternalAction int `json:"deep_external_action,omitempty"`
	// AdPlatformCdpProjectDownloadType 在项目中设置的下载方式
	AdPlatformCdpProjectDownloadType int `json:"ad_platform_cdp_project_download_type,omitempty"`
	// AdPlatformCdpProjectDownloadURL 在项目中设置的下载链接
	AdPlatformCdpProjectDownloadURL string `json:"ad_platform_cdp_project_download_url,omitempty"`
	// AdPlatformCdpProjectDownloadActionTrackURL 在项目中设置的监测链接
	AdPlatformCdpProjectDownloadActionTrackURL string `json:"ad_platform_cdp_project_action_track_url,omitempty"`
	// CdpPromotionID 广告ID
	CdpPromotionID uint64 `json:"cdp_promotion_id,omitempty"`
	// CdpPromotionName 对应广告的名称
	CdpPromotionName string `json:"cdp_promotion_name,omitempty"`
	// AdPlatformCdpPromotionBid 在广告中设置的出价
	AdPlatformCdpPromotionBid float64 `json:"ad_platform_cdp_promotion_bid,omitempty"`
	// AdPlatformCdpPromotionDeepCpaBid 在广告中设置的深度转化出价
	AdPlatformCdpPromotionDeepCpaBid float64 `json:"ad_platform_cdp_promotion_roi_goal,omitempty"`
	// AppCode 您所投放的广告数据中，对应的首选广告位
	AppCode int `json:"app_code,omitempty"`
	// PackageName 您在项目中设置的应用包包名
	PackageName string `json:"package_name,omitempty"`
	// Gender 您所投放的广告数据中，对应的用户性别。无法识别的性别数据会显示为“其他”
	Gender int `json:"gender,omitempty"`
	// Age 您所投放的广告数据中，对应的用户年龄。无法识别的年龄数据会显示为“其他”
	Age string `json:"age,omitempty"`
	// Ac 您所投放的广告数据中，对应的用户网络环境。无法识别的网络数据会显示为“其他”
	Ac int `json:"ac,omitempty"`
	// Platform 您所投放的广告数据，对应的操作系统平台，无法识别的操作系统会显示为“其他”
	Platform string `json:"platform,omitempty"`
	// ProvinceName 您所投放的广告数据，对应的用户省份信息
	ProvinceName string `json:"province_name,omitempty"`
	// CityName 您所投放的广告数据，对应的用户城市信息
	CityName string `json:"city_name,omitempty"`
	// MaterialID 素材的ID
	MaterialID uint64 `json:"material_id,omitempty"`
	// AdPlatformMaterialContent 对应的素材标题、视频及图片内容
	AdPlatformMaterialContent string `json:"ad_platform_material_content,omitempty"`
	// ImageMode 对应的素材类型，包括标题、大图横图、竖版视频等
	ImageMode int `json:"image_mode,omitempty"`
	// AdPlatformMaterialName 素材为视频素材时，对应的视频名称
	AdPlatformMaterialName string `json:"ad_platform_material_name,omitempty"`
}

Dimensions 维度数据

type Material

type Material struct {
	// Mid 素材id
	Mid uint64 `json:"mid,omitempty"`
	// ImageMode 视频素材类型，允许值：CREATIVE_IMAGE_MODE_VIDEO 横版视频、CREATIVE_IMAGE_MODE_VIDEO_VERTICAL 竖版视频
	ImageMode []enum.ImageMode `json:"image_mode,omitempty"`
	// AppCode 首选位置，允许值：
	// 西瓜视频[1]
	// 抖音火山版:[3]
	// 抖音短视频[4]
	// 今日头条:[8]
	// 番茄小说:[26]
	// 穿山甲:[9]
	// Ohayoo精品游戏:[27]
	AppCode []int `json:"app_code"`
}

Material 素材信息

type MaterialGetFilter

type MaterialGetFilter struct {
	// ProjectID 项目ID，最多入参100个
	ProjectID []uint64 `json:"project_id,omitempty"`
	// PromotionID 广告ID，按照promotion_id过滤，最多支持100个
	PromotionID []uint64 `json:"promotion_id,omitempty"`
	// VideoMaterial 视频素材信息
	VideoMaterial *Material `json:"video_material,omitempty"`
	// ImageMaterial 图片素材信息
	ImageMaterial *Material `json:"image_material,omitempty"`
	// TitleMaterial 标题素材信息
	TitleMaterial *Material `json:"title_material,omitempty"`
	// DeliveryMode 投放模式筛选。允许值: MANUAL 手动、PROCEDURAL 自动
	DeliveryMode []string `json:"delivery_mode,omitempty"`
}

MaterialGetFilter 数据报表过滤条件

type MaterialGetListItem

type MaterialGetListItem struct {
	// MaterialID 素材ID
	MaterialID uint64 `json:"material_id,omitempty"`
	// ImageMode 素材类型
	ImageMode string `json:"image_mode,omitempty"`
	// StatDateTime 数据时间
	StatDateTIme string `json:"stat_datetime,omitempty"`
	// Data
	Data []Stat `json:"data,omitempty"`
}

MaterialGetListItem 数据详情

type MaterialGetRequest

type MaterialGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// StartDate 起始日期,格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期
	StartDate time.Time `json:"start_date,omitempty"`
	// EndDate 结束日期,格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期，时间跨度不能超过30天
	EndDate time.Time `json:"end_date,omitempty"`
	// Fields 指定需要的指标名称
	Fields []string `json:"fields,omitempty"`
	// GroupBy 分组条件默认为 STAT_GROUP_BY_FIELD_STAT_TIME
	GroupBy enum.StatGroupBy `json:"group_by,omitempty"`
	// TimeGranularity 时间粒度, 默认值: STAT_TIME_GRANULARITY_DAILY
	TimeGranularity enum.StatTimeGranularity `json:"time_granularity,omitempty"`
	// OrderField 排序字段，所有的统计指标均可参与排序
	OrderField string `json:"order_field,omitempty"`
	// OrderType 排序方式；默认值: DESC；允许值: ASC, DESC
	OrderType enum.OrderType `json:"order_type,omitempty"`
	// Page 页码；默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小，即每页展示的数据量；默认值: 20；取值范围: 1-1000
	PageSize int `json:"page_size,omitempty"`
	// Filtering 过滤字段，json格式，支持字段如下
	Filtering *MaterialGetFilter `json:"filtering,omitempty"`
}

MaterialGetRequest 素材数据报表 API Request

func (MaterialGetRequest) Encode

func (r MaterialGetRequest) Encode() string

Encode implement GetRequest interface

type MaterialGetResponse

type MaterialGetResponse struct {
	model.BaseResponse
	// Data json返回值
	Data *MaterialGetResult `json:"data,omitempty"`
}

MaterialGetResponse 素材数据报表 API Response

type MaterialGetResult

type MaterialGetResult struct {
	// List 数据列表
	List []MaterialGetListItem `json:"list,omitempty"`
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
}

MaterialGetResult 返回值

type Metrics

type Metrics struct {
	// StatCost 表示广告在投放期内的预估花费金额。当天数据可能会有波动，次日稳定
	StatCost float64 `json:"stat_cost,omitempty"`
	// ShowCnt 广告展示给用户的次数。计算方式：经平台判定有效且被计费的展示次数。
	ShowCnt int64 `json:"show_cnt,omitempty"`
	// CpmPlatform 广告平均每一千次展现所付出的费用，计算公式是：总花费/展示数*1000。
	CpmPlatform float64 `json:"cpm_platform,omitempty"`
	// ClickCnt 当头条用户点击广告素材时，触发点击事件，该事件被认为是一次有效的广告点击。
	ClickCnt int64 `json:"click_cnt,omitempty"`
	// Ctr 广告被点击的次数占展示次数的百分比。计算方法：点击数/展示数*100%
	Ctr float64 `json:"ctr,omitempty"`
	// CpcPlatform 广告主为每次点击付出的费用成本，计算公式是：总花费/点击数。
	CpcPlatform float64 `json:"cpc_platform,omitempty"`
	// ClickStartCnt 用户在落地页中开始安装包下载进程的次数，仅安卓下载可以监测到该行为
	ClickStartCnt int64 `json:"click_start_cnt,omitempty"`
	// ClickStartCost 计算方法：总花费/安卓下载开始数。
	ClickStartCost float64 `json:"click_start_cost,omitempty"`
	// ClickStartRate 计算方法：安卓下载开始数/点击数
	ClickStartRate float64 `json:"click_start_rate,omitempty"`
	// DownloadFinishCnt 用户在落地页中下载安装包进程完成的次数，仅安卓下载可以监测到该行为
	DownloadFinishCnt int64 `json:"download_finish_cnt,omitempty"`
	// DownloadFinishCost 计算方式：总花费/安卓下载完成数。
	DownloadFinishCost float64 `json:"download_finish_cost,omitempty"`
	// DownloadFinishRate 计算方式：安卓下载完成数/安卓下载开始数
	DownloadFinishRate float64 `json:"download_finish_rate,omitempty"`
	// InstallFinishCnt 用户在落地页中将安装包安装完成的次数，仅安卓下载可以监测到该行为。如果您的计划开启了商店直投，则下载相关行为数据有部分无法被监测到，而安装数据不受影响，因此安装数可能会大于下载数。
	InstallFinishCnt int64 `json:"install_finish_cnt,omitempty"`
	// InstallFinishCost 计算方式：总花费/安卓安装完成数
	InstallFinishCost float64 `json:"install_finish_cost,omitempty"`
	// InstallFinishRate 计算方式：安卓安装完成数/安卓下载完成数
	InstallFinishRate float64 `json:"install_finish_rate,omitempty"`
	// Active 如果您对接了API，激活数是您认可且回传成功的的激活数。如果您对接了SDK，则激活数是指用户下载您的APP后打开的次数。
	Active int64 `json:"active,omitempty"`
	// ActiveCost 计算方式：总花费/激活数。
	ActiveCost float64 `json:"active_cost,omitempty"`
	// ActiveRate 计算方式：激活数/点击数*100%
	ActiveRate float64 `json:"active_rate,omitempty"`
	// ActiveRegister 如果您对接了API，注册数是您认可且回传成功的的注册数。如果您对接了SDK，则注册数是用户实现注册行为的次数，详情见「SDK对接文档」
	ActiveRegister int64 `json:"active_register,omitempty"`
	// ActiveRegisterCost 广告主为每个注册所付出的成本，计算公式是：总花费/注册数，当天数据可能会有波动，次日早8点后稳定。
	ActiveRegisterCost float64 `json:"active_register_cost,omitempty"`
	// ActiveRegisterRate 注册用户占激活用户的比例
	ActiveRegisterRate float64 `json:"active_register_rate,omitempty"`
	// GameAddiction 有APP内关键行为的用户数量
	GameAddiction int64 `json:"game_addiction,omitempty"`
	// GameAddictionCost 广告主为每个有APP内关键行为的用户所付出的成本，计算公式是总花费/关键行为数。当天数据可能会有波动，次日早8点后稳定。
	GameAddictionCost float64 `json:"game_addiction_cost,omitempty"`
	// GameAddictionRate 关键行为用户占激活用户的比例
	GameAddictionRate float64 `json:"game_addiction_rate,omitempty"`
	// AttributionNextDayOpenCnt 当日激活用户在第二天继续登录，则计为一个次留行为。该指标会将收到的次留回传数据，匹配到对应的激活时间上。 例如：8月1日有10个激活，其中5个在8月2日继续登录，则8月1日的次留数为5。
	AttributionNextDayOpenCnt int64 `json:"attribution_next_day_open_cnt,omitempty"`
	// AttributionNextDayOpenCost 次留成本=消耗/次留数
	AttributionNextDayOpenCost float64 `json:"attribution_next_day_open_cost,omitempty"`
	// AttributionNextDayOpenRate 次留率=次留数/激活数
	AttributionNextDayOpenRate float64 `json:"attribution_next_day_open_rate,omitempty"`
	// NextDayOpen 根据您通过api或sdk回传给我们的时间为准，将次留数披露在回传时间。
	NextDayOpen int64 `json:"next_day_open,omitempty"`
	// ActivePay 用户在应用内首次完成付费的次数
	ActivePay int64 `json:"active_pay,omitempty"`
	// ActivePayCost 用户在应用内首次完成付费的成本，计算方式：消耗/首次付费数。
	ActivePayCost float64 `json:"active_pay_cost,omitempty"`
	// ActivePayRate 计算方式：首次付费数/激活数。
	ActivePayRate float64 `json:"active_pay_rate,omitempty"`
	// GamePayCount 当天用户在应用内完成付费的总次数，多次付费会重复计数。
	GamePayCount int64 `json:"game_pay_count,omitempty"`
	// GamePayCost 当天用户在应用内完成付费的平均成本，计算方式：消耗/付费次数。
	GamePayCost float64 `json:"game_pay_cost,omitempty"`
	// AttributionGamePay7dCount 用户激活应用后的7天内，在应用内完成付费的总次数，并将付费次数披露在每个用户的激活时间上。
	AttributionGamePay7dCount int64 `json:"attribution_game_pay_7d_count,omitempty"`
	// AttributionGamePay7dCost 用户激活应用后的7天内，在应用内完成付费的平均成本，计算方式：消耗/7日付费次数(激活时间)。
	AttributionGamePay7dCost float64 `json:"attribution_game_pay_7d_cost,omitempty"`
	// AttributionGamePay7dPerCount 7天内用户的平均付费次数，计算方式：7日付费次数（激活时间）/7日首次付费数(激活时间)，对首次付费数的统计仅在计划内去重且披露在每个用户的激活时间上。
	AttributionGamePay7dPerCount float64 `json:"attribution_active_pay_7d_per_count,omitempty"`
	// InAppUv 用户调起APP后到达的次数，一般在DPA广告中使用
	InAppUv int64 `json:"in_app_uv,omitempty"`
	// InAppDetailUv 用户调起APP后到达指定详情页的次数，一般在DPA广告中使用
	InAppDetailUv int64 `json:"in_app_detail_uv,omitempty"`
	// InAppCart 用户调起APP后加入购物车的次数，一般在DPA广告中使用
	InAppCart int64 `json:"in_app_cart,omitempty"`
	// InAppPay 用户调起APP后完成付费的次数，一般在DPA广告中使用
	InAppPay int64 `json:"in_app_pay,omitempty"`
	// InAppOrder 用户调起APP后提交订单的次数，一般在DPA广告中使用
	InAppOrder int64 `json:"in_app_order,omitempty"`
	// AttributionGameInAppLtv1Day 所选时间范围内的激活用户，激活当日在APP内的付费金额。
	AttributionGameInAppLtv1Day float64 `json:"attribution_game_in_app_ltv_1day,omitempty"`
	// AttributionGameInAppLtv2Days 所选时间范围内的激活用户，激活后一天内在APP内的付费金额总和。该指标隔日产出，并做了模糊化处理。
	AttributionGameInAppLtv2Days float64 `json:"attribution_game_in_app_ltv_2days,omitempty"`
	// AttributionGameInAppLtv3Days 所选时间范围内的激活用户，激活后二天内在APP内的付费金额总和。该指标隔日产出，并做了模糊化处理。
	AttributionGameInAppLtv3Days float64 `json:"attribution_game_in_app_ltv_3days,omitempty"`
	// AttributionGameInAppLtv4Days 所选时间范围内的激活用户，激活后三天内在APP内的付费金额总和。该指标隔日产出，并做了模糊化处理。
	AttributionGameInAppLtv4Days float64 `json:"attribution_game_in_app_ltv_4days,omitempty"`
	// AttributionGameInAppLtv5Days 所选时间范围内的激活用户，激活后四天内在APP内的付费金额总和。该指标隔日产出，并做了模糊化处理。
	AttributionGameInAppLtv5Days float64 `json:"attribution_game_in_app_ltv_5days,omitempty"`
	// AttributionGameInAppLtv6Days 所选时间范围内的激活用户，激活后五天内在APP内的付费金额总和。该指标隔日产出，并做了模糊化处理。
	AttributionGameInAppLtv6Days float64 `json:"attribution_game_in_app_ltv_6days,omitempty"`
	// AttributionGameInAppLtv7Days 所选时间范围内的激活用户，激活后六天内在APP内的付费金额总和。该指标隔日产出，并做了模糊化处理。
	AttributionGameInAppLtv7Days float64 `json:"attribution_game_in_app_ltv_7days,omitempty"`
	// AttributionGameInAppLtv8Days 所选时间范围内的激活用户，激活后七天内在APP内的付费金额总和。该指标隔日产出，并做了模糊化处理。
	AttributionGameInAppLtv8Days float64 `json:"attribution_game_in_app_ltv_8days,omitempty"`
	// AttributionGameInAppRoi1Day 所选时间范围内的激活用户在激活当日的付费ROI，计算公式是：当日付费金额/所选时间的消耗。
	AttributionGameInAppRoi1Day float64 `json:"attribution_game_in_app_roi_1day,omitempty"`
	// AttributionGameInAppRoi2Days 所选时间范围内的激活用户在激活后一日内的所有付费ROI，计算公式是：激活后一日付费金额/所选时间的消耗。该指标隔日产出，并做了模糊化处理。
	AttributionGameInAppRoi2Days float64 `json:"attribution_game_in_app_roi_2days,omitempty"`
	// AttributionGameInAppRoi3Days 所选时间范围内的激活用户在激活后二日内的所有付费ROI，计算公式是：激活后二日付费金额/所选时间的消耗。
	AttributionGameInAppRoi3Days float64 `json:"attribution_game_in_app_roi_3days,omitempty"`
	// AttributionGameInAppRoi4Days 所选时间范围内的激活用户在激活后三日内的所有付费ROI，计算公式是：激活后三日付费金额/所选时间的消耗。
	AttributionGameInAppRoi4Days float64 `json:"attribution_game_in_app_roi_4days,omitempty"`
	// AttributionGameInAppRoi5Days 所选时间范围内的激活用户在激活后四日内的所有付费ROI，计算公式是：激活后四日付费金额/所选时间的消耗。
	AttributionGameInAppRoi5Days float64 `json:"attribution_game_in_app_roi_5days,omitempty"`
	// AttributionGameInAppRoi6Days 所选时间范围内的激活用户在激活后五日内的所有付费ROI，计算公式是：激活后五日付费金额/所选时间的消耗。
	AttributionGameInAppRoi6Days float64 `json:"attribution_game_in_app_roi_6days,omitempty"`
	// AttributionGameInAppRoi7Days 所选时间范围内的激活用户在激活后六日内的所有付费ROI，计算公式是：激活后六日付费金额/所选时间的消耗。
	AttributionGameInAppRoi7Days float64 `json:"attribution_game_in_app_roi_7days,omitempty"`
	// AttributionGameInAppRoi8Days 所选时间范围内的激活用户在激活后七日内的整体付费ROI，计算公式是：激活后七日付费金额/所选时间的消耗。
	AttributionGameInAppRoi8Days float64 `json:"attribution_game_in_app_roi_8days,omitempty"`
	// AttributionDayActivePayCount 广告计费当日激活且首次付费的次数
	AttributionDayActivePayCount int64 `json:"attribution_day_acitve_pay_count,omitempty"`
	// AttributionDayActivePayCost 消耗/计费当日激活且首次付费数
	AttributionDayActivePayCost float64 `json:"attribution_day_active_pay_cost,omitempty"`
	// AttributionDayActivePayRate 计费当日激活且首次付费数/激活数
	AttributionDayActivePayRate float64 `json:"attribution_day_active_pay_rate,omitempty"`
	// ActivePayIntraDayCount 当日发生激活且首次付费的次数
	ActivePayIntroDayCount int64 `json:"active_pay_intra_day_count,omitempty"`
	// ActivePayIntraDayCost 消耗/激活当日首次付费数
	ActivePayIntroDayCost float64 `json:"active_pay_intra_day_cost,omitempty"`
	// ActivePayIntraDayRate 激活当日首次付费数/激活数
	ActivePayIntroDayRate float64 `json:"active_pay_intra_day_rate,omitempty"`
	// ConvertCnt 将转化数记录在转化事件发生的时间上。建议广告主考核成本时参考“转化数据（计费时间）”例如您的广告在早上8点进行了展示和点击，用户晚上19点发生了激活行为，我们会把激活数披露在晚上19点。
	ConvertCnt int64 `json:"convert_cnt,omitempty"`
	// ConversionCost 广告主为每个转化所付出的平均成本，计算方式：总花费/转化数。当天数据可能会有波动。
	ConversionCost float64 `json:"conversion_cost,omitempty"`
	// ConversionRate 广告被用户转化的次数占点击次数的百分比。计算方式：转化数/点击数*100%
	ConversionRate float64 `json:"conversion_rate,omitempty"`
	// DeepConvertCnt 将深度转化数记录在转化事件发生的时间上。建议广告主考核深度转化成本时参考“深度转化数（计费时间）”例如您的广告在早上8点进行了展示和点击，用户晚上19点发生了激活行为，我们会把激活数披露在晚上19点。
	DeepConvertCnt int64 `json:"deep_convert_cnt,omitempty"`
	// DeepConvertCost 广告主为每个深度转化所付出的平均成本，计算方法：总花费/深度转化数。当天数据可能会有波动，次日早8点后稳定。
	DeepConvertCost float64 `json:"deep_convert_cost,omitempty"`
	// DeepConvertRate 广告被用户进行深度转化的次数占转化次数的百分比。计算方式：深度转化数/转化数*100%
	DeepConvertRate float64 `json:"deep_convert_rate,omitempty"`
	// AttributionConvertCnt 在转化行为发生（或回传）之后，将转化行为回记到过去30天内的扣费（消耗产生）时间上。 例如：广告在8月20日展示给用户，此时广告花费10元，用户点击广告后于8月23日产生1笔购买，则8月23日这笔购买将会展示在8月20日，8月23日没有转化数。
	AttributionConvertCnt int64 `json:"attribution_convert_cnt,omitempty"`
	// AttributionConvertCost 转化成本(计费时间) = 消耗 / 转化数(计费时间)。例如：广告在8月20日展示给用户，此时广告花费10元，用户点击广告后，于8月23日产生2笔购买，则8月20日的转化成本（计费时间） = 5元（即10元除以2笔）。成本考核和系统赔付以该指标为准。
	AttributionConvertCost float64 `json:"attribution_convert_cost,omitempty"`
	// AttributionDeepConvertCnt 在转化行为发生（或回传）之后，将转化行为回记到过去30天内的扣费（消耗产生）时间上。 例如：广告在8月20日展示给用户，此时广告花费10元，用户点击广告后于8月23日产生1笔购买，则8月23日这笔购买将会展示在8月20日。
	AttributionDeepConvertCnt int64 `json:"attribution_deep_convert_cnt,omitempty"`
	// AttributionDeepConvertCost 是一个准确的深度转化成本评估指标。计算方式：消耗 / 深度转化数(计费时间)。例如：广告在8月20日展示给用户，此时广告花费10元，用户点击广告后，于 8 月 23 日产生2笔购买，则8月20日的深度转化成本（计费时间） = 5元（即10元除以2笔）。成本考核和系统赔付以该指标为准。
	AttributionDeepConvertCost float64 `json:"attribution_deep_convert_cost,omitempty"`
	// AttributionDeepConvertRate 深度转化数（计费时间）/转化数（计费时间）*100%
	AttributionDeepConvertRate float64 `json:"attribution_deep_convert_rate,omitempty"`
}

Metrics 指标数据

type OrderBy

type OrderBy struct {
	// Field 排序字段。字段必须在选中的metrics或dimensions中。其中metrics所有字段支持排序。dimensions是否排序请参考维度、指标说明。
	Field string `json:"field,omitempty"`
	// Type 排序方式；默认值: DESC；允许值: ASC, DESC
	Type enum.OrderType `json:"type,omitempty"`
}

OrderBy 排序

type ProjectGetFilter

type ProjectGetFilter struct {
	// ProjectID 项目ID，按照project_id过滤，最多支持100个
	ProjectID []uint64 `json:"project_id,omitempty"`
	// LandingType 推广目的，允许值：APP
	LandingType []enum.LandingType `json:"landing_type,omitempty"`
	// ExternalAction 转化目标，允许值：AD_CONVERT_TYPE_NOTIFY_DOWNLOAD
	// AD_CONVERT_TYPE_DOWNLOAD_FINISH
	// AD_CONVERT_TYPE_INSTALL_FINISH
	// AD_CONVERT_TYPE_ACTIVE
	// AD_CONVERT_TYPE_ACTIVE_REGISTER
	// AD_CONVERT_TYPE_GAME_ADDICTION
	// AD_CONVERT_TYPE_PAY
	ExternalAction []enum.AdConvertType `json:"external_action,omitempty"`
	// AppCode 首选位置，西瓜视频[1]
	// 抖音火山版:[3]
	// 抖音短视频[4]
	// 今日头条:[8]
	// 番茄小说:[26]
	// 穿山甲:[9]
	// Ohayoo精品游戏:[27]
	AppCode []int `json:"app_code,omitempty"`
	// Platform 平台，允许值：ANDROID 安卓、IOS 苹果、OTHER 其他
	Platform []enum.AudiencePlatform
	// PackageName 应用包名
	PackageName []string `json:"package_name,omitempty"`
	// DeliveryMode 投放模式筛选。允许值: MANUAL 手动、PROCEDURAL 自动
	DeliveryMode []string `json:"delivery_mode,omitempty"`
}

ProjectGetFilter 数据报表过滤条件

type ProjectGetListItem

type ProjectGetListItem struct {
	// ProjectID 项目ID
	ProjectID uint64 `json:"project_id,omitempty"`
	// ProjectName 项目名称
	ProjectName string `json:"project_name,omitempty"`
	// StatDateTime 数据时间
	StatDateTIme string `json:"stat_datetime,omitempty"`
	// Data
	Data []Stat `json:"data,omitempty"`
}

ProjectGetListItem 数据详情

type ProjectGetRequest

type ProjectGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// StartDate 起始日期,格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期
	StartDate time.Time `json:"start_date,omitempty"`
	// EndDate 结束日期,格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期，时间跨度不能超过30天
	EndDate time.Time `json:"end_date,omitempty"`
	// Fields 指定需要的指标名称
	Fields []string `json:"fields,omitempty"`
	// GroupBy 分组条件默认为 STAT_GROUP_BY_FIELD_STAT_TIME
	GroupBy enum.StatGroupBy `json:"group_by,omitempty"`
	// TimeGranularity 时间粒度, 默认值: STAT_TIME_GRANULARITY_DAILY
	TimeGranularity enum.StatTimeGranularity `json:"time_granularity,omitempty"`
	// OrderField 排序字段，所有的统计指标均可参与排序
	OrderField string `json:"order_field,omitempty"`
	// OrderType 排序方式；默认值: DESC；允许值: ASC, DESC
	OrderType enum.OrderType `json:"order_type,omitempty"`
	// Page 页码；默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小，即每页展示的数据量；默认值: 20；取值范围: 1-1000
	PageSize int `json:"page_size,omitempty"`
	// Filtering 过滤字段，json格式，支持字段如下
	Filtering *ProjectGetFilter `json:"filtering,omitempty"`
}

ProjectGetRequest 项目数据报表 API Request

func (ProjectGetRequest) Encode

func (r ProjectGetRequest) Encode() string

Encode implement GetRequest interface

type ProjectGetResponse

type ProjectGetResponse struct {
	model.BaseResponse
	// Data json返回值
	Data *ProjectGetResult `json:"data,omitempty"`
}

ProjectGetResponse 项目数据报表 API Response

type ProjectGetResult

type ProjectGetResult struct {
	// List 数据列表
	List []ProjectGetListItem `json:"list,omitempty"`
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
}

ProjectGetResult 返回值

type PromotionGetFilter

type PromotionGetFilter struct {
	// PromotionID 广告ID，按照promotion_id过滤，最多支持100个
	PromotionID []uint64 `json:"promotion_id,omitempty"`
	// LandingType 推广目的，允许值：APP
	LandingType []enum.LandingType `json:"landing_type,omitempty"`
	// ExternalAction 转化目标，允许值：AD_CONVERT_TYPE_NOTIFY_DOWNLOAD
	// AD_CONVERT_TYPE_DOWNLOAD_FINISH
	// AD_CONVERT_TYPE_INSTALL_FINISH
	// AD_CONVERT_TYPE_ACTIVE
	// AD_CONVERT_TYPE_ACTIVE_REGISTER
	// AD_CONVERT_TYPE_GAME_ADDICTION
	// AD_CONVERT_TYPE_PAY
	ExternalAction []enum.AdConvertType `json:"external_action,omitempty"`
	// AppCode 首选位置，西瓜视频[1]
	// 抖音火山版:[3]
	// 抖音短视频[4]
	// 今日头条:[8]
	// 番茄小说:[26]
	// 穿山甲:[9]
	// Ohayoo精品游戏:[27]
	AppCode []int `json:"app_code,omitempty"`
	// Platform 平台，允许值：ANDROID 安卓、IOS 苹果、OTHER 其他
	Platform []enum.AudiencePlatform
	// PackageName 应用包名
	PackageName []string `json:"package_name,omitempty"`
	// DeliveryMode 投放模式筛选。允许值: MANUAL 手动、PROCEDURAL 自动
	DeliveryMode []string `json:"delivery_mode,omitempty"`
}

PromotionGetFilter 数据报表过滤条件

type PromotionGetListItem

type PromotionGetListItem struct {
	// ProjectID 项目ID
	ProjectID uint64 `json:"project_id,omitempty"`
	// ProjectName 项目名称
	ProjectName string `json:"project_name,omitempty"`
	// PromotionID 广告ID
	PromotionID uint64 `json:"promotion_id,omitempty"`
	// PromotionName 广告名称
	PromotionName string `json:"promotion_name,omitempty"`
	// StatDateTime 数据时间
	StatDateTIme string `json:"stat_datetime,omitempty"`
	// Data
	Data []Stat `json:"data,omitempty"`
}

PromotionGetListItem 数据详情

type PromotionGetRequest

type PromotionGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// StartDate 起始日期,格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期
	StartDate time.Time `json:"start_date,omitempty"`
	// EndDate 结束日期,格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期，时间跨度不能超过30天
	EndDate time.Time `json:"end_date,omitempty"`
	// Fields 指定需要的指标名称
	Fields []string `json:"fields,omitempty"`
	// GroupBy 分组条件默认为 STAT_GROUP_BY_FIELD_STAT_TIME
	GroupBy []enum.StatGroupBy `json:"group_by,omitempty"`
	// TimeGranularity 时间粒度, 默认值: STAT_TIME_GRANULARITY_DAILY
	TimeGranularity enum.StatTimeGranularity `json:"time_granularity,omitempty"`
	// OrderField 排序字段，所有的统计指标均可参与排序
	OrderField string `json:"order_field,omitempty"`
	// OrderType 排序方式；默认值: DESC；允许值: ASC, DESC
	OrderType enum.OrderType `json:"order_type,omitempty"`
	// Page 页码；默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小，即每页展示的数据量；默认值: 20；取值范围: 1-1000
	PageSize int `json:"page_size,omitempty"`
	// Filtering 过滤字段，json格式，支持字段如下
	Filtering *PromotionGetFilter `json:"filtering,omitempty"`
}

PromotionGetRequest 广告数据报表 API Request

func (PromotionGetRequest) Encode

func (r PromotionGetRequest) Encode() string

Encode implement GetRequest interface

type PromotionGetResponse

type PromotionGetResponse struct {
	model.BaseResponse
	// Data json返回值
	Data *PromotionGetResult `json:"data,omitempty"`
}

PromotionGetResponse 广告数据报表 API Response

type PromotionGetResult

type PromotionGetResult struct {
	// List 数据列表
	List []PromotionGetListItem `json:"list,omitempty"`
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
}

PromotionGetResult 返回值

type Stat

type Stat struct {
	Dimensions
	Metrics
}