← 返回目录
📁 API Reference › Ad Groups

预估受众人数

您可以使用本接口预估受众人数。本接口涉及的参数与创建广告组接口类似。

注意
由于数据安全性要求，该数字不包含18岁以下年龄段受众，当地法律允许的投放不会受到影响。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{36%}|v1.3{34%}| |---|---|---| |接口路径|/v1.2/ad/tools/audience_size/|/v1.3/ad/audience_size/estimate/| |请求参数名称|placement<br>ios_target_device<br>optimize_goal<br>dpa_retargeting_type<br>dpa_retargeting_actions_days<br>age<br>action_v2<br>user_actions<br>operation_system<br>ios_osv<br>android_osv<br>connection_type<br>device_price<br>include_custom_actions<br>exclude_custom_actions<br>enable_expansion|placements<br>ios14_targeting<br>optimization_goal<br>shopping_ads_retargeting_type<br>shopping_ads_retargeting_actions_days<br>age_groups<br>actions<br>video_user_actions<br>operating_systems<br>min_ios_version<br>min_android_version<br>network_types<br>device_price_ranges<br>included_custom_actions<br>excluded_custom_actions<br>expansion_enabled| |请求参数类型|advertiser_id: number<br>app_id: number <br>pixel_id: number <br>catalog_id: number<br>product_set_id: number |advertiser_id: string <br>app_id: string <br>pixel_id: string<br>catalog_id: string<br>product_set_id: string | |请求参数名称和类型|catalog_authorized_bc: <br>number<br>audience: number[]<br>excluded_audience: number[]<br>location: number[]<br>interest_category_v2: number[]<br>interest_keywords: number[]<br>action_categories: number[]<br>device_models: number[]<br>carriers_v2: number[]<br>pangle_audience_package_include: number[]<br>pangle_audience_package_exclude: number[]<br>pangle_block_app_list_id:<br> number[]<br>automated_targeting: <br>string |catalog_authorized_bc_id: string <br>audience_ids: string[] <br>excluded_audience_ids: string[]<br>location_ids: string[]<br>interest_category_ids: string[]<br>interest_keyword_ids: string[] <br>action_category_ids: string[]<br> device_model_ids : string[]<br>carrier_ids: string[]<br>included_pangle_audience_package_ids: string[]<br> excluded_pangle_audience_package_ids: string[] <br>blocked_pangle_app_ids: <br>string[]<br>auto_targeting_enabled:<br> boolean| |废弃请求参数 |/|campaign_id<br>adgroup_name<br>carriers| |请求中其他改动|/|在v1.3中您需要传入objective_type和optimization_goal。| |新增请求参数 |/|contextual_tag_ids<br>purchase_intention_keyword_ids<br>spending_power<br>promotion_type<br>product_source<br>zipcode_ids<br>isp_ids| |返回参数名称|1<br>(位于user_count对象下) <br>2<br>(位于user_count对象下) |lower_end<br> (位于user_count对象下)<br>upper_end<br>(位于user_count对象下) | |新增返回参数|/ |purchase_intention_keyword_ids`|





# 请求


**地址** <https://business-api.tiktok.com/open_api/v1.3/ad/audience_size/estimate/>

**方法** POST

**Header**

```xtable
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求消息类型<br>允许值: `""application/json""`。  |

参数

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|advertiser_id {必填}|string|广告主ID |
|placement_type|string|版位类型。 <br>枚举值: `PLACEMENT_TYPE_AUTOMATIC`（自动版位），`PLACEMENT_TYPE_NORMAL` （编辑版位）。默认值: `PLACEMENT_TYPE_NORMAL`|
|placements {+条件必填}|string[]|广告版位，当`placement_type`为 `PLACEMENT_TYPE_NORMAL` 时必传，当`placement_type`为`PLACEMENT_TYPE_AUTOMATIC`时忽略本字段。<br>目前，`placements`字段支持`PLACEMENT_TIKTOK `，`PLACEMENT_PANGLE`，`PLACEMENT_GLOBAL_APP_BUNDLE`。获取枚举值的完整列表，请参考[枚举值-版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><p><span style="color:darkred"><b>注意：</b></span><br><ul><li>在全球化应用组合版位（`PLACEMENT_GLOBAL_APP_BUNDLE`）下支持定向的地区包括：巴西、印度尼西亚、越南、菲律宾、泰国、马来西亚、墨西哥、沙特阿拉伯和日本。</li><li>全球化应用组合版位下不支持优化目标落地页浏览量（`optimization_goal`=`TRAFFIC_LANDING_PAGE_VIEW`）。欲了解该优化目标详情，请查看[枚举值-优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。</li><li>若所属的推广系列的推广目标为商品销量（`objective_type` = `PRODUCT_SALES`），仅支持TikTok版位（`PLACEMENT_TIKTOK`）。</li></ul> |
|app_id {+条件必填}|string|推广的App的id。|
|pixel_id {+条件必填}|string|Pixel ID。仅对落地页生效</span>，且需同时传入`external_action`字段。您可以使用[/pixel/list/](https://ads.tiktok.com/marketing_api/docs?id=1740858697598978) 接口获取所有Pixel ID。|
|ios14_targeting{+条件必填}|string|您想定向的iOS设备版本。<br><p><span style="color:darkred"><b>注意:</b></span>：当推广系列的`campaign_type`设置为  `IOS14_CAMPAIGN` 时， `ios14_targeting`字段必填，且必须设置为 `IOS14_PLUS`。<br><br>枚举值：<ul><li>`UNSET`: 该字段的默认值。</li><li>`IOS14_MINUS`: 不受iOS14新的ATT框架影响的iOS设备(运行iOS14.4及更早版本的设备）。在本字段出现后，新建的广告组将以此值作为默认值。</li><li>`IOS14_PLUS`: iOS14.5及以后版本、已执行ATT框架的iOS设备。若想创建iOS14推广系列，需将`ios14_targeting`字段设置为`IOS14_PLUS`，每个iOS14推广系列允许存在最多2个启用状态的广告组。</li></ul><br> `ios14_targeting`字段设置为`IOS14_PLUS`后，不允许变更为其他值。如果设置为`IOS14_PLUS`，系统将会验证相关字段是否符合iOS14推广系列的要求。将会检查以下字段：<ul><li>`app_id`: 该字段的值不能是一个安卓App的ID。</li><li>`operating_systems`: 值不能为`ANDROID`或`PC`。</li><li>`min_ios_version`: 必须传入本字段，且该字段的值不能与`ios14_targeting`的值冲突。</li><li>`min_android_version`: 不能传入参数。</li><li>`optimization_goal`: 只能设置为`CLICK`，`INSTALL`，`IN_APP_EVENT`或`VALUE`。</li><li>`shopping_ads_retargeting_type`: 不能传入参数。</li><li>`shopping_ads_retargeting_actions_days`: 不能传入参数。</li><li>`conversion_window`: 不能传入参数。</li><li>在广告层级， `deeplink_type` 不能设置为 `DEFERRED_DEEPLINK`。</li></ul>|
|objective_type{必填} |string|推广目标。详见[枚举值 - 推广目标](https://ads.tiktok.com/marketing_api/docs?id=1701890985340929)|
|optimization_goal{必填}|string|优化目标。 <br>枚举值: 详见[枚举值-优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
| promotion_type {+条件必填} | string | `objective_type`为`PRODUCT_SALES`时必填。推广对象类型。<br>枚举值详见 [枚举值-推广对象类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
| product_source{+条件必填} | string |`objective_type` 为`PRODUCT_SALES`时必填。 商品来源，即您要推广的商品的来源。<br>枚举值：`UNSET`， `CATALOG` （商品库），`STORE`（TikTok Shop 店铺）。  |
| catalog_id {+条件必填} | string | `objective_type`为`PRODUCT_SALES`时必填。商品库ID。 |
|product_set_id|string| 商品库的商品系列ID。0表示选择所有商品系列。默认值为0。|
|catalog_authorized_bc_id {+条件必填}  |string| 如果所用的商品库是商务中心下的资产，那么您必须传入该商务中心的ID。|
| shopping_ads_retargeting_type  | string | 当`objective_type`为`PRODUCT_SALES`时有效。购物广告受众再营销类型。枚举值：<ul><li>`LAB1` : 对浏览过商品或者将商品加过购物车，但未购买过商品的受众进行再营销。 </li><li>`LAB2`：对将商品加过购物车,但未购买过商品的受众进行再营销。</li><li>`LAB3` : 使用自定义条件组合对受众进行再营销。</li><li>`OFF` : 不进行受众再营销。</li></ul> |
| shopping_ads_retargeting_actions_days{+条件必填} | number |`shopping_ads_retargeting_type` 为`LAB1`或`LAB2`时必填。<br> 所指定的受众行为的有效时间范围。在该时间范围内完成所指定行为的受众将成为购物广告受众再营销的对象。<br>取值范围：1，2，3，7, 14，30，60，90，180。|
| included_custom_actions {+条件必填} | object[] | 当 `shopping_ads_retargeting_type` 为`LAB3`时，您需要传入`included_custom_actions` 和 `excluded_custom_actions` 其中之一。<br>作为包含条件筛选购物广告受众再营销对象的自定义行为。|
#| code | string | 用于筛选出受众再营销对象的自定义行为。枚举值：<ul><li>`VIEW_PRODUCT`：受众浏览过商品。</li><li>`ADD_TO_CART` : 受众将商品加过购物车。</li><li>`PURCHASE` : 受众购买过商品。</li></ul>|
#| days | integer | 用于筛选出完成了自定义行为的受众的时间区间。取值范围：[1,180]。|
| excluded_custom_actions {+条件必填} | object[] |当 `shopping_ads_retargeting_type` 为`LAB3`时，您需要传入`included_custom_actions` 和 `excluded_custom_actions` 其中之一。<br>作为排除条件筛选购物广告受众再营销对象的自定义行为。|
#| code | string | 用于筛选出受众再营销对象的自定义行为。枚举值：<ul><li>`VIEW_PRODUCT`：受众浏览过商品。</li><li>`ADD_TO_CART` : 受众将商品加过购物车。</li><li>`PURCHASE` : 受众购买过商品。</li></ul>|
#| days | integer | 用于筛选出未完成自定义行为的受众的时间区间。取值范围：[1,180]。|
|audience_ids|string[]|受众 ID 列表，通过[/dmp/custom_audience/list/](https://ads.tiktok.com/marketing_api/docs?id=1739940506015746)接口进行管理。 |
|excluded_audience_ids|string[]|排除受众ID数组，通过[/dmp/custom_audience/list/](https://ads.tiktok.com/marketing_api/docs?id=1739940506015746) 接口进行管理。  |
|audience_rule |object| 受众规则，仅支持 `objective_type` 为 `TRAFFIC` 或 `WEB_CONVERSIONS`，见[受众规则](https://ads.tiktok.com/marketing_api/docs?id=1739566532187138) 。|
|audience_type |string| 应用重定向受众类型。枚举值及使用说明，请参考[枚举值 - 应用重定向受众类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)|
|location_ids{+条件必填}|string[]|想要定向的地域对应的地域 ID。<br>您需至少传入`location_ids`或`zipcode_ids`其中一，允许同时传入`location_ids`和`zipcode_ids`。<br><br>最大数量：3,000。若同时传入 `location_ids` 和 `zipcode_ids`，则单个广告组中地域 ID 和邮政编码 ID 的数量之和不可超过 3,000。<br><br>您可以使用[/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)或[/tool/targeting/search/](https://ads.tiktok.com/marketing_api/docs?id=1761236883355649)接口，根据您的版位和推广目标来查询您可以投放的地区以及相应 ID。<br>ID列表详见[附录-地域定向](https://ads.tiktok.com/marketing_api/docs?id=1739311040498689)。<br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>定向地域不允许重叠。例如，不支持同时定向美国和加利福尼亚州。</li></ul>|
| zipcode_ids {+条件必填}|string[]|您想要定向的地域的邮政编码 ID。<br>您需至少传入`location_ids`或`zipcode_ids`其中一，允许同时传入`location_ids`和`zipcode_ids`。<br><br>最大数量：3,000。若同时传入 `location_ids` 和 `zipcode_ids`，则单个广告组中地域 ID 和邮政编码 ID 的数量之和不可超过 3,000。<br><br>您可以通过[/tool/targeting/search/](https://ads.tiktok.com/marketing_api/docs?id=1761236883355649) 返回的`geo_id`（对应的`geo_type` 为`ZIP_CODE`）获取可投地域的邮政编码ID，返回结果基于您设置的版位，推广目标和关键词。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>邮政编码定向目前仅支持定向美国、加拿大、巴西、印度尼西亚、泰国、越南的地域。</li><li>巴西、印度尼西亚、泰国、越南的邮政编码定向目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>邮政编码定向仅支持 TikTok 版位。因此，`placements` 的值中不包含 `PLACEMENT_TIKTOK`。</li><li>定向地域不允许重叠。例如，不支持同时定向美国和加利福尼亚州。</li><li>欲获取邮政编码 ID 的信息，您仅可使用 [/tool/targeting/info/](https://ads.tiktok.com/marketing_api/docs?id=1761237001980929)。 </li></ul>|
| isp_ids | string[] | 想定向的互联网服务提供商的ID。<br>仅当同时通过`location_ids`传入有效的国家或地区层级的地域 ID 时生效。<br>您可通过[/tool/targeting/list/](https://ads.tiktok.com/marketing_api/docs?id=1762962378261506)获取地域ID对应的可定向的互联网服务提供商 ID。<br><p><span style="color:darkred"><b>注意</b></span>：若传入 `isp_ids`，不支持将版位设置为仅全球化应用组合（`placements` =`PLACEMENT_GLOBAL_APP_BUNDLE`）。|
|gender |string|定向受众性别。<br>枚举值: `GENDER_FEMALE`,`GENDER_MALE`,`GENDER_UNLIMITED`。|
|age_groups |string[]|定向受众年龄。<br>枚举值：详见[枚举值-受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|languages |string[]|受众语言。<br>枚举值：详见[枚举值-受众语言](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br>您可通过[/tool/language/](https://ads.tiktok.com/marketing_api/docs?id=1737188554152962)获取语言代码。若您不想限制受众语言，可为本字段传空值或不传入本字段。|
|interest_category_ids|string[]|用于定向受众的一般兴趣分类 ID 列表。<br><br><ul><li>若想搜索或列举一般兴趣分类 ID，可使用[/targeting/search/](1796638342793218.html)（推荐）或 [/tool/interest_category/](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961)。</li><li>若想获取基于您所在行业的推荐兴趣分类 ID 列表，可使用[/tool/targeting_category/recommend/](1736275204260866.html)。</li></ul>|
|interest_keywords_ids|string[]|用于定向受众的其他兴趣分类 ID 列表。<br><br>若想搜索其他兴趣分类 ID，可使用[/targeting/search/](1796638342793218.html)（推荐）或[/tool/interest_keyword/recommend/](https://ads.tiktok.com/marketing_api/docs?id=1763590884474882)。|
|purchase_intention_keyword_ids|string[]| 购买意向分类 ID 列表，用于定向近期行为表明其可能会购买某内容类别相关产品的受众。 <br><br>若想搜索或列举购买意向分类 ID，可使用[/targeting/search/](1796638342793218.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>不支持同时传入 `purchase_intention_keyword_ids` 和`interest_keyword_ids` ，否则会出现关键词冲突。</li><li>`purchase_intention_keyword_ids` 只支持竞价广告，且对应的 `objective_type`（推广目标）应为 `APP_PROMOTION`，`WEB_CONVERSIONS` ，`LEAD_GENERATION`，`TRAFFIC` 或 `PRODUCT_SALES`（对应的 `product_source` 需设置为`CATALOG`），同时版位需包含 TikTok（`PLACEMENT_TIKTOK`）或 Pangle （`PLACEMENT_PANGLE`）。 </li></ul>|
|actions| object[] |用于定向的行为分类对象数组。 |
#|action_scene |string| 用于定向的用户行为种类。<br><br>枚举值：<ul><li>`VIDEO_RELATED`：视频互动。</li><li>`CREATOR_RELATED`：创作者互动。</li><li>`HASHTAG_RELATED`：话题互动。</li></ul> |
#|action_period |number| 选择n天内发生的行为。<br><br>枚举值: `0`，`7`, `15`。<br><br>如果`action_scene`为`CREATOR_RELATED`或`HASHTAG_RELATED`，不论您传入何值，系统将默认使用`0`。`0`表示不设置行为发生的明确时间范围。<br><br><span style="color:darkred"><b>注意:</b></span> 目前，通过<b>TikTok广告管理平台</b>创建带有视频互动定向(`action_scene`= `VIDEO_RELATED`)广告组时，您无法选择行为时间范围(`action_period`)，系统将默认选择15天(`15`)。但是，通过<b>API</b>创建广告组时，仍然可以传入`0`，`7`或`15`。|
#|video_user_actions |string[]| 所选用户行为种类下想要定向的的具体用户行为。<br><br><ul><li>若`action_scene`为`VIDEO_RELATED`，枚举值为：`WATCHED_TO_END`（完播），`LIKED`（点赞），`COMMENTED`（评论），`SHARED`（分享）。 </li><li>若`action_scene`为`CREATOR_RELATED`，枚举值为：`FOLLOWING`（关注），`VIEW_HOMEPAGE`（浏览主页）。</li><li>若`action_scene`为`HASHTAG_RELATED`，枚举值为： `VIEW_HASHTAG`（浏览话题标签）。</li></ul><br><p><span style="color:darkred"><b>注意：</b></span><br>目前，通过<b>TikTok广告管理平台</b>创建广告组时，您无法指定用户行为种类 (`video_user_actions`)。通过<b>TikTok广告管理平台</b>创建的广告将默认使用以下选项：<ul><li>视频互动定向 (`action_scene`= `VIDEO_RELATED`)将选择全部四种选项 (`["WATCHED_TO_END","LIKED","COMMENTED","SHARED"]`)。</li><li>创作者互动定向(`action_scene`=`CREATOR_RELATED`)将选择全部两种选项(`["FOLLOWING","VIEW_HOMEPAGE"]`)。</li></ul>但是，通过<b>API</b>创建广告组时，您可以传入您想要的枚举值组合，例如：当`action_scene`=`VIDEO_RELATED`时传入`["LIKED","COMMENTED"] `。|
#|action_category_ids |string[]| 仅当仅选择 TikTok 版位投放时生效。<br><br>用于定向受众的视频互动分类 ID、创作者互动分类 ID、话题标签 ID 或话题包 ID 列表。<br><br><ul><li>若想搜索或列举视频互动分类 ID 或创作者互动分类 ID，可使用[/targeting/search/](1796638342793218.html)（推荐）或 [/tool/action_category/](https://ads.tiktok.com/marketing_api/docs?id=1737166752522241) 。</li><li>若想获取话题标签 ID 或话题包 ID，可使用[/targeting/search/](1796638342793218.html)（推荐）或 [/tool/hashtag/recommend/](https://ads.tiktok.com/marketing_api/docs?id=1736271339521025)。</li><li>若想获取基于您所在行业的推荐视频互动分类 ID、创作者互动分类 ID、话题标签 ID 或话题包 ID 列表，可使用[/tool/targeting_category/recommend/](1736275204260866.html)。</li></ul>|
|operating_systems{+条件必填}|string[]|受众操作系统。<br><br>仅支持传入一个值。<br><br>枚举值：`ANDROID`, `IOS`。<br><br>本字段在以下场景必填： <ul><li>`objective_type` 为 `APP_PROMOTION`时</li><li>`objective_type` 为`TRAFFIC` 且 `promotion_type` 为 `APP_IOS` 或 `APP_ANDROID` 时</li></ul>|
|min_ios_version|string|受众最低iOS版本。枚举值：详见[枚举值-最低iOS版本](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|min_android_version|string|受众最低Android版本。枚举值：详见[枚举值-最低Android版本](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|device_model_ids| string[]| 设备机型ID列表。可参考[获取设备机型列表](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)获取设备机型ID和状态的更多信息。创建广告时需确保对应设备处于活跃状态（ [/tool/device_model/](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369) 接口返回中`is_active` 为 `True`）。 <br><p><span style="color:darkred"><b>注意</b></span>: 不可同时设置设备机型 (`device_model_ids`) 和设备价格(`device_price_ranges`) 。|
|network_types|string[]|网络类型。默认值：`unlimited`。<br>详见[枚举值-网络类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|household_income| string[]| 您想定向的收入群体。枚举值：`TOP5`(家庭收入群体的前5%), `TOP10`(家庭收入群体的前10%),`TOP10_25`(家庭收入群体的前10-25%), `TOP25_50`(家庭收入群体的前25-50%). <br>目前，该字段有以下限制：<ul><li>不支持覆盖和频次广告。</li><li> 仅支持美国TikTok版位。</li><li>如果您在广告推广系列层面定义了 `special_industries`，那么也不允许使用此字段。</li></ul>  |
|spending_power|string|消费能力。<br><br>枚举值：`ALL`, `HIGH`。<br>如果设为`HIGH`，您就可以定向和普通用户相比 TikTok 广告投入支出通常更多的高消费能力用户。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>本字段不支持推广目标`PRODUCT_SALES`和`RF_REACH`。</li><li>本字段支持自动版位和包含 TikTok 的手动版位。因此，您需将 `placement_type`设置为 `PLACEMENT_TYPE_AUTOMATIC`，或在`placements`的值中包含`PLACEMENT_TIKTOK`。需注意，即使您指定了 Pangle 版位，消费能力定向也不会在 Pangle 版位生效。</li><li>如果您在广告推广系列层面定义了 `special_industries`，那么也不允许使用此字段。</li><li>如果在广告组层级，`auto_targeting_enabled` 设为 `true`，那么该字段会自动设为`ALL`。</li></ul>|
|device_price_ranges|number[]|设备价格区间（10000代表1000+）。该数字必须是50的倍数。<br><b><span style="color: darkred">重要提示</span></b>: 最终的实际上限将在您设定的上限基础上增加50，您可以在TikTok广告管理平台的广告组设置中看到实际上限。例如，如果您设置的价格区间是[0, 250]，实际区间则为[0, 300]。|
|carrier_ids |string[]| 运营商ID。 只有当运营商`in_use`字段为`true`时生效。获取详细信息，参阅[获取运营商列表](https://ads.tiktok.com/marketing_api/docs?id=1737168013095938)。|
|included_pangle_audience_package_ids |string[]| 包含 Pangle 流量包 ID。您可以使用接口[/pangle_audience_package/get/](https://ads.tiktok.com/marketing_api/docs?id=1740040177229826)获取受众ID (`package_id`) 。`bind_type`设置为`INCLUDE`。请不要同时传入该字段和`excluded_pangle_audience_package_ids`。|
|excluded_pangle_audience_package_ids |string[]| 排除 Pangle 流量包 ID。您可以使用接口[/pangle_audience_package/get/](https://ads.tiktok.com/marketing_api/docs?id=1740040177229826)获取受众ID (`package_id`) 。`bind_type`设置为`EXCLUDE`。请不要同时传入该字段和`included_pangle_audience_package_ids`。 |
|blocked_pangle_app_ids  |string[]| Pangle 媒体屏蔽列表 ID，可通过[查询 Pangle 媒体屏蔽列表](https://ads.tiktok.com/marketing_api/docs?id=1740039957181441)接口返回的 `app_package_id` 字段获取。仅当版位中含有 Pangle 时生效。 |
|included_custom_actions|object[]| 商品库广告重定向包含条件。<br> 详情可参考：<span style="font-size:14px">[DSA广告指南](https://ads.tiktok.com/marketing_api/docs?id=1739470724723714)</span>
|excluded_custom_actions|object[]| 商品库广告重定向不包含条件。<br> 详情可参考：<span style="font-size:14px">[DSA广告指南](https://ads.tiktok.com/marketing_api/docs?id=1739470724723714)</span>|
|automated_targeting|boolean|是否开启自动定向。|
|targeting_expansion{-将被废弃}| object | 定向扩量设置|
#|expansion_enabled|boolean| 是否开启定向扩量 |
#|expansion_types {+条件必填}|string[]| 您想要进行扩量的定向受众类型。当`expansion_enabled`为`true`时必传。可进行扩量的受众条件必须已设定值（不能为无限制）。枚举值： <ul><li>`AGE`</li><li>`GENDER`</li><li>`INTEREST_AND_BEHAVIOR`: 本类型包括`ad_tag_v2`, `video_action`, `action_days`, `action_categories`和`action_scene`。</li><li>`CUSTOM_AUDIENCE`: 本类型包括`retargeting_tags`和`retargeting_tags_exclude`。 </li></ul>|
|auto_targeting_enabled{-将被废弃}|boolean|是否开启自动定向。枚举值：`True`, `False`。|
|contextual_tag_ids |string[] | 内容相关定向标签ID列表。您可使用 [/tool/contextual_tag/get/](https://ads.tiktok.com/marketing_api/docs?id=1747747118654465) 获取可用的内容相关定向标签。请查看[内容相关定向](https://ads.tiktok.com/marketing_api/docs?id=1745292519923713)了解如何使用内容相关定向。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>本字段目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。</li><li>仅支持推广系列的推广目标为` REACH` 和 ` VIDEO_VIEWS` 。</li><li>不支持同时将` brand_safety_type` 设置为` THIRD_PARTY` 。</li></ul>|

返回

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述，可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息。更多信息可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据|
#|user_count_stage|number| 对预估受众人数的评价。枚举值： <ul><li>`1`: 过窄：预估受众人数占比小于20%且绝对人数小于10000。 </li><li>`2`: 较窄：预估手中人数占比小于20%但绝对人数大于等于10000。</li><li>`3`: 适中：预估受众人数占比大于等于20%且占比小于80%。</li><li>`4`: 较广：预估受众人数占比大于等于80%。</li></ul>|
#|user_count|object| 预估受众人数详细情况|
##|lower_end|number| 预估受众人数范围的下限|
##|upper_end|number| 预估受众人数范围的上限|
#|purchase_intention_keyword_ids|string[]|购买意向关键词ID列表，用于定向近期行为表明其可能会购买某内容类别相关产品的受众。    |
|request_id |string|请求的日志ID，唯一标识一个请求|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {
        "user_count": {
            "lower_end": 107229000,
            "upper_end": 131059000
        }
    },
    "request_id": "2021090909090909024510008412345678"
}
(/code);
← 获取投放中广告组的动态配额获取广告组 →

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