← 返回目录
📁 API Reference › Smart Creative

更新智能创意广告素材

您可以使用本接口更新您的智能创意广告素材，包括行动引导文案，广告名称，图片、视频素材。该接口是v1.3中的全新接口。

本接口支持增量更新。若想修改支持更新的设置，您可以将 patch_update 设置为 true，同时仅传入要更新的字段和必填字段（包括 Header 参数，advertiser_id和adgroup_id）。

注意
若您想更新数组类型字段中的一个或多个参数，无论您是否将patch_update 设置为 true，均需传入创建智能创意广告时该数组类型字段中所有原有参数及其更新值。若仅传入部分参数，可能导致报错或未传入参数被覆盖为默认值或空值。

  • 例如，若您创建时在media_info_list中传入了tiktok_item_id、identity_id 和identity_type，则当您想要仅更新tiktok_item_id时，仍需要在media_info_list中传入tiktok_item_id、identity_id 和identity_type 这三个字段，其中identity_id 和identity_type 需要传入原值。
  • 若您创建时在media_info_list中指定了多个创意素材，则当您想要仅更新某个创意素材时，仍需要在media_info_list中传入所有创意素材的信息。

提示

请查看下表了解本接口相关的提示，包括返回数据、支持更新范围、更新模式和素材要求。

|类型 {20%} | 详情{70%} |
|---|---|---|
| 返回数据| 由于数据处理需要时间，`/ad/aco/update/`接口将返回模拟结果，其中包含您传入的请求参数。若想获取准确数据，请调用接口 `/ad/aco/update/`完成后等待2-3秒再使用[/ad/aco/get/]( https://ads.tiktok.com/marketing_api/docs?id=1739473020978177)接口。|
| 支持更新范围 | `/ad/aco/update/`接口不支持修改 Smart+ 推广系列中的智能创意广告素材。广告名称若为自动生成则不能修改。 |
|素材要求|  创意素材（广告标题、素材以及行动引导文案）不允许重复。|

请求

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

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求消息类型<br>允许值: `"application/json"`。|

参数

|字段{35%}|类型{13%}|描述{52%}|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|adgroup_id {必填}|string| 广告组 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：传入已开启智能创意的广告组的 ID。该广告组的 `creative_material_mode` 需为 `SMART_CREATIVE`。|
| patch_update | boolean | 是否使用增量更新模式。 <br><br>例如，若想增量更新广告文案，可仅设置以下参数：<ul><li> `patch_update` 设置为 `true` 。</li><li>`title_list`设置为新的广告文案。</li><li>传入其他必填参数，包括 Header 参数， `advertiser_id` 和 `adgroup_id`。</li></ul>|
|media_info_list |object[]| 创意信息列表。|
#|media_info|object|创意信息。|
##|video_info|object| 视频信息。  |
###|video_id{+条件必填}|string| 传入 `video_info` 时必填。<br><br>视频 ID。<br><br>当您通过接口[/file/video/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1737587322856449)上传视频后，您可以在返回中获取视频ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：我们建议您使用[/file/video/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1737587322856449)(`upload_type` = `UPLOAD_BY_VIDEO_ID`)将视频 iD与广告主ID进行绑定。 |
###|file_name |string| 视频名称。 |
##|image_info|object[]| 图片信息。<br><br><ul><li>当您想要上传图片素材时（请求中未包含`video_info`），本字段将作为图片素材。</li><li>当您想要上传视频素材时（请求中包含`video_info`），本字段将作为视频封面。每个`image_info`中仅可上传一张图片。</li></ul> |
###|web_uri{+条件必填}|string| 传入 `image_info` 时必填。<br><br>图片 ID。<br><br>当您通过接口[/file/image/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1739067433456642) 上传图片后，您可以在返回中获取图片 ID。|
###|file_name |string| 图片名称。如果您使用图片素材，该字段值将被用作广告名称。 |
##| aigc_disclosure_type | string | 仅当 `common_material` 中的 `identity_type` 为 `CUSTOMIZED_USER` 时生效。 <br><br>是否启用 AI 生成内容自主声明开关，以表明广告中包含 AI 生成内容。启用该开关后，当用户查看完整广告时，您的广告将带有“广告主标记为 AI 生成”的标签。<br><br>枚举值：<ul><li>`SELF_DISCLOSURE`：启用开关，声明广告包含 AI 生成内容。</li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。</li></ul> 默认值： `NOT_DECLARED`。 <br><br>若想了解此开关支持的推广目标和广告样式，以及使用此开关的步骤，请查看 [AI 生成内容自主声明开关](1799186631031809)。  <br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 您仅可在更新视频（`video_id`）时更新本字段。</li></ul>|
##|tiktok_item_id|string|用作 Spark Ad 的 TikTok 视频 ID。<br><br>传入您在接口[/tt_video/info/](https://ads.tiktok.com/marketing_api/docs?id=1738376324021250)和[/identity/video/get/](https://ads.tiktok.com/marketing_api/docs?id=1740218475032577)中获取的`tiktok_item_id`。<br><br><p><span style="color:darkred"><b>注意</b></span>: 使用Spark Ads意味着您已确认您有权将TikTok视频中的音乐用于商业目的。<br>若您传入了 `tiktok_item_id`，则不必再传入`image_info`, `video_info`, 和`title_list`字段。|
##| identity_id|string|用于 Spark Ads 的认证身份 ID。|
##| identity_type|string|用于 Spark Ads 的认证身份类型。<br><br>枚举值： `AUTH_CODE`, `TT_USER`。<br><br>获取详细信息，参阅[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。|
|title_list|object[]|广告文案列表。广告文案作为您的广告素材一部分向受众展示，传递您想传达的信息。|
#|title{+条件必填}|string|传入 `title_list` 时必填。<br><br>广告文案。不知道怎么写？试试[智能文案](https://ads.tiktok.com/marketing_api/docs?id=1739084248002626)。</li><li>每个广告文案长度允许值为 12-40 字符，不能包含emoji。</li><li>中文或日文每个字占用2个字符，每个英语字符占用1个字符。</li></ul>|
|call_to_action_list |object[]|行动引导文案列表。<br><br><p><span style="color:darkred"><b>注意</b></span>：您在每个`call_to_action_list`对象中最多可以传入 3 条行动引导文案。|
#|call_to_action{+条件必填}|string|传入 `call_to_action_list` 时必填。<br><br>行动引导文案。枚举值可参见[枚举值 - 行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
|deeplink_list|object[]|深度链接列表。长度范围：[0,1]。<br><p><span style="color:darkred"><b>注意</b></span>：每个`deeplink_list`对象中只能提交一个`deeplink`和对应的`deeplink_type`。|
#|deeplink |string| 深度链接：用户下载App后点击链接跳转至的特定页面。|
#|deeplink_type |string| 深度链接类型。 不同推广目标的允许值不同：`NORMAL`(普通深度链接，支持 Traffic、Conversion)， `DEFERRED_DEEPLINK`(延迟深度链接，支持 App Install )。默认值：`NORMAL`。对于iOS 14专属推广系列中包含的广告，此字段无法设置为`DEFERRED_DEEPLINK`。 |
|display_name_list {+条件必填}|object[]|显示名称。<br><p><span style="color:darkred"><b>注意</b></span>：每个`display_name_list`只能传入一个`app_name`或`landing_page_name`。|
#|app_name {+条件必填} |string|应用下载广告的显示名称，默认为应用商店名称，长度限制：1-40个字符。如果应用商店中的应用名称超过了40个字符，你必须使用本字段传入一个新的应用名称，否则创建广告将失败。|
#|landing_page_name |string|落地页的名称。长度限制：1-40个字符。 |
|avatar_icon_list|object[]|广告头像图片列表。<br><p><span style="color:darkred"><b>注意</b></span>：如果您在`media_info`或`common_material`中传入了`identity_id`，则无需传入此字段。传入的值将被忽略。<br>您只能传入一个头像图片ID (`web_uri`)。|
#|avatar_icon|object|广告头像图片。|
##|web_uri |string| 图片 ID。您可以通过接口[/file/image/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1739067433456642) 上传图片。图片的长宽比必须为1：1。|
|page_list|object[]|页面 ID 列表。|
#|page_id{+条件必填}|string|传入 `page_list` 时必填。<br><br>页面 ID。<br><br><ul><li>若想获取您的广告账号中的页面，可使用[/page/get/](1820826387779586.html)。</li><li>若想创建即时体验页面，可使用[即时体验页面编辑器](1740307202170881.html)。</li></ul>|
|card_list|object[]|卡片ID列表。长度范围：[0,1]。|
#|card_id|string|图片卡片ID、礼品码卡片ID、倒计时贴纸ID或下载卡ID。<ul><li> 欲了解如何获取图片卡片ID或下载卡ID，请参考[卡片](1749019652141058.html)。</li><li>欲了解如何获取倒计时贴纸ID，请参考[贴纸](https://ads.tiktok.com/marketing_api/docs?id=1749019667506177)。|
|common_material|object|常用素材。|
#|ad_name|string| 广告名称。传入 `""` （空字符串）代表自动生成。自动生成广告名格式：素材名 + 创建时间（例如 adcreative20210111190739）。广告名称不能超过512字符，不能包含emoji。<br><p><span style="color:darkred"><b>注意</b></span>：中文或日文每个字占用2个字符，每个英语字符占用1个字符。<br>如果您不传入该字段，您将无法通过`/ad/aco/update/`接口更改广告名称。|
#|call_to_action_id|string|行动引导文案素材包ID。行动引导文案素材包指的是一组自动优化的行动引导文案。关于自动优化行动引导文案的更多信息，请参见[智能推荐CTA > 动态优选CTA](https://ads.tiktok.com/marketing_api/docs?id=1740307296329730)。<br><p><span style="color:darkred"><b>注意</b></span>：如果本字段和`call_to_action_list`都传入，`call_to_action_list`会被忽略。|
#|creative_authorized |boolean| 是否允许在我们的 TikTok For Business 创意中心展示您的广告。仅对非美国广告主有效。默认值：`false`。<br><p><span style="color:darkred"><b>注意</b></span>：`creative_authorized`仅可用于视频广告。|
#|playable_url |string| 试玩素材 URL，在 Pangle 版位生效。可通过[获取试玩广告列表](https://ads.tiktok.com/marketing_api/docs?id=1737732758495234)接口获取。请注意：同一个广告组共用同一个试玩广告。 |
#|fallback_type |string|失败路径。如果用户没有安装过应用，您可以选择让用户返回去安装应用，或者去您想推广的网页。 <span style="color：#f40909">不适用于延迟深度链接。</span> 枚举值：`APP_INSTALL`， `WEBSITE`， `UNSET`。如果选择网页，需要通过 `landing_page_urls` 字段指定落地页 URL。<br><p><span style="color:darkred"><b>注意</b></span>：不适用于延迟深度链接。 |
#|tracking_info|object|监测信息|
##|impression_tracking_urls |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>您只能传入一个URL。|
##|click_tracking_urls |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>您只能传入一个URL。<br>目前 Pangle 不支持 DCM、Sizmek 或 Flashtalking。|
##|tracking_pixel_id|string| 要追踪的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值。<br><p><span style="color:darkred"><b>注意</b></span>：如果您的推广目标为   `ENGAGEMENT`  /   `PRODUCT_SALES`   (当 `product_source` =   `CATALOG`   /     `STORE`   且`shopping_ads_type` = `VIDEO`) /  `APP_PROMOTION`  (当 `app_promotion_type` =   `APP_RETARGETING`     )时，此字段为白名单功能。如需使用此字段，请联系您的TikTok销售代表。</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`）。 <br><p><span style="color:darkred"><b>注意</b></span>：当对应的推广系列推广目标为`APP_PROMOTION`，`PRODUCT_SALES`，或 `ENGAGEMENT`时，本字段为白名单功能。如需在这些推广目标下使用此功能，请联系您的TikTok销售代表。 |
##| 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>线下事件追踪目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。</li><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`。</li></ul> |
#|identity_id {+条件必填}|string|认证身份ID，当不使用Spark Ads(`tiktok_item_id`)时必填。|
#|identity_type {+条件必填}|string|认证身份类型，当不使用Spark Ads(`tiktok_item_id`)时必填。|

示例

更新智能创意广告的一个视频创意

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/aco/update/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "patch_update":true,
    "media_info_list": [
        {
            "media_info": {
                "video_info": {
                    "video_id": "{{video_id}}" //new video for the first video
                    },
                    "image_info": [
                        {
                        "web_uri": "{{web_uri}}" //new video cover for the first video
                        }
                    ]
                }
        },
        {   
            "media_info": {
                "video_info": {
                    "video_id": "{{video_id}}" //same video for the second video
                    },
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}" //same video cover for the second video
                    }
                ]
            }
        }
    ]
}'
(/code)

更新智能创意广告的所有广告文案

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/aco/update/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "patch_update":true,
    "title_list": [
        {
            "title": "{{title}}",
            "title": "{{title}}"
        }
    ]
}'
(/code)

返回

|字段{40%}|类型{13%}|描述{47%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述，可见[附录 - 返回码](https：//ads.tiktok.com/marketing_api/docs?id=1737172488964097) 。|
|message |string|返回信息。更多信息可见[附录 - 返回码](https：//ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据|
#|advertiser_id |string| 广告主 ID |
#|adgroup_id |string|广告组ID。|
#|media_info_list |object[]| 创意信息列表。|
##|material_id|string|素材ID|
##|material_operation_status|string|素材状态。枚举值：`ENABLE` (素材可用)，`DISABLE`(素材不可用）。|
##|media_info|object|创意信息。|
###|image_info|object[]| 图片信息。 |
####|web_uri |string| 图片 ID|
####|file_name |string| 图片名称。 |
###|video_info|object| 视频信息。  |
####|video_id|string| 视频ID。 |
####|file_name |string| 视频名称。 |
###| aigc_disclosure_type | string | 是否启用 AI 生成内容自主声明开关，以表明广告中包含 AI 生成内容。启用该开关后，当用户查看完整广告时，您的广告将带有“广告主标记为 AI 生成”的标签。<br><br>枚举值：<ul><li>`SELF_DISCLOSURE`：启用开关，声明广告包含 AI 生成内容。</li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。</li></ul> |
###| tiktok_item_id|string|用作 Spark Ad 的 TikTok 帖子 ID。|
###| identity_id|string|当您使用 Spark Ad（`tiktok_item_id`）时的认证身份ID。|
###| identity_type|string|认证身份类型。使用Spark Ads（`tiktok_item_id`）时，该字段必填。枚举值： `AUTH_CODE`, `TT_USER`。获取详细信息，参阅[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。|
#|title_list |object[]|广告文案列表。广告文案作为您的广告素材一部分向受众展示，传递您想传达的信息。|
##|title|string|广告文案|
#|call_to_action_list|object[]|行动引导文案列表|
##|call_to_action|string|行动引导文案。枚举值可参见[枚举值 - 行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|deeplink_list|object[]|深度链接列表。|
##|deeplink |string| 深度链接：用户下载 App 后点击链接跳转至的特定页面。|
##|deeplink_type |string| 深度链接类型。 不同推广目标的允许值不同：`NORMAL`(普通深度链接，支持 Traffic、Conversion)， `DEFERRED_DEEPLINK`(延迟深度链接，支持 App Install )。默认值：`NORMAL`。对于iOS 14专属推广系列中包含的广告，此字段无法设置为`DEFERRED_DEEPLINK`。 |
#|display_name_list|object[]|显示名称。|
##|app_name|string|App名称。|
##|landing_page_name |string|落地页名称。|
#|avatar_icon|object|广告头像图片信息。|
##|web_uri |string| 广告头像图片 ID。|
#|page_list|object[]|页面 ID 列表。|
##|page_id|string|页面 ID。|
#|card_list|object[]|卡片 ID 列表。长度范围：[0,1]|
##|card_id|string|图片卡片 ID、礼品码卡片 ID、倒计时贴纸 ID 或下载卡 ID。|
#|landing_page_urls |string[]| 落地页URL列表。 |
##|landing_page_url|string|落地页URL。|
#|common_material|object|常用素材。|
##|ad_name|string| 广告名称。|
##|call_to_action_id|string|行动引导文案素材包ID。|
##|creative_authorized |boolean| 是否允许在我们的 TikTok For Business 创意中心展示您的广告。仅对非美国广告主有效。默认值：`false`。<br><p><span style="color:darkred"><b>注意</b></span>：`creative_authorized`仅可用于视频广告。|
##|playable_url |string| 试玩素材 URL。 |
##|fallback_type |string|失败路径。如果用户没有安装过应用，您可以选择让用户返回去安装应用，或者去您想推广的网页。 <span style="color：#f40909">不适用于延迟深度链接。</span> 枚举值：`APP_INSTALL`， `WEBSITE`， `UNSET`。<br><p><span style="color:darkred"><b>注意</b></span>：不适用于延迟深度链接。 |
##|tracking_info|object|监测信息|
###|impression_tracking_urls |string[]|默认展示监测 URL。|
###|click_tracking_urls |string[]|点击监测URL。|
###|tracking_pixel_id|string| 正在追踪的pixel ID。你可以使用此字段追踪发生在外部网站的事件。<br><p><span style="color:darkred"><b>注意</b></span>： 该字段处于测试阶段。如果您要使用该字段，请联系您的TikTok客户代表。 |
###|tracking_app_id | string| 正在追踪的App的ID。|
###| tracking_offline_event_set_ids | string[] | 正在追踪的线下事件组ID列表。 |
##|identity_id|string|认证身份ID，当不使用Spark Ads(`tiktok_item_id`)时必填。|
##|identity_type |string|认证身份类型，当不使用Spark Ads(`tiktok_item_id`)时必填。仅支持`CUSTOMIZED_USER`。|
##|is_smart_creative|boolean|广告组是否启用智能创意。|
|request_id |string|请求的日志id，唯一标识一个请求  |

示例

更新智能创意广告的一个视频创意

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "call_to_action_list": [],
        "deeplink_list": [
            {
                "deeplink_type": "NORMAL",
                "deeplink": ""
            }
        ],
        "media_info_list": [
            {
                "media_info": {
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "video_info": {
                        "video_id": "{{video_id}}"
                    }
                }
            },
            {
                "media_info": {
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "video_info": {
                        "video_id": "{{video_id}}"
                    }
                }
            }
        ],
        "advertiser_id": "{{advertiser_id}}",
        "common_material": {
            "fallback_type": null,
            "tracking_info": {
                "click_tracking_urls": [],
                "tracking_app_id": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_ids}}",
                    "{{tracking_offline_event_set_ids}}"
                ],
                "impression_tracking_urls": [],
                "vast_moat_enabled": false,
                "tracking_pixel_id": "0"
            },
            "identity_type": "CUSTOMIZED_USER",
            "is_smart_creative": true,
            "creative_authorized": false,
            "call_to_action_id": "{{call_to_action_id}}",
            "playable_url": "",
            "identity_id": "{{identity_id}}",
            "ad_name": null
        },
        "card_list": null,
        "avatar_icon_list": [
            {
                "avatar_icon": {
                    "web_uri": "{{web_uri}}"
                }
            }
        ],
        "adgroup_id": "{{adgroup_id}}",
        "display_name_list": [
            {
                "app_name": "",
                "landing_page_name": "{{landing_page_name}}"
            }
        ],
        "title_list": [
            {
                "material_operation_status": "ENABLE",
                "title": "{{title}}",
                "material_id": "{{material_id}}"
            }
        ],
        "landing_page_urls": [
            {
                "landing_page_url": "{{landing_page_url}}"
            }
        ],
        "page_list": null
    }
}'
(/code);

更新智能创意广告的所有广告文案

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "landing_page_urls": [
            {
                "landing_page_url": "{{landing_page_url}}"
            }
        ],
        "call_to_action_list": [],
        "media_info_list": [
            {
                "media_info": {
                    "image_info": [
                        {
                            "file_name": null,
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "aigc_disclosure_type": null,
                    "tiktok_item_id": null,
                    "identity_id": null,
                    "identity_type": null,
                    "material_name": "",
                    "video_info": {
                        "file_name": "",
                        "video_id": "{{video_id}}"
                    }
                }
            }
        ],
        "card_list": null,
        "title_list": [
            {
                "title": "{{title}}",
                "title": "{{title}}"
            }
        ],
        "adgroup_id": "{{adgroup_id}}",
        "advertiser_id": "{{advertiser_id}}",
        "avatar_icon_list": [
            {
                "avatar_icon": {
                    "web_uri": "{{web_uri}}"
                }
            }
        ],
        "display_name_list": [
            {
                "app_name": "",
                "landing_page_name": "{{landing_page_name}}"
            }
        ],
        "common_material": {
            "fallback_type": null,
            "is_smart_creative": true,
            "creative_authorized": false,
            "playable_url": "",
            "identity_id": "{{identity_id}}",
            "tracking_info": {
                "tracking_app_id": null,
                "impression_tracking_urls": [],
                "click_tracking_urls": [],
                "tracking_pixel_id": "0",
                "vast_moat_enabled": false,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ]
            },
            "call_to_action_id": "{{call_to_action_id}}",
            "identity_type": "CUSTOMIZED_USER",
            "ad_name": null
        },
        "deeplink_list": [
            {
                "deeplink_type": "NORMAL",
                "deeplink": ""
            }
        ],
        "page_list": null
    }
}'
(/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 每日平台更新简报 →