← 返回目录
📁 API Reference › Upgraded Smart+ › Ads

创建升级版 Smart+ 广告

此接口可用于创建升级版 Smart+ 广告。

目前，最多仅能在升级版 Smart+ 广告组中创建 30 个广告。

重要提示
对于现有广告账号，如果广告组采用自动广告位或选择的广告位包含 TikTok 时，不再支持使用自定义身份创建非 Spark Ads。2026 年 1 月 15 日及以后新建的所有广告账号，都无法使用自定义身份创建投放到这些广告位的非 Spark Ads。现有广告不受影响且可修改。仅投放到 Pangle 或全球化应用组合广告位的推广系列不受自定义身份功能停用的影响。详细了解即将变更的自定义身份功能和迁移至 Spark Ads。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/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。|
|adgroup_id {必填}|string|广告组 ID。<br><br>若想获取广告组 ID，需使用 [/smart_plus/adgroup/get/](1843314879617026.html) 接口。|
|ad_name|string|广告名称。<br><br>若想自动生成广告名称，需将此字段设置为 `""`（空字符串）。自动生成的广告名称格式为广告 ID (`ad_id`)。<br><br>长度限制：512，不可包含表情符号。<br>每个中文汉字或日文字符计为两个字符，每个英文字母计为一个字符。|
|operation_status|string|广告创建时的状态。<br><br>枚举值：<ul><li>`ENABLE`：广告创建时处于已启用状态。</li><li>`DISABLE`：广告创建时处于未启用状态。</li></ul>默认值：`ENABLE`。|
|creative_list {+条件必填}|object[]|<ul><li>对于单视频广告、标准轮播和商品库轮播样式，此为必填字段。</li></ul><ul><li>对于多影片样式，无需填写此字段。</li></ul><br>创意列表。<br><br>数量范围：1-50。|
#|creative_info  {+条件必填}|object|当传入 `creative_list` 时，此为必填字段。<br><br>创意信息。|
##|ad_format  {+条件必填}|string|当传入 `creative_info` 时，此为必填字段。<br><br>广告样式。<br><br>枚举值：<ul><li>`SINGLE_VIDEO`：单视频广告。</li><ul><li>若想使用此样式，需传入以下任意一项：<ul><li>通过 `video_id` 传入视频，并通过 `web_uri` 传入视频封面。</li><li>通过 `tiktok_item_id` 传入 TikTok 视频帖子。</li></ul></li></ul><li>`CAROUSEL_ADS`：标准轮播。</li><ul><li>若想使用此样式，需传入以下任意一项：<ul><li>通过 `web_uri` 传入轮播图片，并通过 `music_id` 传入一首音乐。</li><li>通过 `tiktok_item_id` 传入 TikTok 照片帖子图片。</li></ul></li></ul><li>`CATALOG_CAROUSEL`：商品库轮播。<ul><li>若想在升级版 Smart+ 网站商品库轮播广告中使用此样式，需通过 `music_id` 传入一首音乐。</li><li>若想在升级版 Smart+ 汽车商品库轮播广告中使用此样式，需通过 `music_id` 传入一首音乐，并通过 `web_uri` 传入一张片尾卡片。</li></ul></li></ul>|
##|video_info {+条件必填}|object|使用以下广告类型时，此为必填字段：<br><br><ul><li>非 Spark Ads 单视频广告。 </li><li>通过 Spark Ads 推送创建的 Spark Ads 单视频广告。</li></ul><br>视频信息。|
###|video_id {+条件必填}|string|当已指定 `video_info` 时，此为必填字段。<br><br>视频 ID。<br><br>若想上传视频并获取视频 ID，需使用 [/file/video/ad/upload/](1737587322856449.html) 接口。<br>若想搜索广告账号内的视频，需使用 [/file/video/ad/search/](1740050472224769.html) 接口。|
###|file_name|string|视频名称。|
##|image_info {+条件必填}|object[]|<ul><li>使用以下广告类型时，此为必填字段：</li><ul><li>非 Spark Ads 单视频广告。需传入视频封面。</li><li>通过 Spark Ads 推送创建的 Spark Ads 单视频广告。需传入视频封面。</li><li>非 Spark Ads 标准轮播广告。需传入 1-35 张轮播图片。</li><li>通过 Spark Ads 推送创建的 Spark Ads 标准轮播广告。需传入 1-35 张轮播图片。</li><li>[升级版 Smart+ 汽车广告](1843324618421314.html)中的商品库轮播广告。需传入 1 张图片作为片尾卡片图片。</li></ul><li>升级版 Smart+ 网站广告中的商品库轮播广告不支持此字段。</li></ul><br>图片信息。|
###|web_uri {+条件必填}|string|当已指定 `image_info` 时，此为必填字段。<br><br>图片 ID。<br><br>若想上传图片并获取图片 ID，需使用 [/file/image/ad/upload/](1739067433456642.html) 接口。<br>若想搜索广告账号内的图片，需使用 [/file/image/ad/search/](1740052016789506.html) 接口。|
##|music_info {+条件必填}|object|如果属于以下场景，此为必填字段：<br><br><ul><li>创建标准轮播广告时，包括：</li><ul><li>非 Spark Ads 标准轮播广告</li><li>通过 Spark Ads 推送创建的 Spark Ads 标准轮播广告</li><li>通过 Spark Ads 提取创建的 Spark Ads 标准轮播广告</li></ul><li>当 `objective_type` 为 `WEB_CONVERSIONS` 或 `LEAD_GENERATION`，并且 `catalog_creative_toggle` 为 `true` 时。系统将自动生成商品库轮播广告。</li></ul><br>音乐信息。|
###|music_id {+条件必填}|string|当已指定 `music_info` 时，此为必填字段。<br><br>轮播广告中使用的音乐的 ID。|
##|aigc_disclosure_type|string|仅当 `ad_configuration` 中的 `identity_type` 为 `CUSTOMIZED_USER` 时生效。<br><br>是否开启 AIGC（人工智能生成内容）自主披露开关，标注广告包含 AI 生成内容。该开关开启后，当广告以完整形式展示时，将显示“广告主标记为 AI 生成”标签。<br><br>枚举值：<ul><li>`SELF_DISCLOSURE`：开启开关，声明广告包含 AI 生成内容。</li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。</li></ul>默认值：`NOT_DECLARED`。<br><br>如需了解该开关支持的推广目标和广告样式，以及使用该开关的详细步骤，参见 [AI 生成内容自主声明开关](1799186631031809.html)。|
##|tiktok_item_id {+条件必填}|string|<ul><li>通过 Spark Ads 提取创建 Spark Ads 时，此为必填字段，包括：</li><ul><li>通过 Spark Ads 提取创建的 Spark Ads 单视频广告。需传入 TikTok 视频帖子。</li><li>通过 Spark Ads 提取创建的 Spark Ads 标准轮播广告。需传入 TikTok 照片帖子。</li></ul><li>当 `catalog_creative_toggle` 为 `true` 时，不支持此字段。</li></ul><br>作为广告 (Spark Ads) 投放的 TikTok 帖子的 ID。<br><br>传入从 [/tt_video/info/](1738376324021250.html) 和 [/identity/video/get/](1740218475032577.html) 接口的返回结果中获取的 `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，即表示你确认拥有将视频中的音乐用于商业用途的权利。</p>|
##|identity_type {+条件必填}|string|当不使用商品库创意创建 Spark Ads 时必填。<br><br>广告发布身份类型。<br><br>枚举值：`AUTH_CODE`、`TT_USER`、`BC_AUTH_TT`。<br><br>查看[广告发布身份](1738958351620097.html)文档，详细了解广告发布身份。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>若想使用电商商品库中的创意创建 Spark Ads，需在 `ad_configuration` 中传入 `identity_type` 和 `identity_id`。</li><li>如果此字段设置为 `TT_USER`、`BC_AUTH_TT` 或 `AUTH_CODE`，且满足以下两个条件，那么需要通过 `call_to_action_id` 传入动态 CTA。<ul><li>推广系列层级的 `objective_type` 为 `APP_PROMOTION` 或 `WEB_CONVERSIONS`。</li><li>广告组层级的 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC`。</li></ul></li></ul>|
##|identity_id {+条件必填}|string|当不使用商品库创意创建 Spark Ads 时必填。<br><br>广告发布身份 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：若想使用电商商品库中的创意创建 Spark Ads，需在 `ad_configuration` 中传入 `identity_type` 和 `identity_id`。</p>|
##|identity_authorized_bc_id {+条件必填}|string|当 `creative_info` 中的 `identity_type` 为 `BC_AUTH_TT` 时必填。<br><br>与“添加到商务中心的 TikTok 用户”类型广告发布身份关联的商务中心 ID。|
|playable_list|object[]|仅在以下任意场景中生效：<ul><li>场景 1：<ul><li>在推广系列层级，`objective_type` 为 `APP_PROMOTION` 且 `app_promotion_type` 为 `APP_INSTALL`。</li><li>在广告组层级，广告位并非仅限全球化应用组合（`placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 为 `["PLACEMENT_GLOBAL_APP_BUNDLE"]`）。</li><li>在广告层级，`ad_format` 为 `SINGLE_VIDEO`，并传入视频或视频帖子。</li></ul></li><li>场景 2：<ul><li>在推广系列层级，`objective_type` 为 `APP_PROMOTION` 且 `app_promotion_type` 为 `MINIS`。</li><li>在广告组层级：<ul><li>`promotion_type` 为 `MINI_GAME`。</li><li>广告位并非仅限全球化应用组合（`placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 为 `["PLACEMENT_GLOBAL_APP_BUNDLE"]`）。</li></ul></li><li>在广告层级，`ad_format` 为 `SINGLE_VIDEO`，并传入视频或视频帖子。</li></ul></li></ul><br>试玩素材列表。<br><br>最大数量：5。<br><br><p><span style="color:darkred"><b>注意</b></span>：试玩广告目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。|
#|playable_url|string|试玩素材 URL。<ul><li>若想将试玩素材上传到广告账号的创意素材库，并获取试玩素材 URL，参见[上传试玩素材](https://business-api.tiktok.com/portal/docs/upload-playables/v1.3)。</li><li>若想获取广告账号内现有试玩素材的 URL，需使用 [/playable/get/](https://business-api.tiktok.com/portal/docs/get-playable-creatives/v1.3) 接口。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：若想创建仅在 TikTok 广告位上投放的试玩广告（`placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 为 `&#91;"PLACEMENT_TIKTOK"&#93;`），需确保试玩素材不为横版。若想验证试玩素材的方向，需使用 [/playable/get/](https://business-api.tiktok.com/portal/docs/get-playable-creatives/v1.3) 接口并确认 `playable_orientation` 为 `BOTH` 或 `PORTRAIT`。|
|ad_text_list {+条件必填}|object[]|当未指定 `tiktok_item_id` 时，此为必填字段。<br><br>广告文案列表。<br>广告文案作为广告创意的一部分展示给受众，用于传递你希望传达的信息。<br><br>最大数量：5。|
#|ad_text {+条件必填}|string|当已指定 `ad_text_list` 时，此为必填字段。<br><br>广告文案。|
|auto_message_list {+条件必填}|object[]|广告组层级的 `promotion_type` 为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE` 时必填。<br><br>在 TikTok 私信广告中使用的自动消息的详情。<br><br>最大数量：1。|
#|auto_message_id {+条件必填}|string|当传入 `auto_message_list` 时，此为必填字段。<br><br>在 TikTok 私信广告中使用的自动消息的 ID。<br><br>目前唯一支持的自动消息类型是欢迎消息。<ul><li>若想获取广告账号中的欢迎消息列表，需使用 [/creative/auto_message/get/](1822106498804738.html) 接口。</li><li>若想在广告账号内创建欢迎消息，需使用 [/creative/auto_message/create/](1822106113771521.html) 接口。</li></ul><br>如需了解如何创建包含欢迎消息的 TikTok 私信广告，参见[创建以 TikTok 私信作为优化位置的升级版 Smart+ 线索收集推广系列](1847302969710913.html)。|
|call_to_action_list|object[]|行动引导文案列表。<br><br>最大数量：3。<br><br><p><span style="color:darkred"><b>注意</b></span>：在以下任意场景中，此字段不受支持，需改用 `call_to_action_id`。<ul><li>场景 1： <ul><li>在推广系列层级，`objective_type` 为 `LEAD_GENERATION`。</li><li>广告组层级的 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC`。</li></ul></li><li>场景 2： <ul><li>推广系列层级的 `objective_type` 为 `APP_PROMOTION` 或 `WEB_CONVERSIONS`。</li><li>广告组层级的 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC`。</li><li>广告层级的 `creative_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://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Call-to-action)。|
|interactive_add_on_list|object[]|创新互动样式（创意素材包）ID 列表。<br><br>数量范围：0-1。|
#|card_id|string|创新互动样式 ID。<br><br>传入以下任一类型的创意素材包的 ID：<ul><li>展示卡片。</li><li>倒计时贴纸。</li><li>礼品码贴纸。</li><li>库存卡片（适用于[升级版 Smart+ 汽车广告](1843324618421314.html)）。</li></ul><br>若想创建创意素材包，需使用 [/creative/portfolio/create/](1739091950439426.html) 接口。<ul><li>如需了解如何获取展示卡片 ID 或库存卡片素材包 ID，参见[卡片](1749019652141058.html)。</li><li>如需了解如何获取倒计时贴纸 ID 或礼品码贴纸素材包 ID，参见[贴纸](1749019667506177.html)。</li></ul>|
|page_list|object[]|页面列表。<br><br>数量范围：0-3。|
#|page_id|string|页面 ID。<br><br><ul><li>若想获取广告账号内的页面，需使用 [/page/get/](1820826387779586.html) 接口。</li><li>若想创建即时体验页面，需使用[即时体验页面编辑器 SDK](1740307202170881.html)。</li></ul>|
|landing_page_url_list|object[]|落地页 URL 列表。<br><br>数量范围：0-1。|
#|landing_page_url {+条件必填}|string|当已指定 `landing_page_url_list` 时，此为必填字段。<br><br>落地页 URL。|
|custom_product_page_list|object[]|仅当满足以下所有条件时生效：<ul><li>在推广系列层级：<ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_RETARGETING`。</li></ul></li><li>在广告组层级：<ul><li>通过 `app_id` 传入 iOS 应用。</li></ul></li></ul><br>广告中使用的自定产品页面的详细信息。<br><br>数量范围：0-1。|
#|custom_product_page_url|string|自定义商品页 (CPP) URL。<br><br>CPP 是包含自定义截图、宣传文案和应用预览的产品页面，可用于重点展示所推广应用的特定内容或功能，或触达特定受众。只有使用 iOS 15+ 设备的用户能打开自定产品页面。<br><br>CPP URL 必须与广告组层级推广的应用 (`app_id`) 一致。<br><br>格式：`https://apps.apple.com/&#123;region&#125;/app/&#123;app_name&#125;/id&#123;app_id&#125;?ppid=&#123;ppid&#125;`。<br><br>长度限制：512 个字符。<br><br>示例：`https://apps.apple.com/us/app/tiktok/id835599320?ppid=12345a6b-c789-12d3-e4f5-g6h78i91jk2l`。<br><br>如需了解如何创建 Apple App Store 上的自定产品页面并获取相应的 CPP URL，参见 [App Store 上的自定产品页面](https://developer.apple.com/app-store/custom-product-pages/)。|
|deeplink_list|object[]|深度链接列表。<br><br>数量范围：0-1。|
#|deeplink|string|深度链接，即你希望已安装应用的受众跳转到的具体位置。|
#|deeplink_type {+条件必填}|string|当传入 `deeplink` 时，此为必填字段。<br><br>深度链接类型。<br><br>枚举值：`DEFERRED_DEEPLINK`、`NORMAL`。<br><br>若想传入此字段，需同时提供 `deeplink` 字段。|
| disclaimer | object | 仅当同时满足以下两个条件时生效：<ul><li>在推广系列层级，`objective_type` 为 `APP_PROMOTION` 或 `WEB_CONVERSIONS`，或 `objective_type` 为 `LEAD_GENERATION` 且 `catalog_enabled` 为 `false` 或不传入。</li><li>在广告组层级，包含 TikTok 广告位。可使用以下任意配置：<ul><li><b>自动广告位</b>：不传入 `placement_type` 和 `placements`。</li><li><b>选择特定广告位</b>，包含 TikTok 广告位：将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL`，并在 `placements` 值中包含 `PLACEMENT_TIKTOK`。</li></ul></li></ul>免责声明信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：不可删除添加到广告中的免责声明。</p> |
#| disclaimer_type {+条件必填} | string | 当传入 `disclaimer` 时，此为必填字段。<br><br>要添加到广告中的免责声明的类型。<br>你可以添加免责声明，确保你的广告符合当地和区域政策。<br><br>枚举值： <ul><li>`TEXT_ONLY`：纯文本免责声明。 </li><li>`TEXT_LINK`：文字链免责声明。</li></ul><br>如需了解如何配置免责声明设置，参见[在广告中添加免责声明](1739953274550273.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。</p> |
#| disclaimer_text {+条件必填} | object | 当 `disclaimer_type` 为 `TEXT_ONLY` 时，此为必填字段。<br><br>广告中的纯文本免责声明。 |
##| text {+条件必填} | string | 当传入 `disclaimer_text` 时，此为必填字段。<br><br>免责声明的文本。<br><br>长度限制：90 个字符。 |
#| disclaimer_clickable_texts {+条件必填} | object[] | 当 `disclaimer_type` 为 `TEXT_LINK` 时，此为必填字段。<br><br>要添加到广告中的一个或多个文字链免责声明。<br><br>最大数量：3。<br><br>如果你使用多个文字链免责声明，传入的所有文本的总长度和单个文本的长度都不能超过 40 个字符。 |
##| text {+条件必填} | string | 当传入 `disclaimer_clickable_texts` 时，此为必填字段。<br><br>免责声明的文本。<br><br>长度限制：40 个字符。 |
##| url {+条件必填} | string | 当传入 `disclaimer_clickable_texts` 时，此为必填字段。<br><br>文字链免责声明的 URL。<br>用户点击每个文本后将跳转到相应的 URL，查看免责声明的更多详细信息。 |
|ad_configuration|object|其他配置。|
#|identity_type {+条件必填}|string|在以下任意场景中，此为必填字段：<ul><li>创建投放到非 TikTok 广告位的非 Spark Ads。现已不再支持将非 Spark Ads 投放到 TikTok 广告位。</li><li>使用电商商品库中的创意创建 Spark Ads。如需详细了解如何创建此类广告，参见[创建升级版 Smart+ 电商商品库广告](1847302895272962.html)。</li><li>使用娱乐商品库中的创意，创建采用多影片样式的 Spark Ads。如需详细了解如何创建此类广告，参见[创建升级版 Smart+ 流媒体广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-streaming-ads/v1.3)。</li></ul><br>广告发布身份类型。<ul><li>对于投放到非 TikTok 广告位的非 Spark Ads，广告发布身份类型的枚举值为：`CUSTOMIZED_USER`。</li><li>对于升级版 Smart+ 电商商品库 Spark Ads（`catalog_creative_toggle` 为 `true`），广告发布身份类型的枚举值为：`TT_USER`、`BC_AUTH_TT`。</li><li>对于采用多影片样式的升级版 Smart+ 流媒体 Spark Ads（`catalog_creative_toggle` 为 `true`），广告发布身份类型的枚举值为：`TT_USER`、`BC_AUTH_TT`。</li></ul><br>查看[广告发布身份](1738958351620097.html)文档，详细了解广告发布身份。|
#|identity_id {+条件必填}|string|在以下任意场景中，此为必填字段：<ul><li>创建投放到非 TikTok 广告位的非 Spark Ads。现已不再支持将非 Spark Ads 投放到 TikTok 广告位。</li><li>使用电商商品库中的创意创建 Spark Ads。如需详细了解如何创建此类广告，参见[创建升级版 Smart+ 电商商品库广告](1847302895272962.html)。</li><li>使用娱乐商品库中的创意，创建采用多影片样式的 Spark Ads。如需详细了解如何创建此类广告，参见[创建升级版 Smart+ 流媒体广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-streaming-ads/v1.3)。</li></ul><br>广告发布身份 ID。|
#|identity_authorized_bc_id {+条件必填}|string|当 `ad_configuration` 中的 `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> |
#|product_specific_type {+条件必填}|string|<ul><li>当推广系列层级的 `catalog_enabled` 为 `true` 时，该字段为必填，可设置为 `ALL`、`PRODUCT_SET` 或 `CUSTOMIZED_PRODUCTS`。</li><li>当推广系列层级的 `catalog_enabled` 为 `false` 或未设置时，该字段为可选，仅可设置为 `UNSET`。</li></ul><br>选择商品的不同维度。<br><br>枚举值：<ul><li>`ALL`：允许 TikTok 动态选择所有商品。</li><li>`PRODUCT_SET`：传入商品系列。TikTok 将动态选择该商品系列中的商品。</li><li>`CUSTOMIZED_PRODUCTS`：传入自定义数量的商品。</li><li>`UNSET`：未设置。</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><ul><li>若想获取广告账号内的商品系列，需使用 [/catalog/set/get/](1740570556295169.html) 接口。</li><li>若想创建商品系列，需使用 [/catalog/set/create/](1740572891104257.html) 接口。</li></ul>|
#|product_ids {+条件必填}|string[]|当 `product_specific_type` 为 `CUSTOMIZED_PRODUCTS` 时，此为必填字段。<br><br>商品库商品的 ID。<br><br>最大数量：20。<br><br>若想获取每个商品库商品的 ID (`product_id`)，需使用 [/catalog/product/get/](1740564136678402.html) 接口。|
#|catalog_creative_toggle|boolean|仅当推广系列层级的 `catalog_enabled` 为 `true` 时生效。<br><br>是否启用从商品库自动选择创意。<br><br>支持的值：`true`、`false`。<br>默认值：`false`。<br><br><ul><li>如果在升级版 Smart+ 网站广告中使用商品库轮播样式时，将此字段设置为 `true`，需提供仅包含 `music_info` 的 `creative_info`，以传入商品库轮播中使用的音乐。</li><li>如果在[升级版 Smart+ 汽车广告](1843324618421314.html)中使用商品库轮播样式时，将此字段设置为 `true`，需提供包含 `image_info`（含 1 张图片）和 `music_info` 的 `creative_info`，以传入商品库轮播中使用的片尾卡片图片和音乐。</li></ul>|
#|catalog_creative_info|object|仅当满足以下条件时生效：<ul><li>广告为[升级版 Smart+ 电商商品库广告](1847302895272962.html)或[升级版 Smart+ 流媒体广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-streaming-ads/v1.3)。</li><li>`catalog_creative_toggle` 为 `true`。</li></ul><br>在广告中使用的商品库创意的其他设置。|
##|catalog_media_settings|string[]|在广告中使用的电商商品库或娱乐商品库创意的类型。<br><br>对于[升级版 Smart+ 电商商品库广告](1847302895272962.html)，枚举值为：<ul><li>`VIDEO`：视频。</li><li>`IMAGE`：图片。</li><li>`TEMPLATE_VIDEO`：视频模板。如果在 `catalog_media_settings` 中包含该值，可选择同时传入 `catalog_template_video_id`。<ul><li>如果不传入 `catalog_template_video_id`，你的商品库中的所有视频模板和视频 URL 将用于生成广告。</li><li>如果传入 `catalog_template_video_id`，所选视频模板将用于生成广告。</li></ul></li></ul><br>对于[升级版 Smart+ 流媒体广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-streaming-ads/v1.3)，枚举值为：<ul><li>`VIDEO`：视频。</li><li>`TEMPLATE_VIDEO`：视频模板。如果在 `catalog_media_settings` 中包含该值，不可同时传入 `catalog_template_video_id`。<ul><li>你的商品库中的所有视频模板和视频 URL 将用于生成广告。</li></ul></li><li>`MULTI_SHOW`：多影片。多影片体验是一种支持自动播放的视频轮播体验，旨在引导用户探索内容库中契合其兴趣的丰富资源，并与之互动。多影片体验由来自商品库的 4 个视频磁贴组成。每个磁贴片段从左上角开始按顺序播放，你可以为磁贴设置相应的特定影片落地页。<ul><li>使用此样式时，通过 `ad_configuration` 对象中的参数 `identity_type`、`identity_id` 和 `identity_authorized_bc_id` 传入广告发布身份详细信息。</li></ul></li></ul><br><br><p><span style="color:darkred"><b>注意</b></span>：如果传入 `catalog_media_settings`，后续无法将 `catalog_creative_toggle` 更新为 `false` 或将 `catalog_media_settings` 更新为空列表 (`[]`)。</p>|
##|catalog_template_video_id|string|仅当满足以下条件时生效：<ul><li>广告为[升级版 Smart+ 流媒体广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-streaming-ads/v1.3)。</li><li> `catalog_media_settings` 中包含 `TEMPLATE_VIDEO`。</li></ul><br>在广告中使用的商品库视频模板的 ID。<br><br>若想获取你的商品库中的视频模板（视频包）ID，需使用 [/catalog/video_package/get/](1740574099715073.html) 接口。<br>如需了解如何在 TikTok 广告管理平台上创建视频包，参见[如何在商品库中创建视频包](https://ads.tiktok.com/help/article/how-to-create-video-packages-in-a-catalog)。|
#| creative_auto_add_toggle | boolean | 仅在以下任意场景中生效：<br><br><ul><li>场景 1：<ul><li>在推广系列层级，`objective_type` 为 `WEB_CONVERSIONS` 且 `sales_destination` 为 `WEBSITE`。</li></ul></li><li>场景 2：<ul><li>在推广系列层级，`objective_type` 为 `LEAD_GENERATION`。</li><li>在广告组层级，`promotion_type` 为 `LEAD_GENERATION`，且 `promotion_target_type` 为 `INSTANT_PAGE` 或 `EXTERNAL_WEBSITE`。</li></ul></li><li>场景 3：<ul><li>在推广系列层级，`objective_type` 为 `LEAD_GENERATION`。</li><li>在广告组层级，`promotion_type` 为 `LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE` ，且`messaging_app_type` 为 `MESSENGER` 或 `WHATAPP`。 </li></ul></li></ul><br>是否在投放期间自动添加新生成的素材。<br>在推广系列投放期间，系统将根据你现有的推广系列素材和创意素材库生成新的创意素材。通过使用 TikTok 最新热门元素（开场、音乐、文案等），你将获得现成的优质内容，这些内容可与你选择的其他素材一起投放。<br>新素材将自动添加到你的推广系列中，不会显示在你的 TikTok 主页上。你可以随时关闭此功能。<br><br>支持的值：`true`、`false`。<br><br>此字段的默认值取决于你是否已加入“默认在投放期间自动添加新生成的素材”功能的白名单：<ul><li>如果你已加入白名单，此字段的默认值将为 `true`。</li><li>如果你未加入白名单，此字段的默认值将为 `false`。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：在投放期间自动添加新生成的素材功能面向所有广告主提供。但默认启用这项功能目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</p>|
#| creative_auto_enhancement_strategy_list | string[] | 应用于你的广告的自动优化策略列表。<br>自动优化功能会在推广系列投放期间对广告进行实时修改。这项功能可以通过打造更具吸引力和冲击力的视觉、声音等元素来提升广告效果。<br>为获得最佳成效，可启用所有自动优化功能，无需任何额外操作即可提升广告的整体质量。<br><br>枚举值：<ul><li>`TRANSLATE_AND_DUB`：翻译和配音。以超过 50 种语言投放广告，与全球受众建立联系。</li><li>`MUSIC_REFRESH`：音乐焕新。替换为当前 TikTok 上流行的音乐，紧跟潮流趋势。</li><li>`VIDEO_QUALITY`：视频质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`IMAGE_QUALITY`：图片质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`IMAGE_RESIZE`：调整尺寸。调整图片大小，充分利用全屏功能。</li></ul><br>此字段的默认值取决于你是否已加入“默认启用自动优化”功能的白名单：<ul><li>如果你已加入默认启用特定策略的白名单，此字段的默认值将为包含这些策略的列表。<ul><li>例如，如果你已加入默认启用所有这些策略的白名单，此字段的默认值将为 `&#91;"TRANSLATE_AND_DUB","MUSIC_REFRESH","VIDEO_QUALITY","IMAGE_QUALITY","IMAGE_RESIZE"&#93;`。 </li></ul></li><li>如果你未加入默认启用任何策略的白名单，此字段的默认值将为空列表 (`&#91;&#93;`)。</li></ul><br>如需了解可启用此设置的场景，参见[适用于升级版 Smart+ 广告的自动优化功能](https://business-api.tiktok.com/portal/docs?id=1855450880142402#item-link-For%20Upgraded%20Smart+%20Ads)。<br><br><p><span style="color:darkred"><b>注意</b></span>：自动优化功能面向所有广告主提供。但默认启用这些功能目前为白名单功能，并且每一项优化功能的默认启用均需单独申请。如需使用此功能，请联系你的 TikTok 销售代表。 </p>|
#|deeplink_utm_params|object[]|仅当满足以下所有条件时生效：<ul><li>在推广系列层级：<ul><li>`objective_type` 为 `WEB_CONVERSIONS`</li><li>`sales_destination` 为 `APP`。</li></ul></li><li>在广告层级：<ul><li>`deeplink` 已传入。</li><li>`deeplink_type` 为 `DEFERRED_DEEPLINK`。</li></ul></li></ul><br>深度链接 URL 参数列表。URL 参数是可添加到 URL 末尾的代码片段，帮助你通过第三方分析平台监测不同渠道的点击量，并了解访客与网站的互动方式。这类参数由键值对组成，通过 `key` 和 `value` 传入。<br><br>最大数量：14。<br><br><p><span style="color:darkred"><b>注意</b></span>：深度链接 URL 参数目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</p>|
##|key|string|深度链接 URL 参数。<br><br>你可以传入自定义参数或 UTM 参数。<br><br>支持的 UTM 参数包括：<ul><li>`utm_source`：为你的网站引流的应用、网站等。示例：TikTok。</li><li>`utm_medium`：广告或营销媒介。示例：CPM、CPC、横幅、视频。</li><li>`utm_content`：用于推广的创意内容。示例：广告名称、CTA、素材、颜色等。</li><li>`utm_campaign`：单个推广系列名称、宣传语或促销码。示例：黑色星期五促销活动。</li></ul><br>注意：UTM 参数区分大小写。<br><br>指定自定义参数时的长度限制：100 个字符。|
##|value|string|深度链接 URL 参数的值。<br><br>你可以传入自定义值或宏名称。<br><br>支持的宏包括：<ul><li>`__CAMPAIGN_NAME__`：这将替换为你的推广系列名称。</li><li>`__CAMPAIGN_ID__`：这将替换为你的推广系列 ID。</li><li>`__AID_NAME__`：这将替换为你的广告组名称。</li><li>`__AID__`：这将替换为你的广告组 ID。</li><li>`__CID_NAME__`：这将替换为你的广告名称。</li><li>`__CID__`：这将替换为你的广告 ID。</li><li>`__PLACEMENT__`：这将替换为你的广告位。</li></ul><br>指定自定义值时的长度限制：600 个字符。|
#|end_card_cta {+条件必填}|string|当满足以下条件时，此为必填字段：<ul><li>在推广系列层级：</li><ul><li>`objective_type` 为 `LEAD_GENERATION`。</li><li>`catalog_enabled` 为 `true`。</li></ul><li>在广告组层级：</li><ul><li>已通过 `catalog_id` 传入汽车库存商品库或汽车型号商品库。</li></ul><li>在广告层级：</li><ul><li>`catalog_creative_toggle` 为 `true`。</li></ul></ul><br>升级版 Smart+ [汽车库存轮播广告](1843325008693250.html)、[汽车型号轮播广告](1843325022799873.html)或[适用于升级版 Smart+ TikTok 私信广告的商品库解决方案](https://business-api.tiktok.com/portal/docs?id=1847302969710913#item-link-For%20the%20catalog%20solution)的片尾卡片 (`image_info`) 行动引导文案。<br><br>枚举值：<ul><li>`SEARCH_INVENTORY`（推荐）：搜索库存。</li><li>`LEARN_MORE`：查看详情。</li><li>`SHOP_NOW`：去逛逛。</li><li>`SIGN_UP`：立即注册。</li><li>`CONTACT_US`：联系我们。</li><li>`BOOK_NOW`：立即预约。</li><li>`READ_MORE`：阅读更多。</li><li>`VIEW_MORE`：立即查看。</li><li>`ORDER_NOW`：立即下单。<li>`SEND_MESSAGE`：发消息。<ul><li>此值仅适用于[升级版 Smart+ TikTok 私信广告的商品库解决方案](https://business-api.tiktok.com/portal/docs?id=1847302969710913#item-link-For%20the%20catalog%20solution)。</li></ul></li></li></ul>|
#|product_display_field_list|string[]|仅当满足以下所有条件时生效：<br><br><ul><li>在推广系列层级：</li><ul><li>`objective_type` 为 `LEAD_GENERATION`。</li><li>`catalog_enabled` 为 `true`。</li></ul><li>在广告组层级：</li><ul><li>已通过 `catalog_id` 传入汽车库存商品库。</li></ul><li>在广告层级：</li><ul><li>`catalog_creative_toggle` 为 `true.`</li></ul></ul><br>[汽车库存轮播广告](1843325008693250.html)中展示的商品详情的列表。<br><br>最大数量：2。<br><br>枚举值：<ul><li>`DEALER_NAME`：车辆的 `dealer_name` 字段。</li><li>`MAKE`：车辆的 `make` 字段。</li><li>`MODEL`：车辆的 `model` 字段。</li><li>`YEAR`：车辆的 `year` 字段。</li><li>`MILEAGE`：车辆的 `mileage` 字段。</li><li>`PRICE`：车辆的 `price` 字段。</li><li>`SALE_PRICE`：车辆的 `sale_price` 字段。</li><li>`EXTERIOR_COLOR`：车辆的 `exterior_color` 字段。</li><li>`TRIM`：车辆的 `trim` 字段。</li><li>`ADDRESS_CITY`：车辆的 `city` 字段。</li><li>`VEHICLE_STATE`：车辆的 `state_of_vehicle` 字段。</li></ul><br>每辆车的标题将自动显示。例如，如果将此字段设置为 `&#91;"MILEAGE","YEAR"&#93;`，广告将展示每辆车的 `mileage`、`price` 和 `title` 字段。<br>若想获取汽车库存商品库中车辆的商品详情字段，并检查是否需要更新详情，需使用 [/catalog/product/get/](1740564136678402.html) 接口。<br><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。</p>|
#|auto_disclaimer_types|string[]|仅当满足以下条件时生效：<br><br><ul><li>在推广系列层级：</li><ul><li>`objective_type` 为 `LEAD_GENERATION`。</li><li>`catalog_enabled` 为 `true`。</li></ul><li>在广告组层级：</li><ul><li>已通过 `catalog_id` 传入汽车型号商品库。</li></ul><li>在广告层级：</li><ul><li>`catalog_creative_toggle` 为 `true.`</li></ul></ul><br>[汽车型号轮播广告](1843325022799873.html)中展示的免责声明类型。<br><br>枚举值：<ul><li>`EMISSION`：排放免责声明。</li><li>`DISCOUNT`：折扣或优惠免责声明。</li></ul><br>最大数量：1。<br><br><p><span style="color:darkred"><b>注意</b></span>：使用任何类型的免责声明前，确保已为汽车型号商品库中的每个车辆传入必要的免责声明详细信息。<br><ul><li>使用排放免责声明时，确保针对每个车辆提供以下详细信息：</li><ul><li>`emission_disclaimer`</li><li>`emission_disclaimer_url`</li><li>`emission_overlay_disclaimer`</li><li>`emission_image_link`</li></ul><li>使用折扣或优惠免责声明时，确保针对每个车辆提供以下详细信息：</li><ul><li>`offer_disclaimer`</li><li>`offer_disclaimer_url`</li></ul>若想获取汽车型号商品库中车辆的属性，需使用 [/catalog/product/get/](1740564136678402.html) 接口。<br>若想更新汽车型号商品库中车辆的属性，需使用 [/catalog/product/update/](1740562287852546.html) 接口。</p>|
#|utm_params|object[]|当推广系列层级的 `objective_type` 为 `WEB_CONVERSIONS` 时生效。<br><br>URL 参数列表。URL 参数是可添加到 URL 末尾的代码片段，帮助你通过第三方分析平台监测不同渠道的点击量，并了解访客与网站的互动方式。这类参数由键值对组成，通过 `key` 和 `value` 传入。<br><br>最大数量：14。<br><br>如果将 `landing_page_url` 设置为已包含 URL 参数的 URL，可选择同时传入 `utm_params` 以存储 URL 中使用的参数。在这一情况下，需确保 `utm_params` 与已使用的 URL 参数精确匹配。广告投放时，URL 参数不会自动附加到 `landing_page_url` 中。|
##|key|string|支持的 UTM 参数包括：<ul><li>`utm_source`：为你的网站引流的应用、网站等。示例：TikTok。</li><li>`utm_medium`：广告或营销媒介。示例：CPM、CPC、横幅、视频。</li><li>`utm_content`：用于推广的创意内容。示例：广告名称、CTA、素材、颜色等。</li><li>`utm_campaign`：单个推广系列名称、宣传语或促销码。示例：黑色星期五促销活动。</li></ul>注意：UTM 参数区分大小写。<br><br>指定自定义参数时的长度限制：100 个字符。|
##|value|string|URL 参数的值。<br><br>你可以指定自定义值或宏名称。<br><br>支持的宏包括：<ul><li>`__CAMPAIGN_NAME__`：这将替换为你的推广系列名称。</li><li>`__CAMPAIGN_ID__`：这将替换为你的推广系列 ID。</li><li>`__AID_NAME__`：这将替换为你的广告组名称。</li><li>`__AID__`：这将替换为你的广告组 ID。</li><li>`__CID_NAME__`：这将替换为你的广告名称。</li><li>`__CID__`：这将替换为你的广告 ID。</li><li>`__PLACEMENT__`：这将替换为你的广告位。</li></ul><br>指定自定义值时的长度限制：600 个字符。|
#|fallback_type|string|满足以下所有条件时必填：<ul><li>在广告组层级：<ul><li>`promotion_type` 为 `LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE`。</li><li>`messaging_app_type` 为 `IM_URL`。</li></ul></li><li>在广告层级：<ul><li>通过深度链接传入的即时通讯应用的自定义 URL 架构。</li></ul></li></ul><br>失败路径类型。<br>用户因未安装应用而无法访问深度链接时跳转到的目标页面。<br><br>枚举值：<ul><li>`WEBSITE`：将推广的网页作为失败路径 URL。同时，你需要通过 `landing_page_url_list` 传入失败路径 URL。</li></ul><br>如需了解如何在 TikTok 即时通讯广告中配置失败路径 URL，参见[创建以即时通讯应用作为优化位置的升级版 Smart+ 线索收集推广系列](1847302988449921.html)。|
#| product_info | object | 商品信息。<br><br>此信息将用于不同广告变体以实现个性化广告投放，从而提升广告效果。过去的数据表明，信息完整的广告通常能获得更高的点击量和转化量。具体效果可能有所不同。<br><br>`product_info` 对象中的所有字段均为选填。但通过参数提供的信息越详细，生成的广告变体效果越好。<br><br>如需了解可使用此字段中参数的场景，参见[升级版 Smart+ 推广系列中可用的商品信息设置](1860735968798721.html)。 |
##| product_titles | string[] | 商品名称列表。<br><br>数量范围：0-1。<br><br>每个商品名称的长度不得超过 40 个字符，且不可包含表情符号。每个中文汉字或日文字符计为两个字符，每个英文字母计为一个字符。<br><br>如果未提供商品名称，系统将使用默认名称，以免该名称显示为空。 |
##| product_image_list | object[] | 商品图片列表。<br><br>数量范围：0-10。<br><br>如果未提供商品图片，系统将使用通用图片，以免该图片显示为空。 |
###| web_uri | string | 商品图片 ID。<br><br>规格要求：<ul><li>图片格式：.jpg、.png、.jpeg 或 .webp。</li><li>文件大小：不超过 5 MB</li><li>图片尺寸：不限。</li></ul>建议图片分辨率：800 x 800 px。<br><br>若想获取图片 ID，需使用 [/file/image/ad/search/](1740052016789506.html) 或 [/file/image/ad/upload/](1739067433456642.html) 接口。 |
##| selling_points | string[] | 卖点列表。<br><br>最大数量：15。<br><br>每个卖点必须为 1-25 个字符，且不得包含表情符号。<br><br>每个中文汉字或日文字符计为两个字符，每个英文字母计为一个字符。 |
##| catalog_tag_list | string[] | 在以下任意场景中生效：<ul><li>场景 1：推广系列层级的 `objective_type` 为 `WEB_CONVERSIONS` 且 `catalog_type` 为 `ECOMMERCE`。</li><li>场景 2： <ul><li>推广系列层级的 `objective_type` 为 `LEAD_GENERATION` 且 `catalog_enabled` 为 `true`。</li><li>在广告组层级通过 `catalog_id` 传入汽车库存商品库。</li></ul></li></ul>商品库广告的商品详细信息。<ul><li>在场景 1 中，将自动显示商品库中的已传入商品信息，以提升成效。枚举值包括：<ul><li>`PRICE`：价格。</li><li>`STRIKETHROUGH_PRICE`：划线价。</li><li>`DISCOUNT`：折扣。</li><li>`FREE_SHIPPING`：包邮。</li></ul>默认值：`["PRICE", "STRIKETHROUGH_PRICE", "DISCOUNT", "FREE_SHIPPING"]`。<br><br>最大数量：4。</li><li>在场景 2 中，库存卡片上将显示传入商品信息的相应文本。枚举值包括：<ul><li>`DEALER_NAME`：经销商名称。</li><li>`CURRENT_MILEAGE`：当前里程。</li><li>`LEAD_PRICE`：价格。</li><li>`LEAD_SALE_PRICE`：促销价。</li><li>`EXTERIOR_COLOR`：外观颜色。</li><li>`TRIM`：内饰。</li><li>`ADDRESS_CITY`：城市。</li><li>`VEHICLE_STATE`：车辆状况。</li></ul>最大数量：2 个主要商品库标签（`DEALER_NAME`、`CURRENT_MILEAGE`、`EXTERIOR_COLOR`、`TRIM`、`ADDRESS_CITY`、`VEHICLE_STATE`），2 个次要商品库标签（`LEAD_PRICE`、`LEAD_SALE_PRICE`）。</li></ul> |
##|product_card_type|string[]|商品卡片展示类型。<br><br>枚举值：<ul><li>`PRODUCT_CARD`：商品卡片。</li><li>`PRODUCT_TILE`：商品磁贴。</li><li>`PRODUCT_INFO_CARD`：信息卡片。</li><li>`PRODUCT_SHOWCASE_TILE`：展示磁贴。</li><li>`ANCHOR`：锚点。</li><li>`CAROUSEL_LABEL`：轮播标签。</li></ul><br>无默认值。<br><br><p><span style="color:darkred"><b>注意</b></span>：提供此字段时，需要至少包含一个值。|
##| promo_info_list | object[] | 仅对[常规升级版 Smart+ 网站推广系列](1847302878676994.html)生效。<br><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>折扣值。<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-List of values for discount_currency or minimum_purchase_currency"> `discount_currency` 或 `minimum_purchase_currency` 值列表</a>。 |
###| promo_code | string | 促销码。<ul><li>通过此字段传入购物者在结账时需要输入的促销码。</li><li>对于自动生效的优惠，无需填写此字段。</li></ul><br>长度限制：不得超过 30 个字符，且不可包含表情符号。每个中文汉字或日文字符计为两个字符，每个英文字母计为一个字符。<br><br><font color="darkred"><b>注意</b></font>：仅限于 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` 时，传入不小于 0 的整数。</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-List of values for discount_currency or 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`。<ul><li>`valid_end_time` 应晚于当前时间。</li><li>如果传入 `valid_end_time`，需一并提供 `valid_start_time`。</li></ul> |
#| product_info_enabled {+条件必填}| string | 商品信息模式。<br><br>枚举值：<ul><li>`UNSET`：禁用商品信息模式。</li><li>`NON_CATALOG`：启用非商品库版本的商品信息。</li><li>`CATALOG`：启用商品库版本的商品信息。</li></ul><br>默认值：`UNSET`。<br><br>如需了解需设置此参数的场景，参见[升级版 Smart+ 推广系列中可用的商品信息设置](1860735968798721.html)。<br><br><font color="darkred"><b>注意</b></font>： <ul><li>仅当在推广系列层级同时满足以下两个条件时，此字段将自动设置为 `CATALOG`：<ul><li>`app_promotion_type` 为 `MINIS`。</li><li>`catalog_enabled` 为 `true`。</li></ul></li><li>仅当通过 `card_id` 在[升级版 Smart+ 汽车广告](1843324618421314.html)中传入库存卡片素材包时，此字段才能设置为 `UNSET`。</li></ul>|
#|call_to_action_id{+条件必填}|string|在以下任意场景中，此为必填字段：<ul><li>场景 1： <ul><li>推广系列层级的 `objective_type` 为 `LEAD_GENERATION`。</li><li>广告组层级的 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC`。</li></ul></li><li>场景 2： <ul><li>推广系列层级的 `objective_type` 为 `APP_PROMOTION` 或 `WEB_CONVERSIONS`。</li><li>广告组层级的 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC`。</li><li>广告层级 `creative_info` 对象中的 `identity_type` 设置为 `TT_USER`、`BC_AUTH_TT` 或 `AUTH_CODE`。</li></ul></li></ul><br>要在广告中使用的行动引导文案 (CTA) 素材包（也称为动态 CTA）的 ID。CTA 素材包是一组自动优化的 CTA。<br><br>如需详细了解自动优化的 CTA，参见[智能推荐行动引导文案 > 动态优选行动引导文案](https://business-api.tiktok.com/portal/docs?id=1740307296329730#item-link-Dynamic%20CTAs%20)。|
#|phone_info {+条件必填}|object|广告组层级的 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` 时必填。<br><br>广告受众点击广告中的行动引导文案按钮后，用于直接拨打电话联系你（广告主）的电话号码的详细信息。<br><br>了解如何[创建以电话通话为优化位置的升级版 Smart+ 线索收集推广系列](1847302998941697.html)。|
##|phone_region_code {+条件必填}|string|当传入 `phone_info` 时，此为必填字段。<br><br>受众点击广告后可拨打的电话号码的地区代码。<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>受众点击广告后可拨打的电话号码的国际区号。<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>受众点击广告后可拨打的电话号码。<br><br>示例：`12638282`。|
#|tracking_info|object|监测信息。|
##|viewability_postbid_partner|string|仅对[常规升级版 Smart+ 网站推广系列](https://business-api.tiktok.com/portal/docs/create-a-regular-upgraded-smart-web-campaign/v1.3)和[升级版 Smart+ 电商商品库广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-e-commerce-catalog-ads/v1.3)生效。<br><br>出价后第三方可见性度量合作伙伴。<br><br>枚举值：`DOUBLE_VERIFY`、`IAS`、`ZEFR`。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>出价后第三方可见性度量功能目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>如需了解支持的推广目标、市场以及出价后度量功能的简要介绍，参见[品牌安全](1739381752981505.html)。</li><li>同时传入 `brand_safety_postbid_partner` 和 `viewability_postbid_partner` 时：<ul><li>如果将这两个字段中的任一字段设置为 `IAS`，需要将它们都指定为 `IAS`，并为 `brand_safety_vast_url` 和 `viewability_vast_url` 指定相同的值（即从度量合作伙伴 IAS 处获取的包装 VAST URL）。</li><li>如果将这两个字段中的任一字段设置为 `ZEFR`，需要将它们都指定为 `ZEFR`。</li><li>如果设置了两个不同的出价后度量合作伙伴，只有出价后品牌安全度量设置会生效。</li></ul></li></ul>|
##|viewability_vast_url {+条件必填}|string|当 `viewability_postbid_partner` 为 `IAS` 时，此为必填字段。<br><br>出价后第三方合作伙伴用于度量可见性的包装 VAST URL。你需要从度量合作伙伴 IAS 处获取 URL。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>出价后第三方可见性度量功能目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>如果将 `brand_safety_postbid_partner` 和 `viewability_postbid_partner` 都设置为 IAS，`brand_safety_vast_url` 和 `viewability_vast_url` 应保持一致。</li></ul>|
##|brand_safety_postbid_partner|string|仅对[常规升级版 Smart+ 网站推广系列](https://business-api.tiktok.com/portal/docs/create-a-regular-upgraded-smart-web-campaign/v1.3)和[升级版 Smart+ 电商商品库广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-e-commerce-catalog-ads/v1.3)生效。<br><br>出价后第三方品牌安全度量合作伙伴。<br><br>枚举值：`DOUBLE_VERIFY`、`IAS`、`ZEFR`。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>出价后第三方品牌安全度量功能目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>如需了解支持的推广目标、市场以及出价后度量功能的简要介绍，参见[品牌安全](1739381752981505.html)。</li><li>同时传入 `brand_safety_postbid_partner` 和 `viewability_postbid_partner` 时：<ul><li>如果将这两个字段中的任一字段设置为 `IAS`，需要将它们都指定为 `IAS`，并为 `brand_safety_vast_url` 和 `viewability_vast_url` 指定相同的值（即从度量合作伙伴 IAS 处获取的包装 VAST URL）。</li><li>如果设置了两个不同的出价后度量合作伙伴，只有出价后品牌安全度量设置会生效。</li></ul></li></ul>|
##|brand_safety_vast_url {+条件必填}|string|当 `brand_safety_postbid_partner` 为 `IAS` 时，此为必填字段。<br><br>出价后第三方合作伙伴用于度量品牌安全的包装 VAST URL。你需要从度量合作伙伴 IAS 处获取 URL。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>出价后第三方品牌安全度量功能目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>如果将 `brand_safety_postbid_partner` 和 `viewability_postbid_partner` 都设置为 IAS，`brand_safety_vast_url` 和 `viewability_vast_url` 应保持一致。</li></ul>|
##|impression_tracking_url|string|默认展示监测 URL。<br><br>由数据合作伙伴生成的 URL，用于监测你的广告获得的展示事件。通常可以在合作伙伴的平台上找到并复制此 URL。<br><ul><li>如果要监测的应用合作伙伴 ID（在广告组层级传入的 `app_id`）为 `44` (TikTok Business SDK) 或 `49`（TikTok 应用 API），无需传入此字段。如果已传入，此字段将被忽略。你可以通过 [/app/list/](1740859313270786.html) 接口或 [/app/info/](1740859272887297.html) 接口返回的 `partner_id`，获取应用合作伙伴 ID。</li><li>如果你要监测的应用已启用自归因（在广告组层级传入的 `app_id`），且该应用的合作伙伴 ID 并非 `44` (TikTok Business SDK) 或 `49`（TikTok 应用 API），无需传入此字段。因为此字段将默认使用你为应用配置的默认展示监测 URL，且不支持 URL 更新。你可以通过 [/app/list/](1740859313270786.html) 接口或 [/app/info/](1740859272887297.html) 接口返回的 `self_attribution_enabled`，确认应用是否已启用自归因。</li></ul>|
##|click_tracking_url|string|点击监测 URL。<br><br>由数据合作伙伴生成的 URL，用于监测你的广告获得的点击事件。通常可以在合作伙伴的平台上找到并复制此 URL。<br><ul><li>如果要监测的应用合作伙伴 ID（在广告组层级传入的 `app_id`）为 `44` (TikTok Business SDK) 或 `49`（TikTok 应用 API），无需传入此字段。如果已传入，此字段将被忽略。你可以通过 [/app/list/](1740859313270786.html) 接口或 [/app/info/](1740859272887297.html) 接口返回的 `partner_id`，获取应用合作伙伴 ID。</li><li>如果你要监测的应用已启用自归因（在广告组层级传入的 `app_id`），且该应用的合作伙伴 ID 并非 `44` (TikTok Business SDK) 或 `49`（TikTok 应用 API），无需传入此字段。因为此字段将默认使用你为应用配置的点击监测 URL，且不支持 URL 更新。你可以通过 [/app/list/](1740859313270786.html) 接口或 [/app/info/](1740859272887297.html) 接口返回的 `self_attribution_enabled`，确认应用是否已启用自归因。</li></ul>目前，Pangle 不支持 DCM、Sizmek 或 Flashtalking。|
##|tracking_app_id|string|当 `objective_type` 为 `WEB_CONVERSIONS` 或 `LEAD_GENERATION` 时生效。<br><br>你希望监测的应用的 ID。<br>你可以使用此字段监测站外应用事件。<br><br>如果在广告组层级已传入 `app_id`，并希望监测站外应用事件，那么通过此字段传入的应用 ID 必须与广告组层级传入的 ID 一致。否则，你可以通过此字段传入任何想要监测的应用 ID。<br><br>若想获取应用 ID 列表，需使用 [/app/list/](1740859313270786.html) 接口。|
##| tracking_pixel_id | string | 仅当在推广系列层级同时满足以下两个条件时生效：<ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_INSTALL` 或 `APP_RETARGETING`。</li></ul><br>Pixel ID，用于监测用户在你的网站上执行的操作，例如页面浏览、加入购物车、付费等。<br><br><ul><li>如果已在广告组层级设置 `pixel_id`，此 `tracking_pixel_id` 必须与之匹配才能监测网站事件。</li><li>如果未在广告组层级设置 `pixel_id`，可传入任意 Pixel ID 来监测网站事件。</li></ul> |
##| tracking_offline_event_set_ids | string[] | 仅当在推广系列层级同时满足以下两个条件时生效：<ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_INSTALL` 或 `APP_RETARGETING`。</li></ul><br>线下事件组 ID 列表，用于监测线下客户行为，例如实体店购买或参加现场活动。<br><br>最大数量：50。<br><br>如需详细了解如何创建和管理线下事件组，参见[此处](https://business-api.tiktok.com/portal/docs/events-api-v1-offline-get-started/v1.3)。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>对于新广告，必须监测现有的自动监测线下事件组。你可以选择省略或提供此字段。<ul><li>如果省略此字段，它将自动包含你的广告账号中所有<b>现有</b>的自动监测线下事件组 ID。</li><li>如果提供此字段，需传入所有<b>现有</b>的自动监测线下事件组 ID。可选择添加非自动监测的线下事件组 ID。若想查找广告账号中现有的自动监测线下事件组，需调用 [/offline/get/](https://business-api.tiktok.com/portal/docs/get-offline-event-sets/v1.3) 并选择 `auto_tracking` 为 `true` 的事件组。</li></ul></li></ul> </p> |
##|tracking_message_event_set_id|string|当满足以下条件时生效：<ul><li>在广告组层级：<ul><li>`promotion_type` 为 `LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE`。</li><li>`optimization_goal` 为 `CLICK`。</li><li>`messaging_app_type` 为 `MESSENGER` 或 `WHATSAPP`。</li></ul></li><li>在广告层级：<ul><li>不传入 `page_list`。</li></ul></li></ul><br>要在即时通讯广告中度量的通讯事件组的 ID。你可以使用此字段来度量用户在你的即时通讯应用中发起对话的时间。<br><br>若想获取可用通讯事件组列表，需使用 [/ctm/message_event_set/get/](1816979158055937.html) 接口。<br><br>如需了解如何创建 TikTok 即时通讯广告，参见[创建以即时通讯应用作为优化位置的升级版 Smart+ 线索收集推广系列](1847302988449921.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。</p>|
##| app_tracking_info_list | object[] | 仅当推广系列层级的 `sales_destination` 为 `WEB_AND_APP` 时生效。<br><br>第三方监测设置的详细信息。<br><br>最大数量：4。 |
###| app_type {+条件必填} | string | 当传入 `app_tracking_info_list` 时，此为必填字段。<br><br>应用类型。<br><br>枚举值：<ul><li>`APP_ANDROID`：Android 应用。</li><li>`APP_IOS`：iOS 应用。</li></ul> |
###| app_id {+条件必填} | string | 当传入 `app_tracking_info_list` 时，此为必填字段。<br><br>应用 ID。<ul><li>当 `app_type` 为 `APP_ANDROID` 时，传入 Android 应用 ID。</li><li>当 `app_type` 为 `APP_IOS` 时，传入 iOS 应用 ID。</li></ul> |
###| impression_tracking_url {+条件必填} | string | 当已传入 `app_type` 时，传入 `impression_tracking_url` 或 `click_tracking_url` ，或同时传入两者。<br><br>展示监测 URL。<ul><li>当 `app_type` 为 `APP_ANDROID` 时，传入 Android 展示监测 URL。</li><li>当 `app_type` 为 `APP_IOS` 时，传入 iOS 展示监测 URL。</li></ul> |
###| click_tracking_url {+条件必填} | string | 当已传入 `app_type` 时，传入 `impression_tracking_url` 或 `click_tracking_url` ，或同时传入两者。<br><br>点击监测 URL。<ul><li>当 `app_type` 为 `APP_ANDROID` 时，传入 Android 点击监测 URL。</li><li>当 `app_type` 为 `APP_IOS` 时，传入 iOS 点击监测 URL。</li></ul> |

discount_currency 或 minimum_purchase_currency 值列表

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

|discount_currency 或 minimum_purchase_currency 值 {50%}|币种{50%}|
|---|---|
|`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/smart_plus/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "ad_name": "{{ad_name}}",
    "landing_page_url_list": [
        {
            "landing_page_url": "{{landing_page_url}}"
        }
    ],
    "creative_list": [
        {
            "creative_info": {
                "ad_format":"CAROUSEL_ADS",
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "music_info": {
                    "music_id": "{{music_id}}"
                },
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format":"SINGLE_VIDEO",
                "video_info": {
                    "video_id": "{{video_id}}"
                },
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format":"SINGLE_VIDEO",
                "tiktok_item_id": "{{tiktok_item_id}}",
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format":"SINGLE_VIDEO",
                "tiktok_item_id": "{{tiktok_item_id}}",
                "identity_type": "BC_AUTH_TT",
                "identity_id": "{{identity_id}}",
                "identity_authorized_bc_id": "{{identity_authorized_bc_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format":"SINGLE_VIDEO",
                "tiktok_item_id": "{{tiktok_item_id}}",
                "identity_type": "AUTH_CODE",
                "identity_id": "{{identity_id}}"
            }
        }
    ],
    "ad_text_list": [
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        }
    ],
    "ad_configuration": {
        "utm_params": [
            {
                "key": "{{key}}",
                "value": "{{value}}"
            }
        ],
        "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。|
#|campaign_name|string|推广系列名称。|
#|adgroup_id|string|广告组 ID。|
#|adgroup_name|string|广告组名称。|
#|smart_plus_ad_id|string|广告 ID。|
#|ad_name|string|广告名称。|
#|operation_status|string|操作状态。<br><br>枚举值：<ul><li>`ENABLE`：广告已启用（处于“开启”状态）。</li><li>`DISABLE`：广告未启用（处于“关闭”状态）。</li><li>`FROZEN`：广告已终止，无法启用。</li></ul>|
#|secondary_status|string|广告二级状态。<br><br>枚举值参见[枚举值 - 广告状态 - 二级状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Ad%20status%20-%20secondary%20status)。<br><br>以下为新增的升级版 Smart+ 广告二级状态：<ul><li>`AD_STATUS_DELIVERY_AND_REAUDIT`：正在审核修改内容。</li><li>`AD_STATUS_DELIVERY_AND_TRANSCODING_FAIL`：广告中的一个或多个视频转码失败。</li><li>`AD_STATUS_REVIEW_PARTIALLY_APPROVED`：正在审核部分广告内容，同时广告正在投放。</li><li>`AD_STATUS_COLLECTION_TOGGLED_OFF`：线索收集已结束。</li><li>`AD_STATUS_PRIVACY_POLICY_REJECTED`：广告因违反隐私政策被拒。</li><li>`AD_STATUS_PRIVACY_POLICY_AUDIT`：广告正在进行隐私政策合规性审核。</li></ul>|
#|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`。|
#|creative_list|object[]|创意列表。|
##|ad_material_id|string|在广告中使用特定创意时生成的广告特定素材 ID。<br><br>此 ID 不同于你将创意素材上传到广告账号的创意素材库时所收到的创意 ID。|
##|material_operation_status|string|创意的状态。<br><br>枚举值： <ul><li>`ENABLE`：创意已启用（处于“开启”状态）。</li><li>`DISABLE`：创意未启用（处于“关闭”状态）。</li></ul>|
##|creative_info|object|创意信息。|
###|ad_format|string|广告样式。<br><br>枚举值： <ul><li>`SINGLE_VIDEO`：单视频广告。</li><li>`CAROUSEL_ADS`：标准轮播。</li><li>`CATALOG_CAROUSEL`：商品库轮播。</li></ul>|
###|material_name|string|素材名称。|
###|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|是否开启 AIGC（人工智能生成内容）自主披露开关，标注广告包含 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>广告发布身份类型。<br><br>枚举值：`AUTH_CODE`、`TT_USER`、`BC_AUTH_TT`。<br><br>查看[广告发布身份](1738958351620097.html)文档，详细了解广告发布身份。|
###|identity_id|string|当不使用商品库创意创建 Spark Ads 时返回。<br><br>广告发布身份 ID。|
###|identity_authorized_bc_id|string|当 `creative_info` 中的 `identity_type` 为 `BC_AUTH_TT` 时返回。<br><br>与“添加到商务中心的 TikTok 用户”类型广告发布身份关联的商务中心 ID。|
#|playable_list|object[]|试玩素材列表。|
##|playable_url|string|试玩素材 URL。|
#|ad_text_list|object[]|广告文案列表。<br><br>广告文案作为广告创意的一部分展示给受众，用于传递你希望传达的信息。|
##|ad_text|string|广告文案。|
#|auto_message_list|object[]|仅当广告组层级的 `promotion_type` 为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE` 时返回。<br><br>在 TikTok 私信广告中使用的自动消息的详情。|
###|auto_message_id|string|当传入 `auto_message_list` 时，此为必填字段。<br><br>在 TikTok 私信广告中使用的自动消息的 ID。<br><br>目前唯一支持的自动消息类型是欢迎消息。<ul><li>若想获取广告账号中的欢迎消息列表，需使用 [/creative/auto_message/get/](1822106498804738.html) 接口。</li><li>若想在广告账号内创建欢迎消息，需使用 [/creative/auto_message/create/](1822106113771521.html) 接口。</li></ul><br>如需了解如何创建包含欢迎消息的 TikTok 私信广告，参见[创建以 TikTok 私信作为优化位置的升级版 Smart+ 线索收集推广系列](1847302969710913.html)。|
#|call_to_action_list|object[]|行动引导文案列表。|
##|call_to_action|string|行动引导文案。<br><br>枚举值参见[枚举值 - 行动引导文案](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Call-to-action)。|
#|interactive_add_on_list|object[]|创新互动样式（创意素材包）ID 列表。|
##|card_id|string|创新互动样式 ID。|
#|page_list|object[]|页面列表。|
##|page_id|string|页面 ID。|
#|landing_page_url_list|object[]|落地页 URL 列表。|
##|landing_page_url|string|落地页 URL。|
#|custom_product_page_list|object[]|广告中使用的自定产品页面的详细信息。|
##|custom_product_page_url|string|自定义商品页 (CPP) URL。<br><br>CPP 是包含自定义截图、宣传文案和应用预览的产品页面，可用于重点展示所推广应用的特定内容或功能，或触达特定受众。<br><br>示例：`https://apps.apple.com/us/app/tiktok/id835599320?ppid=12345a6b-c789-12d3-e4f5-g6h78i91jk2l`。|
#|deeplink_list|object[]|深度链接列表。|
##|deeplink|string|深度链接，即你希望已安装应用的受众跳转到的具体位置。|
##|deeplink_type|string|深度链接类型。<br><br>枚举值：<ul><li>`NORMAL`：非延迟深度链接。</li><li>`DEFERRED_DEEPLINK`：延迟深度链接。</li></ul>|
#| disclaimer | object | 免责声明信息。 |
##| disclaimer_type | string | 广告中免责声明的类型。<br><br>枚举值： <ul><li>`TEXT_ONLY`：纯文本免责声明。</li><li>`TEXT_LINK`：文字链免责声明。</li></ul> |
##| disclaimer_text | object | 广告中的纯文本免责声明。 |
###| text | string | 免责声明的文本。 |
##| disclaimer_clickable_texts | object[] | 广告中的一个或多个文字链免责声明。 |
###| text | string | 免责声明的文本。 |
###| url | string | 文字链免责声明的 URL。<br>用户点击每个文本后将跳转到相应的 URL，查看免责声明的更多详细信息。 |
#|ad_configuration|object|其他配置。|
##|identity_type|string|在以下任意场景中返回：<ul><li>非 Spark Ads 投放到非 TikTok 广告位。现已不再支持将非 Spark Ads 投放到 TikTok 广告位。</li><li>使用电商商品库中的创意创建 Spark Ads。如需详细了解如何创建此类广告，参见[创建升级版 Smart+ 电商商品库广告](1847302895272962.html)。</li></ul><br>广告发布身份类型。<ul><li>对于投放到非 TikTok 广告位的非 Spark Ads，广告发布身份类型的枚举值为：`CUSTOMIZED_USER`。</li><li>对于升级版 Smart+ 电商商品库 Spark Ads（`catalog_creative_toggle` 为 `true`），广告发布身份类型的枚举值为：`TT_USER`、`BC_AUTH_TT`。</li></ul><br>查看[广告发布身份](1738958351620097.html)文档，详细了解广告发布身份。|
##|identity_id|string|在以下任意场景中返回：<ul><li>非 Spark Ads 投放到非 TikTok 广告位。现已不再支持将非 Spark Ads 投放到 TikTok 广告位。</li><li>使用电商商品库中的创意创建 Spark Ads。如需详细了解如何创建此类广告，参见[创建升级版 Smart+ 电商商品库广告](1847302895272962.html)。</li></ul><br>广告发布身份 ID。|
##|identity_authorized_bc_id|string|当 `ad_configuration` 中的 `identity_type` 为 `BC_AUTH_TT` 时返回。<br><br>与“添加到商务中心的 TikTok 用户”类型广告发布身份关联的商务中心 ID。|
##|dark_post_status|string|关于你的创意是否“只在广告中显示”的状态。<br><br>枚举值：<ul><li>`ON`：启用“只在广告中显示”，你的帖子仅通过付费流量展示。</li><li>`OFF`：禁用“只在广告中显示”。帖子将出现在你的 TikTok 主页上，并可获得自然流量。</li></ul>|
##|product_specific_type|string|选择商品的不同维度。<br><br>枚举值：<ul><li>`ALL`：允许 TikTok 动态选择所有商品。</li><li>`PRODUCT_SET`：传入商品系列。TikTok 将动态选择该商品系列中的商品。</li><li>`CUSTOMIZED_PRODUCTS`：传入自定义数量的商品。</li><li>`UNSET`：未设置。</li></ul>|
##|product_set_id|string|商品系列 ID。|
##|product_ids|string[]|商品库商品的 ID。|
##|catalog_creative_toggle|boolean|是否启用从商品库自动选择创意。<br><br>支持的值：`true`、`false`。|
##|catalog_creative_info|object|在广告中使用的商品库创意的其他设置。|
###|catalog_media_settings|string[]|在广告中使用的电商商品库或娱乐商品库创意的类型。<br><br>对于[升级版 Smart+ 电商商品库广告](1847302895272962.html)，枚举值为：<ul><li>`VIDEO`：视频。</li><li>`IMAGE`：图片。</li><li>`TEMPLATE_VIDEO`：视频模板。</li></ul><br>对于[升级版 Smart+ 流媒体广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-streaming-ads/v1.3)，枚举值为： <ul><li>`VIDEO`：视频。</li><li>`TEMPLATE_VIDEO`：视频模板。 </li><li>`MULTI_SHOW`：多影片。多影片体验是一种支持自动播放的视频轮播体验，旨在引导用户探索内容库中契合其兴趣的丰富资源，并与之互动。多影片体验由来自商品库的 4 个视频磁贴组成。每个磁贴片段从左上角开始按顺序播放，你可以为磁贴设置相应的特定影片落地页。</li></ul>|
###|catalog_template_video_id|string|在广告中使用的商品库视频模板的 ID。|
##| creative_auto_add_toggle | boolean | 是否在投放期间自动添加新生成的素材。<br>在推广系列投放期间，系统将根据你现有的推广系列素材和创意素材库生成新的创意素材。通过使用 TikTok 最新热门元素（开场、音乐、文案等），你将获得现成的优质内容，这些内容可与你选择的其他素材一起投放。<br>新素材将自动添加到你的推广系列中，不会显示在你的 TikTok 主页上。你可以随时关闭此功能。<br><br>支持的值：`true`、`false`。 |
##| creative_auto_enhancement_strategy_list | string[] | 应用于你的广告的自动优化策略列表。<br>自动优化功能会在推广系列投放期间对广告进行实时修改。这项功能可以通过打造更具吸引力和冲击力的视觉、声音等元素来提升广告效果。<br><br>枚举值：<ul><li>`TRANSLATE_AND_DUB`：翻译和配音。以超过 50 种语言投放广告，与全球受众建立联系。</li><li>`MUSIC_REFRESH`：音乐焕新。替换为当前 TikTok 上流行的音乐，紧跟潮流趋势。</li><li>`VIDEO_QUALITY`：视频质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`IMAGE_QUALITY`：图片质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`IMAGE_RESIZE`：调整尺寸。调整图片大小，充分利用全屏功能。</li></ul> |
##|deeplink_utm_params|object[]|深度链接 URL 参数列表。URL 参数是可添加到 URL 末尾的代码片段，帮助你通过第三方分析平台监测不同渠道的点击量，并了解访客与网站的互动方式。这类参数由键值对组成，通过 `key` 和 `value` 传入。|
###|key|string|深度链接 URL 参数。<br><br>这类参数可为自定义参数或 UTM 参数。<br><br>支持的 UTM 参数包括：<ul><li>`utm_source`：为你的网站引流的应用、网站等。示例：TikTok。</li><li>`utm_medium`：广告或营销媒介。示例：CPM、CPC、横幅、视频。</li><li>`utm_content`：用于推广的创意内容。示例：广告名称、CTA、素材、颜色等。</li><li>`utm_campaign`：单个推广系列名称、宣传语或促销码。示例：黑色星期五促销活动。</li></ul>|
###|value|string|深度链接 URL 参数的值。<br><br>可为自定义值或宏名称。<br><br>支持的宏包括：<ul><li>`__CAMPAIGN_NAME__`：这将替换为你的推广系列名称。</li><li>`__CAMPAIGN_ID__`：这将替换为你的推广系列 ID。</li><li>`__AID_NAME__`：这将替换为你的广告组名称。</li><li>`__AID__`：这将替换为你的广告组 ID。</li><li>`__CID_NAME__`：这将替换为你的广告名称。</li><li>`__CID__`：这将替换为你的广告 ID。</li><li>`__PLACEMENT__`：这将替换为你的广告位。</li></ul>|
##|end_card_cta|string|[汽车库存轮播广告](1843325008693250.html)、升级版 Smart+ [汽车型号轮播广告](1843325022799873.html)或[适用于升级版 Smart+ TikTok 私信广告的商品库解决方案](https://business-api.tiktok.com/portal/docs?id=1847302969710913#item-link-For%20the%20catalog%20solution)的片尾卡片 (`image_ids`) 行动引导文案。<br><br>枚举值：<ul><li>`SEARCH_INVENTORY`（推荐）：搜索库存。</li><li>`LEARN_MORE`：查看详情。</li><li>`SHOP_NOW`：去逛逛。</li><li>`SIGN_UP`：立即注册。</li><li>`CONTACT_US`：联系我们。</li><li>`BOOK_NOW`：立即预约。</li><li>`READ_MORE`：阅读更多。</li><li>`VIEW_MORE`：立即查看。</li><li>`ORDER_NOW`：立即下单。</li><li>`SEND_MESSAGE`：发消息。<ul><li>此值仅适用于[升级版 Smart+ TikTok 私信广告的商品库解决方案](https://business-api.tiktok.com/portal/docs?id=1847302969710913#item-link-For%20the%20catalog%20solution)。</li></ul></li></ul>|
##|product_display_field_list|string[]|[汽车库存轮播广告](1843325008693250.html)中展示的商品详情的列表。<br><br>枚举值：<ul><li>`DEALER_NAME`：车辆的 `dealer_name` 字段。</li><li>`MAKE`：车辆的 `make` 字段。</li><li>`MODEL`：车辆的 `model` 字段。</li><li>`YEAR`：车辆的 `year` 字段。</li><li>`MILEAGE`：车辆的 `mileage` 字段。</li><li>`PRICE`：车辆的 `price` 字段。</li><li>`SALE_PRICE`：车辆的 `sale_price` 字段。</li><li>`EXTERIOR_COLOR`：车辆的 `exterior_color` 字段。</li><li>`TRIM`：车辆的 `trim` 字段。</li><li>`ADDRESS_CITY`：车辆的 `city` 字段。</li><li>`VEHICLE_STATE`：车辆的 `state_of_vehicle` 字段。</li></ul><br>每辆车的标题将自动显示。例如，如果将此字段设置为 `["MILEAGE","YEAR"]`，广告将展示每辆车的 `mileage`、`price` 和 `title` 字段。<br>若想获取汽车库存商品库中车辆的商品详情字段，并检查是否需要更新详情，需使用 [/catalog/product/get/](1740564136678402.html) 接口。|
##|auto_disclaimer_types|string[]|[汽车型号轮播广告](1843325022799873.html)中展示的免责声明类型。<br><br>枚举值：<ul><li>`EMISSION`：排放免责声明。</li><li>`DISCOUNT`：折扣或优惠免责声明。</li></ul>|
##|utm_params|object[]|URL 参数列表。<br><br>URL 参数是可添加到 URL 末尾的代码片段，帮助你通过第三方分析平台监测不同渠道的点击量，并了解访客与网站的互动方式。这类参数由键值对组成，通过 `key` 和 `value` 传入。|
###|key|string|URL 参数。<br><br>这类参数可为自定义参数或 UTM 参数。<br><br>支持的 UTM 参数包括：<ul><li>`utm_source`：为你的网站引流的应用、网站等。示例：TikTok。</li><li>`utm_medium`：广告或营销媒介。示例：CPM、CPC、横幅、视频。</li><li>`utm_content`：用于推广的创意内容。示例：广告名称、CTA、素材、颜色等。</li><li>`utm_campaign`：单个推广系列名称、宣传语或促销码。示例：黑色星期五促销活动。</li></ul>注意：UTM 参数区分大小写。|
###|value|string|URL 参数的值。<br><br>值可为自定义值或宏名称。<br><br>支持的宏包括：<ul><li>`__CAMPAIGN_NAME__`：这将替换为你的推广系列名称。</li><li>`__CAMPAIGN_ID__`：这将替换为你的推广系列 ID。</li><li>`__AID_NAME__`：这将替换为你的广告组名称。</li><li>`__AID__`：这将替换为你的广告组 ID。</li><li>`__CID_NAME__`：这将替换为你的广告名称。</li><li>`__CID__`：这将替换为你的广告 ID。</li><li>`__PLACEMENT__`：这将替换为你的广告位。</li></ul>|
##|fallback_type|string|失败路径类型。<br><br>用户因未安装应用而无法访问深度链接时跳转到的目标页面。<br><br>枚举值：<ul><li>`WEBSITE`：将推广的网页作为失败路径 URL。同时，你需要通过 `landing_page_url_list` 传入失败路径 URL。</li></ul><br>如需了解如何在 TikTok 即时通讯广告中配置失败路径 URL，参见[创建以即时通讯应用作为优化位置的升级版 Smart+ 线索收集推广系列](1847302988449921.html)。|
##|product_info|object|商品信息。<br><br>此信息将用于不同广告变体以实现个性化广告投放，从而提升广告效果。过去的数据表明，信息完整的广告通常能获得更高的点击量和转化量。具体效果可能有所不同。|
###| product_titles | string[] | 商品名称列表。 |
###| product_image_list | object[] | 商品图片列表。 |
####| web_uri | string | 商品图片 ID。 |
###| selling_points | string[] | 卖点列表。 |
###| catalog_tag_list | string[] | 在以下任意场景中返回：<ul><li>场景 1：推广系列层级的 `objective_type` 为 `WEB_CONVERSIONS` 且 `catalog_type` 为 `ECOMMERCE`。</li><li>场景 2： <ul><li>在推广系列层级，`objective_type` 为 `LEAD_GENERATION` 且 `catalog_enabled` 为 `true`。</li><li>在广告组层级通过 `catalog_id` 传入汽车库存商品库。</li></ul></li></ul>商品库广告的商品详细信息。<ul><li>在场景 1 中，将自动显示商品库中的已传入商品信息，以提升成效。枚举值包括：<ul><li>`PRICE`：价格。</li><li>`STRIKETHROUGH_PRICE`：划线价。</li><li>`DISCOUNT`：折扣。</li><li>`FREE_SHIPPING`：包邮。</li></ul></li><li>在场景 2 中，库存卡片上将显示传入商品信息的相应文本。枚举值包括：<ul><li>`DEALER_NAME`：经销商名称。</li><li>`CURRENT_MILEAGE`：当前里程。</li><li>`LEAD_PRICE`：价格。</li><li>`LEAD_SALE_PRICE`：促销价。</li><li>`EXTERIOR_COLOR`：外观颜色。</li><li>`TRIM`：内饰。</li><li>`ADDRESS_CITY`：城市。</li><li>`VEHICLE_STATE`：车辆状况。</li></ul></li></ul> |
###|product_card_type|string[]|商品卡片展示类型。<br><br>枚举值：<ul><li>`PRODUCT_CARD`：商品卡片。</li><li>`PRODUCT_TILE`：商品磁贴。</li><li>`PRODUCT_INFO_CARD`：信息卡片。</li><li>`PRODUCT_SHOWCASE_TILE`：展示磁贴。</li><li>`ANCHOR`：锚点。</li><li>`CAROUSEL_LABEL`：轮播标签。</li></ul>|
###| promo_info_list | object[] | 仅为[常规升级版 Smart+ 网站推广系列](1847302878676994.html)返回。<br><br>促销码和优惠的详细信息。<br><br>你的促销码、优惠或活动的详细信息将突出显示，以提升互动率和广告效果。促销码需要购物者在结账时输入。优惠会自动生效，无需输入代码。 |
####| 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>折扣值。|
####| discount_currency | string | 当 `discount_type` 为 `CASH` 时返回。<br><br>折扣币种。<br><br>枚举值参见<a href="#item-link-List of values for discount_currency or minimum_purchase_currency"> `discount_currency` 或 `minimum_purchase_currency` 值列表</a>。 |
####| promo_code | string | 促销码。 |
####| minimum_purchase_type | string | 最低购买要求类型。<br><br>枚举值：<ul><li>`QUANTITY`：最低购买数量。</li><li>`SUBTOTAL`：最低小计金额。</li></ul> |
####| minimum_purchase_value | float | 仅当传入 `minimum_purchase_type` 时返回。<br><br>最低购买要求值。 |
####| minimum_purchase_currency | string | 仅当 `minimum_purchase_type` 为 `SUBTOTAL` 时返回。<br><br>最低购买要求币种。<br><br>枚举值参见<a href="#item-link-List of values for discount_currency or 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`。 |
##| product_info_enabled | string | 商品信息模式。<br><br>枚举值：<ul><li>`UNSET`：禁用商品信息模式。</li><li>`NON_CATALOG`：启用非商品库版本的商品信息。</li><li>`CATALOG`：启用商品库版本的商品信息。</li></ul> |
##|call_to_action_id|string|广告中使用的行动引导文案素材包的 ID。|
##|phone_info|object|仅当广告组层级的 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` 时返回。<br><br>广告受众点击广告中的行动引导文案按钮后，用于直接拨打电话联系你（广告主）的电话号码的详细信息。<br><br>了解如何[创建以电话通话为优化位置的升级版 Smart+ 线索收集推广系列](1847302998941697.html)。|
###|phone_region_code|string|受众点击广告后可拨打的电话号码的地区代码。<br><br>示例：`US`。|
###|phone_region_calling_code|string|受众点击广告后可拨打的电话号码的国际区号。<br><br>示例：`+1`。|
###|phone_number|string|受众点击广告后可拨打的电话号码。<br><br>示例：`12638282`。|
##|tracking_info|object|监测信息。|
###|viewability_postbid_partner|string|出价后第三方可见性度量合作伙伴。<br><br>枚举值：`DOUBLE_VERIFY`、`IAS`、`ZEFR`。|
###|viewability_vast_url|string|当 `viewability_postbid_partner` 为 `IAS` 时返回。<br><br>出价后第三方合作伙伴用于度量可见性的包装 VAST URL。你需要从度量合作伙伴 IAS 处获取 URL。|
###|brand_safety_postbid_partner|string|出价后第三方品牌安全度量合作伙伴。<br><br>枚举值：`DOUBLE_VERIFY`、`IAS`、`ZEFR`。|
###|brand_safety_vast_url|string|当 `brand_safety_postbid_partner` 为 `IAS` 时返回。<br><br>出价后第三方合作伙伴用于度量品牌安全的包装 VAST URL。你需要从度量合作伙伴 IAS 处获取 URL。|
###|impression_tracking_url|string|默认展示监测 URL。|
###|click_tracking_url|string|点击监测 URL。|
###|tracking_app_id|string|度量的应用的 ID。|
###| tracking_pixel_id | string | Pixel ID，用于监测用户在你的网站上执行的操作，例如页面浏览、加入购物车、付费等。 |
###| tracking_offline_event_set_ids | string[] | 线下事件组 ID 列表，用于监测线下客户行为，例如实体店购买或参加现场活动。 |
###|tracking_message_event_set_id|string|要在即时通讯广告中度量的通讯事件组的 ID。|
###| app_tracking_info_list | object[] | 第三方监测设置的详细信息。 |
####| app_type | string | 当传入 `app_tracking_info_list` 时返回。<br><br>应用类型。<br><br>枚举值：<ul><li>`APP_ANDROID`：Android 应用。</li><li>`APP_IOS`：iOS 应用。</li></ul> |
####| app_id | string | 当传入 `app_tracking_info_list` 时返回。<br><br>应用 ID。<ul><li>当 `app_type` 为 `APP_ANDROID` 时，此字段表示 Android 应用 ID。</li><li>当 `app_type` 为 `APP_IOS` 时，此字段表示 iOS 应用 ID。</li></ul> |
####| impression_tracking_url | string | 展示监测 URL。<ul><li>当 `app_type` 为 `APP_ANDROID` 时，此字段表示 Android 展示监测 URL。</li><li>当 `app_type` 为 `APP_IOS` 时，此字段表示 iOS 展示监测 URL。</li></ul> |
####| click_tracking_url | string | 点击监测 URL。<ul><li>当 `app_type` 为 `APP_ANDROID` 时，此字段表示 Android 点击监测 URL。</li><li>当 `app_type` 为 `APP_IOS` 时，此字段表示 iOS 点击监测 URL。</li></ul> |
|page_info|object|分页信息。|
#|page|number|当前页码。|
#|page_size|number|分页大小。|
#|total_number|number|结果总数。|
#|total_page|number|结果总页数。|

示例

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_configuration": {
            "call_to_action_id": "{{call_to_action_id}}",
            "tracking_info": {},
            "utm_params": [
                {
                    "key": "{{key}}",
                    "value": "{{value}}"
                }
            ]
        },
        "ad_name": "{{ad_name}}",
        "ad_text_list": [
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            }
        ],
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "advertiser_id": "{{advertiser_id}}",
        "call_to_action_list": [],
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "create_time": "{{create_time}}",
        "creative_list": [
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format":"SINGLE_VIDEO",
                    "identity_authorized_bc_id": "0",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "",
                    "video_info": {
                        "file_name": "",
                        "video_id": "{{video_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format":"SINGLE_VIDEO",
                    "identity_authorized_bc_id": "0",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "tiktok_item_id": "{{tiktok_item_id}}"
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format":"SINGLE_VIDEO",
                    "identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "BC_AUTH_TT",
                    "tiktok_item_id": "{{tiktok_item_id}}"
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format":"CAROUSEL_ADS",
                    "identity_authorized_bc_id": "0",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "{{material_name}}",
                    "music_info": {
                        "music_id": "{{music_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format":"SINGLE_VIDEO",
                    "identity_authorized_bc_id": "0",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "AUTH_CODE",
                    "tiktok_item_id": "{{tiktok_item_id}}"
                },
                "material_operation_status": "ENABLE"
            }
        ],
        "deeplink_list": [],
        "interactive_add_on_list": [],
        "landing_page_url_list": [
            {
                "landing_page_url": "{{landing_page_url}}"
            }
        ],
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "page_list": [],
        "secondary_status": "AD_STATUS_AUDIT",
        "smart_plus_ad_id": "{{smart_plus_ad_id}}"
    }
}
(/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 每日平台更新简报 →