← 返回目录
📁 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+ 接口下线延期申请表单提交申请。
      1. 白名单处理：收到申请后，我们将为您的开发者应用 ID 处理白名单准入。提交延长申请表单的开发者可继续调用 /campaign/spc/create/ 接口至 2026 年 6 月 30 日。
      1. 特殊情况申请：若您有强烈的业务需求，需要在 2026 年 6 月 30 日后继续使用该接口，请直接在表单中说明具体情况，或者与您的销售代表单独联系。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/campaign/spc/get/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。获取详细信息，请参考[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|campaign_ids {必填}|string[]| 推广系列 ID 列表。<br><br>最大数量：100。|

示例

(code curl http)
curl -H "Access-Token:{{Access-Token}}" -H "Content-Type:application/json" -X GET \
-d '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_ids": ["{{campaign_ids}}"]
}' \
https://business-api.tiktok.com/open_api/v1.3/campaign/spc/get/
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述，可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息。更多信息可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id| string| 请求的日志ID，唯一标识一个请求。|
|data |object|返回数据。|
#| list |object[]| Smart+ 推广系列或智能效果网站推广系列列表。|
##|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>举值：`18+`，`25+`。<br><br><ul><li>对于推广目标为 `LEAD_GENERATION` 的推广系列（Smart+ 线索收集推广系列），本字段的值为`18+` 或 `25+`。</li><li>对于推广目标为 `APP_PROMOTION`的推广系列（Smart+ 应用推广系列）或`WEB_CONVERSIONS` 的推广系列（Smart+ 网站推广系列或智能效果网站推广系列），本字段的值固定为 `18+`。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：目前，不支持通过 API 创建 Smart+ 线索收集推广系列。若想筛选您的广告账号中存量的 Smart+ 线索收集推广系列，可调用[/campaign/get/](1739315828649986.html) 并将`filtering`设置为  `&#123;"objective_type":"LEAD_GENERATION", "is_smart_performance_campaign": true&#125;`。 |
##|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>枚举值参见 [`discount_currency` 或 `minimum_purchase_currency` 可选值](https://business-api.tiktok.com/portal/docs?id=1767334204047362#item-link-discount_currency%20%E6%88%96%20minimum_purchase_currency%20%E5%8F%AF%E9%80%89%E5%80%BC)。|
####|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>枚举值参见 [`discount_currency` 或 `minimum_purchase_currency` 可选值](https://business-api.tiktok.com/portal/docs?id=1767334204047362#item-link-discount_currency%20%E6%88%96%20minimum_purchase_currency%20%E5%8F%AF%E9%80%89%E5%80%BC)。|
####|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": {
        "list": [        
       { "campaign_id": "{{campaign_id}}",
        "advertiser_id": "{{advertiser_id}}",
        "app_id": "{{app_id}}",
        "pixel_id": null,
        "app_type": "APP_ANDROID",
        "objective_type": "APP_PROMOTION",
        "campaign_name": "{{campaign_name}}",
        "is_smart_performance_campaign": true,
        "operation_status": "ENABLE",
        "campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "adgroup_secondary_status": "ADGROUP_STATUS_CREATE",
        "campaign_type": "REGULAR_CAMPAIGN",
        "app_promotion_type": "APP_INSTALL",
        "optimization_goal": "CLICK",
        "bid_type": "BID_TYPE_NO_BID",
        "deep_bid_type": null,
        "skip_learning_phase": null,
        "budget": {{budget}},
        "budget_mode": "BUDGET_MODE_DAY",
        "scheduled_budget": {{scheduled_budget}},
        "promotion_type": "APP_ANDROID",
        "optimization_event": "ACTIVE",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "promotion_website_type": null,
        "comment_disabled": true,
        "share_disabled": true,
        "video_download_disabled": true,
        "location_ids": [
            "{{location_ids}}"
        ],
        "languages": [
            "{{languages}}"
        ],
        "exclude_age_under_eighteen": false,
        "excluded_audience_ids": null,
        "blocked_pangle_app_ids": null,
        "special_industries": null,
        "schedule_type": "SCHEDULE_FROM_NOW",
        "schedule_start_time": "2024-04-17 22:00:00",
        "schedule_end_time": "2034-04-15 22:00:00",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "billing_event": "CPC",
        "app_download_url": "{{app_download_url}}",
        "app_name": "{{app_name}}",
        "call_to_action_id": null,
        "call_to_action_list": [
            {
                "call_to_action": "INSTALL_NOW"
            },
            {
                "call_to_action": "DOWNLOAD_NOW"
            }
        ],
        "media_info_list": [
            {
                "media_info": {
                    "video_info": {
                        "video_id": "{{video_id}}",
                        "file_name": "{{file_name}}"
                    },
                    "identity_id": null,
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "identity_type": null,
                    "tiktok_item_id": null
                }
            }
        ],
        "title_list": [
            {
                "title": "{{title}}"
            },
            {
                "title": "{{title}}"
            }
        ],
        "page_list": null,
        "card_list": null,
        "landing_page_urls": null,
        "deeplink": "{{deeplink}}",
        "deeplink_type": "DEFERRED_DEEPLINK",
        "identity_id": "{{identity_id}}",
        "identity_type": "CUSTOMIZED_USER",
        "impression_tracking_url": null,
        "click_tracking_url": "{{click_tracking_url}}",
        "create_time": "{{create_time}}",
        "modify_time": "{{modify_time}}"
        }
      ]    
    }
}
(/code)
← （即将废弃）更新旧版 Smart+ 推广系列（即将废弃）获取投放中旧版 Smart+ 推广系列的动态配额 →

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