获取商品库报表
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://ad.e.kuaishou.com/rest/openapi/gw/dsp/v1/dpa/product/report
返回参数
| 字段 | 类型 | 示例 | 说明 | 备注 |
|---|---|---|---|---|
| code | Integer | 1 | 结果状态码 | |
| message | String | 结果状态信息 | ||
| data | AdGatewayDpaReportView | 数据内容 |
AdGatewayDpaReportView
| 字段 | 类型 | 示例值 | 说明 | 备注 |
|---|---|---|---|---|
| result_list | AdDpaReportViewSnake[] | 单商品报表数据集 | ||
| sum | AdDpaReportViewSnake[] | 全局汇总 | ||
| page_info | PageInfoSneak | 分页信息 |
AdDpaReportViewSnake
| 字段 | 类型 | 示例值 | 说明 | 备注 |
|---|---|---|---|---|
| advertiser_id | Long | 0 | 投放账号ID | |
| library_id | Long | 0 | 商品库ID | |
| outer_id | String | 商品ID | ||
| product_name | String | 商品名称 | ||
| put_status | Integer | 0 | 商品投放状态: 0-关 1-开 | |
| ad_item_action_cost | Double | 0.0 | 行为成本 | |
| ad_item_action_ratio | Double | 0.0 | 行为率 | |
| ad_item_click | Long | 0 | 行为数 | |
| dpa_cost_total | Long | 0 | 花费 | 单位: 厘 |
| dpa_impression1k_cost | Double | 0.0 | 商品千次曝光成本 | |
| dpa_impression_num | Long | 0 | 商品曝光数 | |
| total_conversion_cost | Double | 0.0 | 转化成本 | |
| total_conversion_num | Double | 0.0 | 总的转化数 | |
| total_conversion_ratio | Double | 0.0 | 转化率 | |
| create_time | Long | 0 | 商品创建时间 | |
| update_time | Long | 0 | 商品最后更新时间 | |
| subIndustry_name | 商品类型 | |||
| product_name | 商品名称 | |||
| title | 商品标题 | |||
| category (一级二级三级类目字段后端拼凑返回给前端) | 商品类目 | |||
| theme | 题材 | |||
| ad_show | 广告曝光 | |||
| impression | 封面曝光数 | |||
| photo_click | 封面点击数 | |||
| photo_click_ratio | 封面点击率 | |||
| click | 素材曝光数 | |||
| action_ratio | 素材点击率 | |||
| ad_item_click | 行为数 | |||
| dpa_impression_num | 商品曝光数 | |||
| dpa_cost_total | 花费 | |||
| download_started | 安卓下载开始数 | |||
| download_completed_cost | 安卓下载完成单价 | |||
| download_started_ratio | 安卓开始下载率 | |||
| download_completed | 安卓下载完成数 | |||
| download_completed_ratio | 安卓下载完成率 | |||
| conversion | 激活数 | |||
| conversion_cost | 激活单价 | |||
| event_new_user_pay | 新增付费人数 | |||
| event_new_user_pay_cost | 新增付费人数成本 | |||
| event_new_user_pay_ratio | 新增付费人数率 | |||
| event_pay_first_day | 首日付费次数 | |||
| event_pay_first_day_cost | 首日付费次数成 本 | |||
| event_pay_purchase_amount_first_day | 激活当日付费金额 | |||
| event_pay_first_day_roi | 激活当日ROI | |||
| total_conversion_num | 转化数 | |||
| total_conversion_ratio | 转化率 | |||
| total_conversion_cost | 转化成本 | |||
| dpa_impression_1k_cost | 商品千次曝光成本 | |||
| impression_1k_cost | 平均千次封面曝光花费(元) | |||
| click_1k_cost | 平均千次素材曝光花费 | |||
| photo_click_cost | 平均封面点击单价 | |||
| download_conversion_ratio | 下载完成激活率 | |||
| event_24h_stay_by_conversion_cost | 激活后24h次日留存成本（激活时间） | |||
| event_24h_stay | 激活后24h次日留存数（激活时间） | |||
| event_24h_stay_ratio | 激活后24h次日留存率（激活时间） | |||
| event_pay_purchase_amount_one_day_by_conversion | 激活后24h付费金额(激活时间) | |||
| event_pay_purchase_amount_one_day_by_conversion_roi | 激活后24h-ROI(激活时间) | |||
| event_next_day_stay | 自然日次日留存数（回传时间） | |||
| event_next_day_stay_cost | 自然日次日留存成本（回传时间） | |||
| event_next_day_stay_ratio | 自然日次日留存率（回传时间） |
PageInfoSneak
| 字段 | 类型 | 示例值 | 说明 | 备注 |
|---|---|---|---|---|
| total_count | Long | 1 | 总数 | |
| page_size | Integer | 20 | 页大小 | |
| current_page | Integer | 1 | 当前页码 |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://ad.e.kuaishou.com/rest/openapi/gw/dsp/v1/dpa/product/report' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": 900015068,
"library_id": 1,
"start_date": "2022-01-01",
"end_date": "2022-04-01"
}'响应示例响应示例
{
"code": 0,
"data": {
"page_info": {
"total_count": 0,
"current_page": 0,
"page_size": 0
},
"result_list": [
"string"
],
"sum": [
"string"
]
},
"message": "string",
"request_id": "string"
}
修改于 2023-10-24 07:09:27