程序化创意 2.0 数据
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://ad.e.kuaishou.com/rest/openapi/v1/report/program_creative_report
请求参数
| 字段 | 类型 | 描述 |
|---|---|---|
| advertiser_id | long | 广告主 ID（注：非账户快手 ID），在获取 accessToken 时返回 |
| start_date_min（必选） | string | 增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】目前MAPI最长支持读取近7日的数据，例如今天为0525，则最长可以读取到0518的数据 |
| end_date_min（必选） | string | 增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】可选时间范围参见文档上方说明 |
| campaign_ids（可选） | long[] | 广告计划 ID 集，过滤筛选条件，单次查询数量不超过 5000 |
| unit_ids（可选） | long[] | 广告组 ID 集，过滤筛选条件，单次查询数量不超过 5000 |
| temporal_granularity（可选） | string | 天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据 |
| report_dims（可选） | string[] | "adScene"：按广告场景；"placementType"：按广告范围，快手/联盟;不传/传空/传空数组：不限 |
| page | int | 请求的页码，默认为 1 |
| page_size | int | 每页行数，默认为 20，最大支持 2000 |
返回参数
| 字段 | 类型 | 描述 | |
|---|---|---|---|
| code | int | 返回码/错误码 | |
| message | string | 返回信息/错误信息 | |
| data | JSON | ||
| total_count | int | 数据的总行数 | |
| details | JSON | 数据明细信息 | |
| 其他信息与实时报表保持一致，如下为新增参数 | |||
| campaign_id | long | 计划 id | |
| campaign_name | string | 计划名称 | |
| unit_id | long | 组 id | |
| unit_name | string | 组名称 | |
| creative_id | long | 创意 id | |
| photo_url | string | 视频链接 | |
| photo_id | string | 视频 id | |
| photo_md5 | string | 视频 md5 | |
| image_token | string | 封面 id | |
| cover_url | string | 封面链接 | |
| description | string | 作品广告语 | |
| pic_id | string | 图片库图片ID | |
| pic_list | string[] | 联盟图片（横版/竖版） | 联盟图片imageToken |
| pic_url_list | sring[] | 联盟图片url（横版/竖版） | 联盟图片url |
请求参数
无
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v1/report/program_creative_report'响应示例响应示例
{}
修改于 2023-10-24 06:41:35