（已废弃）支持的筛选条件

您可以使用以下筛选条件缩小报表的范围。

在您开始之前，请阅读下列注意事项： - 传递多个筛选条件时，筛选条件间是 AND 的关系。 - 当使用 IN 筛选类型时，filter_value需要是合法的JSON list字符串。

注意
异步合约广告报表中仅支持campaign_ids，adgroup_ids和ad_ids为筛选条件。

支持的筛选条件

|字段值 {15%} | 支持的字段类型 {20%}     |支持的数据层级{20%} | 描述  {45%}                                                |
| ------------------- | ---------------------------- | --------------------- | ------------------------------------------------------------ |
| campaign_ids        | IN                            | 推广系列、广告组、广告 |  推广系列ID，使用此筛选条件时，最多可传入100 个 `campaign_id`。筛选值示例：`"[123, 456, 789]"` 。|
| campaign_name       | MATCH                         | 推广系列、广告组、广告 | 推广系列名称。                                                 |
| campaign_status     | IN                            | 推广系列、广告组、广告 | 推广系列状态，枚举值 ：`NOT_DELIVERY`, `DISABLE`, `DELIVERING`, `DELETE`。不筛选表示所有状态。 |
| adgroup_ids         | IN                            | 广告组、广告           | 广告组ID，使用此筛选条件时，最多可传入100 个 `adgroup_id`。|
| adgroup_name        | MATCH                         | 广告组| 广告组名称。                                                   |
| adgroup_status      | IN                            | 广告组、广告           | 广告组状态，枚举值：`COMPLETE`, `FROZEN`, `DELIVERING`, `CLOSED`, `NOT_DELIVERY`, `DELETE`。不筛选表示所有状态。 |
| ad_ids              | IN                            | 广告| 广告组ID，使用此筛选条件时，最多可传入100 个 `adgroup_id`。|
| ad_status           | IN                            | 广告| 广告状态，枚举值：`DELIVERING`, `NOT_DELIVERY`,`COMPLETE`, `DISABLE`, `DELETE`, `FROZEN`, `CLOSED`。不筛选表示所有状态。 |
| app                 | IN                            | 广告组| 投放产品，枚举值：`BUZZ_UP`, `SPICY`, `BABE`, `BABE_PLUS`, `TOP_BUZZ`, `NEWS_REPUBLIC`, `ULIKE`, `BUZZ_VIDEO`, `TIKTOK`。Filter_value 举例：`"[\"TIKTOK\",\"BUZZ_VIDEO\"]"`。不筛选表示所有投放产品。 |
| billing_events      | IN                            | 广告组| 计费事件，枚举值：`GD`，`CPT`。                                 |
| platform            | IN                            | 广告组| 投放平台，枚举值：`UNLIMITED`, `ANDROID`, `IOS`。               |
| locations       | IN                            | 广告组| 投放地域，枚举值：详见[附录-地区代码](https://ads.tiktok.com/marketing_api/docs?id=1737585867307010)。 |
| ad_placement        | IN                            | 广告组| 广告版位。 |

筛选示例

如果想获取在2021年4月1日到4月10日开始投放的广告组，可以使用下面的筛选条件：

{"field_name": "schedule_start_time", "filter_type": "RANGE", "filter_value": "[\"2021-04-01\", \"2021-04-10\"]"}