支持的筛选条件
您可以使用以下筛选条件缩小报表的范围。
在您开始之前,请阅读下列注意事项:
- 传递多个筛选条件时,筛选条件间是
AND的关系。 - 当使用
IN筛选类型时,filter_value必须是合法的JSON list 字符串。
例如"[\"ID1\",\"ID2\",\"ID3\"]"。
| 筛选字段 {20%}| 支持的筛选类型{20%} | 备注 {60%}|
|---|---|---|
| advertiser_name | MATCH | 广告账户的名称。|
| advertiser_id | IN | 广告账户的 ID。 |
| registered_area | IN | 广告账户注册地对应的地区代码。 <br><br>若想获取该商务中心下支持筛选的地区代码,请使用[/bc/advertiser/attribute/](1775752357139457.html)。|
| platform_of_account | IN |广告账户的平台。<br><br>支持的值:<ul><li>`ADS_MANGER`:TikTok 广告管理平台。</li><li> `RAP`:TikTok 合约广告平台。</li></ul> |
| owner_of_account | IN | 广告账户所有者。<br><br>支持的值: <ul><li>`OWNED_BY_CURRENT_BUSINESS_CENTER`:归当前商务中心所有。 </li><li>`SHARED_BY_OTHER_BUSINESS_CENTER`:由其他商务中心共享。</li></ul> |
| currency_of_account | IN | 广告账户对应的的币种代码。 <br><br>若想获取该商务中心下支持筛选的币种代码,请使用[/bc/advertiser/attribute/](1775752357139457.html)。|
| cost | <ul><li> GREATER_THAN </li><li>GREATER_EQUAL</li><li> LOWER_THAN </li><li> LOWER_EQUAL </li></ul>| 总消耗。<br><br>该筛选条件将应用于所有广告账户,对应的默认币种为美元(USD)。<br> 例如,筛选条件设置`"filtering=[\"field_name\": \"cost\", \"filter_type\": \"GREATER_EQUAL\"},{\"filter_value\": \"500\"]"` 会筛选出总消耗大于等于 500 美元的广告账户。 |
| account_status | IN | 广告账户的状态。<br><br>支持的值:<ul><li>`APPROVED`:审核通过。</li><li> `NOT_APPROVED`:未通过审核。</li><li>`IN_REVIEW`:正在审核。</li><li>`SUSPENDED`:停用。</li><li>`DISABLED`:永久停用。</li><li>`CONTRACT_INACTIVE`:合同未生效。</li></ul>|