（已废弃）合约广告报表

重要提示
若想拉取 TopView 广告的报表数据，可使用基础报表或受众分析报表，并在筛选条件 buying_type 中指定 RESERVATION_TOP_VIEW 。

合约广告报表是一种报表类型，您可以通过此类报表获取合约广告账号中的广告的消耗和表现数据。目前，若想请求合约广告报表，需将service_type 设置为 RESERVATION 且仅支持将 report_type 设置为 BASIC。

若您想获取竞价广告账号（ TikTok 广告管理平台账号）中的合约广告的报表数据，需将 service_type 设置为 AUCTION 且 report_type 设置为 BASIC，从而请求基础报表。

注意
不支持使用CHUNK模式 （query_mode= CHUNK）生成合约广告报表。CHUNK模式仅支持同步基础报表。

支持的维度

获取合约广告报表支持的维度，请参阅此处。

支持的指标

获取合约广告报表支持的指标，请参阅此处。

支持的筛选条件

获取合约广告报表支持的筛选条件，请参阅此处。

Lifetime指标支持情况

1.3版本的合约广告报表中暂不支持Lifetime指标。

使用案例

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

请求参数：

(code json JSON)
{
    "advertiser_id": 66,
    "service_type": "RESERVATION",
    "report_type": "BASIC",
    "data_level": "RESERVATION_ADVERTISER",
    "dimensions": [
        "advertiser_id"
    ],
    "metrics": [
        "spenc",
        "impressions"
    ],
    "start_date": "2020-10-25",
    "end_date": "2020-11-23",
    "page": 1,
    "page_size": 100
}
(/code)

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

请求参数：

(code json JSON)
{
    "advertiser_id": 66,
    "service_type": "RESERVATION",
    "report_type": "BASIC",
    "data_level": "RESERVATION_ADVERTISER",
    "dimensions": [
        "advertiser_id", "stat_time_day"
    ],
    "metrics": [
        "spend",
        "impressions"
    ],
    "start_date": "2020-10-25",
    "end_date": "2020-11-23",
    "page": 1,
    "page_size": 100
}
(/code)

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

请求参数：

(code json JSON)
{
    "advertiser_id": 66,
    "service_type": "RESERVATION",
    "report_type": "BASIC",
    "data_level": "RESERVATION_ADGROUP",
    "dimensions": [
        "adgroup_id",
        "stat_time_day"
    ],
    "metrics": [
        "spend",
        "impressions"
    ],
    "filtering": [
        {
            "field_name": "adgroup_ids",
            "filter_type": "IN",
            "filter_value": "[123, 456]"
        },
        {
            "field_name": "adgroup_status",
            "filter_type": "IN",
            "filter_value": "[\"COMPLETE\", \"DELIVERING\"]"
        }
    ],
    "start_date": "2020-10-25",
    "end_date": "2020-11-23",
    "page": 1,
    "page_size": 100
}
(/code)