← 返回目录
📁 API Reference › Ads

更新广告

你可以使用本接口修改普通广告的创意素材，包括行动引导文案，广告名称，图片、视频素材等。

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

若想修改智能创意广告的素材，需使用/ad/aco/update/接口。

本接口仅支持patch_update 字段设置为 true 时对以下字段进行增量更新： - ad_name - identity_id - identity_type - identity_authorized_bc_id - video_id - image_ids - music_id - tiktok_item_id - ad_text - ad_texts

更新广告的其他字段时为全量更新模式，请传入所有相关参数，否则某些参数会被覆盖为空值。若您希望支持对其他字段的增量更新，请联系您的 TikTok 销售代表。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。

|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/ad/update/|/v1.3/ad/update/|
|请求参数名称|`open_url` <br>`open_url_type` <br>`vast_moat` <br>`is_creative_authorized`<br>`dpa_fallback_type`<br>`dpa_open_url_type` <br>`dpa_video_tpl_id`  |`deeplink`<br>`deeplink_type`<br> `vast_moat_enabled`<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>`ad_id`: number <br>`card_id`: number |`advertiser_id`: string <br>`adgroup_id`: string <br>`ad_id`: string<br>`card_id`: string |
|废弃请求参数|/|`premium_badge_id`|
|新增请求参数|/ |`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>`patch_update`<br>`sku_ids`<br>`deeplink_utm_params` <br>`product_specific_type`<br>`product_set_id`<br> `item_group_ids`<br>`cpp_url` <br>`aigc_disclosure_type`<br>`ad_texts` |
|请求参数其他变动|/ |必传`identity_type`和`identity_id`。|
|返回参数|/|在v1.3中，系统将返回广告实体的完整信息。详情请参阅本页面的<strong>返回</strong>部分。|
|返回参数类型|`ad_ids`: number[]|`ad_ids`: string[] |
|新增返回参数|/| `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>`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>`creative_auto_enhancement_strategy_list`|

请求

地址 https://business-api.tiktok.com/open_api/v1.3/ad/update/

方法 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`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|adgroup_id {必填}|string| 广告组 ID。 |
| patch_update | boolean | 是否使用增量更新模式。<br><br>本字段设置为 `true` 时，支持增量更新以下字段： <ul><li>`ad_name`</li><li> `identity_id`</li><li> `identity_type`</li><li>`identity_authorized_bc_id`</li><li>`video_id`</li><li>`image_ids`</li><li>`music_id`</li><li>`tiktok_item_id`</li><li>`ad_text`</li><li>`ad_texts`</li></ul><br>例如，若想增量更新广告名称，可仅设置以下参数： <ul><li> `patch_update` 设置为 `true` 。</li><li> `ad_name` 设置为新的广告名称。</li><li>传入其他必填参数，包括 Header 参数， `advertiser_id` 和 `ad_id`。</li></ul> <br><p><span style="color:DarkRed"><b>重要提示</b></span>：若您想使用本字段使用增量更新模式，推荐您进行充分测试，以免对您当前的广告更新工作流程造成不必要的影响。 |
|creatives {必填}|object[]| 广告素材。<br><br>最大数量：20。 |
#|ad_id{必填} |string| 广告 ID |
#|ad_name {+条件必填}|string| 仅当 `patch_update` 未设置为 `true` 时必填。<br><br>广告名称。<br><br>若想使广告名称自动生成，可传入 `""` （空字符串）。自动生成广告名格式：广告 ID （`ad_id`）。<br><br>长度限制：512字符且不能包含表情符号。 <br> <br><p><span style="color:darkred"><b>注意</b></span>：中文或日文每个字占用2个字符，每个英语字符占用1个字符。|
#|identity_id {+条件必填}|string|仅当 `patch_update` 未设置为 `true` 时必填。<br><br>认证身份ID。<br><br>如果您不使用Spark Ads，传入 `identity_id` 和 `identity_type` (`CUSTOMIZED_USER`类型)可帮助您更好地管理广告信息。 |
#|identity_type{+条件必填}|string|仅当 `patch_update` 未设置为 `true` 且使用 Spark Ads 时必填。<br><br>认证身份类型。<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_authorized_bc_id{+条件必填}|string|当`identity_type` 为 `BC_AUTH_TT`时必填。<br><br>与添加到商务中心的TikTok用户这一认证身份绑定的商务中心的 ID。|
#| product_specific_type | string | 仅当 `shopping_ads_type` 设置为 `VIDEO` 且 `product_source` 设置为 `CATALOG` 时生效。 <br><br>选择商品的维度。您可以使用本字段修改商品来源为商品库的视频购物广告中商品选择的维度。 <br><br> 枚举值： <ul><li>`ALL`：允许 TikTok 从所有商品中动态选择。<ul><li>若本字段设置为 `ALL`，无需传入 `sku_ids`，`item_group_ids` 和 `product_set_id`。</li></ul></li><li>`PRODUCT_SET`：请选择一个商品系列。TikTok 将动态选择该商品系列中的商品。<ul><li>若本字段设置为 `PRODUCT_SET`，需传入 `item_group_ids` 和 `product_set_id` 其中之一。</li></ul></li><li> `CUSTOMIZED_PRODUCTS`：选择自定义数量的特定商品。<ul><li>若本字段设置为 `CUSTOMIZED_PRODUCTS`，需传入`sku_ids` 。</li></ul></li></ul>|
#| item_group_ids {+条件必填 }| string[] | 若 `product_specific_type` 设置为 `PRODUCT_SET`，需传入`item_group_ids` 和 `product_set_id` 其中之一。 <br><br> 商品的 SPU（标准化产品单元）ID 列表。指定的商品需属于广告组层级指定的商品库（`catalog_id`）。<br>您可以使用 `item_group_ids` 或 `product_set_id` 字段修改商品来源为商品库的视频购物广告中设置的商品系列。<br><br>最大数量：20。 |
#| product_set_id{+条件必填 } | string | 若 `product_specific_type` 设置为 `PRODUCT_SET`，需传入`item_group_ids` 和 `product_set_id` 其中之一。 <br><br> 商品系列 ID。指定的商品系列中的商品需属于广告组层级指定的商品库（`catalog_id`）。 <br><br>您可以使用 `item_group_ids` 或 `product_set_id`字段修改商品来源为商品库的视频购物广告中设置的商品系列。 |
#| sku_ids {+条件必填 }| string[] | `product_specific_type` 为 `CUSTOMIZED_PRODUCTS` 时必填。<br><br>商品的 SKU（库存量单位）ID 列表。指定的商品需属于广告组层级指定的商品库（`catalog_id`）。<br>本字段可用于修改商品来源为商品库的视频购物广告中设置的特定商品。<br><br> 最大数量：20。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>不支持将本字段更新为空列表或 null 值。</li><li>仅支持设置商品库中的可用商品。若想获取商品库中的可用商品，可使用 [/catalog/product/get/](1740564136678402.html)。可用商品的  `ad_creation_eligible` 为 `AVAILABLE`。</li><li>若为[视频购物类型的轮播广告](https://business-api.tiktok.com/portal/docs?id=1766217791987713#item-link-创建视频购物类型的轮播广告的步骤) （`ad_format` 为 `CATALOG_CAROUSEL`），需确保至少指定了两个商品。</li></ul> |
#| ad_format{+条件必填} | string | 仅当 `patch_update` 未设置为 `true` 时必填。<br><br>广告样式。<br><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><p><span style="color:darkred"><b>注意</b></span>：若您在广告创建时为本字段指定了值，您需传入相同值，不允许更新为其他值。|
#|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> <br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>若您通过本字段更改了 TikTok 轮播广告中指定的图片ID，广告将重新进入审核流程。</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。 <br><span style="color:darkred"><b>注意</b></span>: 若您通过本字段更改了 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。<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/` 接口获取视频包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>若想清空商品来源为商品库的视频购物广告中使用的素材包，可不传入本字段，返回中 `card_id` 的值将变为 null。需注意若广告样式为动态样式且对 `/ad/update/` 的请求中不包含 `card_id` 字段，广告中的素材包不会清空，因为动态样式广告中会自动生成商品卡片。</li></ul>|
#|landing_page_url {+条件必填}|string|落地页URL。 <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` 时有效，商品橱窗页面仅当推广目标为 `TRAFFIC` 或 `CONVERSION` 时有效，仅支持 TikTok 版位。（首次创建前需要通过[协议管理-签订](https://ads.tiktok.com/marketing_api/docs?id=1737192284435457)签订 `LeadAds` 协议）。|
#| 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>：<ul><li>在广告中使用自定产品页面目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>若您在广告中同时使用应用介绍页（`page_id`）和自定产品页面 URL（`cpp_url`）且更新了自定产品页面 URL，应用介绍页不会自动更新。为保持与自定产品页面的一致，您需手动更新应用介绍页上的产品信息。</li></ul>|
#|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>|
#|shopping_ads_deeplink_type|string| 在购物广告中要使用的深度链接的来源。<br><br>枚举值：<ul><li>`NONE`：不设置深度链接。</li><li>`CUSTOM`：自定义深度链接。在广告中使用你提供的深度链接。您需同时传入`deeplink`。</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-支持范围)”小节。<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|本字段仅在满足以下条件时支持： <ul><li>广告组层级： <ul><li> `shopping_ads_type` 设置为 `VIDEO`（视频购物广告）。</li><li>`product_source` 设置为 `CATALOG`。</li><li>`promotion_type` 设置为 `WEBSITE`。</li><li>`optimization_goal` 设置为 `CONVERSION` 或 `VALUE`。</li></ul></li></ul><br>动态目标页面策略。本字段可用于修改商品来源为商品库的视频购物广告中设置的动态目标页面策略。<br><br>枚举值：<ul><li>`DLP`：动态落地页。基于用户的主页、行为和意向，向每位用户展示不同的目标页面，包括自定义网站或即时体验商品页面等，从而最大限度地提高广告转化量。</li><li>`UNSET`：未设置。</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> |
#| 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>若您想为无免责声明的广告增加免责声明，您可以使用本字段指定免责声明类型。</li><li>对于已设置免责声明的广告，您仅可以更新免责声明的文案或URL或同时更新文案和URL。不允许通过本字段更新已有的免责声明类型，仅允许传入原免责声明类型。</li><li>免责声明目前对注册地非美国或加拿大且使用竞价推广目标的广告主，以及使用覆盖和频次推广目标的所有广告主为白名单功能。如需使用此功能，请联系您的TikTok销售代表。</li><li>免责声明功能支持以下推广目标：`APP_PROMOTION`，`WEB_CONVERSIONS`，`REACH`，`TRAFFIC`， `VIDEO_VIEWS`，`ENGAGEMENT`，`LEAD_GENERATION`，`RF_REACH`。 </li><li>免责声明功能仅支持TikTok版位。</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| 您想要追踪的App的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><li> 开启自动监测后又关闭了自动监测的线下事件组，以及已删除的线下事件组，均不视作当前开启自动监测的线下事件组。</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> |
#|vast_moat_enabled |boolean| 是否开启Moat（第三方视频可见性监测）。默认值：`false`。<br><p><span style="color:darkred"><b>注意</b></span>：若您想开启Moat第三方可见性监测，相较于本字段，更推荐使用`viewability_postbid_partner`，将值设为 `MOAT` 。|
#|viewability_postbid_partner |string|出价后第三方可见性监测合作伙伴。枚举值：`MOAT`，`DOUBLE_VERIFY`，`IAS`。<br>仅当创建的广告尚未通过审核，还未生效时，您才可更新本字段。<br> <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>若您设置了两个不同的出价后第三方监测合作伙伴，仅出价后第三方品牌安全监测设置生效。 </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>仅当创建的广告尚未通过审核，还未生效时，您才可更新本字段。<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>仅当创建的广告尚未通过审核，还未生效时，您才可更新本字段。<br><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>仅当创建的广告尚未通过审核，还未生效时，您才可更新本字段。<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。|
#|video_view_tracking_url |string|视频播放监测URL。|
#|playable_url |string| 试玩广告 URL，在 Pangle 和 TikTok 版位生效。可通过[获取试玩广告列表](https://ads.tiktok.com/marketing_api/docs?id=1737732758495234)接口获取。同一个广告组共用同一个试玩广告。<br><br><p><span style="color:darkred"><b>注意</b></span>：自 2024 年 9 月 30 日起，不再支持更新投放至 TikTok 版位的试玩广告。 |
#|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>|
#|app_name {+条件必填} |string|应用下载广告的显示名称，默认为应用商店名称，长度限制：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`仅可用于视频广告。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/update/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "adgroup_id": "{{adgroup_id}}",
    "advertiser_id": "{{advertiser_id}}",
    "creatives": [{
        "ad_id": "{{ad_id}}",
        "ad_name": "{{ad_name}}",
        "identity_id":"{{identity_id}}",
        "identity_type":"CUSTOMIZED_USER",
        "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|与添加到商务中心的TikTok用户这一认证身份绑定的商务中心的ID。当`identity_type` 为 `BC_AUTH_TT`时返回。|
##|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>受众可点击广告拨打的电话号码的地区代码。 <br><br>若想了解如何创建推广对象类型为电话通话的线索广告，请查看[这里](1774482936048641.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：创建推广对象类型为电话通话的线索广告目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。 |
##| phone_region_calling_code | string | 仅当广告组层级 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` 时返回。 <br><br>受众可点击广告拨打的电话号码的区号。 <br><br><p><span style="color:darkred"><b>注意</b></span>：创建推广对象类型为电话通话的线索广告目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。 |
##| phone_number | string | 仅当广告组层级 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` 时返回。 <br><br>受众可点击广告拨打的电话号码。<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> |
##|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（第三方视频可见性监测）。<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_new_structure|boolean|该广告是否为新结构（广告与对应推广系列及广告组结构相同）。|
##|is_aco |boolean| 是否属于程序化广告， true 代表程序化广告， false 代表非程序化广告。 |
##|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": [
            {
                "deeplink_type": "NORMAL",
                "call_to_action_id": null,
                "brand_safety_postbid_partner": "UNSET",
                "creative_type": null,
                "tracking_pixel_id": 0,
                "advertiser_id": "{{advertiser_id}}",
                "viewability_postbid_partner": "UNSET",
                "image_ids": [
                    "{{image_id}}"
                ],
                "app_name": "",
                "profile_image_url": "{{profile_image_url}}",
                "landing_page_url": "{{landing_page_url}}",
                "ad_texts": null,
                "viewability_vast_url": null,
                "identity_id": "{{identity_id}}",
                "click_tracking_url": null,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "optimization_event": null,
                "deeplink": "",
                "is_aco": false,
                "landing_page_urls": null,
                "ad_name": "{{ad_name}}",
                "music_id": null,
                "operation_status": "ENABLE",
                "is_new_structure": true,
                "brand_safety_vast_url": null,
                "create_time": "{{create_time}}",
                "ad_id": "{{ad_id}}",
                "adgroup_name": "{{adgroup_name}}",
                "display_name": "{{display_name}}",
                "impression_tracking_url": null,
                "adgroup_id": "{{adgroup_id}}",
                "identity_type": "CUSTOMIZED_USER",
                "video_id": "{{video_id}}",
                "creative_authorized": false,
                "modify_time": "{{modify_time}}",
                "card_id": null,
                "page_id": null,
                "ad_text": "{{ad_text}}",
                "playable_url": "",
                "call_to_action": "{{call_to_action}}",
                "campaign_id": "{{campaign_id}}",
                "ad_format": "SINGLE_VIDEO",
                "campaign_name": "{{campaign_name}}",
                "vast_moat_enabled": false,
                "fallback_type": "UNSET"
            }
        ]
    }
}
(/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 每日平台更新简报 →