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

支持的筛选条件

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

在您开始之前,请阅读下列注意事项:

  • 传递多个筛选条件时,筛选条件间是 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 | 总消耗范围。                                                   |

内容来源: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 每日平台更新简报 →