← 返回目录
📁 API Reference › (To be deprecated) Legacy Smart+

（即将废弃）创建旧版 Smart+ 推广系列

您可以使用本接口创建 Smart+ 推广系列。

重要提示
- 升级版 Smart+ API： - 我们正在升级 Smart+ API，以提供优化的功能和性能。新的升级版 Smart+ API 已上线。了解升级版 Smart+ 推广系列和可用的升级版 Smart+ API 接口。 - 快速开始： - 报表：无需额外的白名单。 - 推广系列管理：如需获取升级版 Smart+ 体验的权限，请联系你的 TikTok 销售代表，将您的广告账户加入白名单。如果你的广告账户已在白名单中，即可直接使用升级版 Smart+ API 的创建和修改接口。 - 旧版 API 弃用： - 自 2026 年 3 月 31 号，您将无法再通过 /campaign/spc/create/ 接口创建旧版 Smart+ 推广系列。 - 请注意，未迁移的旧版 Smart+ 推广系列不会自动迁移到新版 API。此后若尝试使用旧版 Smart+ API 接口将导致报错，并且无法通过此接口新建推广系列。 - 对于已接入旧版 API 客户的弃用延期申请流程： - 1. 提交申请：若您需要延期使用旧版 Smart+ API 创建接口，请通过旧版 Smart+ 接口下线延期申请表单提交申请。 - 2. 白名单处理：收到申请后，我们将为您的开发者应用 ID 处理白名单准入。提交延长申请表单的开发者可继续调用 /campaign/spc/create/ 接口至 2026 年 6 月 30 日。 - 3. 特殊情况申请：若您有强烈的业务需求，需要在 2026 年 6 月 30 日后继续使用该接口，请直接在表单中说明具体情况，或者与您的销售代表单独联系。

使用前需知

使用 /campaign/spc/quota/get/ 检查您的广告账户是否已达到 Smart+ 推广系列配额上限。

若您由于已达到 Smart+ 推广系列配额上限而无法新建 Smart+ 推广系列，您可以使用 /campaign/spc/quota/get/ 获取投放中的 Smart+ 推广系列列表，随后使用/campaign/status/update/暂停部分投放中的推广系列，从而释放占用的配额。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/campaign/spc/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。 |
|operation_status|string|推广系列创建时的启用/关闭状态。<br><br>枚举值： <ul><li>`ENABLE`: 推广系列创建时处于启用状态。</li><li>`DISABLE`: 推广系列创建时处于关闭状态。</li></ul>默认值：`ENABLE`。<br><br>若想在推广系列创建后更新其启用/关闭状态，请使用[/campaign/status/update](https://ads.tiktok.com/marketing_api/docs?id=1739320994354178)接口。|
|objective_type {必填}|string| 推广目标。<br><br>目前仅支持`APP_PROMOTION`、`WEB_CONVERSIONS` 和 `LEAD_GENERATION`。 <br><br>若想了解创建 Smart+ 线索收集推广系列的步骤，请查看[创建 Smart+ 线索收集推广系列](1827645480080385.html)。|
| spc_type | string | 仅当 `objective_type` 为 `WEB_CONVERSIONS` 时生效。<br><br> 网站推广系列类型。<br><br> 枚举值： <ul><li>`WEB_ALL_IN_ONE`：Smart+ 网站推广系列，支持的优化目标包括转化、价值、点击和落地页浏览量。</li><li>`UNSET`（<span style="color:red">即将废弃</span>）：智能效果网站推广系列，支持的优化目标仅包括转化、价值和点击。</li></ul> 默认值：`UNSET`。<br><br> 若想了解创建 Smart+ 网站推广系列的步骤，请查看[创建 Smart+ 网站推广系列](1814122471133186.html)。<br><br> <p><span style="color:darkred"><b>注意</b></span>： <ul><li>智能效果网站推广系列将在下个 API 版本中废弃。为保证流畅的 API 体验，建议您尽快升级至 [Smart+ 网站推广系列](1814122471133186.html)。Smart+ 网站推广系列是 AI 驱动的自动化解决方案，利用机器学习模型来 促进广告主实现商业目标。</li><li>本字段设置后不支持更新。</li></ul> |
| web_all_in_one_catalog_status | string | 仅当 `spc_type` 为 `WEB_ALL_IN_ONE` 时生效。 <br><br> Smart+ 网站推广系列中的商品库状态。 <br><br>枚举值： <ul><li>`OPEN`：启用。启用商品库的 Smart+ 网站推广系列为 Smart+ 商品库广告。若想了解创建 Smart+ 商品库广告的详细步骤，请查看[创建 Smart+ 商品库广告](https://business-api.tiktok.com/portal/docs?id=1814122471133186#item-link-%E5%88%9B%E5%BB%BA%20Smart+%20%E5%95%86%E5%93%81%E5%BA%93%E5%B9%BF%E5%91%8A)。</li><li> `UNSET`：未启用。未启用商品库的 Smart+ 网站推广系列为 普通 Smart+ 网站推广系列。若想了解创建普通 Smart+ 网站推广系列的详细步骤，请查看[创建普通 Smart+ 网站推广系列](https://business-api.tiktok.com/portal/docs?id=1814122471133186#item-link-%E5%88%9B%E5%BB%BA%E6%99%AE%E9%80%9A%20Smart+%20%E7%BD%91%E7%AB%99%E6%8E%A8%E5%B9%BF%E7%B3%BB%E5%88%97)。</li></ul> 默认值：`UNSET`。 |
|app_promotion_type {+条件必填}|string| 当`objective_type`为`APP_PROMOTION`时必填。<br><br>应用推广类型。 <br><br>目前仅支持`APP_INSTALL`。|
|virtual_objective_type|string|新推广目标类型。<br><br>枚举值：`SALES`（销量）。<br><br>使用本字段创建推广目标为销量的推广系列，该目标合并了网站转化量目标和商品销量目标。了解销量目标的详情，参见[销量目标](1834189283112962.html)。|
|sales_destination{+条件必填}|string|仅当传入 `virtual_objective_type` 时本字段生效且必填。<br><br>销售目标页面，即想要推动销售的渠道。<br><br>枚举值：<ul><li>`WEBSITE`：网站。推动网站上的销售。</li></ul>|
|campaign_type|string|推广系列类型。<br><br>枚举值：`REGULAR_CAMPAIGN`，`IOS14_CAMPAIGN`。<br>默认值：`REGULAR_CAMPAIGN`。|
|campaign_app_profile_page_state|string|是否使用应用介绍页优化广告投放。<br><br>枚举值：`ON` , `OFF`。<br>默认值：`OFF`。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>本字段仅可在`objective_type`为`APP_PROMOTION`的 iOS 14专属推广系列中使用，否则会出现报错。</li><li>将本字段设置为 `ON` 时，需传入应用介绍页的 `page_id`。<ul><li>若想创建应用介绍页，可使用[即时体验页面编辑器](1740307202170881.html)并将 `businessType` 设置为 `4`。</li></ul></li></ul>|
| is_advanced_dedicated_campaign | boolean | 是否使用高级专属推广系列。高级专属推广系列采用捕捉实时信号的高级投放模型。 <br><br>枚举值：`true`，`false`。 <br>默认值：`false`。<br><br>若想了解如何创建此类推广系列，请查看[创建高级专属推广系列](1797011827608577.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持修改。 |
| disable_skan_campaign | boolean | 仅当满足以下所有条件时生效：<ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_INSTALL`。</li><li>`campaign_type` 为 `IOS14_CAMPAIGN`。</li><li>`app_id` 为可用于[高级专属推广系列](1797011827608577.html)的 iOS 应用的 ID。 若想确认应用能否用于高级专属推广系列中，可使用 [/app/list/](1740859313270786.html) 并查看返回的`advanced_dedicated_campaign_allowed`。</li></ul><br>是否关闭 SKAN（SKAdNetwork）归因（Apple 针对 iOS 推广系列的转化归因解决方案）。<br><br>枚举值：<ul><li>`true`：关闭 SKAN 归因。推广系列将不受[专属推广系列配额限制](1752256248260610.html)的约束，您可为此推广系列拉取[自归因平台（SAN）指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-自归因平台指标)数据。但是，不支持为此推广系列拉取 [SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。了解[自归因平台集成](https://ads.tiktok.com/help/article/about-self-attribution-transition)的详情。<ul><li>若专属推广系列中使用了可用于高级专属推广系列的应用，您需使用以下配置之一：仅启用 SKAN 归因、仅启用高级专属推广系列设置、同时启用 SKAN 归因和高级专属推广系列设置。不支持为此推广系列同时关闭 SKAN 归因和高级专属推广系列设置。</li></ul></li><li>`false`：启用 SKAN 归因。推广系列将受[专属推广系列配额限制](1752256248260610.html)的约束，您可为此推广系列拉取 [SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。<ul><li>若您启用 SKAN 归因的同时将 `is_advanced_dedicated_campaign` 设置为 `true`，从而启用高级专属推广系列设置，您将可以为此推广系列同时拉取[自归因平台指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-自归因平台指标)和[ SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。</li></ul></li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>为专属推广系列关闭 SKAN 归因目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>若您已申请为专属推广系列关闭 SKAN 归因的白名单，在满足以下所有条件时，不支持将 `bid_type` 设置为 `BID_TYPE_CUSTOM`：<ul><li>`is_advanced_dedicated_campaign` 为 `false`。</li><li>`disable_skan_campaign` 为 `false`。</li><li>`optimization_goal` 为 `INSTALL` 或 `IN_APP_EVENT`。</li></ul></li><li>本字段设置后不支持更新。</li><li>使用高级专属推广系列要求应用满足一定条件。若您的应用不可用于高级专属推广系列，可联系您的 TikTok 销售代表。您的 TikTok 销售代表将提供故障排查支持，帮助您的应用满足高级专属推广系列的条件。</li></ul> |
|campaign_name {必填}|string| 推广系列名称。 |
|special_industries|string[]|广告分类。 <br><br> 枚举值：<ul><li>`HOUSING`: 房地产，房屋保险，抵押贷款或相关的广告。</li><li>`EMPLOYMENT`: 工作机会，实习机会，职业认证项目或相关的广告。</li><li>`CREDIT`: 信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul><br><span style="color:darkred"><b>注意</b></span>：<ul><li>一旦您选择了行业类型，系统将为您调整定向选项，帮助您遵守广告政策。欲了解详细信息，请参考[受众定向](https://ads.tiktok.com/marketing_api/docs?id=1739381236849665)。<li>本字段仅支持注册地为美国或加拿大的广告主使用。</ul>|
| product_source {+条件必填} | string | `web_all_in_one_catalog_status` 为 `OPEN` 时必填。<br><br> 商品来源，即您要推广的商品的来源。<br><br>枚举值：`CATALOG`（商品库）。 |
| catalog_id {+条件必填}| string | `web_all_in_one_catalog_status` 为 `OPEN` 时必填。<br><br> Smart+ 商品库广告中要使用的商品库的 ID。<br>目前，仅支持指定电商商品库。<br><br> 若想获取商务中心中的商品库，可使用[/catalog/get/](1740315452868610.html)。 |
| catalog_authorized_bc_id {+条件必填} | string | `web_all_in_one_catalog_status` 为 `OPEN` 时必填。<br><br>  商品库（`catalog_id`）所属的商务中心的 ID。 |
| product_specific_type {+条件必填} | string | `web_all_in_one_catalog_status` 为 `OPEN` 时必填。 <br><br>  选择商品的维度。<br><br>  枚举值：<ul><li>`ALL`：允许 TikTok 从所有商品中动态选择。</li><li> `PRODUCT_SET`：请选择一个商品系列。TikTok 将动态选择该商品系列中的商品。</li><li>`CUSTOMIZED_PRODUCTS`：选择自定义数量的特定商品。</li></ul><br><ul><li>若本字段设置为 `ALL`，无需传入 `product_set_id` 和 `product_ids`。</li><li>若本字段设置为 `PRODUCT_SET`，需传入`product_set_id`。</li><li>若本字段设置为 `CUSTOMIZED_PRODUCTS`，需传入`product_ids`。</li></ul>|
| product_set_id {+条件必填} | string | `product_specific_type` 为 `PRODUCT_SET` 时必填。 <br><br>  商品系列 ID。 <br><br> 若想获取广告账户下的商品系列，可使用[/catalog/set/get/](1740570556295169.html)。 <br> 若想创建商品系列，可使用[/catalog/set/create/](1740572891104257.html)。 |
| product_ids {+条件必填} | string[] | `product_specific_type` 为 `CUSTOMIZED_PRODUCTS` 时必填。 <br><br>商品库商品的商品 ID 列表。 <br><br>最大数量：20。 <br><br>若想获取每个商品库商品的商品 ID（`product_id`），可使用[/catalog/product/get/](1740564136678402.html)。 |
|promotion_type {必填}|string|推广对象类型（优化位置）。您可以使用该字段决定在哪里投放广告。 <br><br>目前支持`APP_ANDROID`，`APP_IOS`， `WEBSITE` 和 `LEAD_GENERATION`。 <br><br><ul><li>`objective_type` 为 `APP_PROMOTION` 时，可将本字段设置为 `APP_ANDROID` 或 `APP_IOS`。</li><li>`objective_type` 为 `WEB_CONVERSIONS` 时，需将本字段设置为 `WEBSITE`。</li><li>`objective_type` 为 `LEAD_GENERATION` 时，需将本字段设置为 `LEAD_GENERATION`。</li></ul>|
|app_id|string|推广的应用的 ID。 <br><br>您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786)获取`app_id`。|
|promotion_website_type|string|仅当 `objective_type` 为 `WEB_CONVERSIONS` 且 `spc_type` 为 `UNSET` 或未传入 `spc_type` 时生效。<br> <br>TikTok 即时体验页面类型。<br> <br>目前仅支持`TIKTOK_NATIVE_PAGE`（使用 TikTok 即时体验页面）。 <br><br>如果要使用 TikTok 即时体验页面，在创建推广系列时，您需要传入 TikTok 即时体验页面的`page_id`，且不支持同时传入`pixel_id`。|
|promotion_target_type{+条件必填}|string|当 `objective_type` 设置为 `LEAD_GENERATION` 时必填。<br><br>推广目标线索收集的专属优化位置。<br><br>枚举值：<ul><li>`INSTANT_PAGE`: 即时表单（线索表单）。创建可快速加载的应用内 TikTok 即时表单来收集更多线索。</li><li>`EXTERNAL_WEBSITE`: 第三方网站表单。使用包含第三方网站表单的落地页，或使用会重定向至包含第三方网站表单网站的 TikTok 即时体验页面来收集更多线索。</li></ul>|
|optimization_goal {必填}|string|推广系列使用的优化目标。<br><br>目前仅支持 `CLICK`，`INSTALL`，`IN_APP_EVENT`，`VALUE`， `CONVERT`，`TRAFFIC_LANDING_PAGE_VIEW` 和 `LEAD_GENERATION`。 <br><br>  每个枚举值的描述详见[枚举值-优化目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-%E4%BC%98%E5%8C%96%E7%9B%AE%E6%A0%87)。|
|pixel_id|string|Pixel ID。仅对落地页生效。 <br><br>您可以使用[/pixel/list/](https://ads.tiktok.com/marketing_api/docs?id=1740858697598978)接口获取所有 Pixel ID。|
|optimization_event {必填}|string|广告转化事件。 <br><br>详见[转化事件](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)转化事件。<br>您可以使用[/app/optimization_event/](https://ads.tiktok.com/marketing_api/docs?id=1740859338750977)接口找到您的应用支持的事件。|
| 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>若想了解如何在 Smart+ 线索收集推广系列中配置深层漏斗优化，可查看[创建 Smart+ 线索收集推广系列](1827645480080385.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`。   |
|bid_type|string|出价策略。 <br><br> 枚举值： <ul><li>`BID_TYPE_NO_BID`：最大投放量。</li><li> `BID_TYPE_CUSTOM`：成本上限（或目标 CPA）。</li></ul>|
| bid_price {+条件必填}  | float | 满足以下条件时必填：<ul><li>`spc_type` 为 `WEB_ALL_IN_ONE`</li><li>`optimization_goal` 为 `CLICK`</li><li>`bid_type` 为 `BID_TYPE_CUSTOM`</li></ul><br>  目标平均点击成本。系统将会把平均成效成本保持在指定值的同时尽可能取得最多成效。<br> <br> `bid_price` 需小于设置的`budget`金额。请查看[出价-出价限制](https://business-api.tiktok.com/portal/docs?id=1745292444424193#item-link-%E5%87%BA%E4%BB%B7%E9%99%90%E5%88%B6)了解出价校验机制。 |
| conversion_bid_price {+条件必填} | float |满足以下条件时必填：<ul><li> `spc_type` 为 `WEB_ALL_IN_ONE` </li><li>`optimization_goal` 为 `CONVERT` 或 `TRAFFIC_LANDING_PAGE_VIEW`</li><li>`bid_type` 为 `BID_TYPE_CUSTOM` </li></ul><br>目标平均转化或落地页浏览量成本。系统将会把平均成效成本保持在指定值的同时尽可能取得最多成效。 <br><br> `conversion_bid_price` 需小于设置的`budget`金额。请查看[出价-出价限制](https://business-api.tiktok.com/portal/docs?id=1745292444424193#item-link-%E5%87%BA%E4%BB%B7%E9%99%90%E5%88%B6)了解出价校验机制。 |
|deep_bid_type|string|深度事件出价类型。<br><br>目前仅支持`DEFAULT`，`AEO`，`VO_MIN_ROAS`（仅支持 Smart+ 网站推广系列） 和`VO_HIGHEST_VALUE`。<br><br>枚举值的描述详见[枚举值-深度事件出价类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-深度事件出价类型)。|
| roas_bid {+条件必填} | float | `deep_bid_type` 为 `VO_MIN_ROAS` 时必填。 <br><br>价值优化的目标 ROAS。 <br><br> 取值范围： 0.01-1,000。 |
| 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> |
| 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` 和 `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>|
|billing_event {必填}|string|计费事件。<br><br>枚举值详见[枚举值-计费事件](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-计费事件)。<br><br>目前仅支持`OCPM`和`CPC`。|
|location_ids {必填}|string[]|您想要定向的地域ID列表。<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。<br>ID 列表也可以通过[地域定向](https://ads.tiktok.com/marketing_api/docs?id=1739311040498689) 查看。<br><br><p><span style="color:darkred"><b>注意</b></span><br>若您将美国设置为定向地域，广告组创建完成后不允许将美国从定向地域中移除。|
|languages|string[]|受众语言。<br><br>欲了解支持的语言代码列表，请参阅[枚举值-受众语言](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-受众语言)。|
|gender|string|定向受众性别。<br><br>枚举值：`GENDER_FEMALE`，`GENDER_MALE`，`GENDER_UNLIMITED`。<br>默认值：`GENDER_UNLIMITED`。<br><br><p><span style="color:darkred"><b>注意</b></span>：本字段目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。|
|spc_audience_age |string|该推广系列定向的年龄区间。<br><br>枚举值：<ul><li>`18+`: 18+.</li><li>`25+`: 25+.<ul><li>仅当 `objective_type` 为 `LEAD_GENERATION` 支持指定值为 `25+`。</li></ul></li></ul><br>默认值： `18+`。|
|exclude_age_under_eighteen|boolean|排除十八岁以下受众。<br><br><p><span style="color:darkred"><b>注意</b></span>：自2023年9月21日起，您将不能定向十八岁以下受众。本字段仅支持`true`。|
|excluded_audience_ids|string[]|排除的受众 ID 列表。<br><br>您可以使用[/dmp/custom_audience/list/](https://ads.tiktok.com/marketing_api/docs?id=1739940506015746)接口获取该受众 ID 列表。|
|placement_type|string|版位（广告位）类型。<br><br>枚举值：<ul><li>`PLACEMENT_TYPE_AUTOMATIC`：自动版位。TikTok 的广告系统将使用智能计算，为你提供覆盖所有应用的广告位最佳组合。</li><li>`PLACEMENT_TYPE_NORMAL` ：编辑版位。你将能够选择广告投放的具体应用。</li></ul>默认值:`PLACEMENT_TYPE_NORMAL`。<br><br><ul><li>对于 Smart+ Android 应用推广系列（`promotion_type` 为 `APP_ANDROID`），自动选择版位是一个重点功能。<ul><li>系统将根据您的其他设置自动配置广告投放版位，并从不同的版位中选择高质量流量，来实现更好的广告效果。若传入了 `placement_type` 和 `placements`，将忽略这两个字段，并将值分别覆盖成 `PLACEMENT_TYPE_AUTOMATIC` 和`&#91;"PLACEMENT_TIKTOK","PLACEMENT_PANGLE"&#93;`。</li><li>若想获取 Smart+ 应用推广系列实际选择的版位设置，可使用[/campaign/spc/get/](1767334299811842.html)。</li></ul></li><li>对于 Smart+ iOS 应用推广系列（`promotion_type` 为 `APP_IOS`），自动选择版位是一个重点功能。<ul><li>自 2025 年 6 月30 日起，系统将根据您的其他设置自动配置广告投放版位，并从不同的版位中选择高质量流量，来实现更好的广告效果。若在 2025 年 6 月 30 日后传入了 `placement_type` 和 `placements`，将忽略这两个字段，并将值分别覆盖成 `PLACEMENT_TYPE_AUTOMATIC` 和`&#91;"PLACEMENT_TIKTOK","PLACEMENT_PANGLE"&#93;`。</li><li>若想获取 Smart+ 应用推广系列实际选择的版位设置，可使用[/campaign/spc/get/](1767334299811842.html)。</li></ul></li><li>对于 Smart+ 网站推广系列，自动选择版位是一个重点功能。系统将根据您的其他设置自动配置广告投放版位，并从不同的版位中选择高质量流量，来实现更好的广告效果。若传入了 `placement_type` 和 `placements` ，将忽略这两个字段。若想获取 Smart+ 网站推广系列实际选择的版位设置，可使用[/campaign/spc/get/](1767334299811842.html)。<ul><li>若所有的定向地域（`location_ids`）均不支持 Pangle 版位，则返回 `placement_type` 将为 `PLACEMENT_TYPE_NORMAL` ， 且 `placements` 为 `&#91;"PLACEMENT_TIKTOK"&#93;`。</li><li>若一个或多个定向地域（`location_ids`）不支持 Pangle 版位，则返回 `placement_type` 将为`PLACEMENT_TYPE_AUTOMATIC` 且 `placements` 为 `&#91;"PLACEMENT_TIKTOK","PLACEMENT_PANGLE"&#93;`。</li></ul></li><li>对于 Smart+ 线索收集推广系列（`promotion_type` 为 `LEAD_GENERATION`），需手动选择 TikTok 版位，将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 且将 `placements` 设置为 `["PLACEMENT_TIKTOK"]`。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>推广系列创建后无法更新`placement_type`。</li></ul>|
|placements|string[]|广告版位。<br><br>目前仅支持`PLACEMENT_TIKTOK`。<br><br><ul><li>对于 Smart+ Android 应用推广系列（`promotion_type` 为 `APP_ANDROID`），需使用自动版位，将 `placement_type` 设置为 `PLACEMENT_TYPE_AUTOMATIC` 且不传入`placements`。系统将忽略`placements`参数并自动填充为`&#91;"PLACEMENT_TIKTOK", "PLACEMENT_PANGLE"&#93;`。</li><li>对于 Smart+ iOS 应用推广系列（`promotion_type` 为 `APP_IOS`），需手动选择 TikTok 版位，将`placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 且将 `placements` 设置为`&#91;"PLACEMENT_TIKTOK"&#93;`。</li><li>对于 Smart+ 网站推广系列，自动选择版位是一个重点功能。系统将根据您的其他设置自动配置广告投放版位，并从不同的版位中选择高质量流量，来实现更好的广告效果。若传入了 `placement_type` 和 `placements` ，将忽略这两个字段。若想获取 Smart+ 网站推广系列实际选择的版位设置，可使用[/campaign/spc/get/](1767334299811842.html)。<ul><li>若所有的定向地域（`location_ids`）均不支持 Pangle 版位，则返回 `placement_type` 将为 `PLACEMENT_TYPE_NORMAL` ， 且 `placements` 为 `&#91;"PLACEMENT_TIKTOK"&#93;`。</li><li>若一个或多个定向地域（`location_ids`）不支持 Pangle 版位，则返回 `placement_type` 将为`PLACEMENT_TYPE_AUTOMATIC` 且 `placements` 为 `&#91;"PLACEMENT_TIKTOK","PLACEMENT_PANGLE"&#93;`。</li></ul></li><li>对于 Smart+ 线索收集推广系列（`promotion_type` 为 `LEAD_GENERATION`），需手动选择 TikTok 版位，将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 且将 `placements` 设置为 `["PLACEMENT_TIKTOK"]`。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>推广系列创建后无法更新`placements`。 </li></ul>|
|comment_disabled|boolean|是否允许用户在TikTok上评论您的广告。<br><br>默认值：`false`。|
|share_disabled|boolean|是否禁止将本推广系列分享到第三方平台。|
|video_download_disabled|boolean|用户是否可以在 TikTok 上下载您的广告视频。(该字段设置后不允许修改）。 <br><br>默认值：`false`。|
|blocked_pangle_app_ids|string[]|Pangle 媒体屏蔽 ID 列表。 <br><br>您可以通过[/pangle_block_list/get/](https://ads.tiktok.com/marketing_api/docs?id=1740039957181441)接口返回的`app_package_id`字段获取该信息。<br><br>当您将`placements`仅设置为`PLACEMENT_TIKTOK`，请不要传入该字段。|
|budget_mode|string|预算类型。<br><br>枚举值：`BUDGET_MODE_DAY`，`BUDGET_MODE_DYNAMIC_DAILY_BUDGET`。<br>默认值：`BUDGET_MODE_DAY`。<br><br>欲了解如何设置预算类型，请参阅[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。<br><br><span style="color:darkred"><b>注意</b></span>：<ul><li>目前，创建推广系列后暂不支持更新本字段。</li><li>对于 Smart+ 线索收集推广系列，仅支持设置为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`。</li></ul>|
| budget_auto_adjust_strategy | string | 仅当 `budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` 时生效。<br><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></ul><br><p><span style="color:darkred"><b>注意</b></span>：启用自动增加预算目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 |
|budget {必填}|float|固定推广系列预算或初始推广系列预算。<ul><li>`budget_auto_adjust_strategy` 为 `UNSET` 时，本字段代表固定推广系列预算。</li><li>`budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，本字段代表初始推广系列预算。若想获取当前推广系列预算，可查看返回的`current_budget`。</li></ul><br>欲了解最低预算以及如何设置预算类型，请参阅[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。<br>欲直接获取某一币种对应的每日预算取值范围，请参阅[币种-每日预算取值范围](https://ads.tiktok.com/marketing_api/docs?id=1737585839634433#item-link-Daily%20budget%20value%20range)。|
|schedule_type {必填}|string|广告投放计划类型。<br><br>目前仅支持`SCHEDULE_START_END`和`SCHEDULE_FROM_NOW`。|
|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|广告投放结束时间，格式为`YYYY-MM-DD HH:MM:SS`（UTC+0）。<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><br><p><span style="color:darkred"><b>注意</b></span>：不设置，全部设置为0，或者全部都设置为1都代表了要进行全时投放。|
|identity_id {+条件必填}|string|不使用 Spark Ads 时必填。<br><br>不使用 Spark Ads 时的认证身份 ID。|
|identity_type {+条件必填}|string|不使用 Spark Ads 时必填。<br><br>不使用 Spark Ads 时的认证身份类型。<br><br>枚举值：`CUSTOMIZED_USER`。<br>默认值： `CUSTOMIZED_USER`。|
|media_info_list {必填}|object[]|媒体信息列表。|
#|media_info {必填}|object|媒体信息。<br><br>仅支持视频，不支持图片。<br><br> 视频数量最大值：30。|
##|video_info {+条件必填}|object|<ul><li>对于 Smart+ 应用推广系列和普通 Smart+ 网站推广系列，未传入 `tiktok_item_id`时本字段必填。</li><li>对于 Smart+ 商品库广告，`video_info` 为可选字段。若指定了 `video_info` 和 `image_info`，所指定的视频和封面将用于自动生成单视频广告。</li></ul><br>视频信息。|
###|video_id {+条件必填}|string|传入`video_info`时必填。<br><br>视频 ID。<br><br>您可以通过接口[/file/video/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1737587322856449)上传视频，返回中可以获取视频 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：我们建议您使用[/file/video/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1737587322856449)（`upload_type` = `UPLOAD_BY_VIDEO_ID`）将视频 ID 与广告主 ID 进行绑定。|
###|file_name|string|视频名称。|
##|image_info {+条件必填}|object[]|<ul><li>对于 Smart+ 应用推广系列和普通 Smart+ 网站推广系列，未传入`tiktok_item_id`时本字段必填。</li><li>对于 Smart+ 商品库广告，`image_info` 为可选字段。若指定了 `video_info` 和 `image_info`，所指定的视频和封面将用于自动生成单视频广告。</li></ul><br>图片信息。<br><br>本字段将作为视频封面。<br><br>每个`image_info`中仅可上传一张图片。|
###|web_uri {+条件必填}|string|传入`image_info`时必填。<br><br>图片 ID。<br><br>您可以通过接口[/file/image/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1739067433456642)上传图片，返回中可以获取图片 ID。|
##| music_info {+条件必填}| object | <ul><li>对于 Smart+ 应用推广系列和普通 Smart+ 网站推广系列，不支持本字段。</li><li> 对于 Smart+ 商品库广告，`catalog_creative_toggle`为 `true` 时`music_info`必填。系统将自动生成商品库轮播广告。若想了解如何确保商品库轮播样式可用，可查看[自定义 Smart+ 商品库广告中的广告样式组合](https://business-api.tiktok.com/portal/docs?id=1814122471133186#item-link-%E8%87%AA%E5%AE%9A%E4%B9%89%20Smart+%20%E5%95%86%E5%93%81%E5%BA%93%E5%B9%BF%E5%91%8A%E4%B8%AD%E7%9A%84%E5%B9%BF%E5%91%8A%E6%A0%B7%E5%BC%8F%E7%BB%84%E5%90%88)。</li></ul> <br>音乐信息。 |
###| music_id {+条件必填}| string | 传入 `music_info` 时必填。 <br><br>  用于自动生成的商品库轮播广告的音乐的 ID。 |
##| aigc_disclosure_type | string | 仅当 `identity_type` 为 `CUSTOMIZED_USER` 时生效。 <br><br>是否启用 AI 生成内容自主声明开关，以表明广告中包含 AI 生成内容。启用该开关后，当用户查看完整广告时，您的广告将带有“广告主标记为 AI 生成”的标签。<br><br>枚举值：<ul><li>`SELF_DISCLOSURE`：启用开关，声明广告包含 AI 生成内容。</li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。</li></ul> 默认值： `NOT_DECLARED`。 <br><br>若想了解此开关支持的推广目标和广告样式，以及使用此开关的步骤，请查看 [AI 生成内容自主声明开关](1799186631031809)。  <br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 您仅可在更新视频（`video_id`）时更新本字段。</li></ul>|
##|tiktok_item_id {+条件必填}|string|<ul><li>对于 Smart+ 应用推广系列和普通 Smart+ 网站推广系列，未传入 `image_info` 和 `video_info` 时本字段必填。</li><li>对于 Smart+ 商品库广告，不支持本字段。</li></ul><br>用作 Spark Ads 的 TikTok 帖子 ID。<br><br>ID 可以从[/tt_video/info/](https://ads.tiktok.com/marketing_api/docs?id=1738376324021250)或[/identity/video/get/](https://ads.tiktok.com/marketing_api/docs?id=1740218475032577)接口的返回值中的`item_id`字段值获取。<br><br>传入`tiktok_item_id`后，无需传入`image_info`，`video_info`和`title_list`。 <br><br><p><span style="color:darkred"><b>注意</b></span>：使用 Spark Ads 功能，代表您声明拥有该视频中音乐的版权，可用于营销使用。|
##|identity_type {+条件必填}|string|当使用 Spark Ads 时必填。 <br><br>使用 Spark Ads 时的认证身份类型。<br><br>枚举值：`AUTH_CODE`（授权用户）， `TT_USER`（TikTok 用户），`BC_AUTH_TT`（添加到商务中心的 TikTok 用户）。<br>若想了解认证身份的详情，请查看[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。<br><br><p><span style="color:darkred"><b>注意</b></span>：如果此字段设置为 `TT_USER`、`BC_AUTH_TT` 或 `AUTH_CODE`，并且 `objective_type` 为 `APP_PROMOTION` 或 `WEB_CONVERSIONS`，需要通过 `call_to_action_id` 指定一个动态行动引导文案。</p>|
##|identity_id {+条件必填}|string|当使用 Spark Ads 时必填。 <br><br>使用 Spark Ads 时的认证身份 ID。|
##| identity_authorized_bc_id {+条件必填} | string | 当 `identity_type` 为 `BC_AUTH_TT` 时必填。<br><br>与添加到商务中心的 TikTok 用户这一类型认证身份绑定的商务中心的 ID。 |
|dark_post_status |string|仅当您使用 Spark Ads 推送来创建 Spark Ads 时生效。<br><br>素材的“只在广告中显示”模式的状态。<br><br>枚举值：<ul><li>`ON`: 启用“只在广告中显示”模式，仅获得付费流量。</li><li>`OFF`: 不启用“只在广告中显示”模式。帖子将发布到关联的 TikTok 账号主页，且将可以获得自然流量。</li></ul><br>默认值: `ON`。<br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>仅当广告发布身份的“仅在广告中显示”模式未启用，且广告账号的强制开启“仅在广告中显示”模式也未启用时，才能将此字段设为 `OFF`。若广告账号已启用强制开启“仅在广告中显示”模式，在使用 Spark Ads 推送创建 Spark Ads 时，只能将此字段设为 `ON`。从而防止您的帖子出现在您的 TikTok 主页上并获得自然流量，无论广告发布身份自身的 `ads_only_mode` 设置如何。这是一个保障措施，可确保您的 Spark Ads 推送内容保持仅广告可见，并避免意外发布帖子到个人主页。<ul><li>如需确认广告发布身份的“仅在广告中显示”模式，可使用 [/identity/info/](1740218453385217.html) 并检查返回的 `ads_only_mode`。 </li><li>如需确认广告账号的强制开启“仅在广告中显示”模式启用状态，可使用 [/advertiser/info/](1739593083610113.html) 并检查返回的 `ads_only_mode`。</li></ul></li></ul></p>|
| catalog_creative_toggle | boolean | 仅当 `web_all_in_one_catalog_status` 为 `OPEN` 时生效。 <br><br>是否启用商品库素材的自动选择。  <br><br> 支持的值：`true`，`false`。  <br>默认值：`false`。  <br><br>若本字段设置为 `true`，`music_info` 必填，且系统将使用可用的广告样式（商品库视频、 商品库轮播和单视频）自动生成广告。若想了解具体的设置和要求，可查看[自定义 Smart+ 商品库广告中的广告样式组合](https://business-api.tiktok.com/portal/docs?id=1814122471133186#item-link-%E8%87%AA%E5%AE%9A%E4%B9%89%20Smart+%20%E5%95%86%E5%93%81%E5%BA%93%E5%B9%BF%E5%91%8A%E4%B8%AD%E7%9A%84%E5%B9%BF%E5%91%8A%E6%A0%B7%E5%BC%8F%E7%BB%84%E5%90%88)。 |
|title_list{+条件必填}|object[]|广告文案列表。广告文案作为您的广告素材一部分向受众展示，传递您想传达的信息。<br><br>传入`tiktok_item_id`后，无需传入`image_info`，`video_info`和`title_list`。|
#|title {+条件必填}|string|传入`title_list`时必填。<br><br>广告文案。|
|call_to_action_id{+条件必填}|string|在以下任一场景中，本字段必填：<ul><li>场景 1：<ul><li>`objective_type` 为 `LEAD_GENERATION`。</li></ul></li><li>场景 2：<ul><li>`objective_type` 为 `APP_PROMOTION` 或 `WEB_CONVERSIONS`。</li><li>`media_info` 对象中的 `identity_type` 为 `TT_USER`、`BC_AUTH_TT` 或 `AUTH_CODE`。</li></ul></li></ul><br>行动引导文案素材包 ID。行动引导文案素材包指的是一组自动优化的行动引导文案。<br><br>关于自动优化行动引导文案的更多信息，请参见[智能推荐CTA > 动态优选CTA](https://ads.tiktok.com/marketing_api/docs?id=1740307296329730#item-link-Dynamic%20CTAs%20).|
|call_to_action_list|object[]|行动引导文案列表。<br><br><p><span style="color:darkred"><b>注意</b></span>：在以下任一场景中，均不支持此字段，需要改用 `call_to_action_id`。<ul><li>场景 1：<ul><li>`objective_type` 为 `LEAD_GENERATION`。</li></ul></li><li>场景 2：<ul><li>`objective_type` 为 `APP_PROMOTION` 或 `WEB_CONVERSIONS`。</li><li>`media_info` 对象中的 `identity_type` 为 `TT_USER`、`BC_AUTH_TT` 或 `AUTH_CODE`。</li></ul></li></ul>|
#|call_to_action{+条件必填}|string|传入`call_to_action_list`时必填。<br><br>行动引导文案。<br><br>枚举值见[枚举值-行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-行动引导文案)。|
|product_info |object|额外添加的商品信息。此信息将用于创建广告变体，帮助您达成推广目标，例如脱颖而出、建立信任或改善效果。|
#|promo_info_list|object[]|仅对[普通 Smart+ 网站推广系列](https://business-api.tiktok.com/portal/docs?id=1814122471133186#item-link-%E5%88%9B%E5%BB%BA%E6%99%AE%E9%80%9A%20Smart+%20%E7%BD%91%E7%AB%99%E6%8E%A8%E5%B9%BF%E7%B3%BB%E5%88%97)生效。<br><br>促销码或优惠详情。<br>促销码和优惠有助于提升广告成效。请确保促销码和优惠处于有效状态、信息准确且可在结账时立即使用。<br><br>最大数量：10。|
##|discount_type {+条件必填}|string|传入 `promo_info_list` 时本字段必填。<br><br>折扣类型。<br><br>枚举值：<ul><li>`PERCENTAGE`：百分比折扣。</li><li>`CASH`：现金折扣。</li></ul>|
##|discount_value {+条件必填}|float|传入 `promo_info_list` 时本字段必填。<br><br>折扣数值。<br><br><ul><li>`discount_type` 为 `PERCENTAGE` 时，需指定 1 和 100 之间的整数。</li><li>`discount_type` 为 `CASH` 时，需指定大于 0 的浮点数。</li></ul>|
##|discount_currency {+条件必填}|string|`discount_type` 为 `CASH` 时本字段必填。<br><br>折扣金额。<br><br>枚举值参见 <a href="#item-link-discount_currency 或 minimum_purchase_currency 可选值">`discount_currency` 或 `minimum_purchase_currency` 可选值</a>。|
##|promo_code|string|促销码。<br><br><ul><li>对于需购物者在结账时输入的促销码，需通过本字段指定促销码。</li><li>对于自动应用的优惠，无需传入本字段。</li></ul><br>长度限制：30 个字符，不能包含 emoji。每个汉字或日文单字算作两个字符，每个英文字母算作一个字符。<br><br><p><span style="color:darkred"><b>注意</b></span>：TikTok 专属的促销码通常效果最好。|
##|minimum_purchase_type|string|最低购买要求类型。<br><br>枚举值：<ul><li>`QUANTITY`：最低购买数量。</li><li>`SUBTOTAL`：最低购买金额。</li></ul>|
##|minimum_purchase_value {+条件必填}|float|传入 `minimum_purchase_type` 时本字段必填。<br><br>最低购买数值。<ul><li>`minimum_purchase_type` 为 `QUANTITY` 时，需指定大于等于 1 的整数。</li><li>`minimum_purchase_type` 为 `SUBTOTAL` 时，需指定大于 0 的浮点数。</li></ul>|
##|minimum_purchase_currency {+条件必填}|string|`minimum_purchase_type` 为 `SUBTOTAL` 时必填。<br><br>最低购买金额的币种。<br><br>枚举值参见<a href="#item-link-discount_currency 或 minimum_purchase_currency 可选值">`discount_currency` 或 `minimum_purchase_currency` 可选值</a>。|
##|valid_start_time|string|促销码或优惠的有效期起始时间（UTC+0），格式为 `YYYY-MM-DD HH:MM:SS`。|
##|valid_end_time|string|促销码或优惠的有效期结束时间（UTC+0），格式为 `YYYY-MM-DD HH:MM:SS`。<br><br><ul><li>`valid_end_time` 需晚于当前时间。</li><li>若指定了 `valid_end_time`，需同时传入 `valid_start_time`。</li></ul>|
|card_list|object[]| 创意素材包 ID 列表。<br><br>数量范围：0-1。|
#|card_id|string|创意素材包 ID。<br><br>传入以下类型的创意素材包的 ID：<ul><li>展示卡片（又称图片卡片）。</li><li> 网站信息卡片。</li><li>下载卡。</li><li>倒计时贴纸。</li><li>礼品码贴纸。 </li><li>弹出展示（又称福袋）。</li></ul><br>若想创建素材包，可使用 [/creative/portfolio/create/](1739091950439426.html)。<br><ul><li>欲了解如何获取展示卡片、网站信息卡片、下载卡素材包的 ID，请参考[卡片](1749019652141058.html)。</li><li>欲了解如何获取倒计时贴纸或礼品码贴纸素材包的 ID，请参考[贴纸](1749019667506177.html)。</li><li>若想了解如何获取弹出展示素材包的 ID ，请参考[高级创新互动样式](1749019676181505.html)。</li></ul>|
| automatic_add_on_enabled | boolean | 仅当 `web_all_in_one_catalog_status` 为 `OPEN` 时生效。  <br><br>  是否启用创新互动样式的自动选择。  <br><br>  支持的值：`true`，`false`。 <br> 默认值：`false`。  <br><br>  若本字段设置为 `true`，系统将在广告中自动应用最合适的创新互动样式。若想了解具体的设置和要求，可查看[创建 Smart+ 商品库广告](https://business-api.tiktok.com/portal/docs?id=1814122471133186#item-link-%E5%88%9B%E5%BB%BA%20Smart+%20%E5%95%86%E5%93%81%E5%BA%93%E5%B9%BF%E5%91%8A)中的详细说明。 |
|page_list|object[]|页面 ID 列表。 <br><br>数量范围：0-1。|
#|page_id |string|页面 ID。<br><br><ul><li>若想获取您的广告账号中的页面，可使用[/page/get/](1820826387779586.html)。</li><li>若想创建即时体验页面，可使用[即时体验页面编辑器](1740307202170881.html)。</li></ul>|
|deeplink_type|string|深度链接类型。<br><br>目前仅支持`DEFERRED_DEEPLINK`。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您传入了本字段，则需同时传入`deeplink`字段。|
|deeplink|string|深度链接：用户下载应用后点击链接跳转至的特定页面。 <br><br><p><span style="color:darkred"><b>注意</b></span>：若您传入了本字段，则需同时传入`deeplink_type`字段。 |
|landing_page_urls|object[]|落地页 URL 列表。<br>本字段有以下两种使用模式。<br><ul><li> 单落地页模式：<br>  此模式下，所有的视频/TikTok帖子使用同一个落地页URL。当您使用单落地页模式创建推广系列时，本字段数量范围为 0-1。另外，您无需在此对象数组中指定`video_id`和`tiktok_item_id`。</li><li> 多落地页模式：<br>  此模式仅当`objective_type`为 `WEB_CONVERSIONS`，`promotion_type` 为 `WEBSITE`且 `spc_type` 为 `UNSET` 或未传入 `spc_type`时可用。此模式下，每个视频都对应一个落地页URL。当您使用多落地页模式创建推广系列时，本字段数量范围为为0-30，且长度必须与视频数量相同。例如，若您的推广系列包含三个视频（即`media_info_list`中包含三个对象），您必须在`landing_page_urls`中指定三个对象。另外，您还需要在创建非Spark Ad时指定`video_id`，或在创建Spark Ad时指定`tiktok_item_id`。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：多落地页模式目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。|
#|landing_page_url{+条件必填}|string|传入`landing_page_urls` 时本字段必填。<br> <br> 落地页 URL。|
#|video_id{+条件必填}|string|<ul><li> 当使用多落地页模式且创建非 Spark Ad 推广系列时，本字段必填。</li><li>当使用单落地页模式创建推广系列时，无需指定本字段。</li></ul><br>视频 ID。<br><br>传入您在`video_info`中指定的`video_id`。|
#|tiktok_item_id{+条件必填}|string|<ul><li> 当使用多落地页模式且创建 Spark Ad推广系列时，本字段必填。</li><li>当使用单落地页模式创建推广系列时，无需指定本字段。</li></ul><br>用作 Spark Ad 的 TikTok 视频 ID。<br><br>传入您在`media_info`中指定的`tiktok_item_id`。|
|impression_tracking_url|string|默认展示监测 URL。由数据合作伙伴生成的 URL，用于跟踪广告中的展示事件。 您一般可以在合作伙伴的平台上找到此 URL，并可以复制。<ul><li> 若您希望监测的应用（即广告组层级设置的`app_id`）的合作伙伴ID<strong>是</strong>`44` （TikTok Business SDK）或 `49`（TikTok App API），则您不需要传入本字段。若传入本字段，则将忽略本字段。您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 或 [/app/info/](https://ads.tiktok.com/marketing_api/docs?id=1740859272887297)返回的`partner_id`字段获取应用的合作伙伴ID。</li><li>若您希望监测的应用（即广告组层级设置的`app_id` ）已开启自归因，且其合作伙伴ID<strong>不是</strong>`44`（TikTok Business SDK）或 `49`（TikTok App API），则您同样不需要传入本字段，因为本字段将默认设置为您为应用配置的默认展示监测 URL，且该URL不支持更新。您可通过 [/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 或 [/app/info/](https://ads.tiktok.com/marketing_api/docs?id=1740859272887297)返回的`self_attribution_enabled`字段查看应用是否已开启自归因。</li></ul>|
|click_tracking_url|string|点击监测URL。由数据合作伙伴生成的 URL，用于跟踪广告中的点击事件。 您通常可以在合作伙伴的平台上找到此 URL，并可以复制。<ul><li>若您希望监测的应用（即广告组层级设置的`app_id` ）的合作伙伴ID<strong>是</strong>`44`（TikTok Business SDK）或 `49`（TikTok App API），则您不需要传入本字段。若传入本字段，则将忽略本字段。您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 或[/app/info/](https://ads.tiktok.com/marketing_api/docs?id=1740859272887297)返回的`partner_id`字段获取应用的合作伙伴ID。</li><li>若您希望监测的应用（即广告组层级设置的`app_id` ）已开启自归因，且其合作伙伴ID<strong>不是</strong>`44`（TikTok Business SDK）或 `49`（TikTok App API），则您同样不需要传入本字段，因为本字段将默认设置为您为应用配置的点击监测URL，且该URL不支持更新。您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 或[/app/info/](https://ads.tiktok.com/marketing_api/docs?id=1740859272887297)返回的`self_attribution_enabled`字段查看应用是否已开启自归因。</li></ul><p><span style="color:darkred"><b>注意</b></span> 若您的应用信息中已包含点击监测 URL，则无法更新`click_tracking_url`。|

discount_currency 或 minimum_purchase_currency 可选值

下表列出了 discount_currency 或 minimum_purchase_currency 的枚举值。

| <code>discount_currency</code><br> 或 <code>minimum_purchase_currency</code> 的值 {35%} | 币种 {65%} |
|---|---|
| `AED` | 阿联酋迪拉姆 |
| `ARS` | 阿根廷比索 |
| `AUD` | 澳元 |
| `BDT` | 孟加拉塔卡 |
| `BHD` | 巴林第纳尔 |
| `BOB` | 玻利维亚玻利维亚诺 |
| `BRL` | 巴西雷亚尔 |
| `BYN` | 白俄罗斯卢布 |
| `CAD` | 加拿大元 |
| `CHF` | 瑞士法郎 |
| `CLP` | 智利比索 |
| `CNY` | 人民币 |
| `COP` | 哥伦比亚比索 |
| `CRC` | 哥斯达黎加克朗 |
| `CZK` | 捷克克郎 |
| `DKK` | 丹麦克朗 |
| `DZD` | 阿尔及利亚第纳尔 |
| `EGP` | 埃及镑 |
| `EUR` | 欧元 |
| `GBP` | 英镑 |
| `GTQ` | 危地马拉格查尔 |
| `HKD` | 港元 |
| `HNL` | 洪都拉斯伦皮拉 |
| `HUF` | 匈牙利福林 |
| `IDR` | 印度尼西亚卢比 |
| `ILS` | 以色列新谢克尔 |
| `INR` | 印度卢比 |
| `IQD` | 伊拉克第纳尔 |
| `ISK` | 冰岛克朗 |
| `JOD` | 约旦第纳尔 |
| `JPY` | 日元 |
| `KES` | 肯尼亚先令 |
| `KHR` | 柬埔寨瑞尔 |
| `KRW` | 韩元 |
| `KWD` | 科威特第纳尔 |
| `KZT` | 哈萨克斯坦坚戈 |
| `LBP` | 黎巴嫩镑 |
| `LKR` | 斯里兰卡卢比 |
| `MAD` | 摩洛哥迪拉姆 |
| `MOP` | 澳门元 |
| `MXN` | 墨西哥比索 |
| `MYR` | 马来西亚令吉 |
| `NGN` | 尼日利亚奈拉 |
| `NIO` | 尼加拉瓜科多巴 |
| `NOK` | 挪威克朗 |
| `NZD` | 新西兰元 |
| `OMR` | 阿曼里亚尔 |
| `PEN` | 秘鲁新索尔 |
| `PHP` | 菲律宾比索 |
| `PKR` | 巴基斯坦卢比 |
| `PLN` | 波兰兹罗提 |
| `PYG` | 巴拉圭瓜拉尼 |
| `QAR` | 卡塔尔里亚尔 |
| `RON` | 罗马尼亚列伊 |
| `RSD` | 塞尔维亚第纳尔 |
| `RUB` | 俄罗斯卢布 |
| `SAR` | 沙特里亚尔 |
| `SEK` | 瑞典克朗 |
| `SGD` | 新加坡元 |
| `THB` | 泰铢 |
| `TRY` | 土耳其里拉 |
| `TWD` | 新台币 |
| `UAH` | 乌克兰格里夫纳 |
| `USD` | 美元 |
| `UYU` | 乌拉圭比索 |
| `VEF` | 委内瑞拉玻利瓦尔 |
| `VND` | 越南盾 |
| `ZAR` | 南非兰特 |

示例

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "operation_status": "ENABLE",
    "objective_type": "APP_PROMOTION",
    "app_promotion_type": "APP_INSTALL",
    "campaign_type": "REGULAR_CAMPAIGN",
    "campaign_name": "{{campaign_name}}",
    "promotion_type": "APP_ANDROID",
    "app_id": "{{app_id}}",
    "placement_type": "PLACEMENT_TYPE_AUTOMATIC",
    "location_ids": [
        "6252001"
    ],
    "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "INSTALL",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "identity_type": "CUSTOMIZED_USER",
    "identity_id": "{{identity_id}}",
    "media_info_list": [
        {
            "media_info": {
                "video_info": {
                    "video_id": "{{video_id}}",
                    "file_name": "{{file_name}}"
                },
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ]
            }
        }
    ],
    "title_list": [
        {
            "title": "{{title}}"
        }
    ],
    "call_to_action_id": "{{call_to_action_id}}"
}'
(/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。|
#|operation_status|string|广告创建时的启用/关闭状态。<br><br>枚举值：<ul><li>`ENABLE`：广告创建时处于启用状态。</li><li>`DISABLE`：广告创建时处于未启用状态。</li></ul>|
#|campaign_secondary_status|string|广告状态（二级状态）。<br><br>枚举值见[枚举值-二级状态](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br>对应[/campaign/get/](https://ads.tiktok.com/marketing_api/docs?id=1739315828649986)接口返回的`secondary_status`。|
#|is_smart_performance_campaign|boolean|是否为自动化类型的推广系列。<br><br>支持的值：<ul><li>`true`：推广系列为 Smart+ 推广系列或智能效果网站推广系列。</li><li>`false`：推广系列为普通类型的推广系列。 </li></ul><br><p><span style="color:darkred"><b>注意</b></span>：若`is_smart_performance_campaign` 为 `true` 且 `objective_type` 为 `WEB_CONVERSIONS`，您可根据返回的`spc_type`查看该网站推广系列为 Smart+ 网站推广系列还是智能效果网站推广系列。|
#|objective_type|string| 推广目标。<br><br>目前仅支持`APP_PROMOTION`、`WEB_CONVERSIONS` 和 `LEAD_GENERATION`。 |
#| spc_type| string | 网站推广系列类型。<br><br> 枚举值： <ul><li>`WEB_ALL_IN_ONE`：Smart+ 网站推广系列，支持的优化目标包括转化、价值、点击和落地页浏览量。</li><li>`UNSET`：智能效果网站推广系列，支持的优化目标仅包括转化、价值和点击。</li></ul>|
#| web_all_in_one_catalog_status | string | Smart+ 网站推广系列中的商品库状态。<br><br> 枚举值： <ul><li> `OPEN`：启用。</li><li>`UNSET`：未启用。</li></ul>|
#|app_promotion_type|string|应用推广类型。<br><br>目前仅支持`APP_INSTALL`。|
#|virtual_objective_type|string|新推广目标类型。<br><br>枚举值：`SALES`。<br><br>使用本字段创建推广目标为销量的推广系列，该目标合并了网站转化量目标和商品销量目标。了解销量目标的详情，参见[销量目标](https://business-api.tiktok.com/portal/docs?id=)。|
#|sales_destination|string|销售目标页面，即想要推动销售的渠道。<br><br>枚举值：<ul><li>`WEBSITE`：网站。推动网站上的销售。</li></ul>|
#|campaign_type|string|推广系列类型。<br><br>目前支持`REGULAR_CAMPAIGN`和`IOS14_CAMPAIGN`。|
#|campaign_app_profile_page_state|string|下载中间页使用情况。<br><br>枚举值：`INVALID`，`UNSET`，`ON`，`OFF`。|
#| is_advanced_dedicated_campaign| boolean | 该推广系列是否为高级专属推广系列。高级专属推广系列采用捕捉实时信号的高级投放模型。<br><br>枚举值：`true`，`false`。 |
#| disable_skan_campaign | boolean | 是否关闭 SKAN（SKAdNetwork）归因（Apple 针对 iOS 推广系列的转化归因解决方案）。<br><br>枚举值：<ul><li>`true`：关闭 SKAN 归因。推广系列将不受[专属推广系列配额限制](1752256248260610.html)的约束，您可为此推广系列拉取[自归因平台（SAN）指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-自归因平台指标)数据。但是，不支持为此推广系列拉取 [SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。了解[自归因平台集成](https://ads.tiktok.com/help/article/about-self-attribution-transition)的详情。</li><li>`false`：启用 SKAN 归因。推广系列将受[专属推广系列配额限制](1752256248260610.html)的约束，您可为此推广系列拉取 [SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。</li></ul> |
#| bid_align_type | string | 专属推广系列的归因类型。此类型决定设置的目标 CPA （`conversion_bid_price`） 或目标 ROAS（`roas_bid`） 基于的归因网络类型。<br><br>枚举值：<ul><li>`SAN`：自归因平台归因。</li><li>`SKAN`：SKAN 归因。</li></ul> |
#|campaign_name|string|推广系列名称。|
#|special_industries|string[]| 广告分类。<br><br> 枚举值：<ul><li>`HOUSING`: 房地产，房屋保险，抵押贷款或相关的广告。</li><li>`EMPLOYMENT`: 工作机会，实习机会，职业认证项目或相关的广告。</li><li>`CREDIT`: 信用卡申请，汽车贷款，长期融资或相关的广告。</li></ul>|
#|adgroup_secondary_status|string|广告组状态（二级状态）。<br><br>枚举值参见[枚举值-二级状态](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br>对应[/adgroup/get/](https://ads.tiktok.com/marketing_api/docs?id=1739315828649986)接口返回的`secondary_status`。|
#| product_source | string | 商品来源，即您要推广的商品的来源。<br><br> 枚举值：`CATALOG`（商品库）。 |
#| catalog_id | string | Smart+ 商品库广告中要使用的商品库的 ID。 |
#| catalog_authorized_bc_id | string | 商品库（`catalog_id`）所属的商务中心的 ID。 |
#| product_specific_type | string | 选择商品的维度。<br><br>  枚举值： <ul><li>`ALL`：允许 TikTok 从所有商品中动态选择。</li><li>`PRODUCT_SET`：请选择一个商品系列。TikTok 将动态选择该商品系列中的商品。</li><li>`CUSTOMIZED_PRODUCTS`：选择自定义数量的特定商品。</li></ul>|
#| product_set_id | string | 商品系列 ID。 |
#| product_ids | string[] | 商品库商品的商品 ID 列表。 |
#|promotion_type|string|推广对象类型（优化位置）。您可以使用该字段决定在哪里投放广告。<br><br>枚举值情见[枚举值-推广对象类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#| app_id | string | 推广的应用的 ID。<br><br>您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786)获取`app_id`。|
#|app_type|string|推广的应用的的类型。<br><br>目前仅支持`APP_ANDROID`和`APP_IOS`。|
#|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|广告使用的优化目标。枚举值详见[枚举值-优化目标](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138).|
#|pixel_id|string|Pixel ID。仅对落地页生效。|
#|optimization_event|string|广告组转化事件。<br><br>详情见[转化事件](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)。|
#| 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`。   |
#|bid_type|string|竞价策略。<br><br>详见[枚举值-出价策略](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-出价策略)。|
#| bid_price | float | 目标平均点击成本。系统将会把平均成效成本保持在指定值的同时尽可 能取得最多成效。 |
#| conversion_bid_price | float | 目标平均转化或落地页浏览量成本。系统将会把平均成效成本保持在指定值的同时尽可能取得最多成效。 |
#| deep_bid_type|string|深度事件出价类型。<br><br>详见[枚举值-深度事件出价类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-深度事件出价类型)。|
#| roas_bid | float | 价值优化的目标 ROAS。 |
#|incentive_offer_type|string|此 Smart+ 推广系列适用的激励优惠类型。<br><br>如果推广系列符合资格条件，但未达到特定 CPA 或最低 ROAS 阈值，您将收到给投放该推广系列的广告账号发放的广告赠款，以补偿一部分差额。<br><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 | 为[广告收入价值优化](1739381743067137.html)或[应用内购价值优化](1739381743067137.html)指定的竞价策略的时间窗口期。 <br><br>枚举值： <ul><li>`SEVEN_DAYS`：前 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></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|计费事件。枚举值详见[枚举值-计费事件](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|location_ids|string[]|您想要定向的地域 ID 列表。<br><br>您可以通过[获取可投放地域](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)查询您可以投放的地区。|
#|languages|string[]|受众语言。<br><br>欲了解支持的语言代码列表，请参阅[枚举值-受众语言](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-语言代码)。|
#|gender|string|定向受众性别。<br><br>枚举值: `GENDER_FEMALE`，`GENDER_MALE`，`GENDER_UNLIMITED`。|
#|exclude_age_under_eighteen|boolean|是否排除十八岁以下受众。|
#|spc_audience_age| string | 该推广系列定向的年龄区间。<br><br> 枚举值：<ul><li>`18+`: 18+.</li><li>`25+`: 25+.</ul> |
#|excluded_audience_ids|string[]|排除的受众 ID 列表。|
#|placement_type|string|版位（广告位）类型。<br><br>目前仅支持`PLACEMENT_TYPE_AUTOMATIC`和`PLACEMENT_TYPE_NORMAL`。|
#|placements|string[]|投放版位。<br><br>目前仅支持`PLACEMENT_TIKTOK`和`PLACEMENT_PANGLE`。|
#|comment_disabled|boolean|是否允许用户在 TikTok 上评论您的广告。|
#|share_disabled|boolean|本广告组中的广告是否禁止分享到第三方平台。|
#|video_download_disabled|boolean|用户是否可以在 TikTok 上下载您的广告视频。|
#|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-品牌安全中心)配置自动应用。若要检索广告账户这些设置的详情，可使用[/TikTok_inventory_filters/get/](1830112550443073.html)。 |
#| category_exclusion_ids | string[] | 不希望在该 Smart+ 推广系列前后显示的内容排除类别 ID 列表。<br><br>若想根据类别 ID 获取内容排除类别的详细信息，可使用[/tool/content_exclusion/info/](1769738105333826.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>: 该设置将根据您的[品牌安全中心](https://business-api.tiktok.com/portal/docs?id=1739381752981505#item-link-品牌安全中心)配置自动应用。若要检索广告账户这些设置的详情，可使用[/TikTok_inventory_filters/get/](1830112550443073.html)。 |
#|budget_mode |string| 预算类型。<br><br> 枚举值详见[枚举值-预算类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-预算类型)。 |
#| budget_auto_adjust_strategy | string | `budget_mode` 为`BUDGET_MODE_DYNAMIC_DAILY_BUDGET` 时返回本字段。<br><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> |
#| budget | float | 固定推广系列预算或初始推广系列预算。<br><ul><li>`budget_auto_adjust_strategy` 为 `UNSET` 时，本字段代表固定推广系列预算。</li><li>`budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，本字段代表初始推广系列预算。若想获取当前推广系列预算，可查看返回的`current_budget`。</li></ul> |
#| current_budget | float | `budget_mode` 为`BUDGET_MODE_DYNAMIC_DAILY_BUDGET` 时返回本字段。<br>启用了自动增加预算的推广系列的当前预算。 |
#|scheduled_budget|float|表示隔日预算值。若是非0则表示设置了隔日预算并表示了隔日预算的数值；若是为0则表示未设置隔日预算。|
#|schedule_type|string|广告投放计划类型。|
#|schedule_start_time|string|广告投放起始时间，格式为`YYYY-MM-DD HH:MM:SS`（UTC+0）。|
#|schedule_end_time|string|广告投放结束时间，格式为`YYYY-MM-DD HH:MM:SS`（UTC+0）。|
#|dayparting|string|广告投放安排。格式为48x7的字符串。字符只能为0或者1。0代表不投放，1代表投放。每个字符对应一个30分钟的时间段。第一个字符对应的是周一的凌晨0:01-0:30，第二个字符对应0:31-1:00，依次类推。最后一个字符代表周日23:31-0:00。<br><br><p><span style="color:darkred"><b>注意</b></span>：不设置，全部设置为0，或者全部都设置为1都代表了要进行全时投放。|
#|skip_learning_phase|boolean|是否跳过学习阶段。|
#|identity_type |string|不使用 Spark Ads 时的认证身份类型。<br><br>枚举值：`CUSTOMIZED_USER`。|
#|identity_id |string|不使用 Spark Ads 时的认证身份 ID。|
#|app_download_url|string|应用下载链接。|
#|app_name|string|应用名称。|
#|media_info_list|object[]|媒体信息列表。|
##|media_info |object|媒体信息。|
###|video_info |object|视频信息。|
####|video_id |string|视频 ID。 |
####|file_name|string|视频名称。|
###|image_info |object[]|图片信息。  |
####|web_uri|string|图片 ID。|
###| music_info | object | 音乐信息。 |
####| music_id | string | 用于自动生成的商品库轮播广告的音乐的 ID。 |
###| aigc_disclosure_type | string | 是否启用 AI 生成内容自主声明开关，以表明广告中包含 AI 生成内容。启用该开关后，当用户查看完整广告时，您的广告将带有“广告主标记为 AI 生成”的标签。<br><br>枚举值：<ul><li>`SELF_DISCLOSURE`：启用开关，声明广告包含 AI 生成内容。</li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。</li></ul> |
###|tiktok_item_id|string|用作 Spark Ads 的 TikTok 视频 ID。|
###|identity_type |string|使用 Spark Ads 时的认证身份类型。<br><br> 枚举值：`AUTH_CODE`（授权用户）， `TT_USER`（TikTok 用户），`BC_AUTH_TT`（添加到商务中心的 TikTok 用户）。<br><br> 若想了解认证身份的详情，请查看[认证身份](1738958351620097.html)。 |
###|identity_id |string|使用 Spark Ads 时的认证身份 ID。|
###| identity_authorized_bc_id | string | 当 `identity_type` 为 `BC_AUTH_TT` 时返回本字段。<br><br>与添加到商务中心的 TikTok 用户这一类型认证身份绑定的商务中心的 ID。 |
#|dark_post_status |string|素材的“只在广告中显示”模式的状态。<br><br>枚举值：<ul><li>`ON`: 启用“只在广告中显示”模式，仅获得付费流量。</li><li>`OFF`: 不启用“只在广告中显示”模式。帖子将发布到关联的 TikTok 账号主页，且将可以获得自然流量。</li></ul>|
#| catalog_creative_toggle | boolean | 是否启用商品库素材的自动选择。<br><br>  支持的值：`true`，`false`。 <br><br> 若本字段设置为 `true`，系统将使用可用的广告样式（商品库视频、商品库轮播和单视频）自动生成广告。 |
#|title_list|object[]|广告文案列表。广告文案作为您的广告素材一部分向受众展示，传递您想传达的信息。|
##|title |string|广告文案。|
#|call_to_action_id|string|行动引导文案素材包 ID。|
#|call_to_action_list|object[]|行动引导文案列表。|
##|call_to_action|string|行动引导文案。<br><br>枚举值见[枚举值-行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-行动引导文案)。|
#|product_info|object|额外添加的商品信息。此信息将用于创建广告变体，帮助您达成推广目标，例如脱颖而出、建立信任或改善效果。|
##|promo_info_list|object[]|仅对[普通 Smart+ 网站推广系列](https://business-api.tiktok.com/portal/docs?id=1814122471133186#item-link-%E5%88%9B%E5%BB%BA%E6%99%AE%E9%80%9A%20Smart+%20%E7%BD%91%E7%AB%99%E6%8E%A8%E5%B9%BF%E7%B3%BB%E5%88%97)生效。<br><br>促销码或优惠详情。<br>促销码和优惠有助于提升广告成效。请确保促销码和优惠处于有效状态、信息准确且可在结账时立即使用。|
###|discount_type|string|指定 `promo_info_list` 时返回本字段。<br><br>折扣类型。<br><br>枚举值：<ul><li>`PERCENTAGE`：百分比折扣。</li><li>`CASH`：现金折扣。</li></ul>|
###|discount_value|string|指定 `promo_info_list` 时返回本字段。<br><br>折扣数值。<br><br><ul><li>`discount_type` 为 `PERCENTAGE` 时，本字段为 1 和 100 之间的整数。</li><li>`discount_type` 为 `CASH` 时，本字段为大于 0 的浮点数。</li></ul>|
###|discount_currency|string|`discount_type` 为 `CASH` 时返回本字段。<br><br>折扣金额。<br><br>枚举值参见 <a href="#item-link-discount_currency 或 minimum_purchase_currency 可选值">`discount_currency` 或 `minimum_purchase_currency` 可选值</a>。|
###|minimum_purchase_type|string|最低购买要求类型。<br><br>枚举值：<ul><li>`QUANTITY`：最低购买数量。</li><li>`SUBTOTAL`：最低购买金额。</li></ul>|
###|minimum_purchase_value |float|指定 `minimum_purchase_type` 时返回本字段。<br><br>最低购买数值。<br><br><ul><li>`minimum_purchase_type` 为 `QUANTITY` 时，本字段为大于等于 1 的整数。</li><li>`minimum_purchase_type` 为 `SUBTOTAL` 时，本字段为大于 0 的浮点数。</li></ul>|
###|minimum_purchase_currency|string|`minimum_purchase_type` 为 `SUBTOTAL` 时返回本字段。<br><br>最低购买金额的币种。<br><br>枚举值参见<a href="#item-link-discount_currency 或 minimum_purchase_currency 可选值">`discount_currency` 或 `minimum_purchase_currency` 可选值</a>。|
###|valid_start_time|string|促销码或优惠的有效期起始时间（UTC+0），格式为 `YYYY-MM-DD HH:MM:SS`。|
###|valid_end_time|string|促销码或优惠的有效期结束时间（UTC+0），格式为 `YYYY-MM-DD HH:MM:SS`。|
#|card_list|object[]|创意素材包 ID 列表。|
##|card_id|string|创意素材包 ID。|
#| automatic_add_on_enabled | boolean | 是否启用创新互动样式的自动选择。 <br><br> 支持的值：`true`，`false`。 <br><br>  若本字段设置为 `true`，系统将在广告中自动应用最合适的创新互动样式。 |
#|page_list|object[]|页面 ID 列表。|
##|page_id |string|页面 ID。|
#|deeplink_type|string|深度链接类型。|
#|deeplink|string|深度链接，用户下载应用后点击链接跳转至的特定页面。 |
#|landing_page_urls|object[]|落地页 URL 列表。|
##|landing_page_url|string|落地页 URL。|
##|video_id|string|当推广系列使用多落地页模式时返回。<br><br>视频 ID。|
##|tiktok_item_id|string|当推广系列使用多落地页模式时返回。<br><br>用作 Spark Ads 的 TikTok 帖子 ID。|
#|impression_tracking_url|string|默认展示监测 URL。|
#|click_tracking_url|string|点击监测 URL。|
#|create_time|string|推广系列的创建时间，格式为`YYYY-MM-DD HH:MM:SS`（UTC+0）。|
#|modify_time|string|推广系列的修改时间，格式为`YYYY-MM-DD HH:MM:SS`（UTC+0）。|

示例

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "pixel_id": null,
        "carousel_image_index": null,
        "deeplink": "",
        "adgroup_secondary_status": "ADGROUP_STATUS_AUDIT",
        "gender": "GENDER_UNLIMITED",
        "special_industries": null,
        "location_ids": [
            "6252001"
        ],
        "schedule_end_time": "{{schedule_end_time}}",
        "excluded_audience_ids": null,
        "shopping_ads_fallback_type": null,
        "promotion_type": "APP_ANDROID",
        "product_ids": null,
        "automatic_add_on_enabled": null,
        "budget": {{budget}},
        "skip_learning_phase": true,
        "impression_tracking_url": null,
        "share_disabled": false,
        "deep_bid_type": "DEFAULT",
        "engaged_view_attribution_window": "SEVEN_DAYS",
        "conversion_bid_price": null,
        "is_advanced_dedicated_campaign": false,
        "promotion_website_type": null,
        "schedule_type": "SCHEDULE_START_END",
        "attribution_event_count": "ONCE",
        "campaign_app_profile_page_state": "UNSET",
        "product_set_id": null,
        "roas_bid": null,
        "call_to_action_id": "{{call_to_action_id}}",
        "app_promotion_type": "APP_INSTALL",
        "languages": [],
        "is_smart_performance_campaign": true,
        "call_to_action_list": [],
        "click_tracking_url": null,
        "modify_time": "{{modify_time}}",
        "bid_price": null,
        "media_info_list": [
            {
                "media_info": {
                    "video_info": {
                        "video_id": "{{video_id}}",
                        "file_name": "{{file_name}}"
                    },
                    "identity_type": null,
                    "aigc_disclosure_type": null,
                    "music_info": null,
                    "tiktok_item_id": null,
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "identity_id": null
                }
            }
        ],
        "catalog_creative_toggle": null,
        "advertiser_id": "{{advertiser_id}}",
        "app_id": "{{app_id}}",
        "identity_type": "CUSTOMIZED_USER",
        "card_list": null,
        "campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "page_list": null,
        "scheduled_budget": 0,
        "bid_type": "BID_TYPE_NO_BID",
        "placements": [
            "PLACEMENT_TIKTOK",
            "PLACEMENT_PANGLE"
        ],
        "app_download_url": "{{app_download_url}}",
        "view_attribution_window": "ONE_DAY",
        "create_time": "{{create_time}",
        "dayparting": 
"111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "product_specific_type": null,
        "catalog_authorized_bc_id": null,
        "schedule_start_time": "{{schedule_start_time}}",
        "comment_disabled": false,
        "campaign_type": "REGULAR_CAMPAIGN",
        "deeplink_type": null,
        "campaign_id": "{{campaign_id}}",
        "product_source": null,
        "blocked_pangle_app_ids": null,
        "carousel_image_labels": null,
        "billing_event": "OCPM",
        "campaign_name": "{{campaign_name}}",
        "app_name": "{{app_name}}",
        "optimization_goal": "INSTALL",
        "video_download_disabled": false,
        "operation_status": "ENABLE",
        "click_attribution_window": "SEVEN_DAYS",
        "title_list": [
            {
                "title": "{{title}}"
            }
        ],
        "landing_page_urls": null,
        "spc_audience_age": "18+",
        "app_type": "APP_ANDROID",
        "spc_type": "UNSET",
        "web_all_in_one_catalog_status": null,
        "optimization_event": "ACTIVE",
        "objective_type": "APP_PROMOTION",
        "placement_type": "PLACEMENT_TYPE_AUTOMATIC",
        "exclude_age_under_eighteen": true,
        "identity_id": "{{identity_id}}",
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "catalog_id": null
    }
}
(/code)
← （即将废弃）旧版 Smart+ 推广系列报表指标(To be deprecated) Disable or enable creatives in a Legacy Smart+ Campaign →

内容来源：TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了？
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →