创建广告组
您可以使用本接口创建广告组。在广告组层级可配置广告的版位，受众定向设置（请参阅广告定向），预算和排期，以及出价和优化。欲了解创建广告组的流程以及重要字段，请参阅创建广告组。
在迁移至1.3版本前，请先阅读推广系列管理接口迁移指南，了解推广系列管理API 1.2与1.3版本之间的重点差异。
若想了解 TikTok 广告管理平台上推广系列、广告组、广告层级的功能在 API 中的对应配置，请查看TikTok 广告管理平台的推广系列功能与 API 配置间的映射。
注意
若您已在推广系列层级设置special_industries，需确保该推广系列中的广告组满足对于的定向要求，参见使用特殊广告分类的推广系列中广告组的定向要求。
iOS 14专属推广系列中的广告组
每个iOS 14专属推广系列最多可包含两个启动状态的广告组。要创建一个iOS14专属推广系列中的广告组，您需要将ios14_targeting 设为 IOS14_PLUS。您可以点击这里查看iOS 14专属推广系列指南。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/adgroup/create/|/v1.3/adgroup/create/|
|请求参数名称|<br>placement<br>external_type<br>age<br>operation_system<br>connection_type<br>device_price<br>android_osv<br>ios_osv<br>ios_target_device<br>optimize_goal<br>external_action<br>deep_external_action<br>bid<br>conversion_bid<br>deep_cpabid<br>daily_retention_ratio<br>action_v2<br>user_actions<br>include_custom_actions<br>exclude_custom_actions<br>dpa_retargeting_type<br>dpa_retargeting_actions_days<br>brand_safety<br>enable_expansion<br>ad_app_profile_page_type|<br>placements<br>promotion_type<br>age_groups<br>operating_systems<br>network_types<br>device_price_ranges<br>min_android_version<br>min_ios_version<br>ios14_targeting<br>optimization_goal<br>optimization_event<br>secondary_optimization_event<br>bid_price<br>conversion_bid_price<br>deep_cpa_bid<br>next_day_retention<br>actions<br>video_user_actions<br>included_custom_actions<br>excluded_custom_actions<br>shopping_ads_retargeting_type<br> shopping_ads_retargeting_actions_days<br>brand_safety_type<br>expansion_enabled<br>adgroup_app_profile_page_state|
|请求参数类型|advertiser_id: number<br>campaign_id: number <br>app_id: number <br>store_id: number<br>pixel_id: number<br>catalog_id: number<br>skip_learning_phase: number|advertiser_id: string <br>campaign_id: string <br>app_id: string <br>store_id: string<br>pixel_id: string<br>catalog_id: string<br>skip_learning_phase: boolean|
|请求参数名称和类型|is_comment_disable: number<br>store_authorized_bc: number<br>audience: number[]<br>excluded_audience: number[] <br>location: number[]<br>interest_category_v2: number[]<br>interest_keywords: number[]<br>device_models: number[]<br>carriers_v2: number[]<br>video_download: string <br>pangle_block_app_list_id: number[]<br>action_categories: number[]<br>pangle_audience_package_include: number[]<br>pangle_audience_package_exclude: number[]<br>catalog_authorized_bc: number<br>automated_targeting: string |comment_disabled: boolean<br>store_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> device_model_ids : string[]<br>carrier_ids: string[]<br> video_download_disabled: boolean<br>blocked_pangle_app_ids: string[]<br>action_category_ids: string[]<br> included_pangle_audience_package_ids: string[]<br> excluded_pangle_audience_package_ids: string[]<br>catalog_authorized_bc_id: string<br>auto_targeting_enabled: boolean |
|新增请求参数|/ |shopping_ads_type<br>product_source<br>contextual_tag_ids<br>purchase_intention_keyword_ids<br>spending_power<br>request_id<br>share_disabled<br>promotion_target_type<br>zipcode_ids<br>isp_ids<br>category_exclusion_ids<br>vertical_sensitivity_id<br>search_result_enabled<br>click_attribution_window<br>view_attribution_window<br>attribution_event_count<br>shopping_ads_retargeting_custom_audience_relation<br>saved_audience_id<br>smart_audience_enabled<br>smart_interest_behavior_enabled<br>engaged_view_attribution_window<br>vbo_window<br>tiktok_subplacements<br>messaging_app_type<br>messaging_app_account_id<br>phone_region_code<br>phone_region_calling_code<br>phone_number<br>message_event_set_id<br>deep_funnel_optimization_status<br>deep_funnel_event_source<br>deep_funnel_event_source_id<br>deep_funnel_optimization_event<br>search_keywords<br>automated_keywords_enabled<br>custom_conversion_id<br>is_lhf_compliance<br>app_config|
|废弃请求参数|/ |cpv_video_duration<br>carriers|
|废弃参数枚举植|/|不允许在 optimization_goal字段中使用VIDEO_VIEW<br> 不允许在bid_display_mode字段中使用CPMV|
|返回参数|/ | 在v1.3中，系统将返回广告实体的完整信息。详情请参阅本页面的返回部分。|
|返回参数类型|adgroup_id: number|adgroup_id`: string|
## 请求
**地址** <https://business-api.tiktok.com/open_api/v1.3/adgroup/create/>
**方法** 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。|
|campaign_id {必填}|string|广告组所属的推广系列ID。|
|adgroup_name {必填}|string|广告组名，长度小于 512 字符，不能包含emoji。|
|request_id|string|请求 ID，用于创建同名广告组。<br>若想创建同名广告组，可发送两个创建广告组的请求，请求中指定相同的 `adgroup_name` 和不同的 `request_id`。<br><br>该 ID 还支持接口幂等，可在 10 秒内避免重复请求。如果您在 10 秒内传入相同的请求 ID 重试多次请求，只有一次请求会成功。<br><br>该 ID 和返回参数中的 `request_id` 不同。返回的`request_id`用于唯一标识一次 HTTP 请求。<br><br>本字段的值需为字符串格式的64位整数值。 <br><br>示例： `123456789`|
|shopping_ads_type {+条件必填}|string| 当对应的推广系列 `objective_type` 为 `PRODUCT_SALES`时必填。 <br><br>购物广告类型。<br><br>枚举值：<ul><li>`VIDEO`：视频购物广告。</li><li>`LIVE`：直播购物广告。</li><li>`PRODUCT_SHOPPING_ADS`：商品购物广告。</li></ul> <br>若想了解不同类型的购物广告以及创建[视频购物广告](1741942291730434.html)、[直播购物广告](1754162402455554.html)和[商品购物广告](1785886237030401.html)的步骤，请查看[创建购物广告](1741942179356738.html)。|
|identity_id {+条件必填}|string|仅当 `shopping_ads_type` 为 `VIDEO` 且 `product_source` 为 `SHOWCASE` 或 `shopping_ads_type` 为 `LIVE` 时生效且必填。<br><br>认证身份 ID。|
|identity_type{+条件必填}|string|仅当 `shopping_ads_type` 为 `VIDEO` 且 `product_source` 为 `SHOWCASE` 或 `shopping_ads_type` 为 `LIVE` 时生效且必填。<br><br>认证身份类型。支持选项： `AUTH_CODE` (授权帖子用户), `TT_USER` (TikTok 商务账号用户)，`BC_AUTH_TT`（已添加到商务中心的TikTok用户）。参阅[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097) 获取详细信息。|
|identity_authorized_bc_id{+条件必填}|string|与添加到商务中心的TikTok用户这一认证身份绑定的商务中心的ID。当`identity_type` 为 `BC_AUTH_TT`时必填。|
|product_source{+条件必填}|string|仅视频购物广告和商品购物广告必填。<br><br>商品来源，即您要推广的商品的来源。<br><br>枚举值：`UNSET` ,`CATALOG`(商品库)，`STORE` (TikTok Shop)，`SHOWCASE`（TikTok 橱窗）。<ul><li>对于视频购物广告：<ul><li>通过`campaign_product_source`设置的推广系列层级商品来源决定了广告组层级可选的商品来源：<ul><li>若在推广系列层级`campaign_product_source`设置为`CATALOG`，本字段仅可设置为`CATALOG`。</li><li>若在推广系列层级`campaign_product_source`设置为 `STORE`，本字段仅可设置为`STORE`或`SHOWCASE`。</li></ul></li><li>若未在推广系列层级设置`campaign_product_source`，且同一推广系列下存在至少一个`product_source`设置为`CATALOG` 的历史广告组，和一个`product_source`设置为`STORE` 或`SHOWCASE`的历史广告组，则该推广系列下不允许新建广告组。</li><li>同一推广系列下的广告组的商品来源需均设置为`CATALOG`，或为`STORE`和`SHOWCASE`的组合（包括均为`STORE`，或均为`SHOWCASE`，或为`STORE`和`SHOWCASE`的混合） 。 </li></ul></li><li>对于商品购物广告，需将本字段设置为`STORE`。</li></ul>|
|catalog_id{+条件必填}|string| <ul><li>若 `product_source` 设置为 `CATALOG` 或 `STORE`，本字段必填。</li><li>若 `shopping_ads_type` 设置为 `LIVE`，则字段 `catalog_id`，`catalog_authorized_bc_id`，`store_id` 和 `store_authorized_bc_id` 为选填字段。若您通过这些字段为您的直播购物广告指定了TikTok Shop，将会报告此商店的商品销量。若您不指定 TikTok Shop，将会报告 TikTok 账号（`identity_id`）显示的商品销量。</li></ul><br>商品库ID。 <br><br><ul><li>若 `product_source` 设置为 `CATALOG`，需将本字段设置为您想推广的商品所在的商品库。</li><li>若 `product_source` 设置为 `STORE`，需将本字段设置为与您想推广的商品所在的TikTok Shop 绑定的商品库。</li></ul>您可使用[/store/list/](1752267762718722.html)获取广告账户下可用商店对应的 `catalog_id`，`store_id` 和 `store_authorized_bc_id`。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月 30 日起， `product_source` 为 `STORE` 时，您将无需再传入 `catalog_id`，因为该字段将被忽略。|
|catalog_authorized_bc_id {+条件必填}|string| <ul><li>若 `shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为`CATALOG` 或 `STORE`，本字段必填。</li><li>若 `shopping_ads_type` 设置为 `LIVE`，本字段选填。</li><li>若 `shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 设置为 `STORE`，不支持本字段。</li></ul><br>对该商品库有权限的商务中心的 ID。 <br><br>如果要操作的是已经资产化的商品库，则需要传入相应的商品库 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月 30 日起， `product_source` 为 `STORE` 时，您将无需再传入 `catalog_id`，因为该字段将被忽略。|
|store_id {+条件必填} |string|<ul><li>在以下任意场景必填：<ul><li>`shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `STORE`。</li><li>`shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 设置为 `STORE`。</li></ul></li><li>`shopping_ads_type` 设置为 `LIVE` 时，本字段选填。</li></ul><br>TikTok Shop 店铺 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：欲获取 TikTok Shop 店铺 ID，您可以调用[/bc/asset/get/](https://ads.tiktok.com/marketing_api/docs?id=1739432717798401)：当返回中的`asset_type`为 `TIKTOK_SHOP`时，对应的`asset_id`为 TikTok Shop 店铺 ID。|
|store_authorized_bc_id {+条件必填}|string|传入 `store_id` 时必填。 <br><br>有权管理该商店 (`store_id`）的商务中心的ID。|
|promotion_type {+条件必填} |string|推广对象类型（优化位置）。若对应的推广系列推广目标不是`REACH`，`VIDEO_VIEWS`或`ENGAGEMENT`，则此字段必填。<br>枚举值详见 [枚举值-推广对象类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><p><span style="color:darkred"><b>注意</b></span>: 如果在推广系列层级的`objective_type`是 `ENGAGEMENT`，则该字段只能使用 `EXTERNAL_OR_DISPLAY`。|
|promotion_target_type |string| 仅当推广系列层级的`objective_type` 设置为 `LEAD_GENERATION`时有效。<br> 推广目标线索收集的专属推广对象类型。<br>您可以查看[线索广告](https://ads.tiktok.com/marketing_api/docs?id=1739470742024193)，了解如何创建线索广告。<br>枚举值： <ul><li> `INSTANT_PAGE`：即时表单（线索表单）。创建可快速加载的应用内 TikTok 即时表单来收集更多线索。</li><li> `EXTERNAL_WEBSITE`：第三方网站表单。使用包含第三方网站表单的落地页，或使用会重定向至包含第三方网站表单网站的TikTok即时体验页面来收集更多线索。</li></ul><br>若本字段设置为`EXTERNAL_WEBSITE`且 `optimization_goal` 为 `CLICK`，无需同时传入`pixel_id` 和 `optimization_event`。 |
|messaging_app_type{+条件必填} |string|仅当 `promotion_type` 为 `LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE` 时生效。<ul><li>`optimization_goal` 为 `CONVERSATION` 时，本字段必填。</li><li>`optimization_goal` 为 `CLICK` 时，本字段默认值为`IM_URL`。</li></ul><br>即时通讯广告组中使用的即时通讯应用或自定义 URL。<br><br> 枚举值：<ul><li> `MESSENGER`：Messenger。您需同时通过 `messaging_app_account_id` 指定 Facebook 公共主页。</li><li> `WHATSAPP`：WhatsApp。您需同时指定 `phone_region_code`、`phone_region_calling_code` 和 `phone_number`。系统将自动使用这些字段填充对应的 WhatsApp 电话号码。</li><li>`ZALO`: Zalo。您需同时指定 `phone_region_code`、`phone_region_calling_code` 和 `phone_number` 来自动填充对应的 Zalo 电话号码。</li><li>`LINE`: Line。您需同时通过 `messaging_app_account_id` 指定 LINE Business ID。</li><li>`IM_URL`：即时通讯 URL。</li></ul><br>默认值：`IM_URL`。<br><br>若想了解如何创建 TikTok 即时通讯广告，可查看[创建优化位置为即时通讯应用的线索广告](1774482999036930.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>`optimization_goal` 为 `CONVERSATION` 时，不支持将本字段设置为 `ZALO`，`LINE` 或 `IM_URL`。</li><li>本字段设置后不支持更新。</li></ul> |
| messaging_app_account_id {+条件必填} | string |<ul><li>`messaging_app_type` 为 `MESSENGER`或 `LINE` 时，本字段必填。</li><li>`messaging_app_type` 为 `WHATSAPP`, `ZALO`或 `IM_URL` 时，将忽略本字段。 </li></ul> <br>即时通讯应用账号 ID。<ul><li> `messaging_app_type` 为 `MESSENGER` 时，需通过本字段指定 Facebook 公共主页编号。 <ul><li>若要查找您的 Facebook 公共主页编号，请前往您的 Facebook 公共主页，点击封面照片下方的<b>简介</b>（About），然后点击<b>公共主页信息公示</b>（Page transparency）。</li></ul></li><li>当 `messaging_app_type` 为 `LINE` 时，通过此字段指定 LINE Business ID。<ul><li>若要查找您的 LINE Business ID，请前往您的 LINE 官方账号页面。</li></ul></li><li>`messaging_app_type` 为 `WHATSAPP` 时，将忽略本字段并自动根据指定的`phone_region_code`、`phone_region_calling_code` 和 `phone_number`填充为对应的 WhatsApp 电话号码。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持更新。 |
| phone_region_code {+条件必填} | string | `messaging_app_type` 为 `WHATSAPP` 或 `ZALO` 时，本字段必填。<br><br>WhatsApp 或 Zalo 电话号码的地区代码。<br><br>示例：`US`。 <br><br>若想获取与某一电话号码所绑定的地区对应的地区代码（ `phone_region_code` ）和电话区号 （ `phone_region_calling_code` ），需使用[/tool/phone_region_code/](1774488637039618.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持更新。 |
| phone_region_calling_code{+条件必填} | string | `messaging_app_type` 为 `WHATSAPP` 或 `ZALO` 时，本字段必填。<br><br> WhatsApp 或 Zalo 电话号码的区号。 <br><br>示例：`+1`。 <br><br>若想获取与某一电话号码所绑定的地区对应的地区代码（ `phone_region_code` ）和电话区号 （ `phone_region_calling_code` ），需使用[/tool/phone_region_code/](1774488637039618.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持更新。 |
| phone_number {+条件必填} | string | `messaging_app_type` 为 `WHATSAPP` 或 `ZALO` 时，本字段必填。<br><br>WhatsApp 或 Zalo 电话号码。 <br>对于 WhatsApp，需使用在消息管理工具（MMT）中绑定的 WhatsApp 电话号码。 <br><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持更新。 |
|promotion_website_type{+条件必填}|string|广告组中的 TikTok 即时体验页面类型。<br>枚举值：<ul><li>`UNSET`：不使用 TikTok 即时体验页面。</li><li>`TIKTOK_NATIVE_PAGE`：使用 TikTok 即时体验页面。<br>若您在广告组层级将本字段设置为 `TIKTOK_NATIVE_PAGE`，则不支持传入 `pixel_id`，且您需要在广告层级通过 `page_id` 指定 TikTok 即时体验页面。</li></ul>若想了解如何创建应用预注册广告，请查看[这里](https://ads.tiktok.com/marketing_api/docs?id=1772549012687873)。<br><p><span style="color:darkred"><b>注意</b></span>：若推广系列层级`app_promotion_type`设置为`APP_PREREGISTRATION`，本字段必填。|
|app_id {+条件必填}|string|推广的应用的 ID。您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786)获取`app_id`。<br>在以下使用场景中必填：<ul><li>`objective_type` 设置为 `APP_PROMOTION`，且 `app_promotion_type`设置为`APP_RETARGETING`（应用再营销）。</li><li>`objective_type` 设置为 `APP_PROMOTION`，且 `app_promotion_type`设置为`APP_INSTALL`（应用安装）或`APP_PREREGISTRATION`（应用预注册），同时对应的推广系列非iOS 14专属推广系列。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>: 您不能使用未在 MMP（移动监测合作伙伴）侧启用 SAN（自归因）模块的 App 创建广告组。若想确保您的 App 启用 TikTok 自归因集成，可查看[如何将新应用集成到 SAN](https://ads.tiktok.com/help/article/transition-to-san-for-existing-apps) 和[如何将现有应用迁移到 SAN](https://ads.tiktok.com/help/article/integrate-to-san-for-new-apps)。|
|pixel_id {+条件必填}|string|<ul><li>`optimization_goal` 设置为 `CONVERT` 或`VALUE` 时必填。</li><li> `optimization_goal`非`CONVERT` 或`VALUE` 时不支持。</li></ul>Pixel ID。<br>若想获取广告账户中的 Pixel ID 列表，可使用 [/pixel/list/](1740858697598978.html)。|
|optimization_event{+条件必填}|string|以下任一场景下必填：<ul><li>指定了 `pixel_id`。</li><li>未指定 `pixel_id` 且 `optimization_goal` 非 `IN_APP_EVENT` 或 `VALUE`。</li></ul><br>转化事件。<br><br>若想了解支持的应用和 Pixel 事件，请查看[转化事件](1739361474981889.html)。<br>若想了解您的应用支持的事件，请使用 [/app/optimization_event/](1740859338750977.html)。<br><br><span style="color: darkred"><b>注意：</b></span><ul><li> 若您要在一个已开启CBO的推广系列下创建新的广告组，需确保本字段的值与第一个广告组中的设置保持一致。</li><li>当`optimization_goal`为 `PAGE_VISIT` 时，`optimization_event` 将自动设置为 `PAGE_VISIT`。</li></ul> |
| app_config {+条件必填} | object[] | 推广系列层级 `sales_destination` 为 `WEB_AND_APP` 时必填。<br><br>想要推广的应用详情。<br>最大数量：2。<br>您可以通过本字段指定以下任意类型应用：<br><ul><li>一个安卓应用</li><li>一个 iOS 应用</li><li>一个安卓应用和一个 iOS 应用</li></ul> |
#| app_id {+条件必填} | string | 传入`app_config` 时本字段必填。<br><br>想要推广的应用的 ID。<br><br>若想获取广告账户中的应用 ID 列表，可使用[/app/list/](1740859313270786.html)并查看返回的`app_id`. |
|custom_conversion_id|string|要在广告组中使用的自定义转化的 ID。<br><br>仅当同时满足以下所有条件时生效:<ul><li>指定了`pixel_id`或`app_id`。</li><li>已为`pixel_id`或`app_id`配置了自定义转化。</li><li>`optimization_goal`设置为`CONVERT`或`IN_APP_EVENT`。</li><li>已指定参数`optimization_event` 且该参数与自定义转化关联的标准事件匹配。</li><li>自定义转化的状态为“活跃”或“近期无活动”。</li></ul><br>要获取与 Pixel 或应用关联的自定义转化列表，可使用[/custom_conversion/list/](1842225174460673.html)。 <ul><li>要确认自定义转化是否可用于广告组创建:<ul><li>确保返回的`optimization_event`与广告组创建时指定的`optimization_event`匹配。</li><li>确保`activity_status`为`NO_RECENT_ACTIVITY`或`ACTIVE`。</li></ul></li></ul>|
| deep_funnel_optimization_status| string | 仅当 `promotion_type` 为 `LEAD_GENERATION` 时本字段生效 。 <br> <br> 深层漏斗优化的状态。 <br> 深层漏斗优化同时优化浅层和深层漏斗事件。您可以在主要优化事件之外再选择一个次要事件，这有助于提升推广系列的效果。 <br> <br> 枚举值： <ul><li>`ON` ：启用深层漏斗优化。 </li><li>`OFF`：不启用深层漏斗优化。 </li></ul> 默认值：`OFF`。 <br><br>若想了解如何在线索广告中配置深层漏斗优化，可查看[创建优化位置为即时表单的线索广告](1774482920012801.html)和[创建优化位置为落地页的线索广告](1774482976097281.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>使用 CRM 事件组的深层漏斗优化目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>使用 Pixel 或线下事件组的深层漏斗优化已全量发布。</li></ul> |
| deep_funnel_event_source {+条件必填} | string | `deep_funnel_optimization_status` 为 `ON` 时本字段必填。 <br><br> 事件源类型。 <br><br>枚举值： <ul><li> `PIXEL`：Pixel。</li><li>`OFFLINE`：线下事件组。</li><li>`CRM`：CRM 事件组。</li></ul> |
| deep_funnel_event_source_id{+条件必填} | string | `deep_funnel_optimization_status` 为 `ON` 时本字段必填。<br><br> 事件源 ID。 <br><br><ul><li> `deep_funnel_event_source` 为 `PIXEL` 时，通过本字段指定一个 Pixel ID。<ul><li>若想获取 Pixel 列表，可使用 [/pixel/list/](1740858697598978.html)。</li></ul></li><li>`deep_funnel_event_source` 为 `OFFLINE` 时，通过本字段指定一个线下事件组 ID。<ul><li>若想获取线下事件组 ID 列表，可使用 [/offline/get](1765596808589313.html)。 </li></ul></li><li>当`deep_funnel_event_source`为`CRM`时，通过本字段指定一个 CRM 事件组。<ul><li>若想获取 CRM 事件组 ID 列表，可使用[/crm/list/](1780896521680898.html)。</li></ul></li></ul>|
| deep_funnel_optimization_event {+条件必填} | string | `deep_funnel_optimization_status` 为 `ON` 时 本字段必填。 <br><br> 深层漏斗优化事件。 <br><br><ul><li>若想获取 Pixel、线下事件组和 CRM 事件组支持的标准事件值，可查看[ Pixel 事件类型](1739585696931842.html)中的“<b>用于广告创编的事件名称</b>”列。</li><li>若想获取某个 Pixel 的优化事件，可使用 [/pixel/list/](1740858697598978.html) 并查看返回的 `optimization_event`。</li></ul> <br>示例： `SHOPPING`。 |
|placement_type |string|版位类型。 <br><br>枚举值：<ul><li>`PLACEMENT_TYPE_AUTOMATIC`：自动版位。TikTok 的广告系统将使用智能计算，为您选择所有可用应用的版位最佳组合。 </li><li>`PLACEMENT_TYPE_NORMAL`：编辑版位。通过手动编辑版位，你将能够自主选择广告投放的应用。 </li></ul><br>默认值: `PLACEMENT_TYPE_NORMAL`。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>广告组创建后无法更新`placement_type`。</li><li>若本字段设置为 `PLACEMENT_TYPE_AUTOMATIC` ，则返回的 `placements` 将显示实际支持的版位。例如，若实际仅支持 TikTok 版位，返回的 `placements` 值将为 `PLACEMENT_TIKTOK`。</li></ul>|
|placements {+条件必填}|string[]|<ul><li>当 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 时，本字段必填。</li><li>当 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC` 时，忽略本字段，系统将自动选择版位写入`placements`。</li></ul><br>版位，即广告投放的应用。 <br> <br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>广告组创建后无法更新`placements`。</li><li>目前，`placements`字段支持`PLACEMENT_TIKTOK `，`PLACEMENT_PANGLE`，`PLACEMENT_GLOBAL_APP_BUNDLE`。由于`PLACEMENT_TOPBUZZ`和`PLACEMENT_HELO`已被废弃，请不要选择它们作为广告投放版位。获取枚举值的完整列表，请参考[枚举值-版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。</li><li>在全球化应用组合版位（`PLACEMENT_GLOBAL_APP_BUNDLE`）下支持定向的地区包括：巴西、印度尼西亚、越南、菲律宾、泰国、马来西亚、墨西哥、沙特阿拉伯和日本。</li><li>全球化应用组合版位下不支持优化目标落地页浏览量（`optimization_goal`=`TRAFFIC_LANDING_PAGE_VIEW`）。欲了解该优化目标详情，请查看[枚举值-优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。</li><li>在竞价覆盖人数广告组中使用全球化应用组合版位（`PLACEMENT_GLOBAL_APP_BUNDLE`）目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。<ul><li>如果推广系列层级 `objective_type` 设置为 `REACH`，且广告组层级 `placements` 的值包含 `PLACEMENT_GLOBAL_APP_BUNDLE`，不支持同时设置 `contextual_tag_ids`。</li><li>如果推广系列层级 `objective_type` 设置为 `REACH`，且广告组层级 `placements` 设置为 `["PLACEMENT_GLOBAL_APP_BUNDLE"]`，不支持将 `brand_safety_type` 设置为 `THRID_PARTY`。</li></ul></li><li>若所属的推广系列的推广目标为商品销量（`objective_type` = `PRODUCT_SALES`），仅支持 TikTok 版位（`PLACEMENT_TIKTOK`）。</li></ul>|
| tiktok_subplacements | string[] | 仅当满足以下条件时生效： <ul><li>推广系列层级：`objective_type` 为 `REACH`、`VIDEO_VIEWS` 或 `ENGAGEMENT`。</li><li>广告组层级：`placements` 为 `["PLACEMENT_TIKTOK"]` 且 `placement_type` 为 `PLACEMENT_TYPE_NORMAL`。</li></ul><br>TikTok 子版位，用于选择广告出现的具体位置。<br><br> 枚举值：<ul><li>`IN_FEED`：信息流。广告将投放在“推荐”动态中，可能投放在“个人资料页”和“关注”推荐内容中。</li><li>`SEARCH_FEED`：搜索推荐内容。</li><li>`TIKTOK_LITE`<span style="color:Red">即将废弃</span>：TikTok Lite，占用内容更小、视频加载速度更快的精简版 TikTok 应用。TikTok Lite 子版位仅支持定向日本或韩国时使用。</li><li>`LEMON8`：Lemon8，一款生活方式内容社区应用，内容包含真实生活体验分享、小贴士、指南和商品测评。如果在子版位中包含 Lemon8，广告将展示在其推荐页信息流、搜索信息流和沉浸式视频信息流中。 [了解 Lemon8 的详情](https://ads.tiktok.com/help/article/about-lemon8-in-tiktok-ads-manager)。<ul><li>仅支持在推广系列层级将 `objective_type` 设置为 `REACH` 时在 `tiktok_subplacements` 中包含 `LEMON8`。</li></ul></li></ul><br><ul><li>若您传入 `tiktok_subplacements`， `tiktok_subplacements` 的值中需至少包含 `IN_FEED`。</li><li>若想在 `tiktok_subplacements` 的值中包含 `TIKTOK_LITE`，您需要在定向地域（`location_ids`）中包含日本或韩国的地域。否则，将出现报错。</li><li>若想在 `tiktok_subplacements` 的值中包含 `SEARCH_FEED`、 `TIKTOK_LITE` 或 `LEMON8`，不可同时将 `brand_safety_type` 设置为 `THRID_PARTY`。<ul><li>如果推广系列层级 `objective_type` 设置为 `REACH`，且广告组层级 `tiktok_subplacements` 的值包含 `LEMON8`，不支持同时设置 `contextual_tag_ids`。</li></ul></li></ul> <br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>自 2025 年 7 月 19 日起，您将无法创建或复制使用子版位 TikTok Lite （`TIKTOK_LITE`）的广告组。为确保流畅、不受影响的广告创建体验，推荐您从广告组创建流程中移除此子版位或避免复制包含此类广告组的推广系列。</li><li>在广告组中使用子版位 TikTok Lite（`TIKTOK_LITE`）目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>在广告组中使用子版位搜索推荐内容（`SEARCH_FEED`）目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>在竞价覆盖人数广告组中使用 Lemon8 子版位（`LEMON8`）目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>本字段设置后不允许更新。</li><li>若您创建的广告组的 `tiktok_subplacements` 值中包含 `TIKTOK_LITE`，则不允许更新广告组时从定向地域（`location_ids`）中完全去除日本和韩国地域。</li><li>子版位搜索推荐内容（`SEARCH_FEED`）支持的创新互动样式仅包括展示卡片。不过，该创新互动样式可能不支持您在推广系列层级设置的推广目标。若想了解展示卡片和推广目标的兼容情况，请查看[卡片](https://business-api.tiktok.com/portal/docs?id=1749019652141058#item-link-展示卡片)。</li><li>子版位 TikTok Lite（`TIKTOK_LITE`）支持的创新互动样式仅包括展示卡片、倒计时贴纸和礼品码贴纸。不过，这些创新互动样式可能不支持您在推广系列层级设置的推广目标。若想了解这些新互动样式和推广目标的兼容情况，请查看[卡片](https://business-api.tiktok.com/portal/docs?id=1749019652141058#item-link-展示卡片)和[贴纸](1749019667506177.html)。 </li></ul>|
| search_result_enabled| boolean | 是否在搜索广告中展示您的广告，即当用户在 TikTok 上搜索您的业务相关信息时，系统是否向他们展示您的广告。<br><br><ul><li>若您使用以下推广目标 ( `objective_type` ) : `APP_PROMOTION`, `WEB_CONVERSIONS` , `TRAFFIC` , `LEAD_GENERATION` ，且将 `placement_type` 设置为 `PLACEMENT_TYPE_AUTOMATIC`，或将 `placement_type`设置为 `PLACEMENT_TYPE_NORMAL`的同时将 `PLACEMENT_TIKTOK` 包含在 `placements` 字段中, 则本字段会自动设置为`true`。此时您若想打开自动搜索广告位，可以不传入本字段，或为本字段传入 `true`。 此时您若想关闭自动搜索广告位，需将本字段设置为 `false`。</li><li>若推广目标 (`objective_type`) 为 `WEB_CONVERSIONS`、`TRAFFIC` 或 `LEAD_GENERATION` 且 `is_search_campaign` 为 `true`，本字段将自动设置为 `false` ，因为搜索广告推广系列与自动搜索广告位不兼容。此时，不支持将本字段手动设置为 `true`。</li><li>若您未使用以下推广目标 ( `objective_type` ) : `APP_PROMOTION`, `WEB_CONVERSIONS` , `TRAFFIC` , `LEAD_GENERATION` ，或将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 的同时未将 `PLACEMENT_TIKTOK` 包含在 `placements` 字段中，本字段将自动设置为`false`。此时您无法再将本字段设置为`true`。</li></ul><br>若想了解搜索广告详情，请查看[创建搜索广告](1780164603696130.html)。|
|automated_keywords_enabled|boolean|仅在满足推广系列层级 `is_search_campaign` 为 `true` 时生效。<br><br>是否启用自动关键词，即在添加广告后，让系统自动生成关键词。这样可以拓展优质流量，以便提升成效。在报表中查看成效出色的自动关键词。<br><br>支持的值：`true`，`false`。<br>默认值：`false`。<br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>搜索广告推广系列中启用自动关键词目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li></ul>|
|search_keywords{+条件必填}|object[]|<ul><li>对于搜索广告推广系列（`is_search_campaign` 为 `true`），本字段必填。</li><li>对于非搜索广告推广系列（`is_search_campaign` 为 `false`），不支持本字段。</li></ul><br>搜索关键词列表，即用于与人们搜索的词语匹配，以展示您的广告的一组搜索关键词，可以是词或词组。<br><br>最大数量：1,000。<br><br>若想确认某一推广系列是否为搜索广告推广系列，可使用[/campaign/get/](1739315828649986.html)并查看为该推广系列返回的 `is_search_campaign`。<br><br>若想了解搜索广告推广系列详情，请查看[创建搜索广告推广系列](1815394136739841.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>支持为单个广告组配置最多 1,000 个搜索关键词。</li></ul>|
#|keyword{+条件必填}|string|传入 `search_keywords` 时，需至少提供一个 `keyword` 及对应的 `match_type`。<br><br>搜索关键词。<br><br>长度限制：80 个字符。<br>名称中不可使用表情符号和以下特殊字符：`!` `#` `$` `%` `&` `(` `)` `*` `-` `/` `:` `;` `<` `>` `?` `@` `\` `^` `_` `¥` `……`。否则会出现报错提示。<br><br>若想获取搜索关键词的审核结果，需调用[/adgroup/get/](1739314558673922.html)，检查返回的对象数组 `search_keywords` 中的 `audit_status` 字段。<br><br><p><span style="color:DarkRed"><b>重要</b></span>: 搜索关键词必须遵守 TikTok 的[广告投放条款](https://ads.tiktok.com/help/article/advertising-on-tiktok-first-things-to-note)和社区守则。 <ul><li>若您的关键词被全部判定为违反这些守则，相应的推广系列将不会投放。</li><li>若您的部分关键词未通过审核，请使用[/adgroup/update/](1739586761631745.html)删除违规关键词或更换为恰当的替代关键词。您的推广系列将使用通过审核的关键词继续投放。</li></ul>|
#|match_type{+条件必填}|string|传入 `search_keywords` 时，需至少提供一个 `keyword` 及对应的 `match_type`。<br><br>搜索关键词对应的匹配类型。<br><br>枚举值：<ul><li>`PRECISE_WORD`：精确匹配。您的广告将会在用户的搜索词与这些关键词完全匹配时展示。</li><li>`PHRASE_WORD`：词组匹配。您的广告将会在用户以相同词序搜索这些关键词时展示。</li><li>`BROAD_WORD`：广泛匹配。您的广告将会在用户搜索这些关键词中的任意词时展示，无论词序是否相同。</li></ul>|
#|keyword_bid_type|string|关键词和匹配类型组合的出价类型。<br><br>枚举值：<ul><li>`FOLLOW_ADGROUP`：使用广告组层级的出价（`bid_price`）作为 `keyword_bid`。</li><li>`CUSTOM`：通过 `keyword_bid` 自定义出价。</li></ul><br>默认值：`FOLLOW_ADGROUP`。<br><br>仅当满足以下条件时支持使用枚举值 `CUSTOM`：<ul><li>推广系列层级：<ul><li>`objective_type` 为 `TRAFFIC`</li><li>`is_search_campaign` 为 `true`。</li></ul></li><li>广告组层级：<ul><li>`bid_type` 为 `BID_TYPE_CUSTOM`</li><li>`bid_price` 被指定。</li></ul></li></ul>|
#|keyword_bid{+条件必填}|float|<ul><li>仅当 `keyword_bid_type` 为 `CUSTOM` 时本字段生效且必填。</li><li>`keyword_bid_type` 为 `FOLLOW_ADGROUP` 时忽略本字段。</li></ul><br>关键词和匹配类型组合的出价。<br><br>取值范围：>0。|
|comment_disabled |boolean|是否允许用户在TikTok上评论您的广告。|
|video_download_disabled |boolean| 用户是否可以在 TikTok 上下载您的广告视频（该字段创建后不允许修改）。|
| share_disabled|boolean|是否禁止将本广告组中的广告分享到第三方平台。默认值： `False`。仅当以下条件均满足时 `True`的值会生效：<ul><li>推广系列层级的`objective_type` 设置为以下推广目标之一： `APP_PROMOTION`，`WEB_CONVERSIONS`， `REACH`， `TRAFFIC`，`VIDEO_VIEWS`，`ENGAGEMENT`， `LEAD_GENERATION`。</li><li>版位：<ul><li>`placement_type`设置为 `PLACEMENT_TYPE_AUTOMATIC` 或</li><li>`placement_type`设置为`PLACEMENT_TYPE_NORMAL`且 `placements` = `PLACEMENT_TIKTOK`</li></ul></li></ul>|
|blocked_pangle_app_ids|string[]| Pangle 媒体屏蔽列表 ID。 可通过[查询 Pangle 媒体屏蔽列表](https://ads.tiktok.com/marketing_api/docs?id=1740039957181441)接口返回的`app_package_id`字段获取。仅当版位中含有 Pangle 时生效。 |
|saved_audience_id |string | 以下情形支持该字段：<ul><li>您的推广系列未选择房地产，就业，信贷行业类型（`specical_industries`）。</li><li><b>且</b>您的推广系列的推广目标(`objective_type`) 不为商品销量(`PRODUCT_SALES`)。</li><li><b>且</b>您的广告组选择TikTok广告位（即`placement_type`设置为`PLACEMENT_TYPE_AUTOMATIC`；<b>或</b>`placement_type`设置为`PLACEMENT_TYPE_NORMAL`且`placements`包含`PLACEMENT_TIKTOK`）。</li><li><b>且</b>您的广告组未使用自动定向(即 `auto_targeting_enabled` 未设置为`true`)。</li></ul><br>已保存受众ID。<br>在使用此字段之前，请调用[/dmp/saved_audience/create/](1780154541898754.html)创建已保存受众，并在返回中获取已保存受众ID。与您的已保存受众关联的广告主ID应与广告组中的广告主ID相同。否则，将会出现错误。<br>如果您使用`saved_audience_id`创建广告组，将返回已保存受众ID和包含在已保存受众中的定向选项。 <br>请参阅[创建已保存受众](1780156510696449.html)以了解详细的流程和代码示例。 <br><span style="color:darkred"><b>注意</b></span>：<ul><li>通过[/dmp/saved_audience/create/](1780154541898754.html)创建已保存受众时，您可以指定`gender`等定向选项。但是，如果您使用已保存受众创建广告组，则必须避免同时设置`saved_audience_id`和已保存受众中已有的定向选项（如`gender`）。否则，将会出现错误。</li><li>如果您的已保存受众的设备设置与广告组的设备设置冲突，则会出现错误。例如：<ul><li> 当您的已保存受众的操作系统为Android时，但在创建广告组时，您将`ios14_targeting`设置为`IOS14_PLUS`。</li><li>当您在广告组中使用 Android 应用程序的 App ID，且将`objective_type`字段指定为`APP_PROMOTION`，但您的已保存受众操作系统为iOS。</li></ul></li><li>如果您的API请求引发与已保存受众配置和广告组配置之间冲突相关的错误，则当前错误消息将指示问题涉及您的受众定向选项。为解决此问题，建议使用[/dmp/saved_audience/list/](1780154541898754.html)检查相应定向选项的详细信息，以确定问题的来源，必要时创建新的已保存受众。</li><li>若`saved_audience_id` 创建时设置了`age_groups`， [TikTok 广告的新增年龄定向限制](1788755983247362.html)中针对不同推广目标的年龄限制规定将也适用于该保存受众。在广告组中使用保存受众前，请确保其年龄定向合法。</li></ul>|
|auto_targeting_enabled{-即将废弃}|boolean|是否开启自动定向。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月起，您将无法为广告组开启自动定向或定向扩量。为保证流畅的 API 体验，我们建议您使用[智能定向](1783164662979586.html)。|
| shopping_ads_retargeting_type {+条件必填} | string | `shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `CATALOG` 时必填。<br><br>购物广告受众再营销类型。<br><br>枚举值：<ul><li>`LAB1` : 对浏览过商品或者将商品加过购物车，但未购买过商品的受众进行再营销。 </li><li>`LAB2`：对将商品加过购物车,但未购买过商品的受众进行再营销。</li><li>`LAB3` : 使用自定义条件组合对受众进行再营销。</li><li>`OFF` : 不进行受众再营销。</li></ul> |
| shopping_ads_retargeting_actions_days{+条件必填} | number | 所指定的受众行为的有效时间范围。在该时间范围内完成所指定行为的受众将成为购物广告受众再营销的对象。<br> `shopping_ads_retargeting_type` 为`LAB1`或`LAB2`时必填。 <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` 其中之一。|
#| 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` 其中之一。|
#| code | string | 用于筛选出受众再营销对象的自定义行为。枚举值：<ul><li>`VIEW_PRODUCT`：受众浏览过商品。</li><li>`ADD_TO_CART` : 受众将商品加过购物车。</li><li>`PURCHASE` : 受众购买过商品。</li></ul>|
#| days | integer | 用于筛选出未完成自定义行为的受众的时间区间。取值范围：[1,180]。|
| shopping_ads_retargeting_custom_audience_relation | string | 仅当以下条件均满足时生效： <ul><li>`shopping_ads_type` 设置为 `VIDEO`。</li><li>`product_source`设置为 `CATALOG`。</li><li>传入`shopping_ads_retargeting_type` 且将其设置为`LAB1`，`LAB2` 或 `LAB3`。</li><li>传入`audience_ids` 。</li></ul><br>由 `shopping_ads_retargeting_type` 字段指定的视频购物广告重定向受众与由 `audience_ids` 指定的自定义受众间的逻辑关系。<br><br>枚举值：<ul><li> `OR`：取视频购物广告重定向受众和自定义受众的并集构建定向受众。定向受众中包含属于视频购物广告重定向受众或自定义受众的人群。</li><li> `AND`：取视频购物广告重定向受众和自定义受众的交集构建定向受众。定向受众中仅包含同时属于视频购物广告重定向受众和自定义受众的人群。</li></ul><br>若未设置本字段，将取视频购物广告重定向受众和自定义受众的交集构建定向受众。<br><br><p><span style="color:darkred"><b>注意</b></span>：设置本字段后，不允许手动将本字段更新为 null 值。 |
|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/targeting/search/](https://ads.tiktok.com/marketing_api/docs?id=1761236883355649) 或 [/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)接口，根据您的版位和推广目标来查询您可以投放的地区以及相应 ID。ID 列表也可以通过 [附录-地域定向](https://ads.tiktok.com/marketing_api/docs?id=1739311040498689)查看。<br> <br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>定向地域不允许重叠。例如，不支持同时定向美国和加利福尼亚州。</li><li> 若您在创建广告组时通过 `location_ids` 或 `zipcode_ids` 定向了美国地域，您可随后将定向地域更新为美国的其他地域，但不允许从定向地域中完全去除美国地域，从而只定向非美国地域。</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><p><span style="color:darkred"><b>注意</b></span>：<ul><li> 邮政编码定向目前仅支持定向美国、加拿大、巴西、印度尼西亚、泰国、越南的地域。</li><li>巴西、印度尼西亚、泰国、越南的邮政编码定向目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>不支持在启用了特殊广告分类（`special_industries`）的推广系列中使用邮政编码定向。</li><li>不支持在 `objective_type` 为 `RF_REACH` 的推广系列中使用邮政编码定向。</li><li>邮政编码定向仅支持 TikTok 版位。因此，`placements` 的值中不包含 `PLACEMENT_TIKTOK`。</li><li>定向地域不允许重叠。例如，不支持同时定向美国和加利福尼亚州。</li><li>若您在创建广告组时通过 `location_ids` 或 `zipcode_ids` 定向了美国地域，您可随后将定向地域更新为美国的其他地域，但不允许从定向地域中完全去除美国地域，从而只定向非美国地域。</li><li>欲获取邮政编码 ID 的信息，您仅可使用[/tool/targeting/info/](https://ads.tiktok.com/marketing_api/docs?id=1761237001980929)。 </li></ul>|
|languages |string[]|受众语言。<br>枚举值：详见[枚举值-受众语言](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br>您可通过[/tool/language/](https://ads.tiktok.com/marketing_api/docs?id=1737188554152962)获取语言代码。若您不想限制受众语言，可为本字段传空值或不传入本字段。|
|gender |string|定向受众性别。<br>枚举值: `GENDER_FEMALE`,`GENDER_MALE`,`GENDER_UNLIMITED`。|
|age_groups |string[]|定向受众年龄区间。<br><br>枚举值详见[枚举值-受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-受众年龄区间)。<br><br>在某些场景下，不允许创建定向美国、拉丁美洲、欧洲经济区、英国、瑞士或加拿大 13-17 年龄区间（`AGE_13_17`）受众的广告组。若想了解详情，请查看 [TikTok 广告的新增年龄定向限制](1788755983247362.html)。<br>若您使用了与美国、拉丁美洲、欧洲经济区、英国、瑞士或加拿大 13-17 年龄区间定向不兼容的定向设置，且将 `age_groups` 设置为 `[]` 或不传入字段 `age_groups` ，则该字段将默认为`["AGE_18_24", "AGE_25_34", "AGE_35_44", "AGE_45_54", "AGE_55_100"]`。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您想要定向美国、拉丁美洲、欧洲经济区、英国、瑞士或加拿大 13-17 年龄区间且通常将 `age_groups` 设置为 `[]` 或不传入字段 `age_groups`，推荐您在该字段中明确指定您想要定向的具体年龄区间，例如`AGE_18_24`。 |
|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>如果在广告组层级，`auto_targeting_enabled` 设为 `true`，那么该字段会自动设为`ALL`。</li></ul> |
|household_income| string[]| 您想定向的收入群体。枚举值：`TOP5`(家庭收入群体的前5%), `TOP10`(家庭收入群体的前10%),`TOP10_25`(家庭收入群体的前10-25%), `TOP25_50`(家庭收入群体的前25-50%). <br>注意: <ul><li> 该字段仅支持竞价广告。参考[推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737585562434561)了解详情。</li><li> 该字段仅支持美国TikTok版位。</li></ul> |
|audience_ids|string[]|受众 ID 列表，通过[/dmp/custom_audience/list/](https://ads.tiktok.com/marketing_api/docs?id=1739940506015746)接口进行管理。 |
| smart_audience_enabled | boolean | 是否启用智能受众。 <br><br>枚举值： `true`， `false`。 <br><br>若想了解智能受众详情及如何启用智能受众，请查看[智能定向](1783164662979586.html)。 |
|excluded_audience_ids|string[]|排除受众 ID 列表，通过[/dmp/custom_audience/list/](https://ads.tiktok.com/marketing_api/docs?id=1739940506015746) 接口进行管理。 |
|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_keyword_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>|
| smart_interest_behavior_enabled | boolean | 是否启用智能型兴趣和行为。<br><br>枚举值： `true`， `false`。 <br><br>若想了解智能型兴趣和行为详情及如何启用智能型兴趣和行为，请查看[智能定向](1783164662979586.html)。 |
|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`。 |
|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_android_version|string|受众最低Android版本。枚举值：详见[枚举值-最低Android版本](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|ios14_targeting{+条件必填}|string|推广系列的`campaign_type`为 `IOS14_CAMPAIGN` 时， 本字段必填，且必须设置为 `IOS14_PLUS`。<br><br>您想定向的 iOS 设备版本。<br><br>枚举值：<ul><li>`UNSET`：运行 iOS 14.4 及更早版本的设备。</li><li>`IOS14_MINUS`：不受 iOS14 新的 ATT 框架影响的 iOS 设备（运行比 iOS 14.0 更早版本的设备）。</li><li>`IOS14_PLUS`：运行 iOS 14.5 及之后版本、已执行 ATT 框架的 iOS 设备。此值仅支持在专属推广系列中使用。若想创建 iOS14 推广系列，需将`ios14_targeting`字段设置为`IOS14_PLUS`，每个iOS 14 推广系列允许存在最多 2 个启用状态的广告组。</li><li>`ALL`：运行 iOS 14.5 及之后版本的设备。此值仅支持在 iOS 应用再营销广告或 iOS 重定向类型的视频购物广告（商品来源为商品库且优化位置为应用）中使用。<ul><li>若想在应用再营销广告中定向 iOS 14.5 及以后版本的设备，需将`ios14_targeting`设置为 `ALL` 且将 `min_ios_version` 设置为`14.5`或之后版本。</li><li>若想在应用再营销广告中定向 iOS 14.4 及更早版本的设备，无需传入`ios14_targeting`。</li></ul></li> </ul><br>对于以下两种场景，将忽略您的传参，并将本字段设置为 `ALL`。<ul><li>iOS 应用再营销广告：<ul><li>`app_promotion_type` 为 `APP_RETARGETING`</li><li>且 `promotion_type` 为 `APP_IOS`</li></ul></li><li>iOS 重定向类型的视频购物广告（商品来源为商品库且优化位置为应用）：<ul><li>`shopping_ads_type` 为 `VIDEO`</li><li> `product_source` 为 `CATALOG`</li><li> `promotion_type` 为 `APP_IOS`</li><li>且 `shopping_ads_retargeting_type` 非 `OFF`</li></ul></li></ul>对于其他场景，默认值为 `UNSET`。<br><br>本字段设置为 `IOS14_PLUS` 后不允许更新，且需满足以下条件：<ul><li>广告组层级：<ul><li>`app_id` 字段设置为 iOS App 的 ID。<br>若想获取iOS App 的 ID，可使用[/app/list/](1740859313270786.html)。 iOS App 对应的`platform` 为 `IOS` 。 </li><li>`operating_systems` 字段设置为`["IOS"]`。</li><li>传入 `min_ios_version` 字段，且字段值与`ios14_targeting` 字段的值相匹配。</li><li>`optimization_goal` 字段设置为 `CLICK`，`INSTALL`，`IN_APP_EVENT` 或 `VALUE`。</li><li>不传入以下字段：<ul><li> `min_android_version`</li><li>`shopping_ads_retargeting_type` </li><li>`shopping_ads_retargeting_actions_days`</li></ul> </li></ul> </li><li>广告层级：<ul><li> `deeplink_type` 字段不可设置为 `DEFERRED_DEEPLINK` 。</li></ul></li></ul>|
|min_ios_version{+条件必填} |string|传入`ios14_targeting`时本字段必填。<br><br>受众最低 iOS 版本。<br><br>枚举值详见[枚举值-最低iOS版本](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[]|网络类型。<br>详见[枚举值-网络类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|carrier_ids| string[]| 运营商 ID。只有在对应的`in_use`字段为`true`时，该运营商的定向才有效。所选运营商需要和定向国家对应。您可以使用接口[/v1.3/tool/carrier/](https://ads.tiktok.com/marketing_api/docs?id=1737168013095938) 获取枚举值。|
| 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`）。|
|device_price_ranges|number[]|设备价格区间（10000代表1000+）。该数字必须是50的倍数。<br><b><span style="color: darkred">重要提示</span></b>: 最终的实际上限将在您设定的上限基础上增加50，您可以在TikTok广告管理平台的广告组设置中看到实际上限。例如，如果您设置的价格区间是[0, 250]，实际区间则为[0, 300]。|
|targeting_expansion{-即将废弃}| object | 定向扩量设置。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月起，您将无法为广告组开启自动定向或定向扩量。为保证流畅的 API 体验，我们建议您使用[智能定向](1783164662979586.html)。|
#|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>|
|audience_type {+条件必填} |string| <ul><li>仅当推广系列层级 `app_promotion_type` 设置为 `APP_RETARGETING` 时，本字段生效且必填。<br></li><li>推广系列层级 `app_promotion_type` 未设置为 `APP_RETARGETING` 时，不支持本字段。</li></ul><br>应用再营销受众类型。<br><br>枚举值：`NEW_CUSTOM_AUDIENCE` （再营销自定义受众）。<br><br><ul><li>若您想为应用再营销广告指定空自定义受众，则无需传入 `audience_ids` 和 `excluded_audience_ids`。</li><li>若您想为应用再营销广告指定非空自定义受众，您可以通过 `audience_ids` 仅指定包含受众，或通过`excluded_audience_ids` 仅指定排除受众，或通过 `audience_ids` 和 `excluded_audience_ids` 同时指定包含受众和排除受众。<ul><li>如果`audience_ids`和`excluded_audience_ids`同时传入，这两个字段不能包含同样的受众 ID。</li></ul></li></ul> |
|audience_rule |object| 受众规则，仅支持 `objective_type` 为 `TRAFFIC` 或 `APP_PROMOTION`。详情见[受众规则](https://ads.tiktok.com/marketing_api/docs?id=1739566532187138) |
|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>|
|brand_safety_type|string|品牌安全类型。仅当`placements`设置为`["PLACEMENT_TIKTOK"]`时生效。默认值：`NO_BRAND_SAFETY`。枚举值： <ul><li>`NO_BRAND_SAFETY`：不使用任何品牌安全解决方案，即使用<strong>全部库存</strong>。您的广告可能会在某些包含成人主题的内容周围展示。</li><li>`EXPANDED_INVENTORY`：使用TikTok的品牌安全解决方案，即使用<b>扩展库存</b>。您的广告将不会出现在不当内容或包含成人主题的内容后面。在下个API版本中`EXPANDED_INVENTORY`将替代`NO_BRAND_SAFETY`，并成为默认的品牌安全选项。</li><li>`STANDARD_INVENTORY`：使用TikTok的品牌安全解决方案中的<strong>标准库存</strong>。您的广告将展示在适合大多数品牌的内容周围。 </li><li>`LIMITED_INVENTORY`：使用TikTok的品牌安全解决方案中的<strong>有限库存</strong>。您的广告将展示在不包含成人主题的内容周围。</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>出价前第一方品牌安全筛选对于使用`APP_PROMOTION`，`WEB_CONVERSIONS`，`TRAFFIC`，`LEAD_GENERATION`或`PRODUCT_SALES`推广目标的竞价广告目前均为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>出价前第三方品牌安全解决方案目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 </li><li> 请查看[品牌安全](https://ads.tiktok.com/marketing_api/docs?id=1739381752981505)，了解出价前品牌安全筛选的支持推广目标，支持市场以及简要介绍。</li></ul>|
|brand_safety_partner{+条件必填}|string|品牌安全合作伙伴。只有在品牌安全为第三方（`brand_safety_type` = `THIRD_PARTY`）时必填，此时`placements`需设置为`["PLACEMENT_TIKTOK"]`。枚举值：`IAS`, `OPEN_SLATE`（该合作伙伴在TikTok广告管理平台的对应名称为<strong>DoubleVerify</strong>，因为该合作伙伴已被DoubleVerify收购）。如果需要获取自己的品牌安全设置可以投放的国家和地区，您可以使用`/tool/region/`接口。您需要传入品牌安全类型和品牌安全合作伙伴。<br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>出价前第三方品牌安全解决方案目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 </li><li>本字段设置后无法修改。</li></ul>|
|category_exclusion_ids|string[]|本字段仅支持满足以下条件时使用：<ul><li>推广系列层级：<ul><li>`objective_type` 为 `REACH`，`VIDEO_VIEWS`，`ENGAGEMENT`，`RF_REACH`，`APP_PROMOTION`，`WEB_CONVERSIONS`，`TRAFFIC` 或 `LEAD_GENERATION`。</li></ul></li><li>广告组层级：<ul><li>`placements` 设置为 `["PLACEMENT_TIKTOK"]`。</li><li>`brand_safety_type` 设置为 `STANDARD_INVENTORY` 或`LIMITED_INVENTORY`。</li></ul></li></ul>内容排除类别 ID 列表。 <br>您可以使用[/tool/content_exclusion/get/](1769738074686465.html)来获取内容类别 ID 列表（`excluded_category_list`），ID可以用于指定某内容类别，避免您的广告出现在该内容类型周围。|
|vertical_sensitivity_id|string|本字段仅支持满足以下条件时使用：<ul><li>推广系列层级：<ul><li>`objective_type` 为 `REACH`，`VIDEO_VIEWS` 或 `ENGAGEMENT`。</li></ul></li><li>广告组层级：<ul><li>`placements` 设置为 `["PLACEMENT_TIKTOK"]`。</li><li>`brand_safety_type` 设置为 `STANDARD_INVENTORY` 或`LIMITED_INVENTORY`。</li></ul></li></ul>行业敏感内容控制类别 ID。<br>您可以使用[/tool/content_exclusion/get/](1769738074686465.html) 获取包含敏感内容的行业类别（`vertical_sensitivity_list`），防止某类别出现在您的广告周围。|
|budget_mode {必填}|string|广告预算类型。<br><br>当开启推广系列预算优化（CBO）时，广告组层级的`budget_mode`将被忽略。<br><br>当未开启CBO时， 广告组层级的`budget_mode`支持以下枚举值：<ul><li>`BUDGET_MODE_TOTAL`：总预算。</li><li>`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`：动态日预算，即一周七日的平均预算。单日实际消耗不超过设定的七日平均预算的125%。周消耗不会超过七日平均预算*7。<ul><li>`objective_type`设置为`TRAFFIC`，`APP_PROMOTION`，`WEB_CONVERSIONS`，`LEAD_GENERATION``PRODUCT_SALES`（仅视频购物广告），`REACH`，`VIDEO_VIEWS` 或 `ENGAGEMENT` 且您不想设置总预算时，将本字段设置为`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`。<br><p><span style="color:darkred"><b>注意</b></span>：为推广目标为`REACH`，`VIDEO_VIEWS` 或 `ENGAGEMENT` 的推广系列启用 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` 目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li></ul></li><li>`BUDGET_MODE_DAY`：日预算。<ul><li>`objective_type` 设置为`REACH`，`VIDEO_VIEWS` 或 `ENGAGEMENT`时，推荐您使用动态日预算（`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`）而非日预算（`BUDGET_MODE_DAY`）。</li></ul></li></ul><br>了解如何设置预算类型，请参阅[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>如果本字段设置为`BUDGET_MODE_DAY`，那么`schedule_type`可以是`SCHEDULE_START_END`或`SCHEDULE_FROM_NOW`。</li><li>如果本字段设置为`BUDGET_MODE_TOTAL`，那么`schedule_type`必须是`SCHEDULE_START_END`，您需要传入一个结束时间 (`schedule_end_time`)。</li></ul>|
|budget {必填}|float|广告组预算。<br>当开启了推广系列预算优化（`budget_optimize_on` = `TRUE`）时，该字段将被忽略。<br>详情请参阅[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。欲直接获取某一币种对应的每日预算取值范围，请参阅[币种-每日预算取值范围](https://ads.tiktok.com/marketing_api/docs?id=1737585839634433)。|
|schedule_type {必填}|string|广告投放计划类型。可设置为`SCHEDULE_START_END`或`SCHEDULE_FROM_NOW`。<br><br><ul><li>如果选择`SCHEDULE_START_END`, 您需要设置开始及结束时间。</li><li>如果选择`SCHEDULE_FROM_NOW`, 您只需要设置一个开始时间，结束时间将自动设置为开始时间十年后的时间。</li><li>如果`budget_mode`为`BUDGET_MODE_TOTAL`, 本字段只能设置为`SCHEDULE_START_END`。</li></ul>|
|schedule_start_time {必填}|datetime|广告投放起始时间(UTC+0)，格式为`"YYYY-MM-DD HH:MM:SS"`。<br><br>起始时间可以早于目前时间，但是最多只能早12个小时，且不可晚于`"2028-01-01 00:00:00"`。|
|schedule_end_time {+条件必填}|datetime|当 `schedule_type` 为 `SCHEDULE_START_END` 时必填。<br><br>广告投放结束时间 (UTC+0)，格式为`"YYYY-MM-DD HH:MM:SS"`。<br><br>结束时间不可晚于`"2038-01-01 00:00:00"`。|
|dayparting |string|广告投放安排。格式为48x7的字符串。字符只能为0或者1。0代表不投放，1代表投放。每个字符对应一个30分钟的时间段。第一个字符对应的是周一的凌晨0:01-0:30，第二个字符对应0:31-1:00，依次类推。最后一个字符代表周日23:31-0:00。<br><span style="color: darkred"><b>注意：</b></span><br>不设置，全部设置为0，或者全部都设置为1都代表了要进行全时投放。|
|optimization_goal {必填}|string|优化目标。<br><br>若想获取完整的枚举值，请参阅[枚举值 - 优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br>若想获取 CBO 推广系列支持的枚举值，请参阅[推广系列预算优化 - 支持的优化目标](https://ads.tiktok.com/marketing_api/docs?id=1739381757818881)。<br><br>对于每个优化目标，您需同时手动指定对应的`billing_event`。若想了解与某一优化目标关联的计费事件，可查看<a href="#item-link-优化目标关联的计费事件">优化目标关联的计费事件</a>。<br><br>若要在 Pangle 版位或全球化应用组合版位的广告组中使用优化目标“安装与应用内事件数据”，需将 `optimization_goal` 设置为`INSTALL`，传入 `secondary_optimization_event` 合法值，且在`placements`的值中仅包含 `PLACEMENT_PANGLE`或 `PLACEMENT_GLOBAL_APP_BUNDLE` 或`PLACEMENT_PANGLE`和 `PLACEMENT_GLOBAL_APP_BUNDLE`。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>`promotion_type` 为`LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`、`LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE` 或 `LEAD_GEN_CLICK_TO_CALL` 时，本字段默认值为 `CLICK`。</li><li>自 2024 年 11 月 30 日起，您将无法创建或复制优化目标为“安装与应用内事件数据”且版位为仅 TikTok 或自动版位的广告组。此变动将影响使用以下配置的广告组：<ul><li>推广系列层级：`objective_type` 为 `APP_PROMOTION` </li><li>广告组层级： <ul><li> `optimization_goal` 为 `INSTALL` 且指定了 `secondary_optimization_event` 合法值</li><li>`placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 为`["PLACEMENT_TIKTOK"]`，或 `placement_type` 为`PLACEMENT_TYPE_AUTOMATIC` </li></ul></li><li>现有的投放在 TikTok 版位的“安装与应用内事件数据”广告组将不受影响。此外，Pangle 版位和全球化应用组合版位（即 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 的值仅包含`PLACEMENT_PANGLE` 和 `PLACEMENT_GLOBAL_APP_BUNDLE`）也不受影响。请注意此变更，并在必要时对您的集成进行适当的调整。</li></ul></li><li>`VIDEO_VIEW`枚举值已废弃。当 `objective_type` 在推广计划层级设为 `VIDEO_VIEWS` 时，您可使用`ENGAGED_VIEW` 或 `ENGAGED_VIEW_FIFTEEN`作为优化目标。</li><li>若您要在一个已开启CBO的推广系列下创建新的广告组，需确保本字段的值与第一个广告组中的设置保持一致。</li></ul> |
|secondary_optimization_event|string|当优化目标为`INSTALL` 或 `VALUE` 时的次要优化目标。<br><br>枚举值详见[转化事件-App深度转化事件类型](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>自 2024 年 11 月 30 日起，您将无法创建或复制优化目标为“安装与应用内事件数据”且版位为仅 TikTok 或自动版位的广告组。此变动将影响使用以下配置的广告组：<ul><li>推广系列层级：`objective_type` 为 `APP_PROMOTION` </li><li>广告组层级： <ul><li> `optimization_goal` 为 `INSTALL` 且指定了 `secondary_optimization_event` 合法值</li><li>`placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 为`["PLACEMENT_TIKTOK"]`，或 `placement_type`为`PLACEMENT_TYPE_AUTOMATIC` </li></ul></li><li>现有的投放在 TikTok 版位的“安装与应用内事件数据”广告组将不受影响。此外，Pangle 版位和全球化应用组合版位（即 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 的值仅包含`PLACEMENT_PANGLE` 和 `PLACEMENT_GLOBAL_APP_BUNDLE`）也不受影响。请注意此变更，并在必要时对您的集成进行适当的调整。</li></ul></li><li>若设置了 `secondary_optimization_event`，则需同时传入 `deep_bid_type` 。</li></ul>|
| message_event_set_id {+条件必填}| string | 同时满足以下条件时，本字段必填： <ul><li>`promotion_type` 为 `LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE`。</li><li>`optimization_goal` 为 `CONVERSATION`。</li><li>广告组设置中的即时通讯应用账号没有匹配的唯一消息事件集。</li></ul> <br>即时通讯广告组中使用的消息事件集的 ID。<br><br><ul><li>若广告组设置中的即时通讯应用账号（无论是通过 `messaging_app_account_id` 手动指定的 Messenger 账号还是基于指定的`phone_region_code`、`phone_region_calling_code` 和 `phone_number` 填充的 WhatsApp 账号）匹配到了唯一消息事件集，则将<b>忽略本字段并自动填充</b>为与所选即时通讯应用账号绑定的唯一消息事件集。<ul><li>若想确认是否存在与所选即时通讯应用账号绑定的唯一消息事件集，可使用 [/ctm/message_event_set/get/](1816979158055937.html) 并查看返回的 `matched_event_set`。</li></ul></li><li>若广告组设置中的即时通讯应用账号未匹配到消息事件集（ `/ctm/message_event_set/get/` 返回的`matched_event_set`为空），需使用[/ctm/message_event_set/get/](1816979158055937.html) 并通过返回参数`message_event_set_list`获取可用于广告中的消息事件集列表。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持更新。 |
|frequency {+条件必填}|number| 频次，与`frequency_schedule`共同构成用户看到广告的频次上限（仅适用于`REACH`广告）。<br>需要满足以下两个条件：<ul><li>1 <= `frequency` <= 1000</li><li>1 <= `frequency_schedule` <= 30</li></ul>例如：`frequency` = 2 且 `frequency_schedule` = 3 表示每 3 天至多 2 次展示。 |
|frequency_schedule{+条件必填} |number| 频次天数，与`frequency`共同构成用户看到广告的频次上限（仅适用于`REACH`广告）。详见`frequency`字段说明。|
|bid_type {+条件必填}|string|竞价策略。 竞价策略将决定系统的单次成效费用管理方式、预算支出方式以及广告投放方式。<br><br>当开启推广系列预算优化（CBO）时，本字段必填。<br><br>若想查看枚举值，请参阅[枚举值-竞价策略](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><br><span style="color: darkred"><b>注意</b></span>：若您要在一个已开启 CBO 的推广系列下创建新的广告组，需确保本字段的值与第一个广告组中的设置保持一致。 |
|bid_price{+条件必填} |float|`bid_type` 为 `BID_TYPE_CUSTOM` 且 `billing_event` 为 `CPC`，`CPM` 或 `CPV` 时，本字段必填。<br><br>出价。（成本上限策略下）想尽可能达到的平均单次成效成本。<br><br>当开启了推广系列预算优化（`budget_optimize_on` = `true`）时，建议同一个推广系列下所有广告组出价保持一致。<br><br>`bid_price`需小于您在推广系列层级和广告组层级设置的`budget`金额。请查看[出价-出价限制](https://ads.tiktok.com/marketing_api/docs?id=1745292444424193)了解出价校验机制。|
|conversion_bid_price {+条件必填} |float|`bid_type` 为 `BID_TYPE_CUSTOM` 且 `billing_event` 为 `OCPM` 时，本字段必填。<br><br>oCPM 转化出价。<br><br>`conversion_bid_price`需小于您在推广系列层级和广告组层级设置的`budget`金额。请查看[出价-出价限制](https://ads.tiktok.com/marketing_api/docs?id=1745292444424193)了解出价校验机制。|
|deep_bid_type {+条件必填}|string|深度事件出价类型。<br><br>当开启推广系列预算优化（CBO）且`optimization_goal`为`VALUE`时，本字段必填。<br><br> 枚举值：`VO_MIN_ROAS`（白名单功能），`VO_HIGHEST_VALUE`（白名单功能）。<br><br>枚举值详见[枚举值-深度事件出价类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><br><p><span style="color:darkred"><b>注意</b></span>：若设置了 `secondary_optimization_event`，则需同时传入 `deep_bid_type` 。|
|roas_bid {+条件必填}|float|当`deep_bid_type`为`VO_MIN_ROAS`时必填。<br><br>用于价值优化的ROAS目标值。<br><br>取值范围: <ul><li>对于应用内广告收入场景（`objective_type` 为 `APP_PROMOTION`， `optimization_goal` 为 `VALUE`，且 `optimization_event` 为 `AD_REVENUE_VALUE`）：0.01-10。</li><li>对于商品来源为 TikTok Shop 的商品购物广告场景（`shopping_ads_type` 为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 为 `STORE`）：0.01-20。</li><li>对于其他场景：0.01-1,000。</li></ul>|
| vbo_window | string | 为[广告收入价值优化](1739381743067137.html)或[应用内购价值优化](1739381743067137.html)指定的竞价策略的时间窗口期。 <br><br>枚举值： <ul><li>`SEVEN_DAYS`：前 7 天。</li><li>`ZERO_DAY`：第 0 天（当天）。</li></ul><br><ul><li>使用竞价策略最低 ROAS（目标 ROAS）时，本字段代表目标 ROAS 值的窗口期类型（第 7 天 ROAS 或第 0 天 ROAS）。系统将努力让第 7 天或当天的 ROAS 保持在或超过目标 ROAS 值。 </li><li>使用竞价策略最高价值时，本字段代表最高价值的窗口期类型（前 7 天最高价值或第 0 天最高价值 ）。系统将在前 7 天或当天优先充分消耗预算，同时尽可能获得最大的成效价值。</li></ul><br>若想了解如何为广告启用广告收入价值优化或应用内购价值优化，请查看[开启应用价值优化](https://business-api.tiktok.com/portal/docs?id=1770019181843458#item-link-%E5%BC%80%E5%90%AF%E5%BA%94%E7%94%A8%E4%BB%B7%E5%80%BC%E4%BC%98%E5%8C%96)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>不同场景下的广告收入价值优化或应用内购价值优化目前为白名单功能。如需使用这些功能，请联系您的 TikTok 销售代表。</li><li>在高级专属推广系列或 Android 推广系列中使用<b>应用内购价值优化</b>的第 0 天出价或第 7 天出价（`vbo_window` 为 `ZERO_DAY` 或 `SEVEN_DAYS`）目前为白名单功能。如需使用这些功能，请联系您的 TikTok 销售代表。</li><li>在高级专属推广系列或 Android 推广系列中使用<b>广告收入价值优化</b>的第 0 天出价或第 7 天出价（`vbo_window` 为 `ZERO_DAY` 或 `SEVEN_DAYS`）目前为白名单功能。如需使用这些功能，请联系您的 TikTok 销售代表。</li><li>本字段设置后不允许更新。</li></ul> |
|bid_display_mode{+条件必填}|string|每次浏览成本的测量和计算模式。当在推广系列层级的`objective_type`设置为`VIDEO_VIEWS`，`bid_display_mode`必填且必须设为 `CPV` <br><p><span style="color:DarkRed"><b>注意</b></span>：<ul><li>`bid_display_mode`一旦设置无法更新。</li><li>如果推广系列层级的`objective_type`不为`VIDEO_VIEWS`, 您不需要设置此字段。</li><li>枚举值`CPMV`已经在v1.3版本废弃。|
|deep_cpa_bid |float|当您为App内事件选择出价策略后，您需要在该字段中传入出价价格。|
|next_day_retention| float | 次日留存率。公式：`next_day_retention` = `conversion_bid_price`/`deep_cpa_bid`。取值范围 （0,1]。仅当版位`placements`为`PLACEMENT_PANGLE`且深度转化事件`secondary_optimization_event`为`NEXT_DAY_OPEN`时生效。<br><span style="color:DarkRed"><b>注意</b></span>：如果您想要使用此字段，请同时传入`conversion_bid_price`，`deep_cpa_bid`，和 `next_day_retention`这三个字段，并确保传入的值符合计算公式。否则可能会导致不符合预期的错误。 |
| click_attribution_window | string | 广告组的点击归因窗口期。该窗口期指用户从点击广告到采取行动之间的时间间隔。<br>本字段用于设置可将转化归因至本广告组的时间范围。<br><br>枚举值：<ul><li>`OFF`：不启用。 </li><li> `ONE_DAY`：1天（点击）。</li><li>`SEVEN_DAYS`：7天（点击）。 </li><li>`FOURTEEN_DAYS`：14天（点击）。</li><li> `TWENTY_EIGHT_DAYS`：28天（点击）。 </li></ul><br>若想了解不同推广目标场景下本字段的允许值，请查看[归因窗口期和事件统计方式](1777694366654465.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>若想手动指定归因窗口期，您需至少同时传入`click_attribution_window` 和 `view_attribution_window`，可同时传入`engaged_view_attribution_window`。需注意，一旦指定 `engaged_view_attribution_window`，需同时指定 `click_attribution_window` 和 `view_attribution_window`。</li><li> 若您未传入`click_attribution_window`，`engaged_view_attribution_window`，`view_attribution_window` 和`attribution_event_count`字段，则如果有默认设置，会使用默认设置。若想确认您未手动传入本字段时，是否使用了默认设置，可使用 [/adgroup/get/](1739314558673922.html) 。</li><li>本字段设置后不支持更新。</li></ul>|
| engaged_view_attribution_window | string | 广告组的深度互动观看归因窗口期。该窗口期指用户从观看视频广告 6 秒到采取行动之间的时间间隔。<br>本字段用于设置可将转化归因至本广告组的时间范围。<br><br>枚举值：<ul><li>`ONE_DAY`：1天（深度互动观看）。</li><li>`SEVEN_DAYS`：7天（深度互动观看）。 </li></ul><br>若想了解不同推广目标场景下本字段的允许值，请查看[归因窗口期和事件统计方式](1777694366654465.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>若想手动指定归因窗口期，您需至少同时传入`click_attribution_window` 和 `view_attribution_window`，可同时传入`engaged_view_attribution_window`。需注意，一旦指定 `engaged_view_attribution_window`，需同时指定 `click_attribution_window` 和 `view_attribution_window`。</li><li> 若您未传入`click_attribution_window`，`engaged_view_attribution_window`，`view_attribution_window` 和`attribution_event_count`字段，则如果有默认设置，会使用默认设置。若想确认您未手动传入本字段时，是否使用了默认设置，可使用 [/adgroup/get/](1739314558673922.html) 。</li><li>本字段设置后不支持更新。</li></ul>|
| view_attribution_window | string | 广告组的展示归因窗口期。该窗口期指用户从查看广告到采取行动之间的时间间隔。<br>本字段用于设置可将转化归因至本广告组的时间范围。<br><br>枚举值：<ul><li>`OFF`：不启用。</li><li>`ONE_DAY`：1天（展示）。</li><li>`SEVEN_DAYS`：7天（展示）。 </li></ul><br>若想了解不同推广目标场景下本字段的允许值，请查看[归因窗口期和事件统计方式](1777694366654465.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>若想手动指定归因窗口期，您需至少同时传入`click_attribution_window` 和 `view_attribution_window`，可同时传入`engaged_view_attribution_window`。需注意，一旦指定 `engaged_view_attribution_window`，需同时指定 `click_attribution_window` 和 `view_attribution_window`。</li><li> 若您未传入`click_attribution_window`，`engaged_view_attribution_window`，`view_attribution_window` 和`attribution_event_count`字段，则如果有默认设置，会使用默认设置。若想确认您未手动传入本字段时，是否使用了默认设置，可使用 [/adgroup/get/](1739314558673922.html) 。</li><li>本字段设置后不支持更新。</li></ul>|
| attribution_event_count | string | 广告组的事件统计方式（统计类型）。<br>统计用户在查看或点击了广告后采取操作的次数的方式。<br><br>枚举值： <ul><li>`UNSET` ：未设置。 </li><li> `EVERY`：每一次。某位用户进行的多个购买事件将分别计入转化量。</li><li> `ONCE`：仅一次。某位用户进行的多个事件将只算作 1 次转化。</li></ul><br>若想了解不同推广目标场景下本字段的允许值，请查看[归因窗口期和事件统计方式](1777694366654465.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li> 若您未传入`click_attribution_window`，`engaged_view_attribution_window`，`view_attribution_window` 和`attribution_event_count`字段，则如果有默认设置，会使用默认设置。若想确认您未手动传入本字段时，是否使用了默认设置，可使用 [/adgroup/get/](1739314558673922.html) 。</li><li>本字段设置后不支持更新。</li></ul>|
|billing_event {必填}|string| 计费事件。<br><br>枚举值参见[枚举值-计费事件](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-计费事件)。<br><br>若想了解与某一优化目标关联的计费事件，可查看<a href="#item-link-优化目标关联的计费事件">优化目标关联的计费事件</a>。|
|pacing {必填} |string| 广告投放速度类型。您可以选择`PACING_MODE_SMOOTH`（在预定的时间内平均分配预算）和`PACING_MODE_FAST`（尽快消耗预算并产出结果）。当您开启推广系列预算优化（`budget_optimize_on` = `TRUE`）时，该字段将自动设置为为`PACING_MODE_SMOOTH`。否则您需要填写该字段。|
|statistic_type |string| 转化事件出价统计类型。枚举值 `EVERYTIME`(每一次计费广告)，`NONE`(仅一次计费广告)。您可以通过[/app/optimization_event/](https://ads.tiktok.com/marketing_api/docs?id=1740859338750977)接口获取应用事件对应的`statistic_type`字段值。 |
|is_hfss |boolean|推广内容是否为 HFSS（高脂高盐和高糖）产品/品牌。<br><br>如果您的广告宣传或重点展示的产品/品牌为高脂高盐和高糖食品，需将此字段设置为 `true`。<br><br>在受监管地区，HFSS 广告必须仅针对 18 岁以上用户定向投放。<br><br>当您的定向地区包括英国、澳大利亚、新西兰和欧盟国家或地区时，您可以将此字段设置为 `true`。<br><br>支持的值：`true`，`false`。<br><br>默认值：`false`。|
| is_lhf_compliance | boolean | 推广内容是否符合 LHF（较不健康食品）合规要求。<br><br>将 `is_lhf_compliance` 设置为 `true`，即表示您确认在英国 TikTok 上推广的任何食品或饮料均符合 [2024 年较不健康食品法规](https://www.legislation.gov.uk/uksi/2024/1266/made)以及其他所有适用法律。<br><br>支持的值：`true`，`false`。<br><br>默认值：`false`。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2026 年 1 月 1 日起，当广告定向到英国地域且 `is_hfss` 为 `true` 时，`is_lhf_compliance` 必填，且必须设置为 `true`。</p> |
|operation_status|string|广告组创建时的启用/关闭状态。枚举值：<ul><li>`ENABLE` : 广告组创建时处于启用状态。 </li><li>`DISABLE` : 广告组创建时处于未启用状态。</li></ul> 默认值：`ENABLE`。 <br>若想在广告组创建后更新广告组的启用/关闭状态，请使用 [/adgroup/update/status/](https://ads.tiktok.com/marketing_api/docs?id=1739591716326402) 接口。|
|creative_material_mode |string|创意投放方式。<br><br>枚举值: <code>CUSTOM</code>（自定义）。<br>默认值: <code>CUSTOM</code> （自定义）。<br><br><p><span style="color:darkred"><b>注意</b></span>: 程序化创意广告（`creative_material_mode` = `DYNAMIC`）已下线。我们建议您创建智能创意广告（`creative_material_mode` = `CUSTOM`），以便您更顺畅地迁移。欲知详细信息，请参考[智能创意广告](https://ads.tiktok.com/marketing_api/docs?id=1767322784934914)。|
|adgroup_app_profile_page_state|string|是否启用应用介绍页。<br><br>枚举值：`ON`，`OFF`。<br><br><p><span style="color:darkred"><b>注意</b></span>: 应用介绍页不支持在优化目标为应用内事件且竞价策略为成本上限的专属推广系列中使用。因此本字段在下列条件均满足时不支持设置为`ON`：<ul><li>`ios14_targeting` 设置为 `IOS14_PLUS`</li><li>`optimization_goal` 设置为 `IN_APP_EVENT`</li><li>`bid_type` 设置为 `BID_TYPE_CUSTOM`</li></ul>|
|conversion_window (已废弃) |string|转化窗口，您希望用户从点击或观看广告到最终发生转化的时间周期，广告平台将使用该时间周期内的数据优化您的广告投放效果。该设置不会影响到投放数据归因设置。枚举值详见[枚举值-广告管理-转化窗口期](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
优化目标关联的计费事件
您为广告组指定优化目标时，需同时手动指定对应的计费事件。下表列出了与每个优化目标关联的计费事件。
| <code>optimization_goal</code> 值 {40%}| 对应的 <code>billing_event</code> 值 {60%}|
|---|---|
| `CLICK` | `CPC` |
| `PAGE_VISIT` | `CPC`|
| `CONVERT` | `OCPM` |
| `INSTALL` | `OCPM` |
| `IN_APP_EVENT` | `OCPM` |
| `TRAFFIC_LANDING_PAGE_VIEW` | `OCPM` |
| `LEAD_GENERATION` | `OCPM` |
| `CONVERSATION` | `OCPM` |
| `FOLLOWERS` | `OCPM` |
| `VALUE` | `OCPM` |
| `AUTOMATIC_VALUE_OPTIMIZATION` | `OCPM` |
| `PRODUCT_CLICK_IN_LIVE` | `OCPM` |
| `MT_LIVE_ROOM` | `OCPM` |
| `DESTINATION_VISIT` | `OCPM` |
| `SHOW` | `CPM` |
| `REACH` | `CPM` |
| `ENGAGED_VIEW` | `CPV` |
| `ENGAGED_VIEW_FIFTEEN` | `CPV` |
示例
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"adgroup_name": "{{adgroup_name}}",
"promotion_type": "WEBSITE",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
"video_download_disabled": false,
"location_ids": ["{{location_id}}"],
"gender": "GENDER_UNLIMITED",
"operating_systems": ["ANDROID"],
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}},
"schedule_type": "SCHEDULE_START_END",
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"optimization_goal": "CLICK",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "CPC",
"pacing": "PACING_MODE_SMOOTH",
"operation_status": "ENABLE"
}'
(/code)
返回
|字段{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)。|
|request_id |string|请求的日志id，唯一标识一个请求。 |
|data |object|返回数据。 |
#|advertiser_id |string| 广告主 ID。 |
#|campaign_id |string| 推广系列 ID。 |
#|campaign_name|string| 该广告组所属的推广系列的名称。 |
#|adgroup_id |string| 广告组 ID。 |
#|adgroup_name|string| 广告组名称。 |
#| create_time | string | 广告组创建时间。格式为`"YYYY-MM-DD HH:MM:SS"`。 <br><br>示例：`"2023-01-01 00:00:01"`。|
#| modify_time | string | 广告组修改时间。格式为`"YYYY-MM-DD HH:MM:SS"`。<br><br>示例：`"2023-01-01 00:00:01"`。 |
#|shopping_ads_type|string|当对应的推广系列 `objective_type` 为 `PRODUCT_SALES` 时返回。<br><br>购物广告类型。<br><br>枚举值：<ul><li>`VIDEO`：视频购物广告。</li><li>`LIVE`：直播购物广告。</li><li>`PRODUCT_SHOPPING_ADS`：商品购物广告。</li><li>`CATALOG_LISTING_ADS`：产品目录广告。</li><li> `UNSET`：未设置。</li></ul>|
#|identity_id |string|当 `shopping_ads_type` 为 `VIDEO` 且 `product_source` 为 `SHOWCASE` 或 `shopping_ads_type` 为 `LIVE` 时返回。<br><br>认证身份 ID。|
#|identity_type|string|当 `shopping_ads_type` 为 `VIDEO` 且 `product_source` 为 `SHOWCASE` 或 `shopping_ads_type` 为 `LIVE` 时返回。<br><br>认证身份类型。枚举值: `AUTH_CODE` (授权码认证)， `TT_USER` (TikTok商务用户)， `BC_AUTH_TT`（已添加到商务中心的TikTok用户）。参阅[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097) 获取详细信息。 |
#|identity_authorized_bc_id|string|当`identity_type` 为 `BC_AUTH_TT`时返回。<br><br>与添加到商务中心的TikTok用户这一认证身份绑定的商务中心的ID。|
#|product_source|string|仅视频购物广告和商品购物广告返回本字段。<br><br>商品来源，即您要推广的商品的来源。<br><br>枚举值：`UNSET` ,`CATALOG`(商品库)，`STORE` (TikTok Shop 店铺) ，`SHOWCASE`（TikTok 橱窗）。|
#|catalog_id|string| 以下任意场景下返回：<ul><li> `product_source` 设置为 `CATALOG` 或 `STORE`。</li><li> `shopping_ads_type` 设置为 `LIVE` 且请求中传入了本字段。</li></ul><br>商品库 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月 30 日起，将不再为新创建的 `product_source` 为 `STORE` 的购物广告返回 `catalog_id`，传入的 `catalog_id` 字段将被忽略。存量的 `product_source` 为 `STORE` 的购物广告若未被更新，则不受影响。若您更新存量的这类广告组，若广告组已绑定 `catalog_id` ，则绑定的 `catalog_id` 将清空且该 `catalog_id` 字段将不再返回。|
#|catalog_authorized_bc_id |string| 以下任意场景下返回：<ul><li>`shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为`CATALOG` 或 `STORE`。 </li><li>`shopping_ads_type` 设置为 `LIVE` 且请求中传入了本字段。</li></ul><br>如果要操作的是已经资产化的商品库，本字段会返回相应的商务中心ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月 30 日起，将不再为新创建的 `product_source` 为 `STORE` 的购物广告返回 `catalog_authorized_bc_id`，传入的 `catalog_authorized_bc_id` 字段将被忽略。存量的 `product_source` 为 `STORE` 的购物广告若未被更新，则不受影响。若您更新存量的这类广告组，且广告组已绑定 `catalog_authorized_bc_id`，则绑定的 `catalog_authorized_bc_id` 将清空且该 `catalog_authorized_bc_id` 字段将不再返回。|
#|store_id |string|以下任意场景下返回：<ul><li>`shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `STORE`。</li><li>`shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 设置为 `STORE`。 </li><li>`shopping_ads_type` 设置为`LIVE` 且请求中传入了本字段。</li></ul><br> TikTok Shop 店铺 ID。|
#|store_authorized_bc_id |string|请求中传入 `store_id` 时返回。<br><br>有权管理该商店 (`store_id`）的商务中心的 ID。|
#|promotion_type |string|推广对象类型（优化位置）。您可以使用该字段决定在哪里投放广告。详情见[枚举值-推广对象类型 ](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|promotion_target_type |string|推广目标线索收集的专属推广对象类型。<br>枚举值： <ul><li> `INSTANT_PAGE`：即时表单（线索表单）。创建可快速加载的应用内 TikTok 即时表单来收集更多线索。</li><li> `EXTERNAL_WEBSITE`：第三方网站表单。使用包含第三方网站表单的落地页，或使用会重定向至包含第三方网站表单网站的TikTok即时体验页面来收集更多线索。</li><li>`UNSET`。</li></ul> |
#| messaging_app_type | string | 即时通讯广告组中使用的即时通讯应用或自定义 URL。<br><br>枚举值：<ul><li>`MESSENGER`：Messenger。</li><li>`WHATSAPP`：WhatsApp。</li><li>`ZALO`: Zalo。</li><li>`LINE`: Line。</li><li>`IM_URL`：即时通讯 URL。</li></ul>|
#| messaging_app_account_id | string | 即时通讯应用账号 ID。<ul><li>`messaging_app_type` 为 `MESSENGER` 时，本字段代表 Facebook 公共主页编号。</li><li> `messaging_app_type` 为 `LINE` 时，本字段代表 LINE Business ID。</li><li>`messaging_app_type` 为 `WHATSAPP` 时，本字段代表根据指定的`phone_region_code`、`phone_region_calling_code` 和 `phone_number` 自动填充的 WhatsApp 电话号码。</li></ul> |
#| phone_region_code | string | WhatsApp 或 Zalo 电话号码的地区代码。 <br><br>示例：`US`。 |
#| phone_region_calling_code | string | WhatsApp 或 Zalo 电话号码的区号。<br><br> 示例：`+1`。 |
#| phone_number | string | WhatsApp 或 Zalo 电话号码。 |
#|promotion_website_type|string|广告组中的 TikTok 即时体验页面类型。<br><br>枚举值：<ul><li>`UNSET`：不使用TikTok 即时体验页面。</li><li>`TIKTOK_NATIVE_PAGE`：使用 TikTok 即时体验页面。|
#|app_id |string|推广的应用的 ID。您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786)获取`app_id`。|
#|app_type |string| 推广的应用的的类型。枚举值：`APP_ANDROID`（Android），`APP_IOS`（iOS）。|
#|app_download_url |string|应用下载链接。|
#|pixel_id |string|Pixel ID，仅对落地页生效。|
#|optimization_event |string|广告组转化事件。参阅[转化事件](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889) ，获取详细信息。|
#| app_config | object[] | 推广系列层级 `sales_destination` 为 `WEB_AND_APP` 时返回本字段。<br><br>推广的应用详情。 |
##| app_id | string | 推广的应用的 ID。 |
#|custom_conversion_id|string|广告组中使用的自定义转化的 ID。|
#| deep_funnel_optimization_status | string | 深层漏斗优化的状态。 <br>深层漏斗优化同时优化浅层和深层漏斗事件。您可以在主要优化事件之外再选择一个次要事件，这有助于提升推广 系列的效果。 <br><br> 枚举值：<ul><li>`ON` ：启用深层漏斗优化。</li><li>`OFF`：不启用深层漏斗优化。</li></ul> |
#| deep_funnel_event_source | string | `deep_funnel_optimization_status` 为 `ON` 时返回本字段。 <br><br> 事件源类型。 <br><br> 枚举值： <ul><li> `PIXEL`：Pixel。</li><li>`OFFLINE`：线下事件组。 </li><li>`CRM`：CRM 事件组。</li></ul> |
#| deep_funnel_event_source_id | string | `deep_funnel_optimization_status` 为 `ON` 时返回本字段。 <br><br> 事件源 ID。 <br><br> <ul><li>`deep_funnel_event_source` 为 `PIXEL` 时，本字段代表 Pixel ID。</li><li>`deep_funnel_event_source` 为 `OFFLINE` 时，本字段代表线下事件组 ID。</li><li>`deep_funnel_event_source`为`CRM`时，本字段代表 CRM 事件组 ID。</li></ul> |
#| deep_funnel_optimization_event | string | `deep_funnel_optimization_status` 为 `ON` 时返回本字段。 <br><br> 深层漏斗优化事件。 <br><br>示例： `SHOPPING`。 |
#|placement_type |string|版位类型。 <br>枚举值：`PLACEMENT_TYPE_AUTOMATIC`（自动版位），`PLACEMENT_TYPE_NORMAL` （编辑版位）。|
#|placements |string[]|投放版位。详情见[枚举值-版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><p><span style="color:darkred"><b>注意</b></span>：<ul><li> 当`placement_type`为`PLACEMENT_TYPE_AUTOMATIC`（自动版位）时，本字段返回指定的推广目标下实际支持的版位。例如，若实际仅支持 TikTok版位，本字段返回的值将为`PLACEMENT_TIKTOK` 。<ul><li>若指定的推广目标支持 `PLACEMENT_GLOBAL_APP_BUNDLE` 版位，但您未申请全球化应用组合版位的白名单，则本字段的值将不会包含`PLACEMENT_GLOBAL_APP_BUNDLE`。</li></ul></li><li>当 `placement_type` 为 `PLACEMENT_TYPE_NORMAL`（手动版位）时，本字段通常将返回您在请求中通过`placements`字段指定的版位。<ul><li>唯一的例外是您在请求中通过 `placements` 字段指定了 `PLACEMENT_GLOBAL_APP_BUNDLE` 版位 ，但是您未申请`PLACEMENT_GLOBAL_APP_BUNDLE`的白名单，则本字段的返回值中将筛除 `PLACEMENT_GLOBAL_APP_BUNDLE` 。例如，若您在请求中将 `placements` 设置为`["PLACEMENT_TIKTOK", "PLACEMENT_GLOBAL_APP_BUNDLE"]`，但是未申请全球化应用组合版位的白名单，本字段的返回值将为`["PLACEMENT_TIKTOK"]`。 </li></ul></li></ul>|
#| tiktok_subplacements | string[] | TikTok 子版位，用于选择广告出现的具体位置。 <br><br> 枚举值：<ul><li>`IN_FEED`：信息流。广告将投放在“推荐”动态中，可能投放在“个人资料页”和“关注”推荐内容中。</li><li>`SEARCH_FEED`：搜索推荐内容。</li><li>`TIKTOK_LITE`：TikTok Lite，占用内容更小、视频加载速度更快的精简版 TikTok 应用。TikTok Lite 子版位仅支持定向日本或韩国时使用。</li><li>`LEMON8`：Lemon8，一款生活方式内容社区应用，内容包含真实生活体验分享、小贴士、指南和商品测评。如果在子版位中包含 Lemon8，广告将展示在其推荐页信息流、搜索信息流和沉浸式视频信息流中。 [了解 Lemon8 的详情](https://ads.tiktok.com/help/article/about-lemon8-in-tiktok-ads-manager)。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：若创建广告组时未指定 `tiktok_subplacements`，本字段将为空列表（`[]`）。 |
#| search_result_enabled | boolean | 是否在搜索广告中展示您的广告，即当用户在 TikTok上搜索您的业务相关信息时，系统是否向他们展示您的广告。 |
#|automated_keywords_enabled|boolean|是否启用自动关键词，即在添加广告后，让系统自动生成关键词。这样可以拓展优质流量，以便提升成效。在报表中查看成效出色的自动关键词。<br><br>支持的值：`true`，`false`。|
#|search_keywords|object[]|仅为搜索广告推广系列返回。<br><br>搜索关键词列表，即用于与人们搜索的词语匹配，以展示您的广告的一组搜索关键词，可以是词或词组。|
##|keyword|string|搜索关键词。|
##|match_type|string|搜索关键词对应的匹配类型。<br><br>枚举值：<ul><li>`PRECISE_WORD`：精确匹配。您的广告将会在用户的搜索词与这些关键词完全匹配时展示。</li><li>`PHRASE_WORD`：词组匹配。您的广告将会在用户以相同词序搜索这些关键词时展示。</li><li>`BROAD_WORD`：广泛匹配。您的广告将会在用户搜索这些关键词中的任意词时展示，无论词序是否相同。</li></ul>|
##|keyword_bid_type|string|关键词和匹配类型组合的出价类型。<br><br>枚举值：<ul><li>`FOLLOW_ADGROUP`：使用广告组层级的出价（`bid_price`）作为 `keyword_bid`。</li><li>`CUSTOM`：通过 `keyword_bid` 自定义出价。</li></ul>|
##|keyword_bid|float|关键词和匹配类型组合的出价。|
##|audit_status|string|搜索关键词的审核状态。<br><br>枚举值：<ul><li>`AUDITING`：关键词在审核中。</li><li>`PASS`：关键词已通过审核，可用于投放。</li><li>`REJECTED`：关键词未通过审核，不可用于投放。</li></ul>|
##|reject_info|object[]|仅当 `audit_status` 为 `REJECTED` 时返回。<br><br>拒审详情。|
###|forbidden_location|string|未通过审核的定向地域。<br><br>枚举值参见[附录 - 地区代码](1737585867307010.html)。|
###|reject_reasons|object[]|拒审原因列表。|
####|reason|string|拒审原因。|
#|comment_disabled |boolean |是否允许用户在TikTok上评论您的广告。|
#|video_download_disabled |boolean| 用户是否可以在 TikTok 上下载您的广告视频。|
#|share_disabled|boolean|本广告组中的广告是否禁止分享到第三方平台。|
#|blocked_pangle_app_ids|string[]| Pangle 媒体屏蔽列表 ID。 |
#|audience_type |string| 应用重定向受众类型。枚举值可见[枚举值 - 应用重定向受众类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)|
#|audience_rule |object| 受众规则。 |
#|saved_audience_id |string | 当您在请求中指定了`saved_audience_id`时，将返回此信息。<br>已保存受众ID。|
#|auto_targeting_enabled{-将被废弃}|boolean|是否开启自动定向|
#| shopping_ads_retargeting_type | string |`shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `CATALOG` 时返回。<br><br>购物广告受众再营销类型。<br><br>枚举值：<ul><li>`LAB1` : 对浏览过商品或者将商品加过购物车，但未购买过商品的受众进行再营销。 </li><li>`LAB2`：对将商品加过购物车,但未购买过商品的受众进行再营销。</li><li>`LAB3` : 使用自定义条件组合对受众进行再营销。</li><li>`OFF` : 不进行受众再营销。</li></ul> |
#| shopping_ads_retargeting_actions_days{+条件必填} | number | 所指定的受众行为的有效时间范围。在该时间范围内完成所指定行为的受众将成为购物广告受众再营销的对象。<br> <br>取值范围：1，2，3，7, 14，30，60，90，180。|
#| included_custom_actions | object[] | 作为包含条件筛选购物广告受众再营销对象的自定义行为。|
##| code | string | 用于筛选出受众再营销对象的自定义行为。枚举值：<ul><li>`VIEW_PRODUCT`：受众浏览过商品。</li><li>`ADD_TO_CART` : 受众将商品加过购物车。</li><li>`PURCHASE` : 受众购买过商品。</li></ul>|
##| days | integer | 用于筛选出完成了自定义行为的受众的时间区间。取值范围：[1,180]。|
#| excluded_custom_actions | object[] |作为排除条件筛选购物广告受众再营销对象的自定义行为。|
##| code | string | 用于筛选出受众再营销对象的自定义行为。枚举值：<ul><li>`VIEW_PRODUCT`：受众浏览过商品。</li><li>`ADD_TO_CART` : 受众将商品加过购物车。</li><li>`PURCHASE` : 受众购买过商品。</li></ul>|
##| days | integer | 用于筛选出未完成自定义行为的受众的时间区间。取值范围：[1,180]。|
#| shopping_ads_retargeting_custom_audience_relation | string | 由 `shopping_ads_retargeting_type` 字段指定的视频购物广告重定向受众与由 `audience_ids` 指定的自定义受众间的逻辑关系。<br><br>枚举值：<ul><li> `OR`：取视频购物广告重定向受众和自定义受众的并集构建定向受众。定向受众中包含属于视频购物广告重定向受众或自定义受众的人群。</li><li> `AND`：取视频购物广告重定向受众和自定义受众的交集构建定向受众。定向受众中仅包含同时属于视频购物广告重定向受众和自定义受众的人群。</li></ul> |
#|location_ids |string[]|定向地域的ID。使用[/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713) 获取定向地域的ID。 |
#| zipcode_ids|string[]|定向地域的邮政编码ID。 |
#|languages |string[]|受众语言。<br>枚举值：详见[枚举值-受众语言](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|gender |string|定向受众性别 <br>枚举值: `GENDER_FEMALE`,`GENDER_MALE`,`GENDER_UNLIMITED`。 |
#|age_groups |string[]|定向受众年龄<br>枚举值：详见[枚举值-受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|spending_power|string|消费能力。枚举值：`ALL`, `HIGH`。如果设为`HIGH`，您就可以定向和普通用户相比 TikTok 广告投入支出通常更多的高消费能力用户。|
#|household_income| string[]| 您想定向的收入群体。枚举值：`TOP5`(家庭收入群体的前5%)， `TOP10`(家庭收入群体的前10%)，`TOP10_25`(家庭收入群体的前10-25%)， `TOP25_50`(家庭收入群体的前25-50%)。 |
#|audience_ids|string[]|受众 ID 列表。 |
#| smart_audience_enabled | boolean | 是否已启用智能受众。<br><br>枚举值： `true`， `false`。 |
#|excluded_audience_ids|string[]|排除受众 ID 列表。 |
#|interest_category_ids |string[]|用于定向受众的一般兴趣分类 ID 列表。|
#|interest_keyword_ids|string[]|用于定向受众的其他兴趣分类 ID 列表。|
#|purchase_intention_keyword_ids|string[]| 购买意向分类 ID 列表，用于定向近期行为表明其可能会购买某内容类别相关产品的受众。 |
#|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天内发生的行为。|
##|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>|
##|action_category_ids |string[]| 用于定向受众的视频互动分类 ID、创作者互动分类 ID、话题标签 ID 或话题包 ID 列表。|
#| smart_interest_behavior_enabled | boolean | 是否已启用智能型兴趣和行为。<br><br>枚举值： `true`， `false`。 |
#|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`。 |
#|operating_systems |string[]|受众操作系统，枚举值：`ANDROID`, `IOS`。|
#|min_android_version|string|受众最低 Android 版本。枚举值：详见[枚举值-最低Android版本](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|ios14_targeting |string|您想定向的 iOS 设备版本。枚举值：<ul><li>`UNSET`：运行 iOS 14.4 及更早版本的设备。</li><li>`IOS14_MINUS`：不受 iOS 14 新的 ATT 框架影响的 iOS 设备（运行 iOS1 4.0 及更早的设备）。</li><li>`IOS14_PLUS`：运行 iOS 14.5 及之后版本、已执行 ATT 框架的 iOS 设备。此值仅支持在专属推广系列中使用。</li><li>`ALL`：运行 iOS 14.5 及之后版本、已执行 ATT 框架的 iOS 设备。此值仅支持在 iOS 应用再营销广告或 iOS 重定向类型的视频购物广告（商品来源为商品库且优化位置为应用）中使用。 </li></ul>|
#|min_ios_version|string|受众最低iOS版本。枚举值：详见[枚举值-最低iOS版本](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|ios14_quota_type|string|本推广系列是否占用 iOS 14专属推广系列配额。枚举值：`OCCUPIED`（占用）， `UNOCCUPIED`（不占用）。对于非覆盖和频次推广系列，如果`ios14_targeting`设为 `IOS14_PLUS`， 本字段会自动设为`OCCUPIED`。|
#|device_model_ids| string[]| 设备机型ID列表。关于设备机型更多信息，可参考[获取设备型号列表](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)。|
#|network_types|string[]|网络类型。<br>详见[枚举值-网络类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|carrier_ids |string[]| 运营商ID。 只有当运营商`in_use`字段为`true`时生效。获取详细信息，参阅[获取运营商列表](https://ads.tiktok.com/marketing_api/docs?id=1737168013095938)。|
#| isp_ids | string[] | 定向的互联网服务提供商的ID。|
#|device_price_ranges|number[]|设备价格区间（10000代表1000+）。该数字必须是50的倍数。<br><b><span style="color: darkred">重要提示</span></b>: 最终的实际上限将在您设定的上限基础上增加50，您可以在TikTok广告管理平台的广告组设置中看到实际上限。例如，如果您设置的价格区间是[0, 250]，实际区间则为[0, 300]。|
#|targeting_expansion{-将被废弃}| object | 定向扩量设置|
##|expansion_enabled|boolean| 是否开启定向扩量|
##|expansion_types |string[]| 要进行扩量的定向受众类型|
#|contextual_tag_ids |string[] | 内容相关定向标签ID列表。|
#|brand_safety_type|string|品牌安全类型。枚举值： <ul><li>`NO_BRAND_SAFETY`（将在下个API版本中废弃。）：不使用任何品牌安全解决方案，即使用<strong>全部库存</strong>。您的广告可能会在某些包含成人主题的内容周围展示。</li><li>`EXPANDED_INVENTORY`：使用TikTok的品牌安全解决方案，即使用<b>扩展库存</b>。您的广告将不会出现在不当内容或包含成人主题的内容后面。在下个API版本中`EXPANDED_INVENTORY`将替代`NO_BRAND_SAFETY`，并成为默认的品牌安全选项。</li><li>`STANDARD_INVENTORY`：使用TikTok的品牌安全解决方案中的<strong>标准库存</strong>。您的广告将展示在适合大多数品牌的内容周围。 </li><li>`LIMITED_INVENTORY`：使用TikTok的品牌安全解决方案中的<strong>有限库存</strong>。您的广告将展示在不包含成人主题的内容周围。</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收购）。您可以使用[/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)接口，并根据自己的品牌安全设置获取可投放的国家和地区。您需要传入品牌安全类型和品牌安全合作伙伴。|
#|inventory_filter_enabled|boolean|库存筛选（筛选安全视频，如果不安全则不展示），仅对于 `PLACEMENT_TIKTOK` 版位有效，true表示筛选，false表示不筛选。|
#|category_exclusion_ids|string[]|内容排除类别ID。|
#|vertical_sensitivity_id|string|行业敏感内容控制类型ID。|
#|budget_mode|string|广告预算类型。当开启了推广系列预算优化时，该字段返回`BUDGET_MODE_INFINITE`。获取预算模式的详细信息，请参阅[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。|
#|budget |float|广告预算。当开启了推广系列预算优化（`budget_optimize_on` = `TRUE`）时，该字段返回0.0
#|scheduled_budget |float|表示隔日预算值。若是非0则表示设置了隔日预算并表示了隔日预算的数值；若是为0则表示未设置隔日预算。
#|schedule_type |string|广告投放时间类型<br>枚举值: `SCHEDULE_FROM_NOW`，`SCHEDULE_START_END`。如果您选择了`SCHEDULE_START_END`，您需要明确投放开始和结束时间。 如果您选择了`SCHEDULE_FROM_NOW`，您只需要明确投放开始时间。|
#|schedule_start_time|datetime|广告投放起始时间 (UTC+0)，形式如：`YYYY-MM-DD HH:MM:SS`。|
#|schedule_end_time |datetime|广告投放结束时间 (UTC+0)，形式如：`YYYY-MM-DD HH:MM:SS`。|
#|delivery_mode |string| 覆盖和频次广告组中广告投放的排序与排期策略。<br><br> 枚举值: <ul><li>`STANDARD`：标准投放。每个广告均匀投放，预计会获得大致相同的访问量。</li><li>`SCHEDULE`：计划投放。为每个广告设置投放的特定时间段。</li><li>`SEQUENCE`：顺序投放。为广告设置特定的投放顺序。</li><li>`OPTIMIZE`（<span style="color:red">已废弃</span> ）：优选投放。</li></ul>|
#|dayparting |string|广告投放安排。格式为48x7的字符串。字符只能为0或者1。0代表不投放，1代表投放。每个字符对应一个30分钟的时间段。第一个字符对应的是周一的凌晨0:01-0:30，第二个字符对应0:31-1:00，依次类推。最后一个字符代表周日23:31-0:00。<br><span style="color: darkred"><b>注意：</b></span><br>不设置，全部设置为0，或者全部都设置为1都代表了要进行全时投放。|
#|optimization_goal|string|优化目标 <br>枚举值: 详见[枚举值-优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|secondary_optimization_event|string|当优化目标为`INSTALL`或`VALUE`时的次要优化目标。枚举值：详见[转化事件-App深度转化事件类型](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)。|
#| message_event_set_id | string | 即时通讯广告组中使用的消息事件集的 ID。<br><br>若广告组设置中的即时通讯应用账号匹配到了唯一消息事件集，无论是通过 `messaging_app_account_id` 手动指定的 Messenger 账号还是基于指定的`phone_region_code`、`phone_region_calling_code` 和 `phone_number` 填充的 WhatsApp 账号，则本字段将<b>自动填充</b>为与所选即时通讯应用账号绑定的唯一消息事件集。 |
#|frequency |number| 频次，与 `frequency_schedule`共同构成控制用户看到广告的频次上限（仅适用于覆盖人数广告）。如: `frequency` = 2且`frequency_schedule` = 3 表示每 3 天至多 2 次展示 |
#|frequency_schedule|number| 频次天数，与`frequency`共同构成控制用户看到广告的频次上限（仅适用于覆盖人数广告）。见 `frequency` 字段说明 |
#|bid_type |string|竞价策略。 竞价策略将决定系统的单次成效费用管理方式、预算支出方式以及广告投放方式。<br> 详见[枚举值-竞价策略](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|bid_price |float|出价。想尽可能达到的平均单次成效成本。|
#|conversion_bid_price |float|oCPM转化出价|
#|deep_bid_type |string|深度事件出价类型<br>枚举值: 详见[枚举值-深度事件出价类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|roas_bid|float|用于价值优化的ROAS目标值。|
#| vbo_window | string | 为[广告收入价值优化](1739381743067137.html)或[应用内购价值优化](1739381743067137.html)指定的竞价策略的时间窗口期。 <br><br>枚举值： <ul><li>`SEVEN_DAYS`：前 7 天。</li><li>`ZERO_DAY`：第 0 天（当天）。</li></ul> |
#|bid_display_mode|string|每次浏览成本的计算和测算模式。枚举值：`CPMV`(每千次浏览成本) / `CPV`(每次浏览成本) 。默认值：`CPMV`。|
#|deep_cpa_bid |float|当您为app内事件选择出价策略后，您需要在该字段中传入出价价格。|
#|cpv_video_duration |string|优化目标之视频播放时长<br>枚举值: `SIX_SECONDS`（视频播放6秒），`TWO_SECONDS`（视频播放2秒） |
#| next_day_retention | float | 次日留存率。计算公式：`next_day_retention` = `conversion_bid_price`/`deep_cpa_bid`，范围 (0，1]。仅当`placements`为`PLACEMENT_PANGLE`且深度转化事件`secondary_optimization_event`为`NEXT_DAY_OPEN`时生效。 |
#| click_attribution_window | string | 广告组的点击归因窗口期。该窗口期指用户从点击广告到采取行动之间的时间间隔。<br><br>枚举值：<ul><li>`OFF`：不启用。 </li><li> `ONE_DAY`：1天（点击）。</li><li>`SEVEN_DAYS`：7天（点击）。 </li><li>`FOURTEEN_DAYS`：14天（点击）。</li><li> `TWENTY_EIGHT_DAYS`：28天（点击）。 </li></ul>|
#| engaged_view_attribution_window | string | 广告组的深度互动观看归因窗口期。该窗口期指用户从观看视频广告 6 秒到采取行动之间的时间间隔。<br><br>枚举值：<ul><li>`ONE_DAY`：1天（深度互动观看）。</li><li>`SEVEN_DAYS`：7天（深度互动观看）。 </li></ul>|
#| view_attribution_window | string | 广告组的展示归因窗口期。该窗口期指用户从查看广告到采取行动之间的时间间隔。<br><br>枚举值：<ul><li>`OFF`：不启用。</li><li>`ONE_DAY`：1天（展示）。</li><li>`SEVEN_DAYS`：7天（展示）。 </li></ul>|
#| attribution_event_count | string | 广告组的事件统计方式（统计类型）。<br>统计用户在查看或点击了广告后采取操作的次数的方式。<br><br>枚举值： <ul><li>`UNSET` ：未设置。 </li><li> `EVERY`：每一次。某位用户进行的多个购买事件将分别计入转化量。</li><li> `ONCE`：仅一次。某位用户进行的多个事件将只算作 1 次转化。</li></ul>|
#|billing_event |string| 计费事件。<br>枚举值: 详见[枚举值-计费事件](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-计费事件)。|
#|pacing |string| 广告投放速度类型。您可以选择`PACING_MODE_SMOOTH`（在预定的时间内平均分配预算）和`PACING_MODE_FAST`（尽快消耗预算并产出结果）。当您开启推广系列预算优化（`budget_optimize_on` = `TRUE`）时，该字段将自动设置为为`PACING_MODE_SMOOTH`。否则您需要填写该字段。|
#|operation_status |string|广告组的操作状态。<ul><li>`ENABLE`：广告组处于启用（“开”）状态。</li><li>`DISABLE`：广告组处于未启用（“关”）状态。</li><li>`FROZEN`：广告组处于冻结状态，无法再次启用。</li></ul> |
#|secondary_status |string|广告组状态<br>枚举值：详见[枚举值-广告组状态](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|statistic_type |string| 转化事件出价单位，枚举值 `EVERYTIME`(每一次)，`NONE`(仅一次) |
#| is_hfss |boolean| 推广内容是否为 HFSS（高脂高盐和高糖）产品/品牌。<br><br>支持的值：`true`，`false`。|
#| is_lhf_compliance | boolean | 推广内容是否符合 LHF（较不健康食品）合规要求。<br><br>将 `is_lhf_compliance` 设置为 `true`，即表示您确认在英国 TikTok 上推广的任何食品或饮料均符合 [2024 年较不健康食品法规](https://www.legislation.gov.uk/uksi/2024/1266/made)以及其他所有适用法律。<br><br>支持的值：`true`，`false`。 |
#|creative_material_mode |string|创意投放方式。<br>枚举值: `CUSTOM`（自定义）。|
#|adgroup_app_profile_page_state|string|该广告组是否使用了应用介绍页。枚举值：`INVALID`， `UNSET`， `ON`， `OFF`。|
#|rf_purchased_type |string| 覆盖和频次购买方式，详见[枚举值 - 覆盖和频次广告购买方式](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><p><span style="color:darkred"><b>注意</b></span>：本字段的值始终返回null。 |
#|purchased_impression |number| 覆盖和频次广告购买的展示量。<br><p><span style="color:darkred"><b>注意</b></span>：本字段的值始终返回null。 |
#|purchased_reach|number| 覆盖和频次广告购买的触达人数。<br><p><span style="color:darkred"><b>注意</b></span>：本字段的值始终返回null。 |
#|rf_estimated_cpr |number| 覆盖和频次广告预测的千人覆盖成本。<br><p><span style="color:darkred"><b>注意</b></span>：本字段的值始终返回null。 |
#|rf_estimated_frequency |number| 覆盖和频次预测的人均展示频次。<br><p><span style="color:darkred"><b>注意</b></span>：本字段的值始终返回null。 |
#|is_new_structure |boolean| 推广系列是否是新结构。 |
#|skip_learning_phase |boolean|是否跳过学习阶段。|
#|conversion_window (已废弃) |string|转化窗口，您希望用户从点击或观看广告到最终发生转化的时间周期，广告平台将使用该时间周期内的数据优化您的广告投放效果。该设置不会影响到投放数据归因设置。枚举值详见[枚举值-广告管理-转化窗口期](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|page_info |object|分页信息 |
##|page |number|当前页数 |
##|page_size |number|分页大小 |
##|total_number |number|总数，符合条件的广告组总数 |
##|total_page |number|总页数 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"frequency_schedule": null,
"schedule_type": "SCHEDULE_START_END",
"optimization_goal": "CLICK",
"conversion_window": null,
"adgroup_name": "{{adgroup_name}}",
"campaign_id": "{{campaign_id}}",
"video_download_disabled": false,
"skip_learning_phase": false,
"interest_keyword_ids": [],
"audience_ids": [],
"deep_bid_type": null,
"feed_type": null,
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"network_types": [],
"adgroup_app_profile_page_state": null,
"excluded_audience_ids": [],
"ios14_quota_type": "UNOCCUPIED",
"bid_display_mode": "CPMV",
"billing_event": "CPC",
"modify_time": "{{modify_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"pacing": "PACING_MODE_SMOOTH",
"app_type": null,
"age_groups": null,
"languages": [],
"interest_category_ids": [],
"promotion_type": "WEBSITE",
"rf_estimated_cpr": null,
"category_id": "0",
"auto_targeting_enabled": false,
"gender": "GENDER_UNLIMITED",
"budget_mode": "BUDGET_MODE_TOTAL",
"purchased_reach": null,
"brand_safety_partner": null,
"delivery_mode": null,
"is_hfss": false,
"create_time": "{{create_time}}",
"adgroup_id": "{{adgroup_id}}",
"actions": [],
"frequency": null,
"schedule_infos": null,
"rf_purchased_type": null,
"conversion_bid_price": 0,
"creative_material_mode": "CUSTOM",
"rf_estimated_frequency": null,
"brand_safety_type": "NO_BRAND_SAFETY",
"scheduled_budget": 0,
"is_new_structure": true,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"advertiser_id": "{{advertiser_id}}",
"comment_disabled": false,
"operating_systems": [
"ANDROID"
],
"schedule_start_time": "{{schedule_start_time}}",
"secondary_status": "ADGROUP_STATUS_CREATE",
"next_day_retention": null,
"bid_type": "BID_TYPE_NO_BID",
"keywords": null,
"inventory_filter_enabled": false,
"app_download_url": null,
"purchased_impression": null,
"location_ids": [
"{{location_id}}"
],
"operation_status": "ENABLE",
"statistic_type": null,
"secondary_optimization_event": null,
"app_id": null,
"deep_cpa_bid": 0,
"optimization_event": null,
"placements": [
"PLACEMENT_TIKTOK"
],
"device_price_ranges": null,
"share_disabled": false,
"bid_price": 0,
"campaign_name": "{{campaign_name}}",
"search_result_enabled": false,
"budget": {{budget}},
"pixel_id": null
}
}
(/code);