← 返回目录
📁 API Reference › Reach & Frequency

创建覆盖和频次广告组

此接口可用于创建覆盖和频次广告组。

如需查看详细说明，参见创建覆盖和频次推广系列。

v1.2 与 v1.3 接口对比

下表概述了 v1.2 接口与 v1.3 接口之间的差异。 ``xtable |变更{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/adgroup/rf/create/|/v1.3/adgroup/rf/create/| |请求参数名称|external_type<br>external_action<br>age<br>operation_system<br>connection_type<br>device_price<br>rf_buy_type<br>buy_impression<br>buy_reach<br>optimize_goal<br>brand_safety<br>display_mode|promotion_type<br>optimization_event<br>age_groups<br>operating_systems<br>network_types<br>device_price_ranges<br>rf_purchased_type<br>purchased_impression<br>purchased_reach<br>optimization_goal<br>brand_safety_type<br>delivery_mode| |请求参数数据类型|request_id: number<br>advertiser_id: number<br>campaign_id: number<br>app_id: number |request_id: string<br>advertiser_id: string<br>campaign_id: string<br>app_id: string| |请求参数名称和数据类型|is_share_disable: number<br>is_comment_disable: number<br>audience: number[]<br>excluded_audience: number[]<br>location: number[]<br>device_models: number[]<br>carriers_v2: number[]<br>interest_category_v2: number[]<br>video_download: string|share_disabled: boolean<br>comment_disabled: boolean<br>audience_ids: string[]<br>excluded_audience_ids: string[]<br>location_ids: string[]<br>device_model_ids: string[]<br>carrier_ids: string[]<br>interest_category_ids: string[]<br>video_download_disabled:boolean| | v1.3 中已弃用的请求参数| /|estimate_key| |新增请求参数 |/|contextual_tag_ids| |返回参数数据类型|adgroup_id: number|adgroup_id: string| |返回参数| /|在 v1.3 中，现会返回广告实体的完整信息。如需了解详细信息，参见本页面的“返回”小节。| |新增返回参数 |/|contextual_tag_ids`|


## 请求

**地址** https://business-api.tiktok.com/open_api/v1.3/adgroup/rf/create/

**方法** POST

**Header**

``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {Required}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {Required}|string|请求信息类型<br data-tomark-pass>允许格式：`"application/json"`  |

参数

| 字段 | 类型 | 描述 |
| --- | --- | --- |
| request_id {Required} | string | 请求 ID，用于创建相同名称的广告组。同时，请求 ID 还支持幂等处理，避免重复发送相同的请求。<br>请求 ID 不同于返回参数中的 `request_id`，后者用于唯一标识 HTTP 请求。<br><br>该值应为 64 位整数字符串形式。<br><br>示例：`"123456789"` |
| advertiser_id {Required} | string | 广告主 ID。 |
| campaign_id {Required} | string | 广告组所属的推广系列。 |
|share_disabled|boolean|是否禁止将此广告组中的广告分享到第三方平台。默认值：`False`。|
| adgroup_name {Required} | string | 广告组的名称。不得超过 100 个字符或包含任何表情符号。 |
|promotion_type {Required}|string| 推广类型，你可以使用此字段来选择商品推广的投放位置。枚举值：`APP_ANDROID`、`APP_IOS`、`WEBSITE`、`WEBSITE_OR_DISPLAY`。<br>如果 `objective_type` 为 `RF_REACH`，将此字段设置为 `WEBSITE_OR_DISPLAY`。|
|optimization_event |string|广告组的转化事件。如果推广对象是带有监测 URL 的应用，此为必填字段。如需了解支持的应用事件，参见[转化事件](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)。你可以使用 [/app/external_action/](https://ads.tiktok.com/marketing_api/docs?id=1740859338750977) 接口查看你的应用支持的事件。|
| app_id | string | 所推广手机应用的 ID。  |
| comment_disabled | boolean | 是否禁止用户在 TikTok 上评论你的广告。默认值：`False`。 |
|audience_ids | string[]|你希望定向的受众的 ID。对于要在覆盖和频次广告中定向或排除的受众，你必须在创建或更新受众时将 `audience_sub_type` 设置为 `REACH_FREQUENCY`。 <br><p><span style="color:darkred"><b>注意</b></span>：<br>不可在覆盖和频次广告中使用相似受众。否则系统将报错。 |
|excluded_audience_ids|string[]|你希望排除的受众 ID。对于要在覆盖和频次广告中定向或排除的受众，你必须在创建或更新受众时将 `audience_sub_type` 设置为 `REACH_FREQUENCY`。 <br><p><span style="color:darkred"><b>注意</b></span>：<br>不可在覆盖和频次广告中使用相似受众。否则系统将报错。 |
| age_groups| string[] | 你希望定向的年龄组。  <br><br>如果你的定向地域包含以色列或巴西，无法使用 `AGE_13_17`。  <br><br>枚举值参见[枚举值 - 受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><br>在某些情况下，不允许创建针对美国 13-17 岁年龄组受众 (`AGE_13_17`) 定向投放的广告组。如需了解更多信息，参见 [TikTok 广告的新年龄限制](1788755983247362.html)。<br>如果你使用不支持美国 13-17 岁年龄组受众的定向选项，且不传入 `age_groups` 字段或将其设置为 `[]`，系统将报错。你需要明确传入希望定向的具体年龄组，例如 `AGE_18_24`，以避免出错。|
|gender | string | 受众性别。如需了解更多详细信息，参见[枚举值 - 受众性别](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|languages | string[] | 你希望定向的语言的代码。支持的语言代码列表参见[枚举值 - 语言代码](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。  |
| location_ids {Required} | string[] | 定向地域的 ID。地域可为国家或地区层级、省/州层级、DMA（指定市场区域）或大都市区域层级，或城市层级。<br>地域定向仅支持单一国家或地区。 如果要定向多个地域，这些地域必须位于同一个国家或地区。<br>你可以在[关于覆盖和频次](https://ads.tiktok.com/marketing_api/docs?id=1744571201117186)中查看支持的国家和地区。 |
| is_hfss | boolean | 是否推广 HFSS 食品（高脂、高盐或高糖食品）。<span style="color:#f40909">请注意，禁止在欧洲市场面向未成年人推广 HFSS 食品。</span>  |
| operating_systems | string[] |你希望定向的设备操作系统。<br>枚举值：`ANDROID`、`IOS`、`PC`。|
| network_types |string[]| 你希望定向的设备连接类型。默认值：`unlimited`。枚举值参见[枚举值 - 网络类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|device_model_ids| string[]| 你希望定向的设备型号的 ID。目前仅支持品牌层级的型号 ID。如果传入此字段，不得传入 `device_price_ranges`。如需了解不同层级的设备型号 ID 的枚举值，参见[设备型号](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)。 <br><p><span style="color:darkred"><b>注意</b></span>：仅活跃设备（[/tool/device_model/](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369) 接口的返回结果中 `is_active` = `True`）可用于创建广告组。|
| device_price_ranges|number[]|定向设备价格范围。10,000 表示 1,000 以上。数字必须为 50 的倍数。<br><b><span style="color: darkred">重要说明</span></b>：系统会在你设置的上限基础上再加 50，并将所得的新数值用作设备定向的实际上限。实际上限会在 TikTok 广告管理平台的广告组设置中显示。如果你设置的价格范围为 [0, 250]，系统实际上会按 [0, 300] 处理。|
| carrier_ids |string[]| 你希望定向的运营商。仅当运营商的 `in_use` 字段为 `true` 时，运营商才生效。运营商必须与你希望定向的地域保持一致。使用[获取运营商列表](https://ads.tiktok.com/marketing_api/docs?id=1737168013095938)接口获取运营商 ID。 |
| interest_category_ids |string[]|你希望定向的兴趣类别列表。使用 [/tool/interest_category/](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961) 接口获取兴趣类别的完整列表。|
| rf_purchased_type{Required}  | string | 购买类型。允许的值： <ul><li>`FIXED_SHOW`：购买以达到固定次数的展示量。</li><li>`FIXED_REACH`：购买以触达固定数量的用户。</li><li>`FIXED_BUDGET`：使用固定预算购买。</li></ul>|
|budget{Required} | float | 预算。请根据广告库存预估 API 返回的数据填写此数值。如需了解如何传入该字段，参见[创建覆盖和频次推广系列 - 第 4 步](https://ads.tiktok.com/marketing_api/docs?id=1744571205201922)。 |
| purchased_impression {Required} | number | 要购买的展示量，<b>单位：1,000</b>。请根据广告库存预估 API 返回的数据填写此数值。如需了解如何传入该字段，参见[创建覆盖和频次推广系列 - 第 4 步](https://ads.tiktok.com/marketing_api/docs?id=1744571205201922)。 |
| purchased_reach {Required} | number | 已购买的用户覆盖人数，<b>单位：1,000</b>。请根据广告库存预估 API 返回的数据填写此数值。如需了解如何传入该字段，参见[创建覆盖和频次推广系列 - 第 4 步](https://ads.tiktok.com/marketing_api/docs?id=1744571205201922)。 |
| schedule_start_time {Required} | string | 排期开始时间 (UTC+0)，格式为  `YYYY-MM-DD HH:MM:SS`。<br><br>`schedule_start_time` 和 `schedule_end_time` 之间的间隔不得超过 90 天。<br><br>此字段的值必须采用 `YYYY-MM-DD HH:00:00`  格式，且时间应以广告投放市场所在的时区为准。<br>例如，如果位于 UTC-5 时区的广告主希望创建在 2023 年 11 月 1 日开始投放的覆盖和频次广告组，此字段必须设置为 `"2023-11-01 05:00:00"`。|
| schedule_end_time {Required} | string | 排期结束时间 (UTC+0)，格式为 `YYYY-MM-DD HH:MM:SS`。<br><br>`schedule_start_time` 和 `schedule_end_time` 之间的间隔不得超过 90 天。<br><br>此字段的值必须采用 `YYYY-MM-DD HH:59:59`  格式，且时间应以广告投放市场所在的时区为准。<br>例如，如果位于 UTC-5 时区的广告主希望创建在 2023 年 11 月 10 日结束投放的覆盖和频次广告组，此字段必须设置为 `"2023-11-10 04:59:59"`。|
|frequency{Required} | number | `frequency` 和 `frequency_schedule` 共同决定用户看到你的广告的频率（仅适用于采用 `REACH` 推广目标的广告）。<br>例如，`frequency` = 2 & `frequency_schedule` = 3 表示“每 3 天展示广告的次数不超过两次”。<br>应同时满足以下条件：<ul><li>1 ≤ `frequency` ≤ `frequency_schedule`。</li><li>1 ≤ `frequency_schedule` ≤ min (`schedule_end_time` - `schedule_start_time`, 30)。</li><li>频次上限由 `frequency` 和 `frequency_schedule` 共同决定，不得超过每天 4 次。</li></ul> |
| frequency_schedule {Required} | number | `frequency_schedule` 和 `frequency` 共同决定用户看到你的广告的频率（仅适用于采用 `REACH` 推广目标的广告）。更多信息参见 `frequency` 字段。 |
|optimization_goal {Required} | string |你希望通过广告实现的可度量成效。它必须与推广系列层级的 `objective_type` 值一致。枚举值：`REACH`、`VIDEO_VIEW`、`CLICK`、`POST_ENGAGEMENT`、`INSTALL`。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>对于在 [/campaign/create/](https://business-api.tiktok.com/portal/docs/create-a-campaign/v1.3) 接口中将推广系列层级的 `rf_campaign_type` 设置为 `PULSE` 的 TikTok Pulse 广告组，如果你想使用 6 秒完播率 (View+) 优化目标，将 optimization_goal 设置为 `REACH`，并将 `cpv_video_duration` 设置为 `SIX_SECONDS`。</li><li>TikTok Pulse 广告组中的 6 秒完播率 (View+) 优化目标目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li></ul>|
|cpv_video_duration {+Conditional} | string | 当 `optimization_goal` 为 `VIDEO_VIEW` 或希望使用 6 秒完播率 (View+) 优化目标时必填。<br><br>目标视频观看时长。<br><br>枚举值：`SIX_SECONDS`。<br><br><p><span style="color:darkred"><b>注意</b></span>：对于在 [/campaign/create/](https://business-api.tiktok.com/portal/docs/create-a-campaign/v1.3) 接口中将推广系列层级的 `rf_campaign_type` 设置为 `PULSE` 的 TikTok Pulse 推广系列，如果你想使用 6 秒完播率 (View+) 优化目标，将 `optimization_goal` 设置为 `REACH`，并将 `cpv_video_duration` 设置为 `SIX_SECONDS`。 |
|brand_safety_type|string|覆盖和频次广告的品牌安全类型。默认值：`NO_BRAND_SAFETY`。枚举值： <ul><li>`NO_BRAND_SAFETY`： 不使用任何品牌安全解决方案。 使用全部库存，意味着你的广告可能会展示在某些成人主题的内容前后。 </li><li>`EXPANDED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用扩展库存，意味着你的广告将展示在已移除大部分不当内容、不包含成人主题的内容前后。在下一个 API 版本中，`EXPANDED_INVENTORY` 将替代 `NO_BRAND_SAFETY`，并成为默认的品牌安全选项。</li><li>`STANDARD_INVENTORY`：使用 TikTok 品牌安全解决方案。使用标准库存，意味着你的广告将展示在适合大多数品牌的内容前后。 </li><li>`LIMITED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用有限库存，意味着你的广告将不会展示在包含成人主题的内容前后。</li><li>`THIRD_PARTY`：使用第三方品牌安全解决方案。你还需向 `brand_safety_partner` 字段传入一个值。</li></ul> 若想获取在你的品牌安全设置下可投放广告的国家和地区，需使用 [/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713) 接口。 <br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 出价前第三方品牌安全解决方案目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。 </li><li> 如需了解支持的推广目标、市场以及出价前品牌安全筛选功能的简要介绍，参见[品牌安全](https://ads.tiktok.com/marketing_api/docs?id=1739381752981505)。 </li></ul>|
|brand_safety_partner{+Conditional}|string|覆盖和频次广告的品牌安全合作伙伴。当 `brand_safety_type` 为 `THIRD_PARTY` 时，此为必填字段。枚举值：`IAS`、`OPEN_SLATE`（此合作伙伴在 TikTok 广告管理平台上显示为 <strong>DoubleVerify</strong>，因为其已被 DoubleVerify 收购)。<br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 出价前第三方品牌安全解决方案目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。 </li><li> 此字段设置后不可修改。 </li></ul>|
|category_exclusion_ids|string[]|当 `brand_safety_type` 设置为  `STANDARD_INVENTORY` 或 `LIMITED_INVENTORY` 时生效。<br><br>内容排除类别 ID。<br><br>你可以使用 [/tool/content_exclusion/get/](1769738074686465.html) 接口获取你的广告可不在其前后展示的内容类别 ID 列表 (`excluded_category_list`)。  |
|video_download_disabled|boolean| 用户是否可以在 TikTok 上下载你的视频广告（创建后不可更新）。默认值：`false`。|
|feed_type |string| 信息流类型选项。枚举值：`STANDARD_FEED`、`TOP_FEED`。`STANDARD_FEED` 指库存量大且 CPM 价格正常的信息流，`TOP_FEED` 指库存有限且 CPM 价格更高的信息流。 |
|delivery_mode |string|  用于排序和排定广告投放的策略。<br><br>枚举值：<ul><li>`STANDARD`：标准投放。你的广告将均匀投放，预计会获得大致相同的访问量。<ul><li>当 `optimization_goal` 为 `REACH` 且 `cpv_video_duration` 为 `SIX_SECONDS` 时，此值不适用于 6 秒完播率 (View+) 优化目标。</li></ul></li><li>`SCHEDULE`：按排期投放。设置投放每个广告的特定时间段。如果使用此值，需要同时传入对象数组 `schedules`。</li><li>`SEQUENCE`：按顺序投放。设置特定的广告投放顺序。如果使用此值，需要同时传入字段 `expected_orders`。</li><li>`VIEW_OPTIMIZE`：针对播放量优化投放。你的广告将按能最大限度提升完播率 (VTR) 的方式进行投放，系统会将更多展示量分配给预估 VTR 更高的广告。<ul><li>当 `optimization_goal` 为 `REACH` 且 `cpv_video_duration` 为 `SIX_SECONDS` 时，此值仅适用于 6 秒完播率 (View+) 优化目标。</li></ul></li><li>`OPTIMIZE`（<span style="color:red">已弃用</span>）：经过优化的投放，旨在实现最佳广告效果。</li></ul>|
|schedule_infos |object[]| 广告投放信息。  <br><br>当 `delivery_mode` 设置为 `SEQUENCE` 时，此数组中的对象数量表示你将传入顺序的广告的数量。|
#|schedules{+Conditional} |object[]| 当 `delivery_mode` 设置为 `SCHEDULE` 时必填。<br><br>你希望为广告设置的按排期投放的详细信息。<br><br>确保排期连续，并覆盖通过 `schedule_start_time` 和 `schedule_end_time` 传入的整个投放期。|
##|start_time |string| 广告投放开始时间，格式为 `"YYYY-MM-DD HH:MM:SS"`。 |
##|end_time |string| 广告投放结束时间，格式为 `"YYYY-MM-DD HH:MM:SS"`。 |
#|expected_orders {+Conditional} |number[]| 当 `delivery_mode` 设置为 `SEQUENCE` 时必填。  <br><br>广告组内某个广告的投放顺序。<br><br>若想为广告组中的每个广告设置固定投放顺序，需仅向此字段传入一个数字（例如 `[1]`）。值为 `[1]` 表示该广告将第一个投放。 |
|contextual_tag_ids |string[]|<br>当 `brand_safety_type` 设置为 `THIRD_PARTY` 时，不支持该字段。<br>当 `feed_type` 设置为 `TOP_FEED` 时，不支持该字段。<br><br>内容标签 ID。你可以使用 [/tool/contextual_tag/get/](https://ads.tiktok.com/marketing_api/docs?id=1747747118654465) 接口获取可用的内容标签。 <br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>如果你在 [/campaign/create/](1739318962329602.html) 接口中将 `rf_campaign_type` 设置为 `PULSE`，必须在创建广告组时，在 `PREMIUM` 类型下包含来自 `MAX_PULSE` 或 `CUSTOM` 内容频道组类型的内容标签。`GENERAL` 类型的内容标签为选填字段。如需详细了解如何使用 TikTok Pulse，参见 [TikTok Pulse](https://business-api.tiktok.com/portal/docs?id=1744571201117186#item-link-TikTok%20Pulse)。  <br><br>目前，你可以针对 `AE`（阿拉伯联合酋长国）、`AU`（澳大利亚）、`BR`（巴西）、`CA`（加拿大）、`DE`（德国）、`ES`（西班牙）、`FR`（法国）、`GB`（英国）、`IT`（意大利）、`MX`（墨西哥）、`SA`（沙特阿拉伯）、`TR`（土耳其）和 `US`（美国）定向投放 Max Pulse 广告；针对 `US`（美国）、`CA`（加拿大）、`BR`（巴西）、`AU`（澳大利亚）、`GB`（英国）、`FR`（法国）、`IT`（意大利）、`ES`（西班牙）、`DE`（德国）定向投放类别频道组。这两项功能均为白名单功能。若想在上述市场使用这些功能，请联系你的 TikTok 销售代表。 </li><li>此功能目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li></ul>|

示例

(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
 "languages": [
 "LANGUAGES"
 ], 
 "buy_impression": "BUY_IMPRESSION", 
 "is_comment_disable": "IS_COMMENT_DISABLE", 
 "estimate_key": "ESTIMATE_KEY", 
 "gender": "GENDER", 
 "age": [
 "AGE"
 ], 
 "frequency_schedule": "FREQUENCY_SCHEDULE", 
 "budget": "BUDGET", 
 "campaign_id": "CAMPAIGN_ID", 
 "advertiser_id": "ADVERTISER_ID", 
 "frequency": "FREQUENCY", 
 "location": [
 "LOCATION"
 ], 
 "schedule_end_time": "SCHEDULE_END_TIME", 
 "request_id": "REQUEST_ID", 
 "operation_system": [
 "OPERATION_SYSTEM"
 ], 
 "buy_reach": "BUY_REACH", 
 "rf_buy_type": "RF_BUY_TYPE", 
 "adgroup_name": "ADGROUP_NAME", 
 "schedule_start_time": "SCHEDULE_START_TIME"
}' \
https://business-api.tiktok.com/open_api/v1.3/adgroup/rf/create/
(/code)

返回

|字段|类型|描述|
|---|---|---|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id|string| 请求的日志 ID，唯一标识一个请求。|
|data |object|返回数据。 |
#| advertiser_id  | string | 广告主 ID。 |
#| campaign_id | string | 广告组所属的推广系列。 |
#| adgroup_id | string | 广告组 ID。 |
#|share_disabled|boolean|是否禁止将此广告组中的广告分享到第三方平台。默认值：`False`。|
#| adgroup_name  | string | 广告组的名称。不得超过 100 个字符或包含任何表情符号。 |
#|promotion_type |string| 推广类型，你可以使用此字段来选择商品推广的投放位置。枚举值：`APP_ANDROID`、`APP_IOS`、`WEBSITE`、`WEBSITE_OR_DISPLAY`。 |
#|optimization_event |string|广告组的转化事件。如果推广对象是带有监测 URL 的应用，此为必填字段。如需了解支持的应用事件，参见[转化事件](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)。你可以使用 [/app/external_action/](https://ads.tiktok.com/marketing_api/docs?id=1740859338750977) 接口查看你的应用支持的事件。|
#| app_id | string | 所推广手机应用的 ID。  |
#| comment_disabled | boolean | 是否禁止用户在 TikTok 上评论你的广告。默认值：`False`。 |
#|audience_ids | string[]|你希望定向的受众的 ID。对于要在覆盖和频次广告中定向或排除的受众，你必须在创建或更新受众时将 `audience_sub_type` 设置为 `REACH_FREQUENCY`。 |
#|excluded_audience_ids|string[]|你希望排除的受众 ID。对于要在覆盖和频次广告中定向或排除的受众，你必须在创建或更新受众时将 `audience_sub_type` 设置为 `REACH_FREQUENCY`。|
#| age_groups| string[] | 你希望定向的年龄组。如果你的定向地域包含以色列或巴西，无法使用 `AGE_13_17`。枚举值参见[枚举值 - 受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#| gender | string | 受众性别。如需了解更多详细信息，参见[枚举值 - 受众性别](https://ads.tiktok.com/marketing_api/docs?id=100641)。枚举值： `GENDER_FEMALE`、`GENDER_MALE` 和 `GENDER_UNLIMITED`。|
#| languages | string[] | 你希望定向的语言的代码。支持的语言代码列表参见[枚举值 - 语言代码](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。  |
#| location_ids  | string[] | 定向地域的 ID。如果要定向多个地域，这些地域必须位于同一个国家或地区。你可以在[覆盖和频次](https://ads.tiktok.com/marketing_api/docs?id=1739470723315713)中查看支持的国家和地区。如需获取地域 ID 列表，参见[地域 ID](https://ads.tiktok.com/marketing_api/docs?id=1701890989574146)。|
#| is_hfss | boolean | 是否推广 HFSS 食品（高脂、高盐或高糖食品）。<span style="color:#f40909">请注意，禁止在欧洲市场面向未成年人推广 HFSS 食品。</span>  |
#| operating_systems| string[] |你希望定向的设备操作系统。 枚举值：`ANDROID`、`IOS`、`PC`。|
#| network_types |string[]| 你希望定向的设备连接类型。默认值：`unlimited`。枚举值参见[枚举值 - 网络类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|device_model_ids| string[]| 你希望定向的设备型号的 ID。目前仅支持品牌层级的型号 ID。如需了解不同层级的设备型号 ID 的枚举值，参见[设备型号](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)。|
#| device_price_ranges|number[]|定向设备价格范围。10,000 表示 1,000 以上。数字必须为 50 的倍数。<br><b><span style="color: darkred">重要说明</span></b>：系统会在你设置的上限基础上再加 50，并将所得的新数值用作设备定向的实际上限。实际上限会在 TikTok 广告管理平台的广告组设置中显示。如果你设置的价格范围为 [0, 250]，系统实际上会按 [0, 300] 处理。|
#| carrier_ids |string[]| 你希望定向的运营商。仅当运营商的 `in_use` 字段为 `true` 时，运营商才生效。运营商必须与你希望定向的 location(s) 保持一致。枚举值 (`carrier_id`) 参见[获取运营商列表](https://ads.tiktok.com/marketing_api/docs?id=1737168013095938)。 |
#| interest_category_ids |string[]|你希望定向的兴趣类别列表。使用 [/tool/interest_category/](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961) 接口获取兴趣类别的完整列表。|
#| rf_purchased_type  | string | 购买类型。枚举值： <ul><li>`FIXED_SHOW`：购买以达到固定次数的展示量。</li><li>`FIXED_REACH`：购买以触达固定数量的用户。</li><li>`FIXED_BUDGET`：使用固定预算购买。</li></ul>|
#|budget| float | 预算。请根据广告库存预估 API 返回的数据填写此数值。 |
#| purchased_impression | number | 要购买的展示量，<b>单位：1,000</b>。 |
#| purchased_reach  | number | 已购买的用户覆盖人数，<b>单位：1,000</b>。 |
#| schedule_start_time | string | 排期开始时间 (UTC+0)，格式为  `YYYY-MM-DD HH:MM:SS`。|
#| schedule_end_time | string | 排期结束时间 (UTC+0)，格式为 `YYYY-MM-DD HH:MM:SS`。|
#|frequency |number| `frequency` 和 `frequency_schedule` 共同决定用户看到你的广告的频率（仅适用于采用 `REACH` 推广目标的广告）。<br>例如，`frequency` = 2 & `frequency_schedule` = 3 表示“每 3 天展示广告的次数不超过两次”。 |
#|frequency_schedule |number| `frequency_schedule` 和 `frequency` 共同决定用户看到你的广告的频率（仅适用于采用 `REACH` 推广目标的广告）。更多信息参见 `frequency` 字段。 |
#|optimization_goal  | string |你希望通过广告实现的可度量成效。它必须与推广系列层级的 `objective_type` 值一致。枚举值：`REACH`、`VIDEO_VIEW`、`CLICK`、`POST_ENGAGEMENT`、`INSTALL`。|
#|cpv_video_duration  | string | 目标视频观看时长。<br><br>枚举值：  `SIX_SECONDS`。 |
#|brand_safety_type|string|覆盖和频次广告的品牌安全类型。枚举值： <ul><li>`NO_BRAND_SAFETY`： 不使用任何品牌安全解决方案。 使用全部库存，意味着你的广告可能会展示在某些成人主题的内容前后。 </li><li>`EXPANDED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用扩展库存，意味着你的广告将展示在已移除大部分不当内容、不包含成人主题的内容前后。在下一个 API 版本中，`EXPANDED_INVENTORY` 将替代 `NO_BRAND_SAFETY`，并成为默认的品牌安全选项。</li><li>`STANDARD_INVENTORY`：使用 TikTok 品牌安全解决方案。使用标准库存，意味着你的广告将展示在适合大多数品牌的内容前后。 </li><li>`LIMITED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用有限库存，意味着你的广告将不会展示在包含成人主题的内容前后。</li><li>`THIRD_PARTY`：使用第三方品牌安全解决方案。 </li></ul> 若想获取在你的品牌安全设置下可投放广告的国家和地区，需使用 [/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713) 接口。 |
#|brand_safety_partner|string|覆盖和频次广告的品牌安全合作伙伴。仅当 `brand_safety_type` 为 `THIRD_PARTY` 时可用。枚举值：`IAS`、`OPEN_SLATE`（此合作伙伴在 TikTok 广告管理平台上显示为 <strong>DoubleVerify</strong>，因为其已被 DoubleVerify 收购)。|
#|category_exclusion_ids|string[]|内容排除类别 ID。|
#|video_download_disabled|boolean| 用户是否可以在 TikTok(cannot be updated once created) 上下载你的视频广告。 默认值：`false`。|
#|feed_type |string| 信息流类型选项。枚举值：`STANDARD_FEED`、`TOP_FEED`。`STANDARD_FEED` 指库存量大且 CPM 价格正常的信息流，`TOP_FEED` 指库存有限且 CPM 价格更高的信息流。 |
#|delivery_mode |string| 用于排序和排定广告投放的策略。<br><br>枚举值：<ul><li>`STANDARD`：标准投放。你的广告将均匀投放，预计会获得大致相同的访问量。 </li><li>`SCHEDULE`：按排期投放。 设置投放每个广告的特定时间段。  </li><li>`SEQUENCE`：按顺序投放。设置特定的广告投放顺序。 </li><li>`VIEW_OPTIMIZE`：针对播放量优化投放。你的广告将按能最大限度提升完播率 (VTR) 的方式进行投放，系统会将更多展示量分配给预估 VTR 更高的广告。</li><li>`OPTIMIZE`（<span style="color:red">已弃用</span>）：经过优化的投放，旨在实现最佳广告效果。</li></ul>|
#|schedule_infos |object[]| 广告投放信息。|
##|schedules |object[]| 广告的按排期投放详细信息。 |
###|start_time |string| 广告投放开始时间。 |
###|end_time |string| 广告投放结束时间。 |
##|expected_orders |number[]| 广告组内某个广告的投放顺序。<br><br>例如，值为 `[1]` 表示该广告将第一个投放。|
##|is_draft|boolean|广告投放信息是否处于草稿模式。<br><br>如果此字段的值为 `true`，表示在请求中定义的广告投放信息尚未与任何特定广告相关联。<br><br>若想将广告投放信息与广告关联，需通过 [/ad/create/](1739953377508354.html) 接口将返回的 `schedule_id` 值传入请求参数 `schedule_id`。将广告投放信息与广告关联后，该字段的值将自动设置为 `false`，`schedule_id` 值将为已与之关联的广告投放信息的广告 ID。|
##|schedule_id|string|排期 ID。<br><br>如果 `is_draft` 的值为 `true`，表示在请求中定义的广告投放信息尚未与任何特定广告相关联。<br><br>若想将广告投放信息与广告关联，需通过 [/ad/create/](1739953377508354.html) 接口将此字段的值传入请求参数 `schedule_id`。将广告投放信息与广告关联后，`is_draft` 的值将自动设置为 `false`，此字段的值将为已与之关联的广告投放信息的广告 ID。|
#|notice|string|系统通知。|
#|contextual_tag_ids |string[]|内容标签 ID。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
 "code": 40002,
 "message": "This campaign has been deleted.",
 "request_id": "{{request_id}}",
    "data": {}
}
(/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 每日平台更新简报 →