支持的筛选条件
您可以使用以下筛选条件缩小报表的范围。
在您开始之前,请阅读下列注意事项:
- 传递多个筛选条件时,筛选条件间是
AND的关系。 - 当使用
IN筛选类型时,filter_value必须是合法的 JSON 字符串列表。
注意
- 同步竞价基础报表、受众分析报表、试玩素材报表和 DSA 报表中不包含通过 TikTok Shop 创建的商品最大成交额广告(Product GMV max ads)和直播商品交易总额最大化广告(LIVE GMV max ads)的报表数据。通过 API 或 TikTok 广告管理平台创建的购物广告则不受影响。
| 筛选字段 {15%} | 支持的筛选类型 {30%} | 描述 {55%} |
| --------------- | ----------------------------- | ------------------------------------------------------------ |
| playable_ids | IN | 试玩广告ID。当使用此筛选条件时最多传 1000 个ID。 |
| country_code | IN | 地区代码。枚举见[附录-地域定向](https://ads.tiktok.com/marketing_api/docs?id=1739311040498689)。 |
| orientation | IN | 屏幕方向。枚举值:`BOTH`:横竖皆可,`PORTRAIT`:竖屏,`LANDSCAPE`:横屏。 |
| playable_status | IN | 试玩广告状态。枚举值:`VALIDATING`:校验中, `VALIDATE_FAIL`:校验不通过, `VALIDATE_SUCCESS`:审核中,`AUDIT_FAIL`:审核不通过,`AUDIT_SUCCESS`:审核通过。 |
| playable_name | MATCH | 试玩广告名称。 |
| spend | LOWER_THAN/GREATER_THAN/RANGE | 总消耗范围。 |