feat:UD报表-日报表数据查询接口
This commit is contained in:
parent
ac450c02f0
commit
1c29e4d492
|
|
@ -150,3 +150,20 @@ func (ability *Defaultability) TaobaoUnideskRtaUserAdvertiserGet(req *request.Ta
|
|||
err = util.HandleJsonResponse(jsonStr, &respStruct)
|
||||
return &respStruct, err
|
||||
}
|
||||
|
||||
/*
|
||||
UD报表-日报表数据查询接口
|
||||
*/
|
||||
func (ability *Defaultability) TaobaoUnideskRtaReportDailyGet(req *request.TaobaoUnideskRtaReportDailyGetRequest, accessToken string) (*response.TaobaoUnideskRtaReportDailyGetResponse, error) {
|
||||
if ability.Client == nil {
|
||||
return nil, errors.New("Defaultability topClient is nil")
|
||||
}
|
||||
var jsonStr, err = ability.Client.ExecuteWithSession("taobao.unidesk.rta.report.daily.get", req.ToMap(), req.ToFileMap(), accessToken)
|
||||
var respStruct = response.TaobaoUnideskRtaReportDailyGetResponse{}
|
||||
if err != nil {
|
||||
log.Println("taobaoUnideskRtaReportDailyGet error", err)
|
||||
return &respStruct, err
|
||||
}
|
||||
err = util.HandleJsonResponse(jsonStr, &respStruct)
|
||||
return &respStruct, err
|
||||
}
|
||||
|
|
|
|||
|
|
@ -0,0 +1,58 @@
|
|||
package domain
|
||||
|
||||
type ReportFilterTopQueryDTO struct {
|
||||
/*
|
||||
按照计划过滤
|
||||
*/
|
||||
AdgroupIds *[]int64 `json:"adgroup_ids,omitempty" required:"false"`
|
||||
/*
|
||||
转化效果周期，7：7天，15：15天
|
||||
*/
|
||||
Effect *int `json:"effect,omitempty" required:"false"`
|
||||
/*
|
||||
按照计划组过滤
|
||||
*/
|
||||
CampaignIds *[]int64 `json:"campaign_ids,omitempty" required:"false"`
|
||||
/*
|
||||
按照创意过滤
|
||||
*/
|
||||
CreativeIds *[]int64 `json:"creative_ids,omitempty" required:"false"`
|
||||
/*
|
||||
归因逻辑，1：点击效果，0：展示效果
|
||||
*/
|
||||
EffectType *int `json:"effect_type,omitempty" required:"false"`
|
||||
/*
|
||||
按照素材过滤，素材id从adgroup查询接口获取，素材组合报表只支持根据标题素材id筛选
|
||||
*/
|
||||
MaterialId *int `json:"material_id,omitempty" required:"false"`
|
||||
}
|
||||
|
||||
func (s *ReportFilterTopQueryDTO) SetAdgroupIds(v []int64) *ReportFilterTopQueryDTO {
|
||||
s.AdgroupIds = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportFilterTopQueryDTO) SetEffect(v int) *ReportFilterTopQueryDTO {
|
||||
s.Effect = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportFilterTopQueryDTO) SetCampaignIds(v []int64) *ReportFilterTopQueryDTO {
|
||||
s.CampaignIds = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportFilterTopQueryDTO) SetCreativeIds(v []int64) *ReportFilterTopQueryDTO {
|
||||
s.CreativeIds = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportFilterTopQueryDTO) SetEffectType(v int) *ReportFilterTopQueryDTO {
|
||||
s.EffectType = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportFilterTopQueryDTO) SetMaterialId(v int) *ReportFilterTopQueryDTO {
|
||||
s.MaterialId = &v
|
||||
return s
|
||||
}
|
||||
|
|
@ -0,0 +1,113 @@
|
|||
package domain
|
||||
|
||||
type ReportTopQueryDTO struct {
|
||||
/*
|
||||
排序字段
|
||||
*/
|
||||
OrderByField *string `json:"order_by_field,omitempty" required:"false" `
|
||||
|
||||
/*
|
||||
结束日期，只支持查询近7天的数据，格式yyyy-MM-dd
|
||||
*/
|
||||
EndDate *string `json:"end_date" required:"true"`
|
||||
|
||||
/*
|
||||
第几页
|
||||
*/
|
||||
PageNo *int `json:"page_no,omitempty" required:"false"`
|
||||
|
||||
/*
|
||||
排序方式，ASC：正序、DESC：倒序
|
||||
*/
|
||||
OrderByType *string `json:"order_by_type,omitempty" required:"false"`
|
||||
|
||||
/*
|
||||
每页多少条
|
||||
*/
|
||||
PageSize *int `json:"page_size,omitempty" required:"false"`
|
||||
|
||||
/*
|
||||
分组条件，素材分组仅头条2.0支持，STAT_GROUP_BY_ADVERTISER_ID：按照广告主分组，STAT_GROUP_BY_CAMPAIGN_ID：按照计划组分组，STAT_GROUP_BY_ADGROUP_ID：按照计划分组，STAT_GROUP_BY_CREATIVE_ID：按照创意分组，STAT_GROUP_BY_TIME_DAY：按照天分组，STAT_GROUP_BY_MATERIAL_ID：按照素材分组，STAT_GROUP_BY_MATERIAL_X_ADGROUP_ID：按照素材X计划分组，STAT_GROUP_BY_COMBINATION_MATERIAL_ID：按照素材组合分组，STAT_GROUP_BY_COMBINATION_MATERIALX_CAMPAIGN_ID：按照素材组合X项目分组
|
||||
*/
|
||||
GroupBy *[]string `json:"group_by" required:"true"`
|
||||
|
||||
/*
|
||||
需要返回的指标，不指定则返回默认指标
|
||||
*/
|
||||
Fields *[]string `json:"fields,omitempty" required:"false"`
|
||||
|
||||
/*
|
||||
过滤条件
|
||||
*/
|
||||
Filtering *ReportFilterTopQueryDTO `json:"filtering,omitempty" required:"false"`
|
||||
|
||||
/*
|
||||
开始日期，只支持查询近7天的数据，格式yyyy-MM-dd
|
||||
*/
|
||||
StartDate *string `json:"start_date" required:"true"`
|
||||
|
||||
/*
|
||||
广告主id
|
||||
*/
|
||||
AdvertiserId *int64 `json:"advertiser_id" required:"true"`
|
||||
|
||||
/*
|
||||
平台版本，9999：升级版API（仅巨量2.0API需传入）
|
||||
*/
|
||||
Version *int `json:"version,omitempty" required:"false"`
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetOrderByField(v string) *ReportTopQueryDTO {
|
||||
s.OrderByField = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetEndDate(v string) *ReportTopQueryDTO {
|
||||
s.EndDate = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetPageNo(v int) *ReportTopQueryDTO {
|
||||
s.PageNo = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetOrderByType(v string) *ReportTopQueryDTO {
|
||||
s.OrderByType = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetPageSize(v int) *ReportTopQueryDTO {
|
||||
s.PageSize = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetGroupBy(v []string) *ReportTopQueryDTO {
|
||||
s.GroupBy = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetFields(v []string) *ReportTopQueryDTO {
|
||||
s.Fields = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetFiltering(v ReportFilterTopQueryDTO) *ReportTopQueryDTO {
|
||||
s.Filtering = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetStartDate(v string) *ReportTopQueryDTO {
|
||||
s.StartDate = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetAdvertiserId(v int64) *ReportTopQueryDTO {
|
||||
s.AdvertiserId = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *ReportTopQueryDTO) SetVersion(v int) *ReportTopQueryDTO {
|
||||
s.Version = &v
|
||||
return s
|
||||
}
|
||||
|
|
@ -0,0 +1,85 @@
|
|||
package domain
|
||||
|
||||
type ReportTopDto struct {
|
||||
FavoriteStores int `json:"favorite_stores"`
|
||||
PlayNums99 int `json:"play_nums99"`
|
||||
WifiPlayPercent string `json:"wifi_play_percent"`
|
||||
PreAlipayVolume int `json:"pre_alipay_volume"`
|
||||
CollectionCost string `json:"collection_cost"`
|
||||
SearchCost string `json:"search_cost"`
|
||||
Convert int `json:"convert"`
|
||||
EffectPlayRate string `json:"effect_play_rate"`
|
||||
DirectPreAlipayAmount string `json:"direct_pre_alipay_amount"`
|
||||
AdgroupId int `json:"adgroup_id"`
|
||||
DirectTransactionAmount string `json:"direct_transaction_amount"`
|
||||
LiveRechargeNums int `json:"live_recharge_nums"`
|
||||
ShareNums int `json:"share_nums"`
|
||||
DirectReturnOnInvestment string `json:"direct_return_on_investment"`
|
||||
Day string `json:"day"`
|
||||
AlipayCost string `json:"alipay_cost"`
|
||||
PageArriveUv int `json:"page_arrive_uv"`
|
||||
PageArrive int `json:"page_arrive"`
|
||||
AdPv int `json:"ad_pv"`
|
||||
DirectPreAlipayVolume int `json:"direct_pre_alipay_volume"`
|
||||
CampaignId int `json:"campaign_id"`
|
||||
DirectAlipayCost string `json:"direct_alipay_cost"`
|
||||
ReturnOnInvestment string `json:"return_on_investment"`
|
||||
LiveWatchNums int `json:"live_watch_nums"`
|
||||
Click int `json:"click"`
|
||||
DirectTakeOrderAmount string `json:"direct_take_order_amount"`
|
||||
VisitTime string `json:"visit_time"`
|
||||
PlayOverNums int `json:"play_over_nums"`
|
||||
Ecpm string `json:"ecpm"`
|
||||
FinishPlayRate string `json:"finish_play_rate"`
|
||||
VisitCost string `json:"visit_cost"`
|
||||
EffectPlayCost string `json:"effect_play_cost"`
|
||||
PlayNums50 int `json:"play_nums50"`
|
||||
TakeOrderVolume int `json:"take_order_volume"`
|
||||
Ecpc string `json:"ecpc"`
|
||||
VisitVolume int `json:"visit_volume"`
|
||||
FavoriteBabyVolume int `json:"favorite_baby_volume"`
|
||||
EffectPlayNums int `json:"effect_play_nums"`
|
||||
LiveInteractionNums int `json:"live_interaction_nums"`
|
||||
DirectTransactionVolume int `json:"direct_transaction_volume"`
|
||||
CreativeId int `json:"creative_id"`
|
||||
DirectAddCartVolume int `json:"direct_add_cart_volume"`
|
||||
ConvertRate string `json:"convert_rate"`
|
||||
TransactionAmount int `json:"transaction_amount"`
|
||||
PreAlipayAmount int `json:"pre_alipay_amount"`
|
||||
LiveLikeNums int `json:"live_like_nums"`
|
||||
LiveRechargeAmount int `json:"live_recharge_amount"`
|
||||
LikeNums int `json:"like_nums"`
|
||||
LiveAverageWatchTime string `json:"live_average_watch_time"`
|
||||
VisitPageVolume string `json:"visit_page_volume"`
|
||||
BuyCost string `json:"buy_cost"`
|
||||
LiveFollowNums int `json:"live_follow_nums"`
|
||||
SearchVolume int `json:"search_volume"`
|
||||
Cost int `json:"cost"`
|
||||
DirectFavoriteBabyVolume int `json:"direct_favorite_baby_volume"`
|
||||
PlayNums25 int `json:"play_nums25"`
|
||||
TransactionVolume int `json:"transaction_volume"`
|
||||
AveragePlayTime string `json:"average_play_time"`
|
||||
LiveCommentNums int `json:"live_comment_nums"`
|
||||
AdvertiserId int `json:"advertiser_id"`
|
||||
DirectTakeOrderVolume int `json:"direct_take_order_volume"`
|
||||
TakeOrderAmount int `json:"take_order_amount"`
|
||||
AddCartVolume int `json:"add_cart_volume"`
|
||||
PlayNums int `json:"play_nums"`
|
||||
DepthStoreVolume int `json:"depth_store_volume"`
|
||||
AdCtr string `json:"ad_ctr"`
|
||||
ConvertCost string `json:"convert_cost"`
|
||||
PlayNums75 int `json:"play_nums75"`
|
||||
Play3SCount int `json:"play3s_count"`
|
||||
Play5SCount int `json:"play5s_count"`
|
||||
Play7SCount int `json:"play7s_count"`
|
||||
PlatformPageViewCount int `json:"platform_page_view_count"`
|
||||
LanButtonClickCount int `json:"lan_button_click_count"`
|
||||
LanJumpButtonClickers int `json:"lan_jump_button_clickers"`
|
||||
LanJumpButtonClickRate string `json:"lan_jump_button_click_rate"`
|
||||
MaterialId int `json:"material_id"`
|
||||
TitleMaterialId int `json:"title_material_id"`
|
||||
ImageMaterialId int `json:"image_material_id"`
|
||||
VideoMaterialId int `json:"video_material_id"`
|
||||
CampaignName string `json:"campaign_name"`
|
||||
AdgroupName string `json:"adgroup_name"`
|
||||
}
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
package request
|
||||
|
||||
import (
|
||||
"git.sunqdl.cn/fgqj/topsdk/defaultability/domain"
|
||||
"git.sunqdl.cn/fgqj/topsdk/util"
|
||||
)
|
||||
|
||||
type TaobaoUnideskRtaReportDailyGetRequest struct {
|
||||
ReportTopQueryDTO *domain.ReportTopQueryDTO `json:"report_top_query_dto" required:"true" `
|
||||
}
|
||||
|
||||
func (s *TaobaoUnideskRtaReportDailyGetRequest) SetAdvertiserTopQueryDTO(v domain.ReportTopQueryDTO) *TaobaoUnideskRtaReportDailyGetRequest {
|
||||
s.ReportTopQueryDTO = &v
|
||||
return s
|
||||
}
|
||||
|
||||
func (req *TaobaoUnideskRtaReportDailyGetRequest) ToMap() map[string]interface{} {
|
||||
paramMap := make(map[string]interface{})
|
||||
if req.ReportTopQueryDTO != nil {
|
||||
paramMap["advertiser_top_query_dto"] = util.ConvertStructList(*req.ReportTopQueryDTO)
|
||||
}
|
||||
return paramMap
|
||||
}
|
||||
|
||||
func (req *TaobaoUnideskRtaReportDailyGetRequest) ToFileMap() map[string]interface{} {
|
||||
fileMap := make(map[string]interface{})
|
||||
return fileMap
|
||||
}
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
package response
|
||||
|
||||
import "git.sunqdl.cn/fgqj/topsdk/defaultability/domain"
|
||||
|
||||
type TaobaoUnideskRtaReportDailyGetResponse struct {
|
||||
/*
|
||||
报表数据
|
||||
*/
|
||||
Result []domain.ReportTopDto `json:"result"`
|
||||
/*
|
||||
总条数
|
||||
*/
|
||||
Total int `json:"total"`
|
||||
}
|
||||
Loading…
Reference in New Issue