快手廣告管理平臺Marketing API開發(fā)文檔

【注意事項】快手廣告計劃/廣告組/廣告創(chuàng)意報表查詢接口，如果單次查詢需要處理的有效廣告計劃/廣告組/廣告創(chuàng)意數(shù)量超過5000，會提示“報表查詢處理ID數(shù)比較多，請分批次傳ID進(jìn)行查詢”。其中，“有效快手信息流廣告代理計劃/廣告組/廣告創(chuàng)意數(shù)量”以請求的實際結(jié)果為準(zhǔn)，并非快手推廣賬戶里廣告計劃/快手廣告組/廣告創(chuàng)意的整體數(shù)量。

為了保證更穩(wěn)定、更高效的報表數(shù)據(jù)查詢，現(xiàn)新增歷史投放報表數(shù)據(jù)接口，支持以異步任務(wù)的方式查詢歷史數(shù)據(jù)。快手開戶價格原有的實時報表接口時間范圍調(diào)整為近7天（含當(dāng)天），歷史投放報表接口時間范圍為近6個月（含當(dāng)天）；分時查詢僅支持近7天（含當(dāng)天）的數(shù)據(jù)。由于快手投放廣告后臺可查詢時間范圍近期有變動，快手Marketing API會盡快對齊。

1. 新增權(quán)限code

report_service（獲取快手廣告賬戶報表信息）

需要在授權(quán)URL的scope參數(shù)上添加 report_service，進(jìn)行授權(quán)后才能訪問獲取快手廣告賬戶報表信息的接口，示例如下：https://ad.e.kuaishou.com/openapi/oauth?app_id=1&scope=%5B%22report_service%22%5D&redirect_uri=https://e.kuaishou.com&state=abc

2. 報表查詢

2.1 快手廣告主數(shù)據(jù)（實時）

1） 請求快手廣告主數(shù)據(jù)

請求接口：https://ad.e.kuaishou.com/rest/openapi/v1/report/account_report

請求方式：POST

數(shù)據(jù)格式：JSON