生成报表
本文介绍了生成同步报表和异步报表的具体步骤。
简介
整合不同广告账户的零散数据可能很复杂。但通过报表管理API，您可以自定义维度和细粒度来获取不同广告账户的广告投放数据。您可以在不同的报表类型上生成同步或异步报表。
您可以使用报表管理API拉取关键数据，以创建符合您业务需求的仪表盘。使用API拉取报表将提升效率和灵活度。
前提条件
- 您已经拥有TikTok API for Business的使用权限。详见快速入门 - 具体步骤 。
- 若要创建广告，您需要获取相关的权限。参阅API参考了解使用相关接口（包括“步骤”部分列出的接口）所需的权限；参阅更新应用权限范围了解如何设置权限。
- 异步报表目前为白名单功能。如需使用此功能，请通过白名单功能管理申请。
步骤
使用/report/integrated/get/生成同步报表。参阅生成同步报表了解详细步骤。
注意
不同的报表类型支持不同的维度、指标和筛选条件。您可以在报表类型下查看相应文章，了解详细情况。
下面是查询某个广告主在某一时期的总消耗的示例：
(code)
{
"advertiser_id":"{{advertiser_id}}",
"service_type": "AUCTION",
"report_type": "BASIC",
"data_level": "AUCTION_ADVERTISER",
"dimensions": [
"advertiser_id"
],
"metrics": [
"spend",
"impressions",
"reach"
],
"start_date": "2020-10-16",
"end_date": "2020-10-17",
"page": 1,
"page_size": 200
}
(/code)
- 使用/report/task/create/，/report/task/check/和/report/task/download/来生成异步报表。参阅生成异步报表了解详细步骤。
注意
不同的报表类型支持不同的维度、指标和筛选条件。您可以在报表类型下查看相应文章，了解详细情况。
下面是查询某段时间内按小时分组的广告点击量的示例。
(code)
{
"advertiser_id": "{{advertiser_id}}",
"page":1,
"data_level":"AUCTION_AD",
"report_type":"BASIC",
"dimensions": ["ad_id","stat_time_hour"],
"metrics": ["clicks"],
"page_size": 1,
"start_date": "2022-07-17",
"end_date": "2022-09-17",
"output_format": "CSV_DOWNLOAD",
"file_name": "test"
}
(/code)