← 返回目录
📁 Marketing API › Reporting › Guides › Report types

基础报表

基础报表是一种报表类型,您可以通过此类报表获取最全面的广告数据,包括广告消耗和表现数据、视频播放数据、互动数据,以及应用内事件和网页事件数据。

支持的维度

获取基础报表支持的维度,请参阅此处。

支持的指标

获取基础报表支持的指标,请参阅此处。

支持的筛选条件

获取基础报表支持的筛选条件,请参阅此处。

支持的Lifetime指标

基础报表在广告主层级、推广系列层级、广告组层级以及广告层级均支持Lifetime 指标。

Lifetime 指标不支持分时间或地域查询,当设置 query_lifetime = True 时,dimensions 中不可包含 stat_time_day,stat_time_hour或country_code。

使用案例

1. 查询广告主某段时间内的总消耗。

请求参数:

(code json JSON)
{
    "advertiser_id": "{{advertiser_id}}",
    "service_type": "AUCTION",
    "report_type": "BASIC",
    "data_level": "AUCTION_ADVERTISER",
    "dimensions": [
         "advertiser_id"
    ],
    "metrics": [
        "spend",
        "impressions",
        "reach"
    ],
    "start_date": "{{start_date}}",
    "end_date": "{{end_date}}", 
    "page": 1,
    "page_size": 200
}
(/code)

2. 查询广告主某段时间内部分广告组的分天消耗数据。

请求参数:

(code json JSON)
{
    "advertiser_id":  "{{advertiser_id}}",
    "service_type": "AUCTION",
    "report_type": "BASIC",
    "data_level": "AUCTION_ADGROUP",
    "dimensions": [
        "adgroup_id",
        "stat_time_hour"
    ],
    "metrics": [
        "spend",
        "impressions",
        "reach"
    ],
    "start_date": "{{start_date}}",
    "end_date": "{{end_date}}",
    "filtering": [
        {
            "field_name": "adgroup_ids",
            "filter_type": "IN",
            "filter_value": "[{{adgroup_id}},{{adgroup_id}}]"
        },
        {
            "field_name": "adgroup_status",
            "filter_type": "IN",
            "filter_value": "[\"STATUS_DELIVERY_OK\"]"
        }
    ],
    "query_lifetime": false,
    "page": 1,
    "page_size": 200
}
(/code)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →