创建升级版 Smart+ 广告组
你可以使用本接口创建升级版 Smart+ 广告组。
在一个升级版 Smart+ 推广系列中，你最多可以创建 30 个广告组。
- 在推广系列层级已启用推广系列预算优化 (CBO)（budget_optimize_on 为 true）时，以下设置（如传入）必须在同一推广系列内的所有广告组中保持一致：
- promotion_type
- promotion_target_type
- optimization_goal
- optimization_event
- app_attribution_source
- app_data_source
- billing_event
- bid_type
- bid_price
- conversion_bid_price
- deep_bid_type
- vbo_window
- roas_bid
- identity_id，identity_type，identity_authorized_bc_id 和 native_series_id （promotion_type 为 NATIVE_SERIES 时）
- 在推广系列层级未启用 CBO（budget_optimize_on 为 false）时，以下设置（如传入）必须在同一推广系列内的所有广告组中保持一致：
- bid_type
- deep_bid_type
- vbo_window
- budget_mode
请求
地址 https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/create/
方法 POST
Header
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://business-api.tiktok.com/portal/docs/marketing-api-authentication/v1.3)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许值：`application/json`。|
参数
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|request_id {必填}|string|请求 ID，用于创建名称相同的广告组。同时，请求 ID 还支持幂等处理，避免重复发送相同的请求。如果以相同的请求 ID 多次重复发送请求，仅其中 1 次请求会成功。<br><br>请求 ID 不同于返回参数中的 `request_id`，后者用于唯一标识 HTTP 请求。<br><br>该值应为 64 位整数字符串形式。<br><br>示例：`123456789`。|
|campaign_id {必填}|string|广告组所属的推广系列的 ID。|
|operation_status|string|广告组创建时的状态。<br><br>枚举值：<ul><li>`ENABLE`：广告组创建时处于已启用状态。</li><li>`DISABLE`：广告组创建时处于未启用状态。</li></ul><br>默认值：`ENABLE`。|
|adgroup_name {必填}|string|广告组名称。<br><br>长度限制：512 个字符。不支持使用表情符号。|
|catalog_id {+条件必填}|string|当推广系列层级的 `catalog_enabled` 为 `true` 时，此为必填字段。<br><br>用于广告组的商品库的 ID。<br><br>若想获取你的商务中心内的商品库，需使用 [/catalog/get/](1740315452868610.html) 接口。|
|catalog_authorized_bc_id {+条件必填}|string|当 `catalog_enabled` 为 `true` 时，此为必填字段。<br><br>商品库 (`catalog_id`) 所属的商务中心的 ID。|
|promotion_type {必填}|string|推广类型（优化位置）。<br>你可以使用此字段来选择商品的投放位置。<br><br>目前，我们支持 `APP_ANDROID`、`APP_IOS`、`WEBSITE`、`MINI_APP`、`MINI_GAME`、`NATIVE_SERIES` 和 `LEAD_GENERATION`。<ul><li>当 `objective_type` 为 `APP_PROMOTION` 且 `app_promotion_type` 为 `APP_INSTAL` 或 `APP_RETARGETING` 时，将此字段设置为 `APP_ANDROID` 或 `APP_IOS`。</li><li>当 `objective_type` 为 `APP_PROMOTION` 且 `app_promotion_type` 为 `MINIS` 时，将此字段设置为 `MINI_APP`、`MINI_GAME` 或`NATIVE_SERIES`。</li><li>当 `objective_type` 为 `WEB_CONVERSIONS` 时：<ul><li>如果 `sales_destination` 为 `WEBSITE`，将此字段设置为 `WEBSITE`。</li><li>如果 `sales_destination` 为 `APP`，将此字段设置为 `APP_ANDROID` 或 `APP_IOS`。</li></ul></li><li>当 `objective_type` 为 `LEAD_GENERATION` 时，将此字段设置为以下任意值：<ul><li>`LEAD_GENERATION`</li><li>`LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`</li><li>`LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE`</li><li>`LEAD_GEN_CLICK_TO_CALL`</li></ul></li></ul><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置必须在同一推广系列内的所有广告组中保持一致。</p>|
|promotion_target_type |string|当 `objective_type` 为 `LEAD_GENERATION` 时生效。<br><br>线索收集推广目标的优化位置。<br><br>枚举值：<ul><li>`INSTANT_PAGE`：即时表单。创建可快速加载的应用内 TikTok 即时表单来收集更多线索。</li><li>`EXTERNAL_WEBSITE`：网站表单。使用包含网站表单的落地页，或使用 TikTok 即时体验页面（可跳转到包含网站表单的网站），收集更多线索。</li></ul><br><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</p>|
|optimization_goal {必填}|string|你希望通过推广系列实现的可度量成效。<br><br>目前，我们支持 `CLICK`、`INSTALL`、`IN_APP_EVENT`、`VALUE`、`CONVERT`、`TRAFFIC_LANDING_PAGE_VIEW`、`CONVERSATION` 和 `LEAD_GENERATION`。<br><br>要查找关于每个优化目标的详细描述，参见[枚举值 - 优化目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-优化目标)。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</li><li>当 `promotion_type` 为 `LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE` 且 `optimization_goal` 为 `CONVERSATION` 时，你只能将 `messaging_app_type` 设置为以下任意值：<ul><li>`MESSENGER`</li><li>`WHATSAPP`</li><li>`ZALO`</li></ul></li></ul></p>|
|app_id {+条件必填}|string|当同时满足以下两个条件时，此为必填字段：<br>在推广系列层级：<ul><li>`objective_type` 为 `APP_PROMOTION` 且 `app_promotion_type` 为 `APP_INSTALL` 或 `APP_RETARGETING`，或 `objective_type` 为 `WEB_CONVERSIONS` 且 `sales_destination` 为 `APP`。</li><li>`camapign_type` 为 `REGULAR_CAMPAIGN`。</li></ul><br>待推广应用的 ID。<br><br>若想获取应用 ID 列表，需使用 [/app/list/](1740859313270786.html) 接口。<br><br><p><span style="color:darkred"><b>注意</b></span>：无法通过此字段传入尚未在你的 MMP 上激活 SAN 模块的应用以创建广告组。为确保你的应用已启用 TikTok SAN 集成，参见[如何将应用迁移到 SAN 集成](https://ads.tiktok.com/help/article/transition-to-san-for-existing-apps)。</p>|
|gaming_ad_compliance_agreement|string|在以下任一场景中生效：<ul><li>场景 1：当在推广系列层级同时满足以下两个条件时：<ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_RETARGETING`。</li></ul></li><li>场景 2：当在推广系列层级同时满足以下所有条件时：<ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_INSTALL`。</li><li>`campaign_type` 为 `REGULAR_CAMPAIGN`。</li></ul></li></ul><br>是否同意 TikTok 游戏广告主合规保证政策。|
|pixel_id {+条件必填}|string|<ul><li>当满足以下条件时，此为必填字段：<ul><li>在推广系列层级：`objective_type` 为 `WEB_CONVERSIONS` 或 `LEAD_GENERATION`。</li><li>在广告组层级：`optimization_goal` 设置为 `CONVERT` 或 `VALUE`。</li></ul></li><li>当 `optimization_goal` 设置为 `CLICK`、`INSTALL`、`IN_APP_EVENT` 或 `TRAFFIC_LANDING_PAGE_VIEW` 时，不支持填写该字段。</li></ul><br>Pixel ID。<br><br>若想获取所有 Pixel ID，需使用 [/pixel/list/](1740858697598978.html) 接口。|
| app_config {+条件必填} | object[] | 当推广系列层级的 `sales_destination` 为 `WEB_AND_APP` 时，此为必填字段。<br><br>待推广的一个或多个应用的详细信息。<br><br>最大数量：2。<br><br>你可以在此字段中传入以下任意项：<ul><li>Android 应用</li><li>iOS 应用</li><li>Android 应用和 iOS 应用</li></ul> |
#| app_id {+条件必填} | string | 当传入 `app_config` 时，此为必填字段。<br><br>待推广应用的 ID。<br><br>若想获取你的广告账号内的应用 ID 列表，需使用 [/app/list/](1740859313270786.html) 接口，并查看返回的 `app_id`。|
|minis_id {+条件必填}|string|当 `promotion_type` 为 `MINI_APP` 或 `MINI_GAME` 时，此为必填字段。<br><br>TikTok Mini 的 ID。<ul><li>当 `promotion_type` 为 `MINI_APP` 时，传入短剧类的 TikTok Mini 的 ID。</li><li>当 `promotion_type` 为 `MINI_GAME` 时，传入小游戏类的 TikTok Mini 的 ID。</li></ul><br>若想获取广告账号中的 TikTok Mini 列表，需使用 [/minis/get/](1853450329535490.html) 接口，并选择 `minis_status` 为 `ACTIVE` 的 TikTok Minis。<br><br>查看[创建升级版 Smart+ TikTok Growth Max 短剧推广系列](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-minis-campaign/v1.3)和[创建升级版 Smart+ TikTok Growth Max 小游戏推广系列](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-mini-games-campaign/v1.3)文档，详细了解支持此设置的推广系列类型。|
|optimization_event {+条件必填}|string|在以下任意场景中，此为必填字段：<ul><li>`pixel_id` 已传入。</li><li>不传入 `pixel_id`，且 `optimization_goal` 为 `IN_APP_EVENT` 或 `VALUE`。</li><li> 不传入 `pixel_id` 且传入了 `minis_id`。</li></ul><br>转化事件。<br><br>参见[转化事件](1739361474981889.html)，了解支持的应用和 Pixel 事件。<br>若想找到你的应用支持的事件，需使用 [/app/optimization_event/](1740859338750977.html) 接口。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</p>|
|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><ul><li>若想获取 Pixel 或应用相关的自定义转化列表，需使用 [/custom_conversion/list/](1842225174460673.html) 接口。 </li><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><br>默认值：`OFF`。<br><br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>使用 CRM 事件进行深层漏斗优化目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>使用 Pixel 或线下事件进行深层漏斗优化的功能已全面开放。</li></ul></p>|
|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。<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 事件组 ID。<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`。|
|app_attribution_source|string|仅当同时满足以下条件时生效：<ul><li>在推广系列层级，`objective_type`为`APP_PROMOTION`，且`app_promotion_type`为`APP_INSTALL`或`APP_RETARGETING`。</li><li>该移动应用支持配置归因来源和数据源。<ul><li>如需确认移动应用支持此功能，可使用[/app/list/](https://business-api.tiktok.com/portal/docs/get-the-app-list/v1.3)或[/app/info/](https://business-api.tiktok.com/portal/docs/get-info-of-an-app/v1.3)，并选择一个`is_attribution_flex_enable`为`true`的`app_id`。</li></ul></li></ul><br>你的移动应用的归因来源。<br><br>你选择的归因来源将用于优化、出价和报告。<br><br>枚举值：<ul><li>`MMP`: MMP 归因。来自所选 MMP 的信号将用于归因。</li><li>`SAN`: SAN 归因。来自 TikTok 自归因网络的信号将用于归因。</li></ul><br>你可指定的值取决于你的应用（`app_id`）的配置。若想获取你的应用可用的归因来源和数据源设置，需使用[/tool/available/attribution_source/](https://business-api.tiktok.com/portal/docs/get-available-attribution-sources-and-data-sources-for-an-app/v1.3)。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>本字段设置后不支持更新。</li><li>在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</li><li>在创建升级版 Smart+ 广告组时为应用配置归因来源和数据源目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li></ul>|
|app_data_source|string|你的应用的数据源。<br><br>你选择的归因信号将用于报告。<br><br>枚举值：<ul><li>`MMP`: MMP 信号。来自你的 MMP 的信号将用于报告。</li><li>`EVENT_SDK`: 应用事件 SDK 信号。来自 TikTok 应用事件 SDK 的信号将用于报告。</li><li>`EVENT_API`: 事件 API 信号。来自 TikTok 事件 API 的信号将用于报告。</li></ul><br>你可指定的值取决于你的应用（`app_id`）的配置。若想获取你的应用可用的归因来源和数据源设置，需使用[/tool/available/attribution_source/](https://business-api.tiktok.com/portal/docs/get-available-attribution-sources-and-data-sources-for-an-app/v1.3)。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>本字段设置后不支持更新。</li><li>在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</li><li>在创建升级版 Smart+ 广告组时为应用配置归因来源和数据源目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li></ul>|
|identity_id |string|仅在以下任一场景生效：<ul><li>场景 1：`promotion_type` 为 `NATIVE_SERIES`。</li><li>场景 2：`promotion_type` 为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`且你的广告账号已加入白名单，可以在 TikTok 私信广告的广告组层级选择 TikTok 账号。</li></ul><br>在 TikTok Growth Max 剧集广告中托管和管理你的系列的 TikTok 账号的广告发布身份 ID 或在 TikTok 私信广告中使用的 TikTok 账号的广告发布身份 ID。<br><br>查看[创建以 TikTok 私信作为优化位置的升级版 Smart+ 线索收集推广系列](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-lead-generation-campaign-with-optimization-location-as-tiktok-direct-messages/v1.3)文档，详细了解如何创建 TikTok 私信广告。<br>查看[创建升级版 Smart+ TikTok Growth Max 剧集推广系列](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-mini-series-feed-campaign/v1.3)文档，详细了解如何创建 TikTok Growth Max 剧集广告。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>“在 TikTok 私信广告的广告组层级选择 TikTok 账号”目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>此字段设置后不可更新。</li></ul>|
|identity_type|string|仅在以下任一场景生效：<ul><li>场景 1：`promotion_type` 为 `NATIVE_SERIES`。</li><li>场景 2：`promotion_type` 为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`且你的广告账号已加入白名单，可以在 TikTok 私信广告的广告组层级选择 TikTok 账号。</li></ul><br>在 TikTok Growth Max 剧集广告中托管和管理你的系列的 TikTok 账号的广告发布身份 ID 或在 TikTok 私信广告中使用的 TikTok 账号的广告发布身份类型。<br><br>枚举值：<br><br><ul><li>`TT_USER`：TikTok 企业号用户。</li><li>`BC_AUTH_TT`：商务中心有权访问的 TikTok 账号。</li></ul><br>查看[认证身份](1738958351620097.html)文档，了解详细信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>“在 TikTok 私信广告的广告组层级选择 TikTok 账号”目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>此字段设置后不可更新。</li></ul>|
|identity_authorized_bc_id {+条件必填}|string|当 `identity_type` 为 `BC_AUTH_TT` 时，此为必填字段。<br><br>与“添加到商务中心的 TikTok 用户”类型广告发布身份关联的商务中心 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。|
| native_series_id {+条件必填} | string | `promotion_type` 为 `NATIVE_SERIES` 时必填。<br><br>TikTok 系列 ID。<br>系列是由创作者制作的专属优质视频合集。受众可以通过创作者的个人主页或附加在 TikTok 视频中的链接购买系列访问权。<br><br>若想获取你的广告账号中可用的 TikTok 账号里可选的 TikTok 系列，可使用 [/identity/native_series/get/](https://business-api.tiktok.com/portal/docs/get-the-available-tiktok-series-within-an-ad-account/v1.3)。 |
|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_info`，这将用于自动填充对应的 WhatsApp 电话号码。</li><li>`ZALO`：Zalo。你需要同时通过 `zalo_id_type` 传入 Zalo 联系人格式。 </li><li>`LINE`：Line。你需要同时通过 `messaging_app_account_id` 传入 LINE 企业 ID。</li><li>`IM_URL`：即时通讯 URL。</li></ul><br>查看[创建以即时通讯应用作为优化位置的升级版 Smart+ 线索收集推广系列](1847302988449921.html)文档，详细了解如何创建升级版 Smart+ TikTok 即时通讯广告。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>当 `optimization_goal` 为 `CONVERSATION` 时，无法将此字段设置为 `LINE` 或 `IM_URL`。</li><li>此字段设置后不可更新。</li></ul>|
|zalo_id_type {+条件必填}|string|当 `messaging_app_type` 为 `ZALO` 时，此为必填字段。<br><br>Zalo 联系人格式的类型。<br><br>枚举值：<ul><li>`ZALO_OFFICIAL_ACCOUNT`：Zalo 官方账号 ID。你需要同时通过 `messaging_app_account_id` 传入 Zalo 官方账号 ID。</li><li>`ZALO_PHONE_ACCOUNT`：Zalo 电话号码。你需要同时传入 `phone_info` 以自动填充对应的 Zalo 电话号码。</li><li>当 `optimization_goal` 为 `CLICK` 时，只能将 `zalo_id_type` 设置为 `ZALO_PHONE_ACCOUNT`。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。|
|messaging_app_account_id {+条件必填}|string|在以下任意场景中，此为必填字段且生效：<ul><li>当 `messaging_app_type` 为 `MESSENGER` 或 `LINE` 时。</li><li>当 `messaging_app_type` 为 `ZALO` 并且 `zalo_id_type` 为 `ZALO_OFFICIAL_ACCOUNT` 时。</li></ul><br>即时通讯应用账号的 ID。<ul><li>当 `messaging_app_type` 为 `MESSENGER` 时，通过此字段传入 Facebook 公共主页编号。<ul><li>若想查找你的 Facebook 公共主页编号，前往你的 Facebook 公共主页，点击封面图片下方的“About”，然后点击“Page transparency”。</li></ul></li><li>当 `zalo_id_type` 为 `ZALO_OFFICIAL_ACCOUNT` 时，通过此字段传入 Zalo 官方账号 ID。</li><li>当 `messaging_app_type` 为 `LINE` 时，通过此字段传入 LINE 企业 ID。<ul><li>若想查找你的 LINE 企业 ID，前往你的 LINE 官方账号页面。</li></ul></li><li>当 `messaging_app_type` 为 `WHATSAPP` 或 `zalo_id_type` 为 `ZALO_PHONE_ACCOUNT` 时，此字段将被忽略，并被设置为根据传入的 `phone_info` 自动填充的对应 WhatsApp 或 Zalo 电话号码。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。|
|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。<ul><li>如果广告组设置中的即时通讯应用账号（无论是通过 `messaging_app_account_id` 传入的 Messenger 账号、Zalo 官方账号，还是通过传入的 `phone_info` 填充的 WhatsApp 或 Zalo 电话账号）与现有事件组匹配，此字段将<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>：此字段设置后不可更新。|
|phone_info {+条件必填}|object|在以下任意场景中，此为必填字段：<ul><li>当 `messaging_app_type` 为 `WHATSAPP` 时</li><li>当 `messaging_app_type` 为 `ZALO` 并且 `zalo_id_type` 为 `ZALO_PHONE_ACCOUNT` 时。</li></ul><br>WhatsApp 或 Zalo 电话号码的详细信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。|
#|phone_region_code {+条件必填}|string|当传入 `phone_info` 时，此为必填字段。<br><br>WhatsApp 电话号码或 Zalo 电话号码的地区代码。<br><br>示例：`US`。<br><br>若想获取特定电话号码对应的地区代码 (`phone_region_code`) 和国际区号 (`phone_region_calling_code`)，需使用 [/tool/phone_region_code/](1774488637039618.html) 接口。|
#|phone_region_calling_code {+条件必填}|string|当传入 `phone_info` 时，此为必填字段。<br><br>WhatsApp 电话号码或 Zalo 电话号码的国际区号。<br><br>示例：`+1`。<br><br>若想获取特定电话号码对应的地区代码 (`phone_region_code`) 和国际区号 (`phone_region_calling_code`)，需使用 [/tool/phone_region_code/](1774488637039618.html) 接口。|
#|phone_number {+条件必填}|string|当传入 `phone_info` 时，此为必填字段。<br><br>WhatsApp 电话号码或 Zalo 电话号码。<br><br>对于 WhatsApp，使用已关联消息管理工具 (MMT) 的 WhatsApp 电话号码。|
|bid_type {必填}|string|决定系统的平均成效成本管理方式、预算消耗方式和推广系列投放方式的出价策略。<br><br>枚举值：<ul><li>`BID_TYPE_NO_BID`：最大投放量。</li><li>`BID_TYPE_CUSTOM`：成本上限（或目标 CPA）。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</p>|
|bid_price {+条件必填}|float|当满足以下条件时，此为必填字段：<ul><li>`optimization_goal` 为 `CLICK`。</li><li>`bid_type` 为 `BID_TYPE_CUSTOM`。</li></ul><br>目标平均点击成本。系统会在保持平均成效成本接近或低于指定金额的同时，尽可能获得更多成效。<br><br>`bid_price` 需要低于预算。参见[出价 - 出价限制](1745292444424193.html)，进一步了解出价验证机制。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</p>|
|conversion_bid_price {+条件必填}|float|当满足以下条件时，此为必填字段：<ul><li>`optimization_goal` 为 `CONVERT`、`TRAFFIC_LANDING_PAGE_VIEW`、`INSTALL` 或 `IN_APP_EVENT`。</li><li>`bid_type` 为 `BID_TYPE_CUSTOM`。</li></ul><br>目标平均转化成本或落地页浏览平均成本。系统会在保持平均成效成本接近或低于指定金额的同时，尽可能获得更多成效。<br><br>`conversion_bid_price` 需要低于预算。参见[出价 - 出价限制](1745292444424193.html)，进一步了解出价验证机制。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</p>|
|deep_bid_type {+条件必填}|string|当 `optimization_goal` 为 `VALUE` 时，此为必填字段。<br><br>应用内事件的出价策略。<br><br>枚举值：`DEFAULT`、`AEO`、`VO_MIN_ROAS` 和 `VO_HIGHEST_VALUE`。<br><br>参见[枚举值 - 深层事件出价策略](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-深层事件出价策略)，查看对支持的值的描述。<br><br>在以下任一场景中，你只能将 `deep_bid_type` 设置为 `VO_MIN_ROAS`。<ul><li>在推广系列层级，`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` </li><li>在广告组层级，`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`</li></ul><br><br><p><span style="color:darkred"><b>注意</b></span>：此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</p>|
|roas_bid {+条件必填}|float|当 `deep_bid_type` 为 `VO_MIN_ROAS` 时，此为必填字段。<br><br>价值优化的目标 ROAS。<br><br>值范围：0.01-1,000。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</p>|
|vbo_window|string|为 [VBO IAA](1739381743067137.html)（应用内广告价值优化）或 [VBO IAP](1739381743067137.html)（应用内购买价值优化）传入的出价策略的时间窗口。<br><br>枚举值：<ul><li>`SEVEN_DAYS`：前 7 天（第 7 天）。</li><li>`ZERO_DAY`：当天（第 0 天）。</li></ul><br>默认值：`SEVEN_DAYS`。<br><br><ul><li>如果使用最低 ROAS（目标 ROAS）出价策略，此字段表示目标 ROAS 值的窗口期类型（第 7 天 ROAS 或第 0 天 ROAS）。无论你的预算有多少，系统将力求将你第 7 天或当天的平均 ROAS 保持在接近或高于目标 ROAS 值。</li><li>如果使用最高价值出价策略，此字段表示最高价值窗口期类型（第 7 天最高价值或第 0 天最高价值）。系统将力求在前 7 天或当天充分消耗预算，并尽可能获得最大的成效价值。</li></ul><br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</li><li>不同场景中的 VBO IAP 和 VBO IAA 目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。</li><li>在高级专属推广系列或 Android 推广系列场景中，针对 <b>VBO IAP</b> 的第 0 天和第 7 天出价（`vbo_window` 为 `ZERO_DAY` 或 `SEVEN_DAYS`）目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。</li><li>在高级专属推广系列或 Android 推广系列场景中，针对 <b>VBO IAA</b> 的第 0 天和第 7 天出价（`vbo_window` 为 `ZERO_DAY` 或 `SEVEN_DAYS`）目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。</li><li>此字段设置后不可更新。</li></ul></p>|
|click_attribution_window|string|点击归因窗口期。此归因窗口期指用户从点击广告到采取行动之间的时间间隔。<br><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><li>`THIRTY_DAYS`：30 天点击归因窗口期。<ul><li>仅当 `promotion_type` 为 `MINI_GAME` 时，此为合法值。</li></ul></li><li>`THIRTY_TWO_DAYS`：32 天点击。<ul><li>仅当 `promotion_type` 为 `MINI_APP` 且 `optimization_event` 为 `ACTIVE_PAY` 时，此为合法值。</li></ul></li><li>`ONE_HUNDRED_EIGHTY_DAYS`：180 天点击。<ul><li>仅当 `promotion_type` 为 `MINI_APP` 且 `optimization_event` 为 `ACTIVE_PAY` 时，此为合法值。</li></ul></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`，系统将使用默认设置（如有）。如果不手动传入此字段，要确认是否使用了默认设置，需使用 [/smart_plus/adgroup/get/](1843314879617026.html) 接口。</li><li>此字段设置后不可更新。</li></ul></p>|
|engaged_view_attribution_window|string|深度互动观看归因窗口期。此归因窗口期指用户观看你的视频广告至少 6 秒后，在多长时间范围内的转化会被计入。<br>此字段用于设定可将转化归因到广告组的时间范围。<br><br>枚举值：<ul><li>`OFF`：已关闭。</li><li>`ONE_DAY`：1 天深度互动观看归因窗口期。</li><li>`SEVEN_DAYS`：7 天深度互动观看归因窗口期。</li><li>`FOURTEEN_DAYS`：14 天深度互动观看归因窗口期。<ul><li>此值仅适用于[启用网站和应用优化的升级版 Smart+ 广告](1854746404386113.html)。</li></ul></li><li>`TWENTY_EIGHT_DAYS`：28 天深度互动观看归因窗口期。<ul><li>此值仅适用于[启用网站和应用优化的升级版 Smart+ 广告](1854746404386113.html)。</li></ul></li></ul><br>默认值：`OFF`。<br><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`，系统将使用默认设置（如有）。如果不手动传入此字段，要确认是否使用了默认设置，需使用 [/smart_plus/adgroup/get/](1843314879617026.html) 接口。</li><li>此字段设置后不可更新。</li></ul></p>|
|view_attribution_window|string|观看归因窗口期。此归因窗口期指用户从观看广告到采取行动之间的时间间隔。<br><br>此字段用于设定可将转化归因到广告组的时间范围。<br><br>枚举值：<ul><li>`OFF`：关闭。</li><li>`ONE_DAY`：1 天观看归因窗口期。</li><li>`SEVEN_DAYS`：7 天观看归因窗口期。</li></ul><br>要了解此字段针对不同推广目标场景的允许值，参见[归因窗口期和事件统计方式](1777694366654465.html)。<br><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`，系统将使用默认设置（如有）。如果不手动传入此字段，要确认是否使用了默认设置，需使用 [/smart_plus/adgroup/get/](1843314879617026.html) 接口。</li><li>此字段设置后不可更新。</li></ul></p>|
|attribution_event_count|string|事件统计方式（统计类型）。<br><br>在用户仅浏览或点击广告后，对其操作次数的统计方式。<br><br>枚举值：<ul><li>`UNSET`：未设置。</li><li>`EVERY`：每一次。将某人的多个事件分别统计成不同的转化次数。</li><li>`ONCE`：仅一次。将某人的多个事件计为 1 次转化。</li></ul><br>要了解此字段针对不同推广目标场景的允许值，参见[归因窗口期和事件统计方式](1777694366654465.html)。<br><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`，系统将使用默认设置（如有）。如果不手动传入此字段，要确认是否使用了默认设置，需使用 [/smart_plus/adgroup/get/](1843314879617026.html) 接口。</li><li>此字段设置后不可更新。</li></ul></p>|
|billing_event {必填}|string|你希望为其付费的事件。<br><br>枚举值参见[枚举值 - 计费事件](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-计费事件)。<br><br>目前，我们仅支持 `OCPM` 和 `CPC`：<ul><li>当 `optimization_goal` 为 `CLICK` 时，此字段应设置为 `CPC`。</li><li>当 `optimization_goal` 不为 `CLICK` 时，此字段应设置为 `OCPM`。</li></ul> <br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时，此设置必须在同一推广系列内的所有广告组中保持一致。</p>|
|targeting_optimization_mode|string|受众定向优化模式。<br><br><ul><li>`AUTOMATIC`：自动定向。你可以使用自动定向来充分利用实时数据和机器学习，向最有可能与广告互动的受众定向投放广告。 <ul><li>如果不是升级版 Smart+ 商品库应用广告组，当 `targeting_optimization_mode` 为 `AUTOMATIC` 时，可以将 `suggestion_audience_enabled` 设置为 `false` 或 `true`。 <ul><li>当 `targeting_optimization_mode` 为 `AUTOMATIC` 且 `suggestion_audience_enabled` 为 `false` 时，你可以传入以下可选的受众控制设置： <ul><li>`location_ids`</li><li>`zipcode_ids`</li><li>`spc_audience_age`</li><li>`languages`</li><li>`operating_systems`</li><li>`excluded_audience_ids`</li></ul></li> <li>当 `targeting_optimization_mode` 为 `AUTOMATIC` 且 `suggestion_audience_enabled` 为 `true` 时，你可以传入额外的受众定向设置，用作引导自动定向的建议。 要进一步了解可用设置，参见参数 `suggestion_audience_enabled` 的描述。</li> </ul></li> <li>如果是升级版 Smart+ 商品库应用广告组（推广系列层级的 `sales_destination` 为 `APP`），当 `targeting_optimization_mode` 为 `AUTOMATIC` 时，只能将 `suggestion_audience_enabled` 设置为 `false`。 <ul><li>当 `targeting_optimization_mode` 为 `AUTOMATIC` 且 `suggestion_audience_enabled` 为 `false` 时，你可以传入以下可选的受众控制设置： <ul><li>`location_ids`</li><li>`zipcode_ids`</li><li>`spc_audience_age`</li><li>`languages`</li><li>`audience_ids`</li><li>`excluded_audience_ids`</li><li>`gender`</li></ul> </li></ul> </li></ul></li><li>`MANUAL`：自定义定向。你可以利用自定义定向设置，精准控制广告的目标受众。这可能会限制广告投放并影响推广效果。 <ul><li>当 `targeting_optimization_mode` 为 `MANUAL` 时，你可以传入以下受众设置： <ul><li>`location_ids`</li><li>`zipcode_ids`</li><li>`age_groups`</li><li>`gender`</li><li>`languages`</li><li>`audience_ids`</li><li>`excluded_audience_ids`</li><li>`included_pangle_audience_package_ids`</li><li>`excluded_pangle_audience_package_ids`</li><li>`interest_category_ids`</li><li>`interest_keyword_ids`</li><li>`purchase_intention_keyword_ids`</li><li>`actions`</li><li>`smart_interest_behavior_enabled`</li><li>`smart_audience_enabled`</li><li>`spending_power`</li><li>`household_income`</li><li>`operating_systems`</li><li>`min_android_version`</li><li>`min_ios_version`</li><li>`device_model_ids`</li><li>`network_types`</li><li>`carrier_ids`</li><li>`isp_ids`</li><li>`device_price_ranges`</li><li>`saved_audience_id`</li> </ul></li> </ul> </li> </ul><br>默认值：`AUTOMATIC`。<br><br><p><span style="color:darkred"><b>注意</b></span>：如果你传入的定向设置与定向优化模式设置（`targeting_optimization_mode` 和 `suggestion_audience_enabled`）不一致，这些设置将被忽略，不会报错。|
|suggestion_audience_enabled|boolean|仅当 `targeting_optimization_mode` 为 `AUTOMATIC` 时有效。<br><br>是否启用受众建议。<br><br>受众建议通过传入额外的受众设置来指导自动定向。这些仅为建议，不能保证广告一定会投放给这些受众。<br><br>支持的值：`true`（推荐）、`false`。<br><br>默认值：`false`。<br><br>当 `suggestion_audience_enabled` 为 `true` 时，你可以传入以下额外的受众定向设置：<ul><li>`age_groups`</li><li>`gender`</li><li>`audience_ids`</li><li>`interest_category_ids`</li><li>`interest_keyword_ids`</li><li>`purchase_intention_keyword_ids`</li><li>`actions`</li></ul><br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>如果你传入的定向设置与定向优化模式设置（`targeting_optimization_mode` 和 `suggestion_audience_enabled`）不一致，这些设置将被忽略，不会报错。</li><li>如果在推广系列层级已启用实时 API (RTA)，无法将此字段设置为 `true`。</li></ul></p>|
|targeting_spec {必填}|object|定向设置。<br><br>你可以指定的定向设置会因 `targeting_optimization_mode` 和 `suggestion_audience_enabled` 的值而有所不同。要进一步了解可用设置，参见这两个参数的描述。|
#|app_targeting_type {+条件必填}|string|仅当满足以下所有条件时必填且生效：<br><br><ul><li>在推广系列层级：</li><li>`objective_type` 为 `WEB_CONVERSIONS`</li><li>`sales_destination` 为 `APP`。</li><li>`optimization_goal` 为 `CLICK`、`IN_APP_EVENT` 或 `VALUE`。</li></ul><br>应用定向类型。<br><br>枚举值：<ul><li>`PROSPECT`：潜客开发。寻找潜在顾客，包括尚未与你的商品互动过的用户。</li><li>`RETARGETING`：再营销。向在 TikTok 内外与你的企业互动过的用户展示广告。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<br><br><ul><li>当推广系列层级的 `campaign_type` 为 `IOS14_CAMPAIGN` 时，只能将此字段设置为 `PROSPECT`。</li><li>此字段设置后不可更新。</li></ul>|
#|location_ids {+条件必填}|string[]|<ul><li>当推广系列层级的 `catalog_type` 为 `TRAVEL_ENTERTAINMENT` 时，你需要单独或同时设置 `location_ids` 或 `zipcode_ids`。</li><li>如果你创建了其他类型的升级版 Smart+ 推广系列，那么 `location_ids` 为必填项。</li></ul><br>你希望定向的地域的 ID。<br><br>若想根据你的广告位和推广目标获取可用地域及其对应 ID，需使用 [/tool/targeting/search/](1761236883355649.html) 或 [/tool/region/](1737189539571713.html) 接口。<br>如需获取地域 ID 列表，参见[地域 ID](1739311040498689.html)。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：如果你将美国添加为定向地域，那么在创建推广系列后，将无法移除美国。</p>|
#|zipcode_ids {+条件必填}|string[]|<ul><li> 当推广系列层级的 `catalog_type` 为 `TRAVEL_ENTERTAINMENT` 时，你需要单独或同时设置 `location_ids` 或 `zipcode_ids`。</li><li>如果你创建了其他类型的升级版 Smart+ 推广系列，那么不支持 `zipcode_ids`。</li></ul><br>你希望用于定向地域的邮政编码 ID。<br><br>最大数量：3,000。如果你同时提供了 `location_ids` 和 `zipcode_ids`，每个广告组的地域 ID 和邮政编码 ID 的数量总和不得超过 3,000。<br><br>你可以通过从 [/tool/targeting/search/](1761236883355649.html) 接口返回的 `geo_id`（当 `geo_type` = `ZIP_CODE`），根据你的广告位、推广目标和关键词获取可用的邮政编码 ID。<br><br><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>不支持重叠的定向地域。例如，你无法同时定向美国和加利福尼亚州。</li><li>如果你在创建广告组时通过 `location_ids` 或 `zipcode_ids` 定向了美国地域，后续可以将这些 ID 更新为美国境内的其他地域，但不能移除所有美国地域以仅定向美国以外的国家/地区。</li><li>若想获取关于邮政编码 ID 的信息，只能使用 [/tool/targeting/info/](1761237001980929.html) 接口。</li></ul></p>|
#|languages|string[]|你希望定向的语言的代码。<br><br>支持的语言代码列表参见[枚举值 - 语言代码](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Language%20Code)。|
#|operating_systems|string[]|你希望定向的设备操作系统。<br><br>枚举值：`ANDROID`、`IOS`。<br><br>仅允许一个值。<br><br><ul><li>当 `promotion_type` 为 `APP_ANDROID` 时，此字段将被忽略并默认设置为 `["ANDROID"]`。</li><li>当 `promotion_type` 为 `APP_IOS` 时，此字段将被忽略并默认设置为 `["IOS"]`。</li></ul> |
#|spc_audience_age|string|广告组定向的年龄组。<br><br>枚举值：<ul><li>`ALL`：所有年龄组。</li><li>`OVER_EIGHTEEN`：18 岁以上。</li><li>`OVER_TWENTY_FIVE`：25 岁以上。</li></ul><br>默认值：`OVER_EIGHTEEN`。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>定向所有年龄组 (`ALL`) 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>仅当推广系列层级的 `smart_plus_adgroup_mode` 为 `MULTIPLE` 时，才能使用 `ALL`。若想查看推广系列的 `smart_plus_adgroup_mode`，需使用 [/smart_plus/campaign/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-campaigns/v1.3) 接口。</li></ul></p>|
#|excluded_audience_ids|string[]|要排除的受众 ID 列表。<br><br>若想获取受众 ID 列表，需使用 [/dmp/custom_audience/list/](1739940506015746.html) 接口。<br><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级传入 `rta_id` 时，不支持此字段。|
#|age_groups|string[]|你希望定向的年龄组。<br><br>枚举值：<ul><li>`AGE_13_17`：13-17 岁。</li><li>`AGE_18_24`：18-24 岁。</li><li>`AGE_25_34`：25-34 岁。</li><li>`AGE_35_44`：35-44 岁。</li><li>`AGE_45_54`：45-54 岁。</li><li>`AGE_55_100`：55 岁以上</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：仅在以下情况下，才能使用 `AGE_13_17`：<ul><li>推广系列层级的 `objective_type` 为 `APP_PROMOTION` 且 `app_promotion_type` 为 `APP_INSTALL` 或 `APP_RETARGETING`。</li></ul></p>|
#|gender|string|你希望定向的性别。<br><br>枚举值：`GENDER_FEMALE`、`GENDER_MALE`、`GENDER_UNLIMITED`。|
#|audience_ids|string[]|受众 ID 列表。<br><br>若想获取受众 ID，需使用 [/dmp/custom_audience/list/](1739940506015746.html) 接口。<br><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级传入 `rta_id` 时，不支持此字段。|
#|shopping_ads_retargeting_type|string|仅当满足以下所有条件时生效：<ul><li>在推广系列层级：<ul><li>`objective_type` 为 `WEB_CONVERSION`</li><li>`sales_destination` 为 `WEB_AND_APP`、`WEBSITE` 或 `APP`</li><li>`catalog_type` 为 `ECOMMERCE`</li></ul></li><li>在广告组层级：`targeting_optimization_mode` 为 `MANUAL`。</li></ul><br>再营销类型。<br><br>枚举值：<ul><li>`LAB1`：对已浏览商品或将商品加入购物车但未购买的受众进行再营销。</li><li>`LAB2`：对已将商品加入购物车但未购买的受众进行再营销。</li><li>`LAB3`：使用自定义组合对受众进行再营销。</li><li>`OFF`：不进行再营销。</li></ul><br>默认值：`OFF`。|
#|shopping_ads_retargeting_actions_days {+条件必填}|number|当 `shopping_ads_retargeting_type` 为 `LAB1` 或 `LAB2` 时，此为必填字段。<br><br>所传入受众操作的合法时间范围。系统将对在此时间范围内完成所传入操作的受众进行再营销。<br><br>值范围：1、2、3、7、14、30、60、90、180。|
#|included_custom_actions{+条件必填}|object[]|当 `shopping_ads_retargeting_type` 为 `LAB3` 时，需传入 `included_custom_actions` 或 `excluded_custom_actions`。<br><br>需包含的商品库受众的详细信息。<br>商品库受众基于用户与特定商品的互动，其效果通常优于自定义受众。|
##|code|string|用于筛选再营销受众的自定义操作。<br><br>枚举值：<ul><li>`VIEW_PRODUCT`：受众浏览了商品。</li><li>`ADD_TO_CART`：受众将商品加入了购物车。</li><li>`PURCHASE`：受众购买了商品。</li></ul>|
##|days|integer|用于筛选已完成所传入操作的受众的时间范围。<br><br>值范围：1-180。|
#|excluded_custom_actions{+条件必填}|object[]|当 `shopping_ads_retargeting_type` 为 `LAB3` 时，需传入 `included_custom_actions` 或 `excluded_custom_actions`。<br><br>需排除的商品库受众的详细信息。<br>通过排除用户已与之互动的商品来提升广告效果，确保用户只看到你的品牌的相关广告。|
##|code|string|用于排除受众的自定义操作。<br><br>枚举值：<ul><li>`VIEW_PRODUCT`：受众浏览了商品。</li><li>`ADD_TO_CART`：受众将商品加入了购物车。</li><li>`PURCHASE`：受众购买了商品。</li></ul>|
##|days|integer|用于排除已完成所传入操作的受众的时间范围。<br><br>值范围：1-180。|
#|shopping_ads_retargeting_custom_audience_relation|string|仅当同时满足以下两个条件时生效：<ul><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><font color="darkred"><b>注意</b></font>：此字段设置后不可更新为空值。|
#|included_pangle_audience_package_ids|string[]|仅对 Pangle 广告位有效。不要同时指定此字段和 `excluded_pangle_audience_package_ids`。<br><br>你希望包含的 Pangle 受众 ID。<br><br>你可以使用 [/pangle_audience_package/get/](1740040177229826.html) 接口获取受众 ID (`package_id`)。流量包的 `bind_type` 应为 `INCLUDE`。<br><br>你希望包含的 Pangle 受众 ID。|
#|excluded_pangle_audience_package_ids|string[]|仅对 Pangle 广告位有效。不要同时指定此字段和 `included_pangle_audience_package_ids`。<br><br>你希望排除的 Pangle 受众 ID。<br><br>你可以使用 [/pangle_audience_package/get/](1740040177229826.html) 接口获取受众 ID (`package_id`)。流量包的 `bind_type` 应为 `EXCLUDE`。|
#|interest_category_ids|string[]|你希望用来定向受众的大众兴趣关键词 ID。<br><br><ul><li>若想搜索或列出大众兴趣类别 ID，需使用 [/targeting/search/](1796638342793218.html) 接口（推荐）或 [/tool/interest_category/](1737174348712961.html) 接口。</li><li>若想根据你的行业获取推荐的兴趣类别 ID，需使用 [/tool/targeting_category/recommend/](1736275204260866.html) 接口。</li></ul> |
#|interest_keyword_ids|string[]|你希望用来定向受众的其他兴趣类别 ID。<br><br>若想搜索其他兴趣类别，需使用 [/targeting/search/](1796638342793218.html) 接口（推荐）或 [/tool/interest_keyword/recommend/](1763590884474882.html) 接口。|
#|purchase_intention_keyword_ids|string[]|在受众对特定内容类别的相关购买感兴趣时，用于对其进行定向的购买意向类别 ID。<br><br>若想搜索或列出购买意向类别 ID，需使用 [/targeting/search/](1796638342793218.html) 接口。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：广告位设置应包含 TikTok (`PLACEMENT_TIKTOK`) 或 Pangle (`PLACEMENT_PANGLE`)。</p>|
#|actions|object[]|用于广告定向的行为类别对象列表。|
##|action_scene|string|你希望定向的用户行为类别。<br><br>枚举值：<ul><li>`VIDEO_RELATED`：视频互动。</li><li>`CREATOR_RELATED`：创作者互动。</li><li>`HASHTAG_RELATED`：话题互动。</li></ul>|
##|action_period|number|将统计用户行为的时间段。<br><br>枚举值：`0`、`7`、`15`。<br><br>如果 `action_scene` 为 `CREATOR_RELATED` 或 `HASHTAG_RELATED`，无论你传入什么值，系统都会使用 `0`。`0` 表示未设定具体的时间范围来筛选用户行为。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：目前，通过 <b>TikTok 广告管理平台</b>创建进行视频互动定向的广告组 (`action_scene` = `VIDEO_RELATED`) 时，无法选择时间段 (`action_period`)，系统会默认使用 15 天 (`15`)。但如果通过 <b>API</b> 创建广告组，仍可传入 `0`、`7` 或 `15`。</p>|
##|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>：目前，通过 <b>TikTok 广告管理平台 (TTAM)</b> 创建广告组时，无法传入用户行为类别 (`video_user_actions`)。默认情况下，通过 <b>TTAM</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> 创建广告组，你仍可以传入想要的枚举值组合，例如：`["LIKED","COMMENTED"]`（如果 `action_scene` = `VIDEO_RELATED`）。</p>|
##|action_category_ids|string[]|仅当 TikTok 广告位是唯一选定的广告位时有效。<br><br>你希望用来定向受众的视频互动类别 ID、创作者互动类别 ID、话题 ID 或话题汇总 ID。<br><br><ul><li>若想搜索或列出视频互动类别 ID 或创作者互动类别 ID，需使用 [/targeting/search/](1796638342793218.html) 接口（推荐）或 [/tool/action_category/](1737166752522241.html) 接口。</li><li>若想获取话题 ID 或话题汇总 ID，需使用 [/targeting/search/](1796638342793218.html) 接口（推荐）或 [/tool/hashtag/recommend/](1736271339521025.html) 接口。</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)以及[为广告组启用智能定向](1783164826830849.html)。|
#|smart_audience_enabled|boolean|是否启用智能受众。<br><br>支持的值：`true`、`false`。<br><br>如需详细了解智能受众以及如何启用智能受众，参见[智能定向](1783164662979586.html)以及[为广告组启用智能定向](1783164826830849.html)。|
#|spending_power|string|你希望定向的消费能力。<br><br>枚举值：`ALL`、`HIGH`。<br><br>如果该值设置为 `HIGH`，你可以定向高消费用户，这些用户在 TikTok 广告引导下的购买支出通常高于平均水平。|
#|household_income|string[]|你希望定向的家庭收入。<br><br>枚举值：`TOP5`（邮政编码地区的前 5%）、`TOP10`（邮政编码地区的前 10%）、`TOP10_25`（邮政编码地区的前 10% - 25%）、`TOP25_50`（邮政编码地区的前 25% - 50%）。|
#|min_android_version|string|最低 Android 版本。<br><br>枚举值参见[枚举值 - 最低 Android 版本](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Minimum%20Android%20Version)。|
#|min_ios_version|string|受众最低 iOS 版本。<br><br>枚举值参见[枚举值 - 最低 iOS 版本](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Minimum%20iOS%20Version)。|
#|device_model_ids|string[]|设备型号 ID 列表。<br><br>若想获取完整设备型号 ID 列表及其状态，需使用 [/tool/device_model/](1737172880570369.html) 接口。仅活跃设备（[/tool/device_model/](1737172880570369.html) 接口的返回结果中 `is_active` = `true`）可用于创建广告组。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：不能同时设置设备型号 (`device_model_ids`) 和设备价格 (`device_price_ranges`)。</p>|
#|network_types|string[]|你希望定向的网络类型。<br><br>枚举值参见[枚举值 - 网络类型](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Connection%20Type)。|
#|carrier_ids|string[]|你希望定向的运营商。<br><br>运营商必须与你希望定向的地域保持一致。<br><br>若想获取枚举值，需使用 [/tool/carrier/](1737168013095938.html) 接口。仅当运营商的 `in_use` 字段为 `true` 时，运营商才生效。|
#|isp_ids|string[]|仅当你通过 `location_ids` 同时指定国家或地区层级的有效地域 ID 时才有效。<br><br>你希望定向的互联网服务提供商 (ISP) 的 ID。<br><br>你可以使用 [/tool/targeting/list/](1762962378261506.html) 接口来获取可针对地域 ID 定向的 ISP ID。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：传入 `isp_ids` 时，无法将广告位仅设置为全球化应用组合 (`placements` = `PLACEMENT_GLOBAL_APP_BUNDLE`)。</p>|
#|device_price_ranges|number[]|定向设备价格范围。<br><br>10,000 表示 1,000 以上。数字必须为 50 的倍数。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：系统会在你设置的上限基础上再加 50，并将所得的新数值用作设备定向的实际上限。实际上限会在 TikTok 广告管理平台的广告组设置中显示。如果你设置的价格范围为 [0, 250]，系统实际上会按 [0, 300] 处理。</p>|
#|saved_audience_id|string|同时满足以下两个条件时有效：<ul><li>在推广系列中未指定住房、就业或信贷的类别 (`specical_industries`)。</li><li>在广告组中选择了 TikTok 广告位（即 `placement_type` 设置为 `PLACEMENT_TYPE_AUTOMATIC`，<b>或</b> `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 中包含 `PLACEMENT_TIKTOK`）。</li></ul><br>已保存受众 ID。<br><br>若想获取广告账号中已保存受众的列表，需使用 [/dmp/saved_audience/list/](1780154619404290.html) 接口。<br><br>在使用此字段之前，调用 [/dmp/saved_audience/create/](1780154541898754.html) 接口创建已保存受众，并从返回结果中获取已保存受众的 ID。已保存受众的关联广告主 ID 应与广告组中的广告主 ID 相同，否则系统将报错。<br><br>如果使用 `saved_audience_id` 来创建广告组，返回结果将包含已保存受众的 ID 及其中的定向选项。<br><br>如需详细了解工作流程和代码示例，参见[创建已保存受众](1780156510696449.html)。<br><br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>在通过 [/dmp/saved_audience/create/](1780154541898754.html) 接口创建已保存受众时，你可以传入包括 `gender` 在内的不同定向选项。但是，请注意，如果你是基于已保存受众来创建广告组，必须避免同时设置 `saved_audience_id` 和已保存受众中定义的定向选项（如 `gender`）。</li><li>如果已保存受众中的定向设置与广告组中的定向设置相冲突，将以已保存受众中的设置为准。因此，广告组中有冲突的定向选项将被忽略。<ul><li>例如，如果你创建了已保存受众，其 `gender` 设置为 `GENDER_FEMALE`，然后使用该受众来创建广告组，并将 `gender` 指定为 `GENDER_MALE`，那么所创建的广告组将在性别定向配置中采用已保存受众中设置的值 `GENDER_FEMALE`。</li></ul></li><li>如果创建 `saved_audience_id` 时传入了 `age_groups`，[TikTok 广告的新增年龄定向限制](1788755983247362.html)中列出的针对不同推广目标的年龄限制规则同样适用。在广告组中使用已保存受众 (`saved_audience_id`) 之前，请先确认允许使用年龄定向设置。</li></ul></p>|
#|blocked_pangle_app_ids|string[]|Pangle 应用屏蔽 ID 列表。<br><br>你可以通过[获取 Pangle 屏蔽列表](1740039957181441.html)接口返回的 `app_package_id` 字段获取 ID。仅当选择 Pangle 广告位时有效。|
|budget_mode|string|<ul><li> 在推广系列层级禁用推广系列预算优化 (CBO)（`budget_optimize_on` 为 `false`）时，此为必填字段。</li><li>在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时忽略。</li></ul><br>广告组预算模式。<br><br>枚举值：<ul><li>`BUDGET_MODE_TOTAL`：总预算。</li><li>`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`：动态日预算。即一周内的平均日预算。日消耗不会超过平均日预算的 125%。周消耗不会超过平均日预算的 7 倍。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>此设置（如传入）必须在同一推广系列内的所有广告组中保持一致。</li><li>如果此字段设置为 `BUDGET_MODE_TOTAL`，那么 `schedule_type` 必须是 `SCHEDULE_START_END`，并需要设置结束日期 (`schedule_end_time`)。</li><li>当推广系列层级的 `budget_optimize_on` 为 `false` 且 `budget_mode` 为 `BUDGET_MODE_DAY` 时，只能将此字段设置为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`。</li></ul> |
|budget_auto_adjust_strategy |string|仅当满足以下所有条件时生效： <ul><li>在推广系列层级：`budget_optimize_on` 为 `false`。</li> <li>在广告组层级： <ul><li>当 `objective_type` 为 `APP_PROMOTION` 时： <ul><li>`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`。</li><li>`optimization_goal` 为 `VALUE`。</li><li>`deep_bid_type` 为 `VO_MIN_ROAS`。</li><li>`vbo_window` 为 `ZERO_DAY`。</li></ul></li> <li>当 `objective_type` 为 `LEAD_GENERATION` 时：<ul><li>`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`。</li><li>`bid_type` 为 `BID_TYPE_CUSTOM`。</li></ul> </li></ul></li></ul><br>自定义广告组预算的广告组预算策略。<br><br>枚举值： <ul><li>`AUTO_BUDGET_INCREASE`：启用基于目标增加预算功能。允许系统在广告效果出色且满足目标 CPA、第 0 天目标 ROAS 和预算要求时自动增加预算。 <ul><li>当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，传入的 `budget` 将作为初始日预算。如果你的预算利用率至少达到 90%，日预算将自动增加 20%，每天最多可增加 10 次。你的日预算将在每天重置为原来的日预算。</li></ul></li><li>`UNSET`：禁用基于目标增加预算功能。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：基于目标增加预算目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。|
|budget|float|<ul><li>在推广系列层级禁用推广系列预算优化 (CBO)（`budget_optimize_on` 为 `false`）时，此为必填字段。</li><li>在推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时忽略。</li></ul><br>固定广告组预算或初始广告组预算。<ul><li>当 `budget_auto_adjust_strategy` 为 `UNSET` 时，此字段表示固定广告组预算。</li><li>当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，此字段表示初始广告组预算。若想获取当前的广告组预算，需查看返回的 `current_budget`。</li></ul><br>如需了解如何配置预算设置，参见[预算](1739381246298114.html)。如需直接查看某个币种的日预算取值范围，参见[币种 - 每日预算取值范围](https://business-api.tiktok.com/portal/docs?id=1737585839634433#item-link-Daily%20budget%20value%20range)。|
|min_budget|float|仅当满足以下所有条件时生效：<ul><li>在推广系列层级：<ul><li>`budget_optimize_on` 为 `true`</li><li>`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`</li></ul></li><li>在广告组层级：<ul><li>`bid_type` 为 `BID_TYPE_NO_BID`</li></ul></li></ul><br>广告组最低预算。<br><br>系统会尽量确保消耗至少达到该金额，但不作保证。|
|schedule_type {必填}|string|排期类型。<br><br>枚举值：<ul><li>`SCHEDULE_FROM_NOW`：从排定的开始时间起持续投放广告组。<ul><li>在以下任一场景中，你只能将 `schedule_type` 设置为 `SCHEDULE_FROM_NOW`。<ul><li>在推广系列层级，`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` </li><li>在广告组层级，`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`</li></ul></li></ul></li><li>`SCHEDULE_START_END`：在排定的开始时间和结束时间之间投放广告组。</li></ul>|
|schedule_start_time {必填}|string|排期开始时间 ，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。<br><br>开始时间最多可比当前时间早 12 小时，但不得晚于 `2028-01-01 00:00:00`。|
|schedule_end_time {+条件必填}|string|当 `schedule_type` 为 `SCHEDULE_START_END` 时，此为必填字段。<br><br>排期结束时间，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。<br><br>结束时间不得晚于 `2038-01-01 00:00:00`。|
|movie_premiere_date|string|同时满足以下两个条件时有效：<ul><li>推广系列层级的 `is_promotional_campaign` 为 `true`。</li><li>你已加入白名单，可使用“大型娱乐推广”推广系列设置来推广院线上映。</li></ul><br>院线上映日期，格式为 `YYYY-MM-DD` (UTC+0)。<br><br>提供电影上映日期，供系统将该时间纳入效果优化中。|
|dayparting|string|广告投放安排，格式为由 48 x 7 个字符组成的字符串。<br>每个字符都对应星期一到星期日的一个 30 分钟的时间范围。每个字符可设为 0 或 1。1 表示在该 30 分钟时段投放，0 表示不投放。第一个字符对应星期一 0:01–0:30；第二个字符对应星期一 0:31–1:00；最后一个字符对应星期日 23:31–次日 0:00。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：当该值全为 1 或不传入该字段时，均视为全时投放。</p>|
|is_hfss|boolean|仅当 `targeting_optimization_mode` 为 `MANUAL` 时生效。<br><br>是否推广 HFSS（高脂、高盐、高糖）产品/品牌内容。<br><br>如果你的广告宣传或重点展示的商品/品牌为高脂、高盐和高糖食品，将此字段设置为 `true`。<br><br>在受监管地区，HFSS 广告必须仅针对 18 岁以上用户定向投放。<br><br>如果你的定向地域包含英国、澳大利亚、新西兰和欧盟地区，可将此字段设置为 `true`。<br><br>支持的值：`true`、`false`。<br><br>默认值：`false`。|
|is_lhf_compliance {+条件必填}|boolean|如果定向地域包含英国地区，且 `is_hfss` 为 `true`，此为必填字段，并且必须设置为 `true`。<br><br>推广内容是否符合 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`。|
|placement_type|string|决定你的广告将在哪里展示的广告位策略。<br><br>枚举值：<ul><li>`PLACEMENT_TYPE_AUTOMATIC`：自动广告位。TikTok 的广告系统将使用智能计算，为你提供覆盖所有应用的广告位最佳组合。</li><li>`PLACEMENT_TYPE_NORMAL`：选择广告位。通过手动选择广告位，你将能够选择投放广告的应用。</li></ul><br>默认情况下，系统会根据你的其他设置为你的升级版 Smart+ 推广系列自动配置广告位，并会从不同广告位选择优质流量来获得更理想的投放效果。<br><br>但是，如果仅支持选择广告位，省略广告位参数（`placement_type` 和 `placements`）可能会触发广告位错误。在这种情况下，需要手动将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 并传入 `placements`。<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`，此字段会被忽略，并由 TikTok 广告系统为你的广告选择的广告位组合所覆盖。</li></ul><br>你希望投放广告的应用。<br><br>枚举值：<ul><li>`PLACEMENT_TIKTOK`：TikTok。</li><li>`PLACEMENT_PANGLE`：Pangle。</li><li>`PLACEMENT_GLOBAL_APP_BUNDLE`：全球化应用组合。</li></ul><br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>`placements` 在广告组创建后无法更新。</li><li>可以用全球化应用组合广告位 (`PLACEMENT_GLOBAL_APP_BUNDLE`) 定向的可用地域：巴西、印度尼西亚、越南、菲律宾、泰国、马来西亚、墨西哥、沙特阿拉伯和日本。</li><li>全球化应用组合广告位 (`PLACEMENT_GLOBAL_APP_BUNDLE`) 不支持将落地页浏览量作为优化目标 (`optimization_goal`=`TRAFFIC_LANDING_PAGE_VIEW`)。如需了解优化目标，参见[枚举值 - 优化目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Optimization%20Goal)小节。</li></ul> |
|tiktok_subplacements|string[]|仅当满足以下条件时生效：<ul><li>在推广系列层级：`objective_type` 为 `APP_PROMOTION`、`LEAD_GENERATION` 或 `WEB_CONVERSIONS`。</li><li>在广告组层级：`placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`。</li></ul><br>TikTok 子广告位，可供你选择广告的展示位置。<br><br>枚举值：<ul><li>`LEMON8`：Lemon8，一款生活方式内容社区应用，内容包含真实生活体验分享、小贴士、指南和商品测评。如果选择 Lemon8 作为子广告位，广告将展示在其推荐页信息流、搜索信息流和沉浸式视频信息流中。[详细了解 Lemon8 效果竞价广告](https://ads.tiktok.com/help/article/about-lemon8-in-tiktok-ads-manager)。</li><li>`PINE_DRAMA`：PineDrama，一款观看短剧的应用。广告将被投放在推荐页面、剧集信息流等位置。[详细了解 PineDrama 效果竞价广告](https://ads.tiktok.com/help/article/about-pinedrama-for-performance-auction-in-tiktok-ads-manager)。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>在广告组中使用 Lemon8 子广告位 (`LEMON8`) 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>如果在推广系列层级传入 `rta_id`，不支持 Lemon8 子广告位 (`LEMON8`)。</li><li>若想在线索收集推广系列中使用 Lemon8 下级广告位 (`LEMON8`)（推广系列层级的 `objective_type` 为 `LEAD_GENERATION`），需确保广告组层级的 `promotion_type` 为 `LEAD_GENERATION`。</li><li>在广告组中使用 PineDrama 子广告位 (`PINE_DRAMA`) 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>使用 PineDrama 子广告位时，可定向的地区包括巴西、印度尼西亚、墨西哥、泰国、美国和越南。</li><li>此字段设置后不可更新。</li></ul>|
|comment_disabled|boolean|是否允许用户在 TikTok 上评论推广系列。<br><br>支持的值：`true`、`false`。<br><br>默认值：`false`。|
|share_disabled|boolean|是否禁止将推广系列分享到第三方平台。<br><br>支持的值：`true`、`false`。<br><br>默认值：`false`。|
|video_download_disabled|boolean|用户是否可以在 TikTok 上下载你的视频广告。<br><br>支持的值：`true`、`false`。<br><br>默认值：`false`。|
示例
不启用受众建议的自动定向
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/create/' \
--header 'Access-Token: "{{Access-Token}}" ' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"request_id": "{{request_id}}",
"adgroup_name": "{{adgroup_name}}",
"app_id": "{{app_id}}",
"promotion_type": "APP_ANDROID",
"optimization_goal": "INSTALL",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "OCPM",
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"targeting_optimization_mode": "AUTOMATIC",
"targeting_spec": {
"location_ids": [
"1562822"
],
"spc_audience_age": "OVER_EIGHTEEN",
"operating_systems": [
"ANDROID"
]
}
}'
(/code)
启用受众建议的自动定向
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/create/' \
--header 'Access-Token: "{{Access-Token}}"' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"request_id": "{{request_id}}",
"adgroup_name": "{{adgroup_name}}",
"app_id": "{{app_id}}",
"promotion_type": "APP_ANDROID",
"optimization_goal": "INSTALL",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "OCPM",
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"targeting_optimization_mode": "AUTOMATIC",
"suggestion_audience_enabled": true,
"targeting_spec": {
"location_ids": [
"1562822"
],
"spc_audience_age": "OVER_EIGHTEEN",
"operating_systems": [
"ANDROID"
],
"age_groups": [
"AGE_18_24",
"AGE_25_34",
"AGE_35_44",
"AGE_45_54",
"AGE_55_100"
],
"gender": "GENDER_UNLIMITED",
"audience_ids": [
"{{audience_id}}",
"{{audience_id}}",
"{{audience_id}}",
"{{audience_id}}"
],
"interest_category_ids": [
"17",
"10"
],
"purchase_intention_keyword_ids": [
"14",
"17"
],
"actions": [
{
"action_scene": "VIDEO_RELATED",
"action_period": 15,
"video_user_actions": [
"WATCHED_TO_END",
"LIKED",
"COMMENTED",
"SHARED"
],
"action_category_ids": [
"13",
"15"
]
},
{
"action_scene": "CREATOR_RELATED",
"action_period": 0,
"video_user_actions": [
"FOLLOWING",
"VIEW_HOMEPAGE"
],
"action_category_ids": [
"8",
"10"
]
},
{
"action_scene": "HASHTAG_RELATED",
"action_period": 0,
"video_user_actions": [
"VIEW_HASHTAG"
],
"action_category_ids": [
"8",
"5"
]
}
]
}
}'
(/code)
自定义定向
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/create/' \
--header 'Access-Token: "{{Access-Token}}"' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"request_id": "{{request_id}}",
"adgroup_name": "{{adgroup_name}}",
"app_id": "{{app_id}}",
"promotion_type": "APP_ANDROID",
"optimization_goal": "INSTALL",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "OCPM",
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"targeting_optimization_mode": "MANUAL",
"targeting_spec": {
"location_ids": [
"1562822"
],
"age_groups": [
"AGE_18_24",
"AGE_25_34",
"AGE_35_44",
"AGE_45_54",
"AGE_55_100"
],
"gender": "GENDER_UNLIMITED",
"audience_ids": [
"{{audience_id}}",
"{{audience_id}}",
"{{audience_id}}",
"{{audience_id}}"
],
"interest_category_ids": [
"17",
"10"
],
"purchase_intention_keyword_ids": [
"14",
"17"
],
"actions": [
{
"action_scene": "VIDEO_RELATED",
"action_period": 15,
"video_user_actions": [
"WATCHED_TO_END",
"LIKED",
"COMMENTED",
"SHARED"
],
"action_category_ids": [
"13",
"15"
]
},
{
"action_scene": "CREATOR_RELATED",
"action_period": 0,
"video_user_actions": [
"FOLLOWING",
"VIEW_HOMEPAGE"
],
"action_category_ids": [
"8",
"10"
]
},
{
"action_scene": "HASHTAG_RELATED",
"action_period": 0,
"video_user_actions": [
"VIEW_HASHTAG"
],
"action_category_ids": [
"8",
"5"
]
}
],
"smart_interest_behavior_enabled": false,
"smart_audience_enabled": true,
"spending_power": "HIGH",
"operating_systems": [
"ANDROID"
]
}
}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string| 请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|advertiser_id|string|广告主 ID。|
#|campaign_id|string|推广系列 ID。|
#|campaign_name|string|广告组所属的推广系列的名称。|
#|adgroup_id|string|广告组 ID。|
#|adgroup_name|string|广告组名称。|
#|catalog_id|string|当推广系列层级的 `catalog_enabled` 为 `true` 时返回。<br><br>用于广告组的商品库的 ID。|
#|catalog_authorized_bc_id|string|当推广系列层级的 `catalog_enabled` 为 `true` 时返回。<br><br>商品库 (`catalog_id`) 所属的商务中心的 ID。|
#|promotion_type|string|推广类型（优化位置）。你可以使用此字段来选择商品的投放位置。<br><br>目前，我们支持 `APP_ANDROID`、`APP_IOS`、`WEBSITE`、`MINI_GAME`、`NATIVE_SERIES` 和 `LEAD_GENERATION`。<ul><li>当 `objective_type` 为 `APP_PROMOTION` 且 `app_promotion_type` 为 `APP_INSTAL` 时，此字段将为 `APP_ANDROID` 或 `APP_IOS`。</li><li>当 `objective_type` 为 `APP_PROMOTION` 且 `app_promotion_type` 为 `MINIS` 时，此字段将为 `MINI_APP`、`MINI_GAME` 或 `NATIVE_SERIES`。</li><li>当 `objective_type` 为 `WEB_CONVERSIONS` 时：<ul><li>如果 `sales_destination` 为 `WEBSITE`，此字段将为 `WEBSITE`。</li><li>如果 `sales_destination` 为 `APP`，此字段将为 `APP_ANDROID` 或 `APP_IOS`。</li></ul></li><li>当 `objective_type` 为 `LEAD_GENERATION` 时，此字段将为以下任意值：<ul><li>`LEAD_GENERATION`</li><li>`LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`</li><li>`LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE`</li><li>`LEAD_GEN_CLICK_TO_CALL`</li></ul></li></ul>|
#|app_id |string|待推广应用的 ID。<br><br>若想获取应用 ID 列表，需使用 [/app/list/](1740859313270786.html) 接口。|
#| gaming_ad_compliance_agreement|string|仅在以下任意场景中返回：<ul><li>场景 1：当在推广系列层级同时满足以下两个条件时：<ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_RETARGETING`。</li></ul></li><li>场景 2：当在推广系列层级同时满足以下所有条件时：<ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_INSTALL`。</li><li>`campaign_type` 为 `REGULAR_CAMPAIGN`。</li></ul></li></ul><br>是否同意 TikTok 游戏广告主合规保证政策。<br><br>政策如下：你确认并证明，你希望在 TikTok 上推广的任何游戏应用、产品或服务（游戏），包括任何相关的 URL，均 (a) 符合可访问或玩该游戏的司法管辖区的所有适用法律和法规，并且可以根据要求提供支持文件来证明该游戏不属于非法赌博或博彩；以及 (b) 过去和现在均未经受任何关于该游戏的合法性或合规性的调查或诉讼。<br><br>枚举值：<ul><li>`ON`：同意该政策。</li><li>`OFF`：不接受该政策。</li></ul>|
#|promotion_website_type|string|TikTok 即时体验页面类型。<br><br>目前，我们仅支持 `TIKTOK_NATIVE_PAGE`（使用 TikTok 即时体验页面）。|
#|promotion_target_type|string|线索收集推广目标的优化位置。<br><br>枚举值：<ul><li>`INSTANT_PAGE`：即时表单。创建可快速加载的应用内 TikTok 即时表单来收集更多线索。</li><li>`EXTERNAL_WEBSITE`：网站表单。使用包含网站表单的落地页，或使用 TikTok 即时体验页面（可跳转到包含网站表单的网站），收集更多线索。</li></ul>|
#|optimization_goal|string|你希望通过广告实现的可度量成效。<br><br>枚举值参见[枚举值 - 优化目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Optimization%20Goal)。|
#|pixel_id|string|Pixel ID。|
#| app_config | object[] | 当 `sales_destination` 为 `WEB_AND_APP` 时返回。<br><br>待推广的一个或多个应用的详细信息。 |
##| app_id | string | 待推广应用的 ID。 |
#| minis_id|string|当 `promotion_type` 为 `MINI_APP` 或 `MINI_GAME` 时返回。<br><br>TikTok Mini 的 ID。|
#|optimization_event|string|广告组的转化事件。<br><br>更多信息参见[转化事件](1739361474981889.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：如果在创建广告组时将 `optimization_event` 设置为 `IMPRESSION_LEVEL_AD_REVENUE` 或 `AD_REVENUE_VALUE`（请注意，这两个枚举值相同且效果完全一致）以启用价值优化，返回的 `optimization_event` 将始终为 `IMPRESSION_LEVEL_AD_REVENUE`。|
#|custom_conversion_id|string|用于广告组的自定义转化的 ID。|
#|deep_funnel_optimization_status|string|通过深层漏斗优化，你可以在主要优化事件之外再选择一个次要事件，这有助于提升推广系列的效果。 <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。<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`。|
#|app_attribution_source|string|你的应用的归因来源。<br><br>你选择的归因来源将用于优化、出价和报告。<br><br>枚举值：<ul><li>`MMP`: MMP 归因。来自所选 MMP 的信号将用于归因。</li><li>`SAN`: SAN 归因。来自 TikTok 自归因网络的信号将用于归因。</li></ul>|
#|app_data_source|string|你的应用的数据源。<br><br>你选择的归因信号将用于报告。<br><br>枚举值：<ul><li>`MMP`: MMP 信号。来自你的 MMP 的信号将用于报告。</li><li>`EVENT_SDK`: 应用事件 SDK 信号。来自 TikTok 应用事件 SDK 的信号将用于报告。</li><li>`EVENT_API`: 事件 API 信号。来自 TikTok 事件 API 的信号将用于报告。</li></ul>|
#| identity_id|string|仅在以下任意场景中返回： <ul><li>场景 1：当 `promotion_type` 为 `NATIVE_SERIES` 时。</li><li>场景 2：当 `promotion_type` 为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`，并且你的广告账号已加入白名单，可以在 TikTok 私信广告的广告组层级选择 TikTok 账号。</li></ul><br>广告发布身份 ID。 |
#| identity_type |string|仅在以下任意场景中返回： <ul><li>场景 1：当 `promotion_type` 为 `NATIVE_SERIES` 时。</li><li>场景 2：当 `promotion_type` 为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`，并且你的广告账号已加入白名单，可以在 TikTok 私信广告的广告组层级选择 TikTok 账号。</li></ul><br>广告发布身份类型。<br><br>枚举值： <ul><li>`TT_USER`：TikTok 企业号用户。</li><li>`BC_AUTH_TT`：商务中心有权访问的 TikTok 账号。</li></ul><br>详细信息参见[认证身份](1738958351620097.html)。|
#| identity_authorized_bc_id|string|当 `identity_type` 为 `BC_AUTH_TT` 时返回。<br><br>与“添加到商务中心的 TikTok 用户”类型广告发布身份关联的商务中心 ID。|
#|native_series_id | string | TikTok 剧集 ID。<br>剧集提供由创作者制作的独家优质视频合集。用户可通过创作者主页或 TikTok 视频所附链接购买并观看剧集。 |
#| 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><br>如需详细了解如何创建升级版 Smart+ TikTok 即时通讯广告，参见[创建以即时通讯应用作为优化位置的升级版 Smart+ 线索收集推广系列](1847302988449921.html)。|
#| zalo_id_type |string|Zalo 联系人格式的类型。<br><br>枚举值：<ul><li>`ZALO_OFFICIAL_ACCOUNT`：Zalo 官方账号 ID。 </li><li>`ZALO_PHONE_ACCOUNT`：Zalo 电话号码。 </li></ul>|
#| messaging_app_account_id |string|即时通讯应用账号的 ID。<ul><li>当 `messaging_app_type` 为 `MESSENGER` 时，此字段表示 Facebook 公共主页编号。</li><li>当 `messaging_app_type` 为 `LINE` 时，此字段表示 LINE 企业 ID。</li><li>当 `zalo_id_type` 为 `ZALO_OFFICIAL_ACCOUNT` 时，此字段表示 Zalo 官方账号 ID。</li><li>当 `messaging_app_type` 为 `WHATSAPP` 或 `zalo_id_type` 为 `ZALO_PHONE_ACCOUNT`时，此字段表示根据传入的 `phone_info` 自动填充的 WhatsApp 或 Zalo 电话号码。</li></ul>|
#| message_event_set_id|string|要在即时通讯广告组中使用的通讯事件组的 ID。<br><br>如果广告组设置中的即时通讯应用账号（无论是通过 `messaging_app_account_id` 传入的 Messenger 账号、Zalo 官方账号，还是与传入的 `phone_info` 匹配的 WhatsApp 或 Zalo 电话账号）与现有事件组匹配，此字段将<b>自动填充</b>与你选择的即时通讯应用账号关联的去重通讯事件组。|
#| phone_info|object|WhatsApp 或 Zalo 电话号码的详细信息。|
##| phone_region_code |string|WhatsApp 电话号码或 Zalo 电话号码的地区代码。<br><br>示例：`US`。|
##| phone_region_calling_code|string|WhatsApp 电话号码或 Zalo 电话号码的国际区号。<br><br>示例：`+1`。|
##| phone_number|string|WhatsApp 电话号码或 Zalo 电话号码。|
#|bid_type|string|出价策略。<br><br>枚举值及其描述参见[枚举值 - 出价策略](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Bidding%20Strategy)。|
#|bid_price|float|目标平均点击成本。系统会在保持平均成效成本接近或低于指定金额的同时，尽可能获得更多成效。|
#|conversion_bid_price|float|目标平均转化成本或落地页浏览平均成本。系统会在保持平均成效成本接近或低于指定金额的同时，尽可能获得更多成效。|
#|deep_bid_type|string|应用内事件的出价策略。<br><br>枚举值及其描述参见[枚举值 - 深层事件出价策略](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Deep%20Event%20Bidding%20Strategy)。|
#|roas_bid|float|价值优化的目标 ROAS。|
#| incentive_offer_type|string|适用于升级版 Smart+ 广告组的激励赠款类型。<br>如果你的广告组符合资格条件，并超过特定的 CPA 或最低 ROAS/目标 ROAS 阈值，你将获得激励性质的广告赠款，可供你在同一广告账号中使用。<br>如需详细了解获得激励赠款的资格条件以及激励金额的计算方法，参见 [Smart+ 平台激励赠款活动（成本上限/最低 ROAS/目标 ROAS）](https://ads.tiktok.com/help/article/incentive-offer)。<br><br>枚举值：<ul><li>`INELIGIBLE`：此广告组不符合获得任何激励赠款的条件。</li><li>`COST_CAP_AND_MIN_ROAS`：此广告组使用成本上限或最低 ROAS/目标 ROAS 出价策略，并有资格获得激励赠款。 </li></ul>|
#|vbo_window|string|传入的 [VBO IAA](1739381743067137.html)（应用内广告价值优化）或 [VBO IAP](1739381743067137.html)（应用内购买价值优化）的出价策略时间窗口。<br><br>枚举值：<ul><li>`SEVEN_DAYS`：前 7 天（第 7 天）。</li><li>`ZERO_DAY`：当天（第 0 天）。</li></ul>|
#|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><li>`THIRTY_DAYS`：30 天点击归因窗口期。</li><li>`THIRTY_TWO_DAYS`：32 天点击归因窗口期。</li><li>`ONE_HUNDRED_EIGHTY_DAYS`：180 天点击归因窗口期。</li></ul>|
#| engaged_view_attribution_window | string | 深度互动观看归因窗口期。此归因窗口期指用户观看你的视频广告至少 6 秒后，在多长时间范围内的转化会被计入。<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>|
#|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><br>枚举值：<ul><li>`UNSET`：未设置。</li><li>`EVERY`：每一次。将某人的多个事件分别统计成不同的转化次数。</li><li>`ONCE`：仅一次。将某人的多个事件计为 1 次转化。</li></ul>|
#|billing_event|string|计费事件。<br><br>枚举值参见[枚举值 - 计费事件](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Billing%20Event)。|
#|pacing|string|投放速度。你选择的广告投放速度决定了日预算的使用速度。<br><br>枚举值：<ul><li>`PACING_MODE_SMOOTH`：标准。根据市场需求和高峰时段价格，尽可能均匀地使用预算。此投放速度适合偏好稳定消耗的广告主。</li></ul>|
#|budget_mode|string|广告组预算模式。<br><br>枚举值：<ul><li>`BUDGET_MODE_TOTAL`：总预算。</li><li>`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`：动态日预算。即一周内的平均日预算。日消耗不会超过平均日预算的 125%。周消耗不会超过平均日预算的 7 倍。*</li></ul>|
#| budget_auto_adjust_strategy |string|当同时满足以下两个条件时返回：<ul><li>在推广系列层级：`budget_optimize_on` 为 `false`。</li><li>在广告组层级：`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`。</li></ul><br>自定义广告组预算的广告组预算策略。<br><br>枚举值： <ul><li>`AUTO_BUDGET_INCREASE`：启用基于目标增加预算功能。允许系统在广告效果出色且满足目标 CPA、第 0 天目标 ROAS 和预算要求时自动增加预算。 </li><li>当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，传入的 `budget` 将作为初始日预算。如果你的预算利用率至少达到 90%，日预算将自动增加 20%，每天最多可增加 10 次。你的日预算将在每天重置为原来的日预算。</li><li>`UNSET`：禁用基于目标增加预算功能。</li></ul>|
#|budget|float|固定广告组预算或初始广告组预算。<ul><li>当 `budget_auto_adjust_strategy` 为 `UNSET` 时，此字段表示固定广告组预算。</li><li>当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，此字段表示初始广告组预算。若想获取当前的推广系列预算，请查看返回的 `current_budget`。</li></ul>|
#| current_budget|float|仅当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时返回。<br><br>已启用基于目标增加预算功能的广告组的当前预算。|
#|min_budget|float|广告组最低预算。<br><br>系统会尽量确保消耗至少达到该金额，但不作保证。|
#|schedule_type|string|排期类型。<br><br>枚举值：<ul><li>`SCHEDULE_FROM_NOW`：从排定的开始时间起持续投放广告组。</li><li>`SCHEDULE_START_END`：在排定的开始时间和结束时间之间投放广告组。</li></ul>|
#|schedule_start_time|string|广告组投放开始时间 ，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。|
#|schedule_end_time|string|广告组投放结束时间 ，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。|
#| movie_premiere_date|string|院线上映日期，格式为 `YYYY-MM-DD` (UTC+0)。<br><br>提供电影上映日期，供系统将该时间纳入效果优化中。|
#|dayparting|string|广告投放安排，格式为由 48 x 7 个字符组成的字符串。每个字符都对应星期一到星期日的一个 30 分钟的时间范围。每个字符可设为 0 或 1。1 表示在该 30 分钟时段投放，0 表示不投放。第一个字符对应星期一 0:01–0:30；第二个字符对应星期一 0:31–1:00；最后一个字符对应星期日 23:31–次日 0:00。<br><br><p><span style="color:darkred"><b>注意</b></span>：当该值全为 0 或全为 1 时，均视为全时投放。</p>|
#|targeting_optimization_mode|string|受众定向优化模式。<ul><li>`MANUAL`：自定义定向。你可以利用自定义定向设置，精准控制广告的目标受众。这可能会限制广告投放并影响推广效果。</li><li>`AUTOMATIC`：自动定向。你可以使用自动定向来充分利用实时数据和机器学习，向最有可能与广告互动的受众定向投放广告</li></ul>|
#|suggestion_audience_enabled|boolean|是否启用受众建议。<br><br>受众建议通过指定额外的受众设置来指导自动定向。这些仅为建议，不能保证广告一定会投放给这些受众。<br><br>支持的值：`true`、`false`。|
#|targeting_spec|object|定向设置。|
##| app_targeting_type |string|仅当同时满足以下所有条件时返回：<ul><li>在推广系列层级：</li><li>`objective_type` 为 `WEB_CONVERSIONS`</li><li>`sales_destination` 为 `APP`。</li><li>`optimization_goal` 为 `CLICK`、`IN_APP_EVENT` 或 `VALUE`。</li></ul><br>应用定向类型。<br><br>枚举值：<ul><li>`PROSPECT`：潜客开发。寻找潜在顾客，包括尚未与你的商品互动过的用户。</li><li>`RETARGETING`：再营销。向在 TikTok 内外与你的企业互动过的用户展示广告。</li></ul>|
##|location_ids|string[]|你希望定向的地域的 ID。|
##|zipcode_ids|string[]|定向地域的邮政编码 ID。|
##|spc_audience_age|string|广告组定向的年龄组。<br><br>枚举值：<ul><li>`ALL`：所有年龄组。</li><li>`OVER_EIGHTEEN`：18 岁以上。</li><li>`OVER_TWENTY_FIVE`：25 岁以上。</li></ul>|
##|languages|string[]|你希望定向的语言的代码。<br><br>支持的语言代码列表参见[枚举值 - 语言代码](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Language%20Code)。|
##|operating_systems|string[]|你希望定向的设备操作系统。<br><br>枚举值：`ANDROID`、`IOS`|
##|excluded_audience_ids|string[]|要排除的受众 ID 列表。|
##|age_groups|string[]|你希望定向的年龄组。<br><br>枚举值参见[枚举值 - 受众年龄区间](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Age%20Group)。|
##|gender|string|你希望定向的性别。<br><br>枚举值：`GENDER_FEMALE`、`GENDER_MALE`、`GENDER_UNLIMITED`。|
##|audience_ids|string[]|受众 ID 列表。|
##|shopping_ads_retargeting_type|string|再营销类型。<br><br>枚举值：<ul><li>`LAB1`：对已浏览商品或将商品加入购物车但未购买的受众进行再营销。</li><li>`LAB2`：对已将商品加入购物车但未购买的受众进行再营销。</li><li>`LAB3`：使用自定义组合对受众进行再营销。</li><li>`OFF`：不进行再营销。</li></ul>|
##|shopping_ads_retargeting_actions_days|number|当 `shopping_ads_retargeting_type` 为 `LAB1` 或 `LAB2` 时返回。<br><br>所传入受众操作的合法时间范围。系统将对在此时间范围内完成所传入操作的受众进行再营销。|
##|included_custom_actions|object[]|需包含的商品库受众的详细信息。<br>商品库受众基于用户与特定商品的互动，其效果通常优于自定义受众。|
###|code|string|用于筛选再营销受众的自定义操作。<br><br>枚举值：<ul><li>`VIEW_PRODUCT`：受众浏览了商品。</li><li>`ADD_TO_CART`：受众将商品加入了购物车。</li><li>`PURCHASE`：受众购买了商品。</li></ul>|
###|days|integer|用于筛选已完成所传入操作的受众的时间范围。|
##|excluded_custom_actions|object[]|需排除的商品库受众的详细信息。<br>通过排除用户已与之互动的商品来提升广告效果，确保用户只看到你的品牌的相关广告。|
###|code|string|用于排除受众的自定义操作。<br><br>枚举值：<ul><li>`VIEW_PRODUCT`：受众浏览了商品。</li><li>`ADD_TO_CART`：受众将商品加入了购物车。</li><li>`PURCHASE`：受众购买了商品。</li></ul>|
###|days|integer|用于排除已完成所传入操作的受众的时间范围。|
##|shopping_ads_retargeting_custom_audience_relation|string|通过 `shopping_ads_retargeting_type` 传入的再营销受众与通过 `audience_ids` 传入的自定义受众之间的逻辑关系。<br><br>枚举值：<ul><li>`OR`：基于再营销受众和自定义受众的并集创建目标受众。广告组将针对商品库受众或自定义受众中的任意用户定向投放。</li><li>`AND`：基于再营销受众和自定义受众的交集创建目标受众。广告组将针对既属于再营销受众又属于自定义受众的用户定向投放。</li></ul>|
##|included_pangle_audience_package_ids|string[]|你希望包含的 Pangle 受众 ID。 |
##|excluded_pangle_audience_package_ids|string[]|你希望排除的 Pangle 受众 ID。 |
##|interest_category_ids|string[]|你希望用来定向受众的大众兴趣关键词 ID。|
##|interest_keyword_ids|string[]|你希望用来定向受众的其他兴趣类别 ID。<br><br>若想搜索其他兴趣类别，需使用 [/targeting/search/](1796638342793218.html) 接口（推荐）或 [/tool/interest_keyword/recommend/](1763590884474882.html) 接口。|
##|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|将统计用户行为的时间段。|
###|video_user_actions|string[]|在某个用户行为类型下，你希望定向的具体用户互动。<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`。<br><br>如需详细了解智能兴趣和行为以及如何启用智能兴趣和行为，参见[智能定向](1783164662979586.html)。|
##|smart_audience_enabled|boolean|是否启用智能受众。<br><br>支持的值：`true`、`false`。<br><br>如需详细了解智能受众以及如何启用智能受众，参见[智能定向](1783164662979586.html)。|
##|spending_power|string|你希望定向的消费能力。<br><br>枚举值：`ALL`、`HIGH`。<br><br>如果该值设置为 `HIGH`，你可以定向高消费用户，这些用户在 TikTok 广告引导下的购买支出通常高于平均水平。|
##|household_income|string[]|你希望定向的家庭收入。<br><br>枚举值：`TOP5`（邮政编码地区的前 5%）、`TOP10`（邮政编码地区的前 10%）、`TOP10_25`（邮政编码地区的前 10% - 25%）、`TOP25_50`（邮政编码地区的前 25% - 50%）。|
##|min_android_version|string|最低 Android 版本。<br><br>枚举值参见[枚举值 - 最低 Android 版本](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Minimum%20Android%20Version)。|
##|min_ios_version|string|受众最低 iOS 版本。<br><br>枚举值参见[枚举值 - 最低 iOS 版本](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Minimum%20iOS%20Version)。|
##|device_model_ids|string[]|设备型号 ID 列表。 |
##|network_types|string[]|你希望定向的网络类型。<br><br>枚举值参见[枚举值 - 网络类型](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Connection%20Type)。|
##|carrier_ids|string[]|你希望定向的运营商。 |
##|isp_ids|string[]|定向的互联网服务提供商的 ID。|
##|device_price_ranges|number[]|定向设备价格范围。10,000 表示 1,000 以上。数字必须为 50 的倍数。<br><br><p><span style="color:darkred"><b>注意</b></span>：系统会在你设置的上限基础上再加 50，并将所得的新数值用作设备定向的实际上限。实际上限会在 TikTok 广告管理平台的广告组设置中显示。如果你设置的价格范围为 [0, 250]，系统实际上会按 [0, 300] 处理。</p>|
##|saved_audience_id|string|当创建广告组时，传入 `saved_audience_id` 后返回。<br><br>已保存受众 ID。|
##|blocked_pangle_app_ids|string[]|Pangle 应用屏蔽 ID 列表。|
##|brand_safety_type|string|Smart+ 推广系列的库存筛选层级。<br><br>枚举值：<ul><li>`EXPANDED_INVENTORY`：扩展库存。你的广告不会展示在明显不适当的内容前后，但可能会展示在成人主题内容前后。</li><li>`STANDARD_INVENTORY`：标准库存。你的广告将展示在适合大多数品牌的内容前后。</li><li>`LIMITED_INVENTORY`：有限库存。你的广告不会展示在包含成人主题的内容前后。</li><li>`NO_BRAND_SAFETY`：不使用任何品牌安全解决方案的全部库存，这意味着你的广告可能会展示在某些成人主题的内容前后。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：系统会根据你的[品牌安全中心](https://business-api.tiktok.com/portal/docs?id=1739381752981505#item-link-Brand%20Safety%20Hub)配置自动应用此设置。若想获取广告账号此类设置的详细信息，需使用 [/tiktok_inventory_filters/get/](1830112550443073.html) 接口。</p>|
##|category_exclusion_ids|string[]|内容排除类别 ID。|
#| 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`。|
#|placement_type|string[]|决定你的广告将在哪里展示的广告位策略。<br><br>枚举值： <ul><li>`PLACEMENT_TYPE_AUTOMATIC`：自动广告位。</li><li>`PLACEMENT_TYPE_NORMAL`：选择广告位。</li></ul>|
#|placements|string[]|你希望投放广告的应用。<br><br>枚举值： <ul><li>`PLACEMENT_TIKTOK`：TikTok。</li><li>`PLACEMENT_PANGLE`：Pangle。</li><li>`PLACEMENT_GLOBAL_APP_BUNDLE`：全球化应用组合。</li></ul>|
#|tiktok_subplacements|string[]|TikTok 子广告位，可供你选择广告的展示位置。<br><br>枚举值：<ul><li>`LEMON8`：Lemon8，一款生活方式内容社区应用，内容包含真实生活体验分享、小贴士、指南和商品测评。如果选择 Lemon8 作为子广告位，广告将展示在其推荐页信息流、搜索信息流和沉浸式视频信息流中。[详细了解 Lemon8 效果竞价广告](https://ads.tiktok.com/help/article/about-lemon8-in-tiktok-ads-manager)。</li><li>`PINE_DRAMA`：PineDrama，一款观看短剧的应用。广告将被投放在推荐页面、剧集信息流等位置。[详细了解 PineDrama 效果竞价广告](https://ads.tiktok.com/help/article/about-pinedrama-for-performance-auction-in-tiktok-ads-manager)。</li></ul>|
#|search_result_enabled|boolean|是否在“搜索广告”中包含你的广告，即当用户在 TikTok 上搜索你的业务相关信息时向其展示你的广告。<br><br>支持的值：`true`、`false`。|
#|comment_disabled|boolean|是否允许在 TikTok 上评论你的广告。<br><br>支持的值：`true`、`false`。|
#|share_disabled|boolean|是否禁止将推广系列分享到第三方平台。<br><br>支持的值：`true`、`false`。|
#|video_download_disabled|boolean|用户是否可以在 TikTok 上下载你的视频广告。<br><br>支持的值：`true`、`false`。|
#|skip_learning_phase|boolean|是否跳过学习阶段。<br><br>支持的值：`true`。|
#|create_time|string|创建广告组的时间，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。<br><br>示例：`2025-01-01 00:00:01`。|
#|modify_time|string|最后修改广告组的时间，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。<br><br>示例：`2025-01-01 00:00:01`。|
示例
不启用受众建议的自动定向
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"adgroup_id": "{{adgroup_id}}",
"adgroup_name": "{{adgroup_name}}",
"advertiser_id": "{{advertiser_id}}",
"app_id": "{{app_id}}",
"attribution_event_count": "ONCE",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "OCPM",
"budget": 0,
"budget_mode": "BUDGET_MODE_INFINITE",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"click_attribution_window": "SEVEN_DAYS",
"comment_disabled": false,
"create_time": "{{create_time}}",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"deep_bid_type": "DEFAULT",
"engaged_view_attribution_window": "SEVEN_DAYS",
"min_budget": 0,
"modify_time": "{{modify_time}}",
"operation_status": "ENABLE",
"optimization_event": "ACTIVE",
"optimization_goal": "INSTALL",
"pacing": "PACING_MODE_SMOOTH",
"placement_type": "PLACEMENT_TYPE_AUTOMATIC",
"placements": [
"PLACEMENT_TIKTOK",
"PLACEMENT_GLOBAL_APP_BUNDLE",
"PLACEMENT_PANGLE"
],
"promotion_type": "APP_ANDROID",
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"search_result_enabled": true,
"secondary_status": "ADGROUP_STATUS_CREATE",
"share_disabled": false,
"skip_learning_phase": true,
"targeting_optimization_mode": "AUTOMATIC",
"targeting_spec": {
"actions": [],
"age_groups": [
"AGE_18_24",
"AGE_25_34",
"AGE_35_44",
"AGE_45_54",
"AGE_55_100"
],
"brand_safety_type": "EXPANDED_INVENTORY",
"gender": "GENDER_UNLIMITED",
"location_ids": [
"1562822"
],
"operating_systems": [
"ANDROID"
],
"spc_audience_age": "OVER_EIGHTEEN",
"spending_power": "ALL"
},
"video_download_disabled": false,
"view_attribution_window": "ONE_DAY"
}
}
(/code)
启用受众建议的自动定向
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"adgroup_id": "{{adgroup_id}}",
"adgroup_name": "{{adgroup_name}}",
"advertiser_id": "{{advertiser_id}}",
"app_id": "{{app_id}}",
"attribution_event_count": "ONCE",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "OCPM",
"budget": 0,
"budget_mode": "BUDGET_MODE_INFINITE",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"click_attribution_window": "SEVEN_DAYS",
"comment_disabled": false,
"create_time": "{{create_time}}",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"deep_bid_type": "DEFAULT",
"engaged_view_attribution_window": "SEVEN_DAYS",
"min_budget": 0,
"modify_time": "{{modify_time}}",
"operation_status": "ENABLE",
"optimization_event": "ACTIVE",
"optimization_goal": "INSTALL",
"pacing": "PACING_MODE_SMOOTH",
"placement_type": "PLACEMENT_TYPE_AUTOMATIC",
"placements": [
"PLACEMENT_TIKTOK",
"PLACEMENT_GLOBAL_APP_BUNDLE",
"PLACEMENT_PANGLE"
],
"promotion_type": "APP_ANDROID",
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"search_result_enabled": true,
"secondary_status": "ADGROUP_STATUS_CREATE",
"share_disabled": false,
"skip_learning_phase": true,
"suggestion_audience_enabled": true,
"targeting_optimization_mode": "AUTOMATIC",
"targeting_spec": {
"actions": [
{
"action_category_ids": [
"13",
"15"
],
"action_period": 15,
"action_scene": "VIDEO_RELATED",
"video_user_actions": [
"WATCHED_TO_END",
"LIKED",
"COMMENTED",
"SHARED"
]
},
{
"action_category_ids": [
"8",
"10"
],
"action_period": 0,
"action_scene": "CREATOR_RELATED",
"video_user_actions": [
"FOLLOWING",
"VIEW_HOMEPAGE"
]
},
{
"action_category_ids": [
"8",
"5"
],
"action_period": 0,
"action_scene": "HASHTAG_RELATED",
"video_user_actions": [
"VIEW_HASHTAG"
]
}
],
"age_groups": [
"AGE_18_24",
"AGE_25_34",
"AGE_35_44",
"AGE_45_54",
"AGE_55_100"
],
"audience_ids": [
"{{audience_id}}",
"{{audience_id}}",
"{{audience_id}}",
"{{audience_id}}"
],
"brand_safety_type": "STANDARD_INVENTORY",
"category_exclusion_ids": [
"200",
"201",
"202",
"203"
],
"gender": "GENDER_UNLIMITED",
"interest_category_ids": [
"17",
"10"
],
"location_ids": [
"1562822"
],
"operating_systems": [
"ANDROID"
],
"purchase_intention_keyword_ids": [
"14",
"17"
],
"spc_audience_age": "OVER_EIGHTEEN",
"spending_power": "ALL"
},
"video_download_disabled": false,
"view_attribution_window": "ONE_DAY"
}
}
(/code)
自定义定向
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"adgroup_id": "{{adgroup_id}}",
"adgroup_name": "{{adgroup_name}}",
"advertiser_id": "{{advertiser_id}}",
"app_id": "{{app_id}}",
"attribution_event_count": "ONCE",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "OCPM",
"budget": 0,
"budget_mode": "BUDGET_MODE_INFINITE",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"click_attribution_window": "SEVEN_DAYS",
"comment_disabled": false,
"create_time": "{{create_time}}",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"deep_bid_type": "DEFAULT",
"engaged_view_attribution_window": "SEVEN_DAYS",
"min_budget": 0,
"modify_time": "{{modify_time}}",
"operation_status": "ENABLE",
"optimization_event": "ACTIVE",
"optimization_goal": "INSTALL",
"pacing": "PACING_MODE_SMOOTH",
"placement_type": "PLACEMENT_TYPE_AUTOMATIC",
"placements": [
"PLACEMENT_TIKTOK",
"PLACEMENT_GLOBAL_APP_BUNDLE",
"PLACEMENT_PANGLE"
],
"promotion_type": "APP_ANDROID",
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"search_result_enabled": true,
"secondary_status": "ADGROUP_STATUS_CREATE",
"share_disabled": false,
"skip_learning_phase": true,
"suggestion_audience_enabled": false,
"targeting_optimization_mode": "MANUAL",
"targeting_spec": {
"actions": [
{
"action_category_ids": [
"13",
"15"
],
"action_period": 15,
"action_scene": "VIDEO_RELATED",
"video_user_actions": [
"WATCHED_TO_END",
"LIKED",
"COMMENTED",
"SHARED"
]
},
{
"action_category_ids": [
"8",
"10"
],
"action_period": 0,
"action_scene": "CREATOR_RELATED",
"video_user_actions": [
"FOLLOWING",
"VIEW_HOMEPAGE"
]
},
{
"action_category_ids": [
"8",
"5"
],
"action_period": 0,
"action_scene": "HASHTAG_RELATED",
"video_user_actions": [
"VIEW_HASHTAG"
]
}
],
"age_groups": [
"AGE_18_24",
"AGE_25_34",
"AGE_35_44",
"AGE_45_54",
"AGE_55_100"
],
"audience_ids": [
"{{audience_id}}",
"{{audience_id}}",
"{{audience_id}}",
"{{audience_id}}"
],
"brand_safety_type": "STANDARD_INVENTORY",
"category_exclusion_ids": [
"200",
"201",
"202",
"203"
],
"gender": "GENDER_UNLIMITED",
"interest_category_ids": [
"17",
"10"
],
"location_ids": [
"1562822"
],
"operating_systems": [
"ANDROID"
],
"purchase_intention_keyword_ids": [
"14",
"17"
],
"smart_audience_enabled": true,
"smart_interest_behavior_enabled": false,
"spending_power": "HIGH"
},
"video_download_disabled": false,
"view_attribution_window": "ONE_DAY"
}
}
(/code)