一、返回样例：
{ "code": 0, "message": "OK", "data": { "total_count": 1, "details": [ { "charge": 76.0, "show": 10, "aclick": 20, "bclick": 10, "share": 3, "comment": 4, "like": 5, "follow": 2, "report": 0, "block": 0, "negative": 0, "activation": 10, "submit": 20, "cancel_follow": 0, "download_started": 0, "download_completed": 0, "stat_date": "2019-08-23", "stat_hour": 0, "photo_click": 5, "photo_click_ratio": 0.5, "action_ratio": 0.5, "impression_1k_cost": 7600.0, "photo_click_cost": 15.2, "action_cost": 7.6, "event_pay_first_day": 3, "event_pay_purchase_amount_first_day": 50.0, "event_pay_first_day_roi": 0.6578947368421053, "event_pay": 6, "event_pay_purchase_amount": 100.0, "event_pay_roi": 1.3157894736842106, "event_register": 8, "event_register_cost": 9.5, "event_register_ratio": 0.8, "event_jin_jian_app": 8, "event_jin_jian_app_cost": 9.5, "event_credit_grant_app": 6, "event_credit_grant_app_cost": 12.666666666666666, "event_credit_grant_app_ratio": 0.75, "event_order_paid": 6,
"event_order_paid_purchase_amount": 100.0, "event_order_paid_cost": 12.666666666666666, "form_count": 20, "form_cost": 3.8, "form_action_ratio": 2.0, "event_jin_jian_landing_page": 8, "event_jin_jian_landing_page_cost": 9.5, "event_credit_grant_landing_page": 6, "event_credit_grant_landing_page_cost": 12.666666666666666, "event_credit_grant_landing_ratio": 0.75, "unit_id": 2960851, "unit_name": "zj-MAPI激活66818", "campaign_id": 2343304, "campaign_name": "MAPI-ZJ" } ] } } |
二、快手广告创意数据（实时）
请求快手信息流广告创意数据
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/report/creative_report
请求方式：POST
数据格式：JSON
字段 |
类型 |
描述 |
advertiser_id |
long |
快手广告主ID（注：非快手广告账户快手ID），在获取accessToken时返回 |
start_date_min（必选其1） |
string |
增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】 可选时间范围参见文档上方说明 |
end_date_min（必选其1） |
string |
增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】 可选时间范围参见文档上方说明 |
start_date（必选其2） |
string |
过滤筛选条件，格式yyyy-MM-dd 可选时间范围参见文档上方说明 |
end_date（必选其2） |
string |
过滤筛选条件，格式yyyy-MM-dd 可选时间范围参见文档上方说明 |
campaign_type（可选） |
int |
计划类型，过滤筛选条件 1 - 作品推广； 2 - 提升应用安装； 3 - 获取电商下单； 4 - 推广品牌活动； 5 - 收集销售线索； 6 - 保量广告； 7 - 提高应用活跃。 |
campaign_ids（可选） |
long[] |
快手广告计划ID集，过滤筛选条件，单次查询数量不超过5000 |
unit_ids（可选） |
long[] |
快手广告组ID集，过滤筛选条件，单次查询数量不超过5000 |
creative_ids（可选） |
long[] |
快手广告创意ID集，过滤筛选条件，单次查询数量不超过5000 |
temporal_granularity（可选） |
string |
天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据 |
report_dims（可选） |
string[] |
"adScene"：按快手广告场景；不传/传空/传空数组：不限 |
page |
int |
请求的页码，默认为 1 |
page_size |
int |
每页行数，默认为20，最大支持2000 |
请求示例：
curl -H "Access-Token:d198a850da67a1f81279e30" \ -H "Content-Type:application/json" \ -d ' { "start_date": "2018-12-06", "end_date": "2018-12-07", "advertiser_id": 486, "temporal_granularity": "DAILY", "campaign_type": 3, "optimize_target": "click", "page_size": 2, "page": 1 } ' |
