快手广告投放：小店通转化数据报表

请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/merchant/report/detail_report

请求方式：POST

数据格式：JSON

请求参数

字段	类型	描述
advertiser_id	long	快手广告数据转化主 ID（注：非账户快手 ID），在获取 accessToken 时返回
advertiser_id	long	广告主 ID（注：非账户快手 ID），在获取 accessToken 时返回
view_type	int	数据类型：1：账户；2：广告计划；3：广告组；4：广告创意
group_type	int	汇总方式：1：天 （默认值）；2：小时 此时 start_date 只能是当天，end_date 只能是下一天
start_date	string	过滤筛选条件，格式 yyyy-MM-dd
end_date	string	过滤筛选条件，格式 yyyy-MM-dd
campaign_ids（可选）	string	计划 id 列表，以英文逗号分割，查询计划转化数据 viewType=2 时必填，否则不用填写
unit_ids（可选）	string	单元 id 列表，以英文逗号分割，查询单元转化数据 viewType=3 时必填，否则不用填写
creative_ids（可选）	string	创意 id 列表，以英文逗号分割，查询创意转化数据 viewType=4 时必填，否则不用填写
programmed_creative_ids（可选）	string	程序化创意 id 列表，以英文逗号分割，查询程序化创意转化数据 viewType=4 时必填，，否则不用填写
page	int	请求的页码，默认为 1
page_size	int	每页行数，默认为 20，最大支持 2000

返回参数

字段	类型	描述
code	int	返回码/错误码
code	int	返回码/错误码
message	string	返回信息/错误信息
data	JSON
total_count	int	数据的总行数
details	JSON	数据明细信息
report_date	string	日期
report_hour	int	小时
report_date_hour	string	日期+小时
campaign_name	string	计划名称
campaign_id	string	计划 ID
unit_name	string	快手广告代运营组名称
unit_id	string	广告组 ID
creative_name	string	创意名称
creative_id	string	创意 id
cost_total	long	花费
impression	long	封面曝光数
photo_click	long	封面点击数
photo_click_ratio	double	封面点击率
click	long	素材曝光数
actionbar_click	long	行为数
action_ratio	doube	行为率
merchant_photo_impression_1k_cost	double	平均千次封面曝光花费(元)
merchant_photo_click_cost	double	平均封面点击单价(元)
merchant_impression_1k_cost	double	平均千次素材曝光花费(元)
merchant_click_cost	double	平均行为单价(元)
play_3s_ratio	double	3s 播放率
play_5s_ratio	double	5s 播放率
play_end_ratio	double	完播率
share	long	分享数
comment	long	评论数
likes	long	点赞数
report	long	举报数
block	long	拉黑数
negative	long	减少此类作品数
merchant_reco_fans	long	涨粉量
reco_fans_cost	double	涨粉成本（元）
paied_order	long	支付订单数
order_cost	double	下单成本
gmv	double	GMV
t0_gmv	long	当日累计 GMV
t1_gmv	long	投后 1 日累计 GMV
t3_gmv	long	投后 3 日累计 GMV
t7_gmv	long	投后 7 日累计 GMV
t15_gmv	long	投后 15 日累计 GMV
t30_gmv	long	投后 30 日累计 GMV
roi	double	ROI
t0Roi	double	当日累计 ROI
t1Roi	double	投后 1 日累计 ROI
t3Roi	double	投后 3 日累计 ROI
t7Roi	double	投后 7 日累计 ROI
t15Roi	double	投后 15 日累计 ROI
t30Roi	double	投后 30 日累计 ROI
t7_retention	long	投后 7 日涨粉留存量
t30_retention	long	投后 30 日涨粉留存量
t7_retention_ratio	double	投后 7 日涨粉留存率
t30_retention_ratio	double	投后 30 日涨粉留存率
t0_order_cnt	long	当日累计订单成交量
t1_order_cnt	long	投后 1 日累计订单成交量
t3_order_cnt	long	投后 3 日累计订单成交量
t7_order_cnt	long	投后 7 日累计订单成交量
t15_order_cnt	long	投后 15 日累计订单成交量
t30_order_cnt	long	投后 30 日累计订单成交量

请求实例

curl -H "Access-Token:d198a850da67a16279e30" \
-H "Content-Type:application/json" \
-d '

{
   	"start_date": "2021-03-01",
   	"end_date": "2021-03-07",
   	"advertiser_id": 486,
       "view_type": 2,
       "campaign_ids": "111,222",
      	"page_size": 2,
   	"page": 1
}
' https://ad.e.kuaishou.com/rest/openapi/v1/merchant/report/detailReport

返回实例

{	"code": 0,	"message": "OK",	"data": {		"total_count": 1,		"details": [{			"report_date": "2021-03-05",			"report_hour": 0,			"campaign_id": 36700091,			"campaign_name": "直播推广_20210305_11:45",			"unit_id": 0,			"unit_name": "",			"creative_id": 0,			"creative_name": "",			"put_status": 1,			"unit_create_time": 0,			"campaign_create_time": 1614915941428,			"creative_create_time": 0,			"cost_total": 0,			"paied_order": 0,			"gmv": 0.0,			"t1_retention": 0,			"t7_retention": 0,			"t30_retention": 0,			"t0_order_cnt": 0,			"t1_order_cnt": 0,			"t3_order_cnt": 0,			"t7_order_cnt": 0,			"t15_order_cnt": 0,			"t30_order_cnt": 0,			"t0_gmv": 0,			"t1_gmv": 0,			"t3_gmv": 0,			"t7_gmv": 0,			"t15_gmv": 0,			"t30_gmv": 0,			"merchant_photo_impression_1k_cost": 0.0,			"merchant_photo_click_cost": 0.0,			"merchant_impression_1k_cost": 0.0,			"merchant_click_cost": 0.0,			"order_cost": 0.0,			"roi": 0.0,			"t1_retention_ratio": 0.0,			"t7_retention_ratio": 0.0,			"t30_retention_ratio": 0.0,			"t0_roi": 0.0,			"t1_roi": 0.0,			"t3_roi": 0.0,			"t7_roi": 0.0,			"t15_roi": 0.0,			"t30_roi": 0.0,			"impression": 0,			"photo_click": 0,			"photo_click_ratio": 0.0,			"click": 0,			"actionbar_click": 0,			"action_ratio": 0.0,			"play_3s_ratio": 0.0,			"play_5s_ratio": 0.0,			"play_end_ratio": 0.0,			"share": 0,			"comment": 0,			"likes": 0,			"report": 0,			"block": 0,			"negative": 0.0,			"merchant_reco_fans": 0,			"reco_fans_cost": 0.0,			"played_three_seconds": 0,			"played_five_seconds": 0,			"played_end": 0,			"live_played_3s": 0,			"live_event_goods_view": 0,			"live_reward": 0,			"live_comment": 0,			"live_share": 0,			"conversion_live_play_3_s_cost": 0.0,			"conversion_live_event_goods_view_cost": 0.0,			"live_event_goods_view_ratio": 0.0,			"reportDateHour": "2021-03-05 00:00"
		}]
	},	"request_id": "5ec6d47de07345ada69eee1b34586afc"}

---

文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址：http://www.mqs.net/post/8682.html