← 返回目录
📁 API Reference › Ads

创建广告

你可以使用本接口上传广告素材（图片、视频、标题，行动引导文案）以创建普通广告。

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

使用前需知

在继续操作前，先查阅创建推广系列，了解可用的推广系列创建使用场景，以便确定最适合您集成方案的业务场景。

不同的版位会对应不同的素材格式和要求，请根据相应素材的具体要求上传。点击这里查看如何创建普通广告。

每个广告组下最多包含 20 个或 50 个普通广告。 - 若广告组所属的推广系列的推广目标为RF_REACH，则该广告组内最多可以包含 20 个广告。 - 若广告组所属的推广系列的推广目标为PRODUCT_SALES，则该广告组内最多可以包含 20 个广告（campaign_product_source 为 STORE 时）或 50 个广告（campaign_product_source 为 CATALOG 时）。 - 若广告组所属的推广系列的推广目标非PRODUCT_SALES或RF_REACH，则该广告组内最多可以包含 50 个广告。

若想创建智能创意广告，需使用 /ad/aco/create/ 接口。

在迁移至 1.3 版本前，请先阅读推广系列管理接口迁移指南，了解推广系列管理 API 1.2 与 1.3 版本之间的重点差异。

若想了解 TikTok 广告管理平台上推广系列、广告组、广告层级的功能在 API 中的对应配置，请查看TikTok 广告管理平台的推广系列功能与 API 配置间的映射。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/ad/create/|/v1.3/ad/create/| |请求参数名称|product_ids<br>open_url<br>open_url_type<br>is_creative_authorized<br>dpa_fallback_type<br>dpa_open_url_type<br>dpa_video_tpl_id|item_group_ids<br>deeplink<br>deeplink_type<br>creative_authorized<br>shopping_ads_fallback_type<br>shopping_ads_deeplink_type<br>shopping_ads_video_package_id| |请求参数类型|advertiser_id: number<br>adgroup_id: number<br>card_id: number|advertiser_id: string <br>adgroup_id: string <br>card_id: string | |废弃请求参数|/|premium_badge_id| |新增请求参数|/ |product_specific_type<br>item_group_ids<br>product_set_id<br>sku_ids<br>dynamic_format<br>vertical_video_strategy<br>dynamic_destination<br>instant_product_page_used<br>card_type<br>card_image_id<br>card_tags<br>card_show_price<br>card_image_index<br>page_image_index<br>brand_safety_vast_url<br>viewability_postbid_partner<br>viewability_vast_url<br>utm_params<br>key<br>value<br>showcase_products（包括该对象内的参数）<br>tracking_app_id<br>tracking_offline_event_set_ids<br>music_id<br>carousel_image_index<br>tiktok_page_category<br>phone_region_code<br>phone_region_calling_code<br>phone_number<br>schedule_id<br>deeplink_format_type<br>deeplink_utm_params<br>cpp_url<br>aigc_disclosure_type<br>tracking_message_event_set_id<br>auto_message_id<br>ad_texts<br>creative_auto_enhancement_strategy_list| |请求参数其他变动|/ |identity_type和identity_id必填。| |返回参数|/|在v1.3中，系统将返回广告实体的完整信息。详情请参阅本页面的<strong>返回</strong>部分。| |返回参数类型|ad_ids: number[]|ad_ids`: string[] |


## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/ad/create/


**方法** POST

**Header**

```xtable
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://business-api.tiktok.com/portal/docs/marketing-api-authentication/v1.3)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许值：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|adgroup_id {必填}|string| 广告组 ID。 |
|creatives {必填}|object[]| 广告创意。<br><br>最大数量：20。<br>单次请求中可在一个广告组中创建最多 20 个广告。若想在同一广告组中创建额外的广告，需多次调用`/ad/create/`。|
#|ad_name {必填}|string| 广告名称。<br><br>若想使广告名称自动生成，可传入 `""` （空字符串）。自动生成广告名格式：广告 ID （`ad_id`）。<br><br>长度限制：512字符且不能包含表情符号。 <br> <br><p><span style="color:darkred"><b>注意</b></span>：中文或日文每个字占用2个字符，每个英语字符占用1个字符。|
#|identity_type {必填}|string|认证身份类型。<br><br>枚举值：  `CUSTOMIZED_USER` (自定义用户），`AUTH_CODE` (授权用户)， `TT_USER` (TikTok 企业号用户）， `BC_AUTH_TT`（添加到商务中心的TikTok用户）。<br><br>关于认证身份的更多信息，请访问[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。 |
#|identity_id {必填}|string|认证身份ID。<br><br>如果您不使用Spark Ads，传入 `identity_id` 和 `identity_type` (`CUSTOMIZED_USER`类型)可帮助您更好地管理广告信息。 |
#|identity_authorized_bc_id{+条件必填}|string|当`identity_type` 为 `BC_AUTH_TT`时必填。<br><br>与添加到商务中心的TikTok用户这一认证身份绑定的商务中心的ID。|
#|catalog_id {+条件必填}|string|您为广告选择的商品库ID。商品来源为商品库的购物广告必填。广告中所展示的商品即来自该商品库。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月 30 日起，广告组层级 `product_source` 为 `STORE` 时，您将无需再传入本字段，因为本字段将被忽略。|
#|product_specific_type{+条件必填}|string|仅以下任意场景下必填：<ul><li> `shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `CATALOG`。</li><li>`shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 设置为 `STORE`。</li></ul><br>选择商品的维度。<br><br>枚举值：<ul><li>`ALL`：允许 TikTok 从所有商品中动态选择。</li><li> `PRODUCT_SET`：请选择一个商品系列。TikTok 将动态选择该商品系列中的商品。</li><li>`CUSTOMIZED_PRODUCTS`：选择自定义数量的特定商品。</li></ul><br>若 `shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `CATALOG`，支持将本字段设置为 `ALL` ，`PRODUCT_SET` 或`CUSTOMIZED_PRODUCTS` 。<ul><li>若本字段设置为 `ALL`，无需传入 `sku_ids`，`item_group_ids` 和 `product_set_id`。</li><li>若本字段设置为 `PRODUCT_SET`，需传入`item_group_ids` 和 `product_set_id` 其中之一。 </li><li>若本字段设置为 `CUSTOMIZED_PRODUCTS`，需传入`sku_ids` 。</li></ul><br>若 `shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 设置为 `STORE`，支持将本字段设置为 `ALL` 或 `CUSTOMIZED_PRODUCTS`。 <ul><li>若本字段设置为 `ALL`，无需传入 `sku_ids`，`item_group_ids` 和 `product_set_id`。</li><li>若本字段设置为 `CUSTOMIZED_PRODUCTS`，需传入`item_group_ids `。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>若 `shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为`STORE`，需通过 `item_group_ids` 字段直接指定商品。</li><li>若 `shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为`SHOWCASE`，需通过 `showcase_products` 字段直接指定商品。</li><li>若 `shopping_ads_type` 设置为 `LIVE`，则无需指定商品。</li></ul>|
#|item_group_ids{+条件必填}|string[]|<ul><li>若`shopping_ads_type`设置为 `VIDEO`， `product_source` 设置为 `CATALOG`，且 `product_specific_type` 设置为 `PRODUCT_SET`，您需传入`item_group_ids` 和 `product_set_id` 其中之一。</li><li>若`shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` , `product_source` 设置为 `STORE` ，且`product_specific_type` 设置为 `CUSTOMIZED_PRODUCTS`，本字段必填。</li></ul><br>商品的 SPU （标准化产品单元）ID 列表。<br><br>最大数量：<ul><li>`shopping_ads_type` 设置为 `VIDEO`， `product_source` 设置为 `CATALOG`，且 `product_specific_type` 设置为 `PRODUCT_SET` 时：20。</li><li>`shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS` , `product_source` 设置为 `STORE`，且`product_specific_type` 设置为 `CUSTOMIZED_PRODUCTS` 时：50。</li></ul>|
#|product_set_id{+条件必填}|string|若`shopping_ads_type` 设置为 `VIDEO`， `product_source` 设置为 `CATALOG`，且 `product_specific_type` 设置为 `PRODUCT_SET`，您需传入`item_group_ids` 和 `product_set_id` 其中之一。 <br><br>商品系列ID。|
#|sku_ids{+条件必填}|string[]|`shopping_ads_type` 设置为 `VIDEO` ，`product_source` 设置为 `CATALOG`，且 `product_specific_type` 设置为 `CUSTOMIZED_PRODUCTS` 时必填。 <br><br>商品的 SKU（库存量单位）ID列表。<br><br>最大数量：20。|
#| showcase_products {+条件必填} | object[] | 广告组层级`product_source`设置为`SHOWCASE`时必填。您可查看[创建商品来源为橱窗的视频购物广告](https://ads.tiktok.com/marketing_api/docs?id=1759232259360770)了解详情。<br>您想要用在广告中的橱窗商品列表。最大数量：20。<br> 您可调用[/showcase/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1759233576199169)，获取可用的橱窗商品。 |
##| item_group_id | string | 商品的SPU ID。 |
##| store_id | string | 商品（`item_group_id`）所属的店铺ID。<br>请注意本字段仅支持TikTok Shop店铺。 |
##| catalog_id | string | 商品（`item_group_id`）所属的商品库ID。 <br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月 30 日起，广告组层级 `product_source` 为 `STORE` 时，您将无需再传入本字段，因为本字段将被忽略。|
#| ad_format {必填} | string | 广告样式。<br>枚举值：`SINGLE_IMAGE`，`SINGLE_VIDEO`，`LIVE_CONTENT`，`CAROUSEL_ADS`，`CATALOG_CAROUSEL`。 <br> 本字段在以下场景必填： <ul><li> 单视频广告需将该字段设为 `SINGLE_VIDEO`。 </li><li>单图片广告需将该字段设为`SINGLE_IMAGE`。  </li><li> TikTok 标准轮播广告需将该字段设为 `CAROUSEL_ADS`。</li><li> 视频购物类型的TikTok轮播广告需将该字段设为`CATALOG_CAROUSEL`。<br>点击[这里](https://ads.tiktok.com/marketing_api/docs?id=1766217791987713)查看创建轮播广告的步骤。</li><li> 直播购物广告需将该字段设为 `LIVE_CONTENT`。  </li></ul><p><span style="color:darkred"><b>注意</b></span>： <ul><li>本字段设置为 `CAROUSEL_ADS`或`CATALOG_CAROUSEL`后不允许更新。 </li></ul>     |
#|vertical_video_strategy|string|商品销量场景中使用的视频类型。 <br><br>枚举值： `UNSET`（未设置），`SINGLE_VIDEO`（单个视频），`CATALOG_VIDEOS`（使用视频模板的商品库视频），`CATALOG_UPLOADED_VIDEOS`（使用已上传视频的商品库视频）， `LIVE_STREAM`（直播视频）。 <br><br> 如果`dynamic_format`为`DYNAMIC_CREATIVE`，该字段必须设置为`UNSET`。 <br><br>若想了解如何管理已上传的商品库视频，从而用于商品来源为商品库的视频购物广告中，可查看[上传商品库视频并与商品绑定](1803654904260674.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>使用已上传的商品库视频创建广告样式为商品库视频、商品来源为商品库的视频购物广告（即`vertical_video_strategy` 设置为 `CATALOG_UPLOADED_VIDEOS`）目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>将 `vertical_video_strategy` 设置为 `CATALOG_UPLOADED_VIDEOS` 后，不允许将该字段更新为其他值。</li></ul>|
#|dynamic_format|string|动态样式。<br><br>枚举值：<ul><li>`DYNAMIC_CREATIVE`：动态样式。根据用户的购买意图向每位用户展示不同的视频，商品卡片和目标页面，从而最大限度地提高广告转化量。 </li><li>`UNSET`：未设置。</li></ul>|
#|video_id {+条件必填}|string| <ul><li>`ad_format` 设置为`SINGLE_VIDEO`且`identity_type` 为 `CUSTOMIZED_USER`时必填。</li><li>`ad_format` 设置为`SINGLE_VIDEO` 且`identity_type` 为`TT_USER`或`BC_AUTH_TT`时，您需传入`video_id` 和 `tiktok_item_id` 其中之一。</li><li>`ad_format` 设置为 `SINGLE_IMAGE` 或 `CAROUSEL_ADS` 时不支持本字段。</li></ul><br>视频 ID。<br><br>若要创建 Spark Ads，您需使用 `video_id` 或 `tiktok_item_id`。若想了解 Spark Ads 详情，请查看[创建Spark Ads](https://ads.tiktok.com/marketing_api/docs?id=1739470744631298)。<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 进行绑定。|
#| image_ids {+条件必填} | string[] | 图片 ID 列表（图片素材或视频封面）。<br>可使用接口[/file/image/ad/search/](https://ads.tiktok.com/marketing_api/docs?id=1740052016789506)或[/file/image/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1739067433456642)获取。  <ul><li>当`ad_format`设置为`SINGLE_VIDEO`时：<ul><li>若想创建非 Spark Ads 的视频广告或通过 Spark Ads 推送创建 Spark Ads 视频广告，本字段必填且传入的值会作为视频封面（缩略图）（只允许传入一个值），此时您传入的图片宽高比需要与视频的宽高比保持一致。</li><li> 若想通过 Spark Ads 提取创建 Spark Ads 视频广告，不支持本字段。此时应传入`tiktok_item_id` 。</li></ul></li><li>当 `ad_format`设置为`CAROUSEL_ADS`时：<ul><li>若想创建非 Spark Ads 的标准轮播广告或通过 Spark Ads 推送创建 Spark Ads 标准轮播广告，本字段必填且本字段的 ID 数量范围为&#91;1, 35&#93;，且本字段指定的图片 ID 的顺序即为轮播广告中对应图片的展示顺序。  <br>请查看[创建轮播广告](https://ads.tiktok.com/marketing_api/docs?id=1766217791987713)，了解可在 TikTok 标准轮播广告中使用的图片的要求。</li><li> 若想通过 Spark Ads 提取创建 Spark Ads 标准轮播广告，不支持本字段。此时应传入`tiktok_item_id`。</li></ul></li><li>当 `ad_format` 设置为 `SINGLE_IMAGE` 时，本字段必填且您仅可向本字段传入一个图片 ID。<br>若想了解单图片广告中的图片要求，请查看[创建单图片广告](1777633230937090.html)。</li></ul>|
#| carousel_image_index |integer| 仅当`ad_format`设置为`CATALOG_CAROUSEL`，且所指定的商品已设置对应的附加图片 URL 列表时生效。 <br><br>用于指定视频购物类型的轮播广告中要使用的附加图片的索引。若未传入本字段，将在视频购物类型的轮播广告中使用商品库商品的主图。<br><br>取值范围：&#91;0, 9&#93;。<ul><li>您通过本字段传入的数值代表每个商品库商品的附加图片列表（`additional_image_urls`）中要使用的附加图片的位置。例如，若`carousel_image_index` 设置为<strong> 1</strong>，代表您将使用每个`additional_image_urls`的值中的<strong>第二个</strong>图片作为轮播广告中使用的图片。您可通过[/catalog/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1740564136678402)返回的`additional_image_urls`字段获取商品对应的附加图片列表。</li><li>若您使用了本字段指定附加图片索引，系统将计算有可用附加图片的电商商品数量。若根据您提供的索引无法匹配到商品的对应附加图片，或从匹配到的附加图片 URL 拉取商品的附加图片失败，则该商品将不会计入。<ul><li> 有可用附加图片的商品总数大于等于 2 时，仅在广告中展示这些有可用附加图片的商品，并使用商品的附加图片。</li><li> 有可用附加图片的商品总数小于 2 时，将展示所有商品，并均使用商品的主图。</li></ul></li></ul> |
#| music_id {+条件必填} | string | 以下任意场景下必填：<ul><li>`ad_format` 设置为 `CAROUSEL_ADS` 且您想要创建非 Spark Ads 的标准轮播广告或通过 Spark Ads 推送创建 Spark Ads 标准轮播广告。</li><li>`ad_format` 设置为 `CATALOG_CAROUSEL`</li></ul><br>想要在 TikTok 轮播广告中使用的音乐的 ID。 <br>请查看[创建轮播广告-步骤-创建一个广告](https://ads.tiktok.com/marketing_api/docs?id=1766217791987713)，了解如何获取可在TikTok轮播广告中使用的音乐ID。   |
#|tiktok_item_id {+条件必填}|string| <ul><li>`identity_type` 设置为`AUTH_CODE`，`TT_USER` 或 `BC_AUTH_TT` 且您想要通过 Spark Ads 提取创建 Spark Ads 时必填。</li><li>`identity_type` 设置为 `CUSTOMIZED_USER` 时不支持本字段。</li></ul> <br>用作 Spark Ads 的 TikTok 帖子 ID。<br><br>若想了解 Spark Ads 详情，请查看[创建 Spark Ads](1739470744631298.html)。<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><p><span style="color:darkred"><b>注意</b></span>：使用此功能，代表您声明拥有该视频中音乐的版权，可用于营销使用。 |
#| promotional_music_disabled | boolean |是否关闭推广音乐开关。`true`： 关闭；`false`： 打开。默认`true`。如果您想为TikTok视频开启合拍或跟拍，请将该字段设置为`false`，即打开推广音乐。 |
#|item_duet_status |string |合拍开关状态。`ENABLE`: 打开合拍；`DISABLE`: 禁止合拍。默认值: `DISABLE`。只有在`promotional_music_disabled`设置为`false`时，该字段才有效。|
#|item_stitch_status |string |跟拍开关状态。`ENABLE`: 打开跟拍；`DISABLE`: 禁止跟拍。默认值: `DISABLE`。只有在`promotional_music_disabled`设置为`false`时，该字段才有效。 |
#| dark_post_status | string | 表示该视频是否为dark post。返回值可以是`OFF`或者`ON`。默认值：`ON`。<br>dark post广告不会出现在创作者的TikTok主页。<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>|
#|shopping_ads_video_package_id|string| 商品视频包 ID。使用[/catalog/video/get/](https://ads.tiktok.com/marketing_api/docs?id=1740574099715073)接口获取视频包ID。|
#|ad_text {+条件必填}|string| <ul><li>对于非 Spark Ads，需传入 `ad_text` 和 `ad_texts` 其中之一。</li><li> 对于[ Spark Ads 推送](https://business-api.tiktok.com/portal/docs?id=1739470744631298#item-link-Spark%20Ads%20%E6%8E%A8%E9%80%81)，`ad_text` 必填。</li></ul><br>广告文案，将作为广告创意的一部分展示给你的受众，向他们传达你想要推广的信息。不知道怎么写？试试[智能文案](https://ads.tiktok.com/marketing_api/docs?id=1739084248002626)。<ul><li>广告文案长度允许值为 1-100 字符，不能包含emoji。</li><li>中文或日文每个字占用2个字符，每个英语字符占用1个字符。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>若同时指定 `ad_text` 和 `ad_texts`，将忽略 `ad_text`。</li></ul>|
#|ad_texts{+条件必填}|string[]|<ul><li>对于非 Spark Ads，需传入 `ad_text` 和 `ad_texts` 其中之一。</li><li>仅对[搜索广告推广系列](1815394136739841.html)生效。</li></ul><br>广告文案列表。<br>广告文案将作为广告创意的一部分展示给您的受众，向他们传达您想要推广的信息。若您指定多个广告文案，系统将自动将相关性最强的文案展示给受众并自动优化文案效果。<br><br>若您不确定如何构思有效的广告文案，可使用[智能文案](https://ads.tiktok.com/marketing_api/docs?id=1739084248002626)功能，获取基于语言和行业的推荐广告文案。<br><br>长度限制：5。<br><br>单个广告文案的长度限制：100 字符，且不能包含 emoji。<br>中文或日文每个字占用 2 个字符，每个英语字符占用 1 个字符。<br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>若同时指定 `ad_text` 和 `ad_texts`，将忽略 `ad_text`。</li><li>搜索广告推广系列中的智能多标题广告文案（`ad_texts`）目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li></ul>|
#|call_to_action {+条件必填}|string| 行动引导文案，引导用户在看到您的广告后完成您期望的行为。<br><br>对于TikTok广告，本字段或者`call_to_action_id`必须传入一个。<br><br>枚举值见 [枚举值-行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><br>直播购物广告中若`creative_type`设置为`SHORT_VIDEO_LIVE`，则本字段必填且必须设置为`WATCH_LIVE`。 |
#|call_to_action_id {+条件必填}|string|行动引导文案素材包ID。行动引导文案素材包指的是一组自动优化的行动引导文案。<br><br>如果本字段和`call_to_action`都传入，`call_to_action`会被忽略。<br><br>关于自动优化行动引导文案的更多信息，请参见[智能推荐CTA > 动态优选CTA](https://ads.tiktok.com/marketing_api/docs?id=1740307296329730)。|
#|card_id|string|创意素材包 ID。<br><br>传入以下类型的创意素材包的 ID：<ul><li>行动引导文案。</li><li>展示卡片（又称图片卡片）。</li><li>网站信息卡片。</li><li>下载卡。</li><li>商品卡片。</li><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><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>商品磁贴素材包在广告中使用后，不允许再从广告中清空，但允许将其更新为其他的素材包。</li></ul>|
#|landing_page_url {+条件必填}|string|用户跳转至的落地页。 <br><br>落地页 URL 支持在末尾拼接 URL 参数。若想了解 URL 参数详情，请查看字段`utm_params`的对应描述。<br><br>示例：https://www.example.com?utm_source=TikTok&utm_medium=video&utm_campaign=Campaign1&utm_content=Content1|
#|utm_params|object[]|本字段支持在以下场景中使用：<ul><li>商品来源为商品库的视频购物广告场景：<ul><li>推广系列层级：<ul><li>`objective_type` 设置为 `PRODUCT_SALES`</li></ul></li><li>广告组层级：<ul><li> `shopping_ads_type` 设置为 `VIDEO`（视频购物广告）</li><li>`product_source` 设置为 `CATALOG` </li><li>`promotion_type` 设置为 `WEBSITE`，`APP_ANDROID`，或 `APP_IOS`</li></ul></li></ul></li><li>非视频购物广告场景：<ul><li>推广系列层级：<ul><li>`objective_type` 设置为 `REACH`，`TRAFFIC`，`VIDEO_VIEWS`， `LEAD_GENERATION`，`ENGAGEMENT`，`APP_PROMOTION` （`app_promotion_type` 需设置为`APP_PREREGISTRATION`），`WEB_CONVERSIONS` 或 `RF_REACH`。</li></ul></li></ul></li></ul><br>URL 参数列表。URL 参数是可以添加到 URL 末尾的代码片段，可以帮助您通过第三方分析平台监测来自不同渠道的点击，并了解访客与网站的互动情况。每个 URL 参数由`key`和`value`指定的键值对组成。<br><br>最大数量：14。<br><br><ul><li>若您在广告中使用商品库链接（`shopping_ads_fallback_type` 为 `SHOPPING_ADS`），您可通过传入`utm_params`为商品库链接添加 URL 参数。URL 参数将在广告投放时自动拼接到商品库链接。</li><li>若您在广告中使用自定义链接（网站 URL）（`shopping_ads_fallback_type` 为 `CUSTOM`），您可手动为自定义链接添加 URL 参数，然后将 `landing_page_url` 直接设置为带有 URL 参数的 URL。 <ul><li>然而，若您在广告中使用自定义链接且同时传入了 `utm_params`，在广告投放时 URL 参数不会自动拼接到自定义链接（`landing_page_url`）。此时，您需确保通过`landing_page_url` 指定的 URL 已经带有 URL 参数，且`utm_params` 与 URL 中的 URL 参数完全匹配。否则，将出现报错。 </li></ul></li><li>在非视频购物广告场景，若您将 `landing_page_url` 设置为一个已带有 URL 参数的 URL，您可同时传入 `utm_params`，以记录 URL 中带有的 URL 参数。此时，您需确保 `utm_params` 与 URL中的 URL 参数完全匹配。在广告投放时 URL 参数不会自动拼接到`landing_page_url`。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：在非视频购物广告场景使用 `utm_params` 目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。  |
##| key|string|URL 参数。<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`：单个推广系列的名称、标语或促销代码。示例：BlackFridayProm。</li></ul><br>请注意，UTM 参数区分大小写。<br><br>若传入自定义参数，则长度限制为 100 个字符。|
##| value|string|URL 参数的值。<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 个字符。|
#|page_id {+条件必填}|number| 页面 ID。<br><br><ul><li>若想获取您的广告账号中的页面，可使用[/page/get/](1820826387779586.html)。</li><li>若想创建即时体验页面，可使用[即时体验页面编辑器](1740307202170881.html)。</li></ul><br>即时表单仅当推广系列的推广目标为 `LEAD_GENERATION` 时有效，仅支持 TikTok 版位。（首次创建前需要通过[协议管理-签订](https://ads.tiktok.com/marketing_api/docs?id=1737192284435457)签订 `LeadAds` 协议）。<br>注意:  我们将于2023年2月16起不再支持创建精品栏广告。为保证流畅的API体验，请勿将商品橱窗页面设为落地页。|
#| cpp_url | string |自定产品页面 URL。<br>自定产品页面是一种定制化的产品页面，支持自定义截图、推广文字和应用预览，可用于突出介绍所推广应用的特定内容或功能，或针对特定受众群体进行推广。<br><br>自定产品页面 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> 若想了解支持使用自定产品页面的场景以及相关步骤，请查看[自定产品页面](1798658439859202.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：在广告中使用自定产品页面目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。|
#|tiktok_page_category{+条件必填}|string|当广告组层级的`optimization_goal` 为 `PAGE_VISIT`时，此字段为必填项。 <br><br>您希望推广的 TikTok 页面的类别。<br><br>枚举值： <ul><li>`PROFILE_PAGE`：TikTok 账号主页。无需传入`landing_page_url` 或 `page_id`。</li><li>`OTHER_TIKTOK_PAGE`：其他 TikTok 页面，包括播放列表页面、话题标签页面、音乐页面和商业化特效页面。您需同时通过 `landing_page_url` 指定具体的 TikTok 页面 URL。<ul><li> 若想获取 TikTok 页面 URL，可在 TikTok 应用中点按你要推广的 TikTok 页面右上角的分享按钮，然后点击复制 URL。</li></ul></li><li>`TIKTOK_INSTANT_PAGE`：自定义 TikTok 即时体验页面。您需同时通过 `page_id` 指定具体的自定义 TikTok 即时体验页面。<ul><li>若想获取广告账户中的自定义 TikTok 即时体验页面，可使用 [/page/get/](1820826387779586.html) 并将 `business_type` 设置为 `TIKTOK_INSTANT_PAGE`。 </li></ul></li></ul><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>广告创建后，此字段不支持更新。 </li><li>若您将 `tiktok_page_category` 设置为 `OTHER_TIKTOK_PAGE`，则广告创建后不支持更新 `landing_page_url`。</li></ul>|
#| phone_region_code {+条件必填} | string | 若广告组层级 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` ， 则 `phone_number` ， `phone_region_calling_code` 以及 `phone_region_code` 参数均为必填。<br><br>受众可点击广告拨打的电话号码的地区代码。 <br><br> 示例：`US`。 <br><br>若想了解如何创建推广对象类型为电话通话的线索广告，请查看[这里](1774482936048641.html)。 <br>若想获取与某一电话号码所绑定的地区对应的地区代码（ `phone_region_code` ）和电话区号 （ `phone_region_calling_code` ），需使用[/tool/phone_region_code/](1774488637039618.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：创建推广对象类型为电话通话的线索广告目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。 |
#| phone_region_calling_code {+条件必填} | string | 若广告组层级 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` ， 则 `phone_number` ， `phone_region_calling_code` 以及 `phone_region_code` 参数均为必填。 <br><br>受众可点击广告拨打的电话号码的区号。 <br><br>示例： `+1`。<br><br>若想了解如何创建推广对象类型为电话通话的线索广告，请查看[这里](1774482936048641.html)。 <br>若想获取与某一电话号码所绑定的地区对应的地区代码（ `phone_region_code` ）和电话区号 （ `phone_region_calling_code` ），需使用[/tool/phone_region_code/](1774488637039618.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：创建推广对象类型为电话通话的线索广告目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。 |
#| phone_number {+条件必填} | string | 若广告组层级 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` ， 则 `phone_number` ， `phone_region_calling_code` 以及 `phone_region_code` 参数均为必填。<br><br>受众可点击广告拨打的电话号码。<br><br>示例：`12638282`。<br><br>若想了解如何创建推广对象类型为电话通话的线索广告，请查看[这里](1774482936048641.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：创建推广对象类型为电话通话的线索广告目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。 |
#| creative_auto_enhancement_strategy_list | string[] | 应用于你的广告的自动优化策略列表。<br>你传入的优化功能将在你的推广系列投放期间自动实时应用。<br><br>枚举值：<ul><li>`VIDEO_QUALITY`：视频质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`MUSIC_REFRESH`：音乐焕新。替换为当前 TikTok 上流行的音乐，紧跟潮流趋势。</li><li>`IMAGE_QUALITY`：图片质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`IMAGE_RESIZE`：调整尺寸。调整图片大小，充分利用全屏功能。</li></ul><br>此字段的默认值取决于你是否已加入“默认启用自动优化”功能的白名单：<ul><li>如果你已加入默认启用特定策略的白名单，此字段的默认值将为包含这些策略的列表。<ul><li>例如，如果你已加入默认启用所有这些策略的白名单，此字段的默认值将为 `&#91;"MUSIC_REFRESH","VIDEO_QUALITY","IMAGE_QUALITY","IMAGE_RESIZE"&#93;`。 </li></ul></li><li>如果你未加入默认启用任何策略的白名单，此字段的默认值将为空列表 (`&#91;&#93;`)。</li></ul><br>查看[适用于手动广告的自动优化功能](https://business-api.tiktok.com/portal/docs?id=1855450880142402#item-link-手动广告)，了解可启用此设置的场景。<br><br><p><span style="color:darkred"><b>注意</b></span>：自动优化功能面向所有广告主提供。但默认启用这些功能目前为白名单功能，并且每一项优化功能的默认启用均需单独申请。如需使用此功能，请联系你的 TikTok 销售代表。 </p>|
#|deeplink |string|深度链接，即已安装应用的用户点击链接后跳转至的特定页面。<br>参见`deeplink_type`。<br><br>若想了解非延迟深度链接和延迟深度链接的支持场景，请查看“[深度链接 - 支持范围 - 深度链接](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-支持范围)”小节。<br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>延迟深度链接目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。请注意，设置延迟深度链接需要相应的技术资源和开发能力。</li><li>非延迟深度链接在某些场景下目前为白名单功能。若想了解非延迟深度链接为白名单功能的具体场景，请查看“[深度链接 - 支持范围 - 深度链接](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-支持范围)”小节。如需在这些场景中使用此功能，请联系您的TikTok销售代表。</li></ul>|
#|deeplink_type |string| 深度链接类型。 <br><br>枚举值：<ul><li>`NORMAL`：非延迟深度链接。</li><li>`DEFERRED_DEEPLINK`：延迟深度链接。</li></ul><br>默认值：`NORMAL`。<br><br>若想了解非延迟深度链接和延迟深度链接的支持场景，请查看“[深度链接 - 支持范围 - 深度链接](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-支持范围)”小节。<br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>延迟深度链接目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。请注意，设置延迟深度链接需要相应的技术资源和开发能力。</li><li>非延迟深度链接在某些场景下目前为白名单功能。若想了解非延迟深度链接为白名单功能的具体场景，请查看“[深度链接 - 支持范围 - 深度链接](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-支持范围)”小节。如需在这些场景中使用此功能，请联系您的TikTok销售代表。</li><li>专属推广系列中不支持延迟推广系列。因此，若广告所属的推广系列的 `campaign_type` 为 `IOS14_CAMPAIGN`，则不支持将本字段设置为 `DEFERRED_DEEPLINK` 。</li></ul>|
#| deeplink_format_type {+条件必填} | string | 推广系列层级 `objective_type` 设置为 `TRAFFIC` ，且广告组层级`optimization_goal` 设置为 `DESTINATION_VISIT` 时，`deeplink_format_type` 和 `deeplink` 均必填。 <br><br>深度链接的格式类型。 <br><br>枚举值：  <ul><li>`UNIVERSAL_OR_APP`：通用/应用链接，即以`http://`或 `https://` 开头的 iOS 通用链接或 Android 应用链接。</li><li>`SCHEME`：URL 架构，即格式为`scheme://resource` 的自定义网址架构。例如，WhatsApp 的自定义网址架构格式应为`whatsapp://resource`。</li></ul><br>若想了解如何在访问量广告中使用目标页面访问这一优化目标，请查看[优化访问量广告中的目标页面访问](1782086241778690.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不允许更新。 |
#|shopping_ads_deeplink_type |string| 在购物广告中要使用的深度链接的来源。<br><br>枚举值：<ul><li>`NONE`：不设置深度链接。</li><li>`CUSTOM`：自定义深度链接。在广告中使用你提供的深度链接。您需同时传入`deeplink`。</li><li>`SHOPPING_ADS`：商品库深度链接。使用商品库中为各商品添加的深度链接。</li></ul><br>默认值：`NONE`。<br><br>`SHOPPING_ADS` 的值不支持在满足以下条件的场景中使用：<ul><li>广告组层级：<ul><li>`shopping_ads_type` 为 `VIDEO` （视频购物广告）</li><li>且 `product_source` 为 `CATALOG`</li></ul></li><li>广告层级：<ul><li> `ad_format` 为 `SINGLE_VIDEO` 且 `vertical_video_strategy` 为 `SINGLE_VIDEO`</li><li>或 `ad_format` 为 `CATALOG_CAROUSEL`</li></ul></li></ul><br>若想了解非延迟深度链接和延迟深度链接的支持场景，请查看“[深度链接 - 支持范围 - 深度链接](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-支持范围)”小节。<br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>延迟深度链接目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。请注意，设置延迟深度链接需要相应的技术资源和开发能力。</li><li>非延迟深度链接在某些场景下目前为白名单功能。若想了解非延迟深度链接为白名单功能的具体场景，请查看“[深度链接 - 支持范围 - 深度链接](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-支持范围)”小节。如需在这些场景中使用此功能，请联系您的TikTok销售代表。</li></ul>|
#| deeplink_utm_params | object[] | 本字段仅在满足以下条件时支持：<ul><li>广告组层级：<ul><li>`shopping_ads_type` 设置为 `VIDEO` （视频购物广告）</li><li> `product_source` 设置为 `CATALOG`</li><li> `promotion_type` 设置为 `WEBSITE`，`APP_ANDROID` 或 `APP_IOS`</li></ul></li></ul><br>深度链接 URL 参数列表。URL 参数是可以添加到 URL 末尾的代码片段，可以帮助您通过第三方分析平台监测来自不同渠道的点击，并了解访客与网站的互动情况。每个URL 参数由 `key` 和 `value` 指定的键值对组成。 <br><br>最大数量：14。 <br><br><ul><li>若您在广告中使用商品库深度链接（`shopping_ads_deeplink_type` 为 `SHOPPING_ADS`），您可通过传入`deeplink_utm_params`为商品库深度链接添加 URL 参数。URL 参数将在广告投放时自动拼接到商品库深度链接。</li><li>若您在广告中使用自定义深度链接（网站 URL）（`shopping_ads_deeplink_type` 为 `CUSTOM`），您可手动为自定义深度链接添加 URL 参数，然后将 `deeplink`直接设置为带有 URL 参数的深度链接。<ul><li>然而，若您在广告中使用自定义深度链接且同时传入了 `deeplink_utm_params`，在广告投放时URL 参数不会自动拼接到自定义深度链接（`deeplink`）。此时，您需确保`deeplink_utm_params`与深度链接中的 URL 参数完全匹配。</li></ul></li></ul><br><p><span style="color:darkred"><b>注意</b></span>：深度链接 URL 参数目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 |
##| key | string | 深度链接 URL 参数。<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`：单个推广系列的名称、标语或促销代码。示例：BlackFridayProm。</li></ul><br>请注意，UTM 参数区分大小写。<br><br>若传入自定义参数，则长度限制为 100 个字符。|
##| value | string | 深度链接 URL 参数的值。 <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 个字符。 |
#|shopping_ads_fallback_type{+条件必填}|string| 在购物广告再营销场景下，深度链接唤起失败后的返回落地页（失败路径）类型。<br><br>枚举值：<ul><li>`DEFAULT`：未设置。</li><li>`CUSTOM`: 自定义链接。您可以在广告组中提供一个网页地址, 并回退到这个地址。您需同时传入`landing_page_url`。</li><li>`SHOPPING_ADS`：商品库链接。 回退到目录中为各商品添加的网页地址。</li></ul><br>`SHOPPING_ADS` 的值不支持在满足以下条件的场景中使用：<ul><li>广告组层级：<ul><li>`shopping_ads_type` 为 `VIDEO` （视频购物广告）</li><li>且 `product_source` 为 `CATALOG`</li></ul></li><li>广告层级：<ul><li> `ad_format` 为 `SINGLE_VIDEO` 且 `vertical_video_strategy` 为 `SINGLE_VIDEO`</li><li>或 `ad_format` 为 `CATALOG_CAROUSEL`</li></ul></li></ul><br>若想了解失败路径的支持场景，请查看“[深度链接 - 支持范围 - 失败路径](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-失败路径)”小节。|
#|fallback_type |string|失败路径。如果用户没有安装过应用，您可以选择让用户回退去安装应用，或者去您想推广的网页。<br><br>枚举值：<ul><li>`APP_INSTALL`：广告组层级通过 `app_id` 指定的推广应用对应的 App Store 或 Google Play 页面。</li><li>`WEBSITE`：通过 `landing_page_url` 指定的推广网页。</li><li>`UNSET`：未设置。</li></ul><br>若本字段设置为 WEBSITE，需传入 `landing_page_url` 。<br><br>若想了解失败路径的支持场景，请查看“[深度链接 - 支持范围 - 失败路径](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-失败路径)”小节。 |
#|dynamic_destination|string|动态目标页面策略。<br><br>枚举值：<ul><li>`DLP`：动态落地页。基于用户的主页、行为和意向，向每位用户展示不同的目标页面，包括自定义网站或即时体验商品页面等，从而最大限度地提高广告转化量。</li><li>`UNSET`：未设置。</li></ul><br>若`promotion_type` 为`APP_ANDROID`或`APP_IOS`，则此字段不可设置为`DLP`。<br><br><p><span style="color:darkred"><b>注意</b></span>：动态目标页面在商品来源为商品库的视频购物广告推广网站且使用优化目标点击或落地页浏览量时不支持使用。因此，满足以下条件时本字段不支持设置为`DLP`：<ul><li> 广告组层级：<ul><li>`shopping_ads_type` 设置为 `VIDEO`（视频购物广告）。 </li><li>`product_source` 设置为 `CATALOG`。</li><li>`promotion_type` 设置为 `WEBSITE`。</li><li>`optimization_goal` 设置为 `CLICK` 或 `TRAFFIC_LANDING_PAGE_VIEW`。</li></ul></li></ul>|
#|instant_product_page_used|boolean| 是否使用TikTok即时体验商品页面（自动生成的TikTok即时体验页面，展示多种商品，提供原生落地页体验）。<ul><li>若`dynamic_destination`为 `DLP`，则不需要传入该参数。</li><li>若`dynamic_destination` 为`UNSET`，您可以将本字段设置为`true`，且无需同时传入`page_id`。</li></ul> |
#| page_image_index |integer| 仅当`instant_product_page_used`设置为`true`，且所指定的商品已设置对应的附加图片列表时生效。<br><br>用于指定TikTok 即时体验商品页面中要使用的附加图片的索引。若未传入本字段，将在TikTok 即时体验商品页面中使用商品库商品的主图。<br>取值范围：&#91;0, 9&#93;。<ul><li>您通过本字段传入的数值代表每个商品库商品的附加图片列表（`additional_image_urls`）中要使用的附加图片的位置。例如，若`page_image_index` 设置为<strong> 1</strong>，代表您将使用每个`additional_image_urls`的值中的<strong>第二个</strong>图片作为TikTok 即时体验商品页面中使用的图片。您可通过[/catalog/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1740564136678402)返回的`additional_image_urls`字段获取商品对应的附加图片列表。</li><li>若您指定的数值超过了商品对应的附加图片列表中附加图片URL的数量，将忽略本字段，使用商品的主图（`image_url`）。您可通过[/catalog/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1740564136678402)返回的`image_url` 字段获取商品对应的主图。</li></ul> |
#| auto_message_id {+条件必填}| string | 仅当广告组层级 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE` 时必填。<br><br> TikTok 私信广告中使用的自动消息的 ID。<br>目前唯一支持的自动消息类型为欢迎消息。<br><br><ul><li>若想获取广告账户中欢迎消息的列表，可使用[/creative/auto_message/get/](1822106498804738.html)。</li><li>若想在广告账户中创建欢迎消息，可使用[/creative/auto_message/create/](1822106113771521.html)。</li></ul><br>若想了解如何创建使用了欢迎消息的 TikTok 私信广告，可查看[创建优化位置为 TikTok 私信的线索广告](1774482992153601.html)。 |
#| 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> 对于广告样式为单视频或标准轮播的广告，您仅可在更新广告素材（视频或图片）时更新本字段。例如，若您仅修改标准轮播广告中图片的顺序，则不支持更新本字段。</li><li>对于广告样式为动态样式、商品库视频或商品库轮播的广告，不支持更新本字段。</li></ul>|
#| disclaimer_type | string | 您想要在广告中添加的免责声明类型。枚举值：`TEXT_LINK`（文字链免责声明），`TEXT_ONLY`（纯文本免责声明）。请查看[使用免责声明](https://ads.tiktok.com/marketing_api/docs?id=1739953274550273)，了解如何进行免责声明设置。<br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>免责声明目前对注册地非美国或加拿大且使用竞价推广目标的广告主，以及使用覆盖和频次推广目标的所有广告主为白名单功能。如需使用此功能，请联系您的TikTok销售代表。</li><li>免责声明功能支持以下推广目标：`APP_PROMOTION`，`WEB_CONVERSIONS`， `REACH`，`TRAFFIC`， `VIDEO_VIEWS`，`ENGAGEMENT`，`LEAD_GENERATION`，`RF_REACH`。 </li><li>免责声明功能仅支持TikTok版位。</li><li>免责声明功能不支持在程序化创意广告中使用。</li><li>广告中加入免责声明后，不允许删除免责声明。 </li></ul> |
#| disclaimer_text {+条件必填} | object | 您想要在广告中添加的纯文本免责声明。当`disclaimer_type`为`TEXT_ONLY`时必填。 |
##| text | string | 免责声明文案。 长度限制：90个字符。 |
#| disclaimer_clickable_texts {+条件必填} | object[] | 您想要在广告中添加的文字链免责声明。当`disclaimer_type`为 `TEXT_LINK`时必填。 最大数量：3。<br>若使用多个免责声明，则所有文案的总长度以及单个文案的长度均应不超过40个字符。 |
##| text | string | 免责声明文案。 长度限制：40个字符。 |
##| url | string | 文字链免责声明的URL 。用户点击对应文字时，将打开您提供的对应URL，查看免责声明的详细内容。 |
#|tracking_pixel_id|number| 要追踪的 Pixel 的 ID。您可以使用此字段监测发生在外部网站的事件。支持的推广目标包括竞价广告推广目标(`REACH`,`VIDEO_VIEWS`,`TRAFFIC`,  `WEB_CONVERSIONS`, `LEAD_GENERATION`, `APP_PROMOTION`, `PRODUCT_SALES`, `ENGAGEMENT`) 和覆盖和频次广告推广目标(`RF_REACH`)。<ul><li>竞价广告推广目标 <br>如果在  广告组  层级中  `pixel_id`!=0  且pixel用于追踪外部网站事件， 那么  `tracking_pixel_id`   中传入的值须和广告组中  `pixel_id`   的值保持一致。否则您可以在   `tracking_pixel_id`  中填入任意有效 ID 值。</li><li>覆盖和频次广告推广目标<br>您可以在 `tracking_pixel_id`中填入任意有效ID值。 |
#|tracking_app_id | string| 您想要监测的应用的 ID。您可以使用此字段监测发生在外部网站的应用事件。<br>支持的推广目标包括竞价广告推广目标（`REACH`，`VIDEO_VIEWS`， `TRAFFIC`， `WEB_CONVERSIONS`，`LEAD_GENERATION`， `APP_PROMOTION`，`PRODUCT_SALES`，`ENGAGEMENT`）和覆盖和频次广告推广目标（`RF_REACH`）。<br>若已在广告组层级已设置 `app_id` ，且您想要追踪站外应用事件，则您通过本字段传入的App ID必须为您在广告组层级设置的App ID。若未在广告组层级设置`app_id`，则您可以通过本字段传入任意想追踪的App的ID。<br>您可以通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 接口获取App ID（`app_id`）。|
#| tracking_offline_event_set_ids | string[] | 想要监测的线下事件组 ID 列表。您可以使用本字段监测和衡量浏览广告或与之互动的用户的线下活动。<br>最大数量：50。<br> 点击[这里](https://ads.tiktok.com/marketing_api/docs?id=1758051319816193)了解如何创建和管理线下事件组。<br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>新建的广告中需对当前开启自动监测的线下事件组进行追踪：<ul><li>您可不传入本字段。本字段的值将自动默认为广告账户下<strong>当前</strong>所有开启自动监测的线下事件组，或</li><li>您可手动传入本字段。您需至少传入广告账户下<strong>当前</strong>所有开启自动监测的线下事件组，未开启自动监测的线下事件组为可选。欲获取广告账户下当前所有开启自动监测的线下事件组的ID，需调用[/offline/get/](https://ads.tiktok.com/marketing_api/docs?id=1765596808589313)先获取广告账户下的所有线下事件组ID，再根据返回的`auto_tracking`值筛选出其中开启自动监测的线下事件组的ID。</li></ul></li><li>本字段支持以下推广目标： `REACH`，`VIDEO_VIEWS`，`TRAFFIC`, `LEAD_GENERATION`，`APP_PROMOTION`，`WEB_CONVERSIONS`，`ENGAGEMENT`，和`PRODUCT_SALES`。<ul><li> 若推广目标（`objective_type`）设置为`PRODUCT_SALES`，您仅可在商品来源为商品库的视频购物广告中使用本字段。因此广告组层级需满足以下要求：<ul><li>`shopping_ads_type` = `VIDEO` ，且</li><li>`product_source` = `CATALOG`。</li></ul></li></ul></li></ul> |
#| tracking_message_event_set_id | string | 仅当广告组层级同时满足以下条件时生效： <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><li>未传入 `page_id`</li></ul><br>即时通讯广告中监测的消息事件集的 ID。您可以使用本字段监测用户何时在即时通讯应用中开始对话。 <br><br> 若想获取可用的消息事件集列表，可使用[/ctm/message_event_set/get/](1816979158055937.html)。<br> 若想了解如何创建 TikTok 即时通讯广告，可查看[创建优化位置为即时通讯应用的线索广告](1774482999036930.html)。  <br><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持更新。 |
#|viewability_postbid_partner |string|出价后第三方可见性监测合作伙伴。枚举值：`MOAT`，`DOUBLE_VERIFY`，`IAS`，`ZEFR`。<br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>出价后第三方可见性监测目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。</li><li> 请查看[品牌安全](https://ads.tiktok.com/marketing_api/docs?id=1739381752981505)，了解出价后监测的支持推广目标，支持市场以及简要介绍。 </li><li> 当您同时传入`brand_safety_postbid_partner` 和`viewability_postbid_partner`时：<ul><li>一旦将两字段其中之一设置为 `IAS`，则另一字段也需要设置为`IAS`，且您需要为`brand_safety_vast_url`和`viewability_vast_url`传入相同的值（即您从监测合作伙伴IAS处获取的封装的 VAST 网址）。</li><li>一旦将两字段其中之一设置为 `ZEFR`，则另一字段也需要设置为`ZEFR`。</li><li>若您设置了两个不同的出价后第三方监测合作伙伴，仅出价后第三方品牌安全监测设置生效。 </li></ul></li><li> 出价后第三方监测不支持在程序化创意广告中使用。</li><li> 出价后第三方监测不支持在`promotion_type`设置为`LIVE_SHOPPING`的广告组中使用。</li></ul> |
#|viewability_vast_url {+条件必填} |string| 出价后第三方监测合作伙伴用于监测可见性的封装的 VAST 网址。当`brand_safety_postbid_partner` 为 `IAS`时必填。您需从监测合作伙伴IAS处获取对应URL。<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><li>出价后第三方监测不支持在程序化创意广告中使用。</li><li> 出价后第三方监测不支持在`promotion_type`设置为`LIVE_SHOPPING`的广告组中使用。</li></ul>|
#|brand_safety_postbid_partner |string| 出价后第三方品牌安全监测合作伙伴。枚举值：`DOUBLE_VERIFY`，`IAS`，`ZEFR`。 <br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>出价后第三方品牌安全监测目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。</li><li> 请查看[品牌安全](https://ads.tiktok.com/marketing_api/docs?id=1739381752981505)，了解出价后监测的支持推广目标，支持市场以及简要介绍。</li><li>您在广告组层级配置的出价前品牌安全筛选设置决定了您能否同时使用出价后第三方品牌安全监测和出价后第三方可见性监测：<ul><li>若您在广告组层级将`brand_safety_type`设置为 `NO_BRAND_SAFETY` ，则在广告组层级可传入`viewability_postbid_partner`，不能传入`brand_safety_postbid_partner` 。</li><li> 若您在广告组层级将`brand_safety_type`设置的值非 `NO_BRAND_SAFETY` ，则在广告组层级可同时传入`viewability_postbid_partner`和`brand_safety_postbid_partner`。</li></ul></li><li> 当您同时传入`brand_safety_postbid_partner` 和`viewability_postbid_partner`时：<ul><li>一旦将两字段其中之一设置为`IAS`，则另一字段也需要设置为`IAS`，且您需要为`brand_safety_vast_url`和`viewability_vast_url`传入相同的值（即您从监测合作伙伴IAS处获取的封装的 VAST 网址）。</li><li> 若您设置了两个不同的出价后第三方监测合作伙伴，仅出价后第三方品牌安全监测设置生效。</li></ul></li><li>出价后第三方监测不支持在程序化创意广告中使用。</li><li> 出价后第三方监测不支持在`promotion_type`设置为`LIVE_SHOPPING`的广告组中使用。</li></ul>|
#|brand_safety_vast_url {+条件必填} |string|出价后第三方监测合作伙伴用于监测品牌安全的封装的 VAST 网址。当`brand_safety_postbid_partner` 为 `IAS`时必填。您需从监测合作伙伴IAS处获取对应URL。<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><li>出价后第三方监测不支持在程序化创意广告中使用。</li><li> 出价后第三方监测不支持在`promotion_type`设置为`LIVE_SHOPPING`的广告组中使用。</li></ul>|
#|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>目前 Pangle 不支持 DCM、Sizmek 或 Flashtalking。|
#|playable_url |string| 试玩广告URL，在 Pangle 和 TikTok 版位生效。可通过[/playable/get/](https://ads.tiktok.com/marketing_api/docs?id=1737732758495234)接口获取。同一个广告组共用同一个试玩广告。 <br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 9 月 30 日起，不再支持创建投放至 TikTok 版位的试玩广告。|
#|operation_status|string|<p><span style="color:darkred"><b>注意</b></span><ul><li>对于覆盖和频次广告，需将`operation_status`设置为`ENABLE`，或不传入`operation_status`，请不要将`operation_status`设置为`DISABLE`。</li></ul> <br>广告创建时的启用/关闭状态。枚举值：<ul><li>`ENABLE`：广告创建时处于启用状态。</li><li>`DISABLE`：广告创建时处于未启用状态。</li></ul> 默认值：`ENABLE`。若想在广告创建后更新广告的启用/关闭状态，请使用 [/ad/status/update/](https://ads.tiktok.com/marketing_api/docs?id=1739953422970882)接口。|
#|creative_type {+条件必填}|string| 直播购物广告、商品购物广告或应用预注册场景中的创意素材类型。<br><br><ul><li>若广告组层级 `shopping_ads_type` 设置为 `LIVE` ，本字段必填，且需设置为 `SHORT_VIDEO_LIVE` 或 `DIRECT_LIVE`。</li><li>若广告组层级 `shopping_ads_type` 设置为 `PRODUCT_SHOPPING_ADS`，可省略本字段或将本字段设置为`PSA`。</li><li>当推广系列层级 `app_promotion_type`设置为`APP_PREREGISTRATION`，且广告组层级`promotion_website_type`设置为`TIKTOK_NATIVE_PAGE`时，您可省略本字段或将本字段设置为`CUSTOM_INSTANT_PAGE`。</li></ul><br>枚举值： <ul><li>`SHORT_VIDEO_LIVE`: 短视频引流至直播间广告。</li><li> `DIRECT_LIVE`: 直播间带货。每个推广系列只能有一个直播间。</li><li>`PSA`：商品视觉元素将作为广告创意使用。 </li><li>`CUSTOM_INSTANT_PAGE`：自定义 TikTok 即时体验页面。</li></ul>|
#|video_view_tracking_url |string|视频播放监测URL。|
#|app_name {+条件必填} |string|广告展示的App名称。默认为应用商店名称，长度限制：1-40个字符。如果应用商店中的应用名称超过了40个字符，您必须使用本字段传入一个新的应用名称，否则创建广告将失败。|
#|display_name {+条件必填}|string|落地页或纯曝光广告的显示名称，长度限制：1-40个英文字符或1-20个中文/日文/韩文字符，当推广对象类型为落地页或纯曝光时必填|
#|avatar_icon_web_uri |string|广告头像图片 ID，可以通过[素材管理-图片上传](https://ads.tiktok.com/marketing_api/docs?id=1739067433456642)接口上传图片<span style="color:#ff0000">（图片比例要求1:1）</span>|
#|creative_authorized |boolean| 是否允许在我们的 TikTok For Business 创意中心展示您的广告。仅对非美国广告主有效。默认值：`false`。<br><p><span style="color:darkred"><b>注意</b></span>：`creative_authorized`仅可用于视频广告。|
#|schedule_id| string |仅对覆盖和频次广告生效。<br><br>广告投放信息ID。<br><br>本字段用于将广告投放信息ID与您要在已设置顺序投放的覆盖和频次广告组中创建的广告绑定。<br><br>若想获取广告投放信息ID，可调用[/adgroup/rf/create/](1738235338194945.html)并将`delivery_mode` 设置为 `SEQUENCE`。广告投放信息与广告绑定后，`is_draft`字段的值将变为`false`，而`schedule_id`字段的值将变为与广告投放信息绑定的广告的 ID。若想确认广告投放信息ID与广告已成功绑定，调用[/adgroup/get/](1739314558673922.html)并查看返回中`is_draft` 和`schedule_id`字段的值。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_name": "{{ad_name}}",
        "identity_type":"CUSTOMIZED_USER",
        "identity_id":"{{identity_id}}",
        "ad_format": "SINGLE_VIDEO",
        "video_id":"{{video_id}}",
        "image_ids":["{{image_id}}"],
        "ad_text": "{{ad_text}}",
        "call_to_action": "{{call_to_action}}",
        "landing_page_url":"{{landing_page_url}}"
    }]
}'
(/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|返回数据。|
#|ad_ids|string[]|广告ID。|
#|creatives |object[]| 广告列表。返回字段根据请求参数中 `fields` 字段产生，默认返回所有字段。|
##|advertiser_id |string| 广告主 ID。 |
##|campaign_id |string| 推广系列 ID。 |
##|campaign_name |string| 推广系列名称。 |
##|adgroup_id |string| 广告组 ID。 |
##|adgroup_name|string| 广告组名称。 |
##|ad_id |string| 广告 ID。 |
##|ad_name |string| 广告名称。 |
##|create_time |string|广告创建时间。|
##|modify_time |string|广告修改时间。|
##|identity_id|string|认证身份 ID。|
##|identity_type|string|认证身份类型。枚举值：  `CUSTOMIZED_USER` (自定义用户），`AUTH_CODE` (授权码认证)， `TT_USER` (TikTok商务用户)， `BC_AUTH_TT`（已添加到商务中心的TikTok用户）。|
##|identity_authorized_bc_id|string|当`identity_type` 为 `BC_AUTH_TT`时返回。与添加到商务中心的TikTok用户这一认证身份绑定的商务中心的ID。|
##|catalog_id|string|您为广告选择的商品库 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月 30 日起，将不再为新创建的广告组层级 `product_source` 为 `STORE` 的购物广告返回 `catalog_id`，传入的 `catalog_id` 字段将被忽略。存量的 `product_source` 为 `STORE` 的购物广告若未被更新，则不受影响。若您更新存量的这类广告，且广告已绑定 `catalog_id` ，则绑定的 `catalog_id` 将清空且该 `catalog_id` 字段将不再返回。|
##|product_specific_type|string|选择商品的维度。<br><br>枚举值：<ul><li>`ALL`：允许 TikTok 从所有商品中动态选择。</li><li> `PRODUCT_SET`：请选择一个商品系列。TikTok 将动态选择该商品系列中的商品。</li><li>`CUSTOMIZED_PRODUCTS`：选择自定义数量的特定商品。</li></ul>|
##|item_group_ids|string[]|商品的 SPU ID 列表。|
##|product_set_id|string|商品系列 ID。|
##|sku_ids|string[]|商品的 SKU ID 列表。|
##| showcase_products | object[] |您想要用在广告中的橱窗商品列表。 |
###| item_group_id | string | 商品的 SPU ID。 |
###| store_id | string | 商品（`item_group_id`）所属的店铺 ID。|
###| catalog_id | string | 商品（`item_group_id`）所属的商品库 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 6 月 30 日起，将不再为新创建的广告组层级 `product_source` 为 `STORE` 的购物广告返回本字段，传入的 `showcase_products` 对象数组中的 `catalog_id` 字段将被忽略。存量的 `product_source` 为 `STORE` 的购物广告若未被更新，则不受影响。若您更新存量的这类广告，且广告已绑定 `showcase_products` 对象数组中的 `catalog_id`，则绑定的`catalog_id` 将清空且该 `catalog_id` 字段将不再返回。 |
##|ad_format |string| 广告样式，枚举值：`SINGLE_IMAGE`，`SINGLE_VIDEO`，`LIVE_CONTENT`, `CAROUSEL_ADS`（非视频购物类型的轮播广告），`CATALOG_CAROUSEL`（视频购物类型的轮播广告）。|
##|vertical_video_strategy|string|商品销量场景中使用的视频类型。 <br><br>枚举值： `UNSET`（未设置），`SINGLE_VIDEO`（单个视频），`CATALOG_VIDEOS`（使用视频模板的商品库视频），`CATALOG_UPLOADED_VIDEOS`（使用已上传视频的商品库视频）， `LIVE_STREAM`（直播视频）。  |
##|dynamic_format|string|动态样式。<br><br>枚举值：<ul><li>`DYNAMIC_CREATIVE`：智能创意。根据用户的购买意图向每位用户展示不同的视频，商品卡片和目标页面，从而最大限度地提高广告转化量。 </li><li>`UNSET`：未设置。</li></ul>|
##|video_id |string| 视频 ID。<br><br>若广告为通过从关联的企业号、创作者授权的帖子或商务中心中创作者授权的账户提取原生视频而创建的 Spark Ads，则本字段值为 null。此时您可以通过`tiktok_item_id`字段获取用作 Spark Ads 的 TikTok 帖子 ID。<br><br>若想了解 Spark Ads 详情，请查看[创建 Spark Ads](1739470744631298.html)。|
##|image_ids|string[]| 图片 ID 列表。 |
##|carousel_image_index|integer |用于指定视频购物类型的轮播广告中要使用的附加图片的索引。<br> 您通过本字段传入的数值代表每个商品库商品的附加图片列表（`additional_image_urls`）中要使用的附加图片的位置。|
##| music_id | string | TikTok 轮播广告中使用的音乐的 ID。   |
##|tiktok_item_id |string| 用作 Spark Ads 的 TikTok 帖子 ID，<br><br>若想了解 Spark Ads 详情，请查看[创建 Spark Ads](1739470744631298.html)。 |
##| promotional_music_disabled | boolean |是否关闭推广音乐开关。`true`： 关闭；`false`： 打开。默认`true`。如果您想为TikTok视频开启合拍或跟拍，请将该字段设置为`false`，即打开推广音乐。 |
##|item_duet_status | string | 合拍开关状态。枚举值：`ENABLE`： 打开合拍；`DISABLE`： 禁止合拍。只有在`promotional_music_disabled`设置为`false`时，该字段才有效。|
##| item_stitch_status | string | 跟拍开关状态。枚举值：`ENABLE`： 打开跟拍；`DISABLE`： 禁止跟拍。只有在`promotional_music_disabled`设置为`false`时，该字段才有效。|
##| dark_post_status | string | 表示该视频是否为dark post。返回值可以是OFF或者ON。|
##| branded_content_disabled | boolean |默认值为`false`。当`branded_content_disabled`为`true`时，`dark_post_status`将无法被更改。|
##|shopping_ads_video_package_id|string| 商品库视频模板ID。<br data-tomark-pass>当对应的推广系列`objective_type`为`PRODUCT_SALES`时返回该字段。|
##|ad_text |string| 广告文案，将作为广告创意的一部分展示给您的受众，向他们传达您想要推广的信息。关键词匹配类型为精确匹配。|
##|ad_texts |string| 广告文案列表。 |
##|call_to_action|string| 行动引导文案，见 [枚举值-行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)|
##|call_to_action_id|string|行动引导文案包ID。|
##|card_id|string| 创意素材包 ID。|
##|landing_page_url |string|落地页 URL。|
##|utm_params |object[]|URL 参数列表。|
###|key |string| URL 参数。|
###|value |string|URL 参数的值。|
##|page_id |number|页面 ID。|
##| cpp_url | string | 自定产品页面 URL。<br>自定产品页面是一种定制化的产品页面，支持自定义截图、推广文字和应用预览，可用于突出介绍所推广应用的特定内容或功能，或针对特定受众群体进行推广。 |
##|tiktok_page_category|string|您希望推广的 TikTok 页面的类别。<br><br>枚举值： <ul><li>`PROFILE_PAGE`：TikTok 账号主页。</li><li>`OTHER_TIKTOK_PAGE`：其他 TikTok 页面，包括播放列表页面、话题标签页面、音乐页面和商业化特效页面。</li><li>`TIKTOK_INSTANT_PAGE`：自定义 TikTok 即时体验页面。</li></ul>|
##| phone_region_code | string | 仅当广告组层级 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` 时返回。 <br><br> 受众可点击广告拨打的电话号码的地区代码。 |
##| phone_region_calling_code | string | 仅当广告组层级 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` 时返回。 <br><br>受众可点击广告拨打的电话号码的区号。 |
##| phone_number | string | 仅当广告组层级 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` 时返回。<br><br> 受众可点击广告拨打的电话号码。 |
##| creative_auto_enhancement_strategy_list | string[] | 应用于你的广告的自动优化策略列表。<br>你传入的优化功能将在你的推广系列投放期间自动实时应用。<br><br>枚举值：<ul><li>`VIDEO_QUALITY`：视频质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`MUSIC_REFRESH`：音乐焕新。替换为当前 TikTok 上流行的音乐，紧跟潮流趋势。</li><li>`IMAGE_QUALITY`：图片质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`IMAGE_RESIZE`：调整尺寸。调整图片大小，充分利用全屏功能。</li></ul> |
##|deeplink |string| 深度链接，即已安装应用的用户点击链接后跳转至的特定页面。|
##|deeplink_type |string| 深度链接类型。  <br><br>枚举值：<ul><li>`NORMAL`：非延迟深度链接。</li><li>`DEFERRED_DEEPLINK`：延迟深度链接。</li></ul> |
##| deeplink_format_type | string | 深度链接的格式类型。<br><br>枚举值：  <ul><li>`UNIVERSAL_OR_APP_LINK`：通用/应用链接，即以`http://`或 `https://` 开头的 iOS 通用链接或 Android 应用链接。</li><li>`SCHEME_LINK`：URL 架构，即格式为`scheme://resource` 的自定义网址架构。例如，WhatsApp 的自定义网址架构格式应为`whatsapp://resource`。</li><li>`NONE`：非深度链接。</li></ul> |
##|shopping_ads_deeplink_type|string| 在购物广告中要使用的深度链接的来源。<br><br>枚举值：<ul><li>`NONE`：不设置深度链接。</li><li>`CUSTOM`：自定义深度链接。在广告中使用你提供的深度链接。</li><li>`SHOPPING_ADS`：商品库深度链接。使用商品库中为各商品添加的深度链接。</li></ul>|
##| deeplink_utm_params| object[] | 深度链接 URL 参数列表。 |
###| key | string | 深度链接 URL 参数。 |
###| value | string | 深度链接 URL 参数的值。 |
##|shopping_ads_fallback_type|string| 在购物广告再营销场景下，深度链接唤起失败后的返回落地页类型。<br><br>枚举值：<ul><li>`DEFAULT`：未设置。</li><li>`CUSTOM`: 自定义链接。您可以在广告组中提供一个网页地址, 并回退到这个地址。</li><li>`SHOPPING_ADS`：商品库链接。 回退到目录中为各商品添加的网页地址。</li></ul>|
##|fallback_type |string|失败路径。如果用户没有安装过应用，您可以选择让用户回退去安装应用，或者去您想推广的网页。 <br><br>枚举值：<ul><li>`APP_INSTALL`：广告组层级通过 `app_id` 指定的推广应用对应的 App Store 或 Google Play 页面。</li><li>`WEBSITE`：通过 `landing_page_url` 指定的推广网页。</li><li>`UNSET`：未设置。</li></ul> |
##|dynamic_destination|string|动态目标页面策略。<br><br>枚举值：<ul><li>`DLP`：动态落地页。基于用户的主页、行为和意向，向每位用户展示不同的目标页面，包括自定义网站或即时体验商品页面等，从而最大限度地提高广告转化量。</li><li>`UNSET`：未设置。</li></ul>|
##| auto_message_id | string | TikTok 私信广告中使用的自动消息的 ID。<br> 目前唯一支持的自动消息类型为欢迎消息。 |
##| aigc_disclosure_type | string | 是否启用 AI 生成内容自主声明开关，以表明广告中包含 AI 生成内容。启用该开关后，当用户查看完整广告时，您的广告将带有“广告主标记为 AI 生成”的标签。<br><br>枚举值：<ul><li>`SELF_DISCLOSURE`：启用开关，声明广告包含 AI 生成内容。</li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。</li></ul> |
##| disclaimer_type | string | 广告中的免责声明类型。枚举值：`TEXT_LINK`（文字链免责声明），`TEXT_ONLY`（纯文本免责声明）。 |
##| disclaimer_text | object | 广告中的纯文本免责声明。 |
###| text | string | 免责声明文案。 |
##| disclaimer_clickable_texts | object[] | 广告中的文字链免责声明。 |
###| text | string | 免责声明文案。 |
###| url | string | 文字链免责声明的URL 。用户点击对应文字时，将打开您提供的对应URL，查看免责声明的详细内容。 |
##|tracking_pixel_id|number|正在监测的 Pixel 的 ID。你可以使用此字段监测发生在外部网站的事件。|
##|tracking_app_id | string| 正在监测的应用的 ID。|
##| tracking_offline_event_set_ids | string[] | 正在监测的线下事件组 ID 列表。 |
##| tracking_message_event_set_id | string | 即时通讯广告中监测的消息事件集的 ID。 |
##|vast_moat_enabled |boolean| 是否开启Moat（第三方视频可见性监测）。TikTok与Moat合作，为您在TikTok for Business上购买的品牌竞价、覆盖和频次信息流广告提供可见性监测。默认值：`false`。<br><p><span style="color:darkred"><b>注意</b></span>：若您想开启Moat第三方可见性监测，相较于本字段，更推荐使用`viewability_postbid_partner`，将值设为 `MOAT` 。|
##|viewability_postbid_partner|string|出价后第三方可见性监测合作伙伴。枚举值：`UNSET`，`MOAT`，`DOUBLE_VERIFY`，`IAS`，`ZEFR`。|
##|viewability_vast_url |string|出价后第三方监测合作伙伴用于监测可见性的封装的 VAST 网址。当`brand_safety_postbid_partner`非`IAS`时本字段为空值。|
##|brand_safety_postbid_partner |string|  出价后第三方品牌安全监测合作伙伴。枚举值： `UNSET`，`DOUBLE_VERIFY`，`IAS`，`ZEFR`。 |
##|brand_safety_vast_url| string|出价后第三方监测合作伙伴用于监测品牌安全的封装的 VAST 网址。当`brand_safety_postbid_partner`非`IAS`时本字段为空值。|
##|impression_tracking_url |string|默认展示监测URL。  |
##|click_tracking_url |string|点击监测URL。|
##|playable_url |string| 试玩广告URL|
##|operation_status|string|广告的操作状态。<ul><li>`ENABLE`：广告处于启用（“开”）状态。</li><li>`DISABLE`：广告处于未启用（“关”）状态。</li><li>`FROZEN`：广告处于冻结状态，无法再次启用。</li></ul>  |
##|secondary_status|string| 广告状态（二级状态），见[枚举值-二级状态](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
##|creative_type|string| 商直播购物广告、商品购物广告或应用预注册场景中的创意素材类型。枚举值：<ul><li>`SHOP_PDP`：短视频带货广告，包含一个商品链接。</li><li>`SHOP_PLP`: 短视频带货广告，包含6-50个商品链接。</li><li> `SHORT_VIDEO_LIVE`: 短视频引流至直播间广告。</li><li> `DIRECT_LIVE`: 直播间带货。每个推广系列只能有一个直播间。</li><li>`PSA`：商品视觉元素将作为广告创意使用。 </li><li>`CUSTOM_INSTANT_PAGE`：自定义 TikTok 即时体验页面。<br>仅当推广系列层级 `app_promotion_type`设置为`APP_PREREGISTRATION`，且广告组层级`promotion_website_type`设置为`TIKTOK_NATIVE_PAGE`时返回此值。</li></ul>|
##|app_name |string|应用名称|
##|display_name |string|落地页或纯曝光广告的显示名称。|
##|profile_image_url |string|头像 URL。|
##|creative_authorized |boolean| 是否允许在我们的 TikTok For Business 创意中心展示您的广告。仅对非美国广告主有效。默认值：`false`。<br><p><span style="color:darkred"><b>注意</b></span>：`creative_authorized`仅可用于视频广告。|
##|is_aco |boolean| 是否属于程序化广告， `true`代表程序化广告，`false`代表非程序化广告。 |
##|is_new_structure|boolean|该广告是否为新结构（广告与对应推广系列及广告组结构相同）。|
##|optimization_event|string|广告组转化事件。参阅[转化事件](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)，获取详细信息。 |
#|page_info |object | 分页信息。 |
##|page |number | 当前页数。 |
##|page_size |number | 分页大小。 |
##|total_number |number | 总结果数。 |
##|total_page |number | 总页数。 |

示例

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "ad_name": "{{ad_name}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "creative_type": null,
                "adgroup_id": "{{adgroup_id}}",
                "campaign_id": "{{campaign_id}}",
                "playable_url": "",
                "operation_status": "ENABLE",
                "brand_safety_vast_url": null,
                "impression_tracking_url": null,
                "viewability_postbid_partner": "UNSET",
                "viewability_vast_url": null,
                "identity_id": "{{identity_id}}",
                "display_name": "{{display_name}}",
                "page_id": null,
                "ad_id": "{{ad_id}}",
                "identity_type": "CUSTOMIZED_USER",
                "landing_page_url": "{{landing_page_url}}",
                "campaign_name": "{{campaign_name}}",
                "landing_page_urls": null,
                "profile_image_url": "{{profile_image_url}}",
                "ad_text": "{{ad_text}}",
                "is_new_structure": true,
                "create_time": "{{create_time}}",
                "call_to_action_id": null,
                "advertiser_id": "{{advertiser_id}}",
                "video_id": "{{video_id}}",
                "adgroup_name": "{{adgroup_name}}",
                "creative_authorized": false,
                "deeplink_type": "NORMAL",
                "tracking_pixel_id": 0,
                "is_aco": false,
                "brand_safety_postbid_partner": "UNSET",
                "image_ids": [
                    "{{image_id}}"
                ],
                "deeplink": "",
                "fallback_type": "UNSET",
                "app_name": "",
                "vast_moat_enabled": false,
                "ad_format": "SINGLE_VIDEO",
                "optimization_event": null,
                "ad_texts": null,
                "click_tracking_url": null,
                "call_to_action": "{{call_to_action}}",
                "card_id": null,
                "modify_time": "{{modify_time}}"
            }
        ]
    }
}
(/code)
← 广告获取广告 →

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