支持的筛选条件
您可以使用以下筛选条件缩小报表的范围。
除了基础报表支持的筛选条件之外,受众分析报表还支持以下筛选条件。
注意
- 异步受众分析报表中仅支持campaign_ids,adgroup_ids和ad_ids为筛选条件。 - 受众分析报表在包括竞价广告、覆盖和频次广告以及 TopView 广告数据。但是,您无法在受众分析报表中筛选特定售卖类型的数据。
要筛选特定售卖类型的数据,请使用 /report/integrated/get/ 生成基础报表。在filtering对象数组中,指定buying_type字段并输入AUCTION、RESERVATION_TOP_VIEW或RESERVATION_RF枚举值。 - 对于 TopView 广告,仅支持为 2024 年 1 月 18 日后投放的广告拉取广告层级消耗相关的指标及受众细分的消耗相关的指标数据。 - 同步竞价基础报表、受众分析报表、试玩素材报表和 DSA 报表中不包含通过 TikTok Shop 创建的商品最大成交额广告(Product GMV max ads)和直播商品交易总额最大化广告(LIVE GMV max ads)的报表数据。通过 API 或 TikTok 广告管理平台创建的购物广告则不受影响。
|筛选字段{20%}| 筛选类型{10%}| 支持的广告层级{18%}|备注{52%}|
|---|---|---|---|
| campaign_system_origins | IN | 推广系列、广告组、广告 | 推广系列来源。<br><br>枚举值:<ul><li>`PROMOTE`:该推广系列为通过 TikTok 移动应用创建的内容加热推广系列。</li><li>`TT_ADS_PLATFORM`:该推广系列为通过 API 或 TikTok 广告管理平台创建的非内容加热推广系列。</li></ul><br> 默认值:`"[\"TT_ADS_PLATFORM\"]"`。<br><br>若想了解内容加热广告支持的维度、指标和筛选条件,请查看[内容加热推广系列](1785880454546433.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>仅支持在同步受众报表中使用本筛选条件。</li><li>异步受众报表中默认返回内容加热广告的报表数据。</li></ul> |
|dma_ids|IN|推广系列、广告组、广告|根据特定市场区域(DMA)筛选。 仅维度中包含`dma_id`时可用。枚举值请参考[地域定向](https://ads.tiktok.com/marketing_api/docs?id=1739311040498689)。|
|region_ids|IN|推广系列、广告组、广告|根据省/州级区域筛选。仅维度中包含`province_id`时可用。|
|interest_category|IN|推广系列、广告组、广告| 根据一级兴趣类别筛选。仅维度中包含`interest_category`时可用。枚举值请参考[兴趣分类](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961)。|
|interest_category_tier2|IN|推广系列、广告组、广告|根据二级兴趣类别筛选。仅维度中包含`interest_category_tier2`时可用。枚举值请参考[兴趣分类](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961)。|
|interest_category_tier3|IN|推广系列、广告组、广告| 根据三级兴趣类别筛选。仅维度中包含`interest_category_tier3`时可用。枚举值请参考[兴趣分类](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961)。|
|interest_category_tier4|IN|推广系列、广告组、广告| 根据四级兴趣类别筛选。仅维度中包含`interest_category_tier4`时可用。枚举值请参考[兴趣分类](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961)。|
| destination | IN | 广告 | 目标页类型。<br>枚举值:<ul><li>`APP`:所推广 App 在 Google Play 或 Apple Store 的下载页面。广告对应的广告组中`promotion_type` 设置为 `APP_ANDROID` 或 `APP_IOS`。</li><li>`TIKTOK_INSTANT_PAGE`: TikTok 即时体验页面,包括自定义页面、线索表单(即时体验表单)、应用介绍页和即时体验商品页面。广告中指定了TikTok即时体验页面的页面ID(`page_id`)。</li><li> `WEBSITE`:网站页面。广告中指定了落地页(`landing_page_url`)。</li><li>`SOCIAL_MEDIA_APP`:社交媒体 URL。若想了解支持将目标页面设置为社交媒体 URL 的广告类型,请查看[创建推广对象类型为即时通讯应用的线索广告](1774482999036930.html)。 </li><li> `PHONE_CALL`:电话号码。若想了解支持将目标页面设置为电话号码的广告类型,请查看[创建推广对象类型为电话通话的线索广告](1774482936048641.html)。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>:本筛选条件仅支持在同步受众分析报表中使用。 |
|creative_material_mode|IN|广告组、广告|创意投放方式。<br>枚举值: `CUSTOM`(自定义)、`DYNAMIC`(程序化)、`SMART_CREATIVE`(智能创意)。|
|bid_strategy|IN|广告组|竞价策略。枚举值:`BID_STRATEGY_COST_CAP`, `BID_STRATEGY_BID_CAP`, `BID_STRATEGY_MAX_CONVERSION` 和`BID_STRATEGY_LOWEST_COST`. |