获取智能创意广告素材
您可以使用本接口获取智能创意广告素材，包括行动引导文案，广告名称，图片、视频素材。该接口是v1.3中的全新接口。
由于数据处理需要时间，/ad/aco/create/和/ad/aco/update/接口将返回模拟结果，其中包含您传入的请求参数。若想获取准确数据，请调用接口 /ad/aco/create/或/ad/aco/update/完成后等待2-3秒再使用/ad/aco/get/接口。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/ad/aco/get/
方法 GET
Header
|字段|类型|描述|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|adgroup_ids {必填}|string[]| 广告组ID，允许数量范围: 1-100。 |
|advertiser_id {必填}|string| 广告主ID。 |
| exclude_field_types_in_response| string[]|想要从返回中移除的字段种类。<br>允许的枚举值： <ul><li>`NULL_FIELD`: 值为null的字段。</li></ul>|
示例
(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "advertiser_id=ADVERTISER_ID" \
--data-urlencode "adgroup_ids=[\"ADGROUP_IDS\"]" \
https://business-api.tiktok.com/open_api/v1.3/ad/aco/get/
(/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|返回数据。|
#|list|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[]| 图片信息。 <ul><li>若素材类型为视频，`image_info` 中将包含视频封面图的详情。</li><li>若素材类型为图片，`image_info` 中将包含图片素材的详情。</li></ul>|
#####|web_uri |string| 图片ID。|
#####|file_name |string|使用[/ad/aco/create/](1739473063234626.html)创建智能创意广告时指定的用于生成广告名称的图片名。<br><br>若您创建智能创意广告时未在`image_info`对象数组中传入`file_name`，本字段的值将为空字符串。 |
####|video_info|object|仅当素材类型为视频时返回。<br><br> 视频信息。 |
#####|video_id|string| 视频ID。 |
#####|file_name |string| 使用[/ad/aco/create/](1739473063234626.html)创建智能创意广告时指定的用于生成广告名称的视频名称。<br><br>若您创建智能创意广告时未在`video_info`对象中传入`file_name`，本字段的值将为空字符串。 |
####| 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。|
####| material_name | string | 素材（图片或视频）的名称。<br><br>本字段用于决定素材在 TikTok 广告管理平台展示的名称。 <ul><li>若素材类型为图片，则 TikTok 广告管理平台展示的名称与 `material_name` 的值一致。</li><li>若素材类型为视频，则 TikTok 广告管理平台展示的名称为file_name 或 `material_name` 的值。<ul><li>`file_name`不为空时，展示的素材名称为`file_name`的值。</li><li>`file_name`为空时，展示的素材名称为`material_name`的值。</li></ul></li></ul> |
####| identity_id|string|认证身份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|广告文案。|
###|material_id|string|素材ID。|
###|material_operation_status|string|素材状态。枚举值：`ENABLE` (素材可用)，`DISABLE`(素材不可用）。|
##|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`(普通 DeepLink，支持 Traffic、Conversion)， `DEFERRED_DEEPLINK`(延迟 DeepLink，支持 App Install )。默认值：`NORMAL`。对于iOS 14专属推广系列中包含的广告，此字段无法设置为`DEFERRED_DEEPLINK`。 |
##|display_name_list|object[]|显示名称。|
###|app_name|string|App名称。|
###|landing_page_name |string|落地页名称。|
##|avatar_icon_list|object[]|广告头像图片列表。|
###|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">不适用于 Deferred DeepLink。</span> 枚举值：`APP_INSTALL`， `WEBSITE`， `UNSET`。<br><p><span style="color:darkred"><b>注意</b></span>：不适用于延迟Deeplink。 |
###|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。<br><p><span style="color:darkred"><b>注意</b></span>：当对应的推广系列推广目标为`APP_PROMOTION`，`PRODUCT_SALES`，或 `ENGAGEMENT`时，本字段为白名单功能。如需在这些推广目标下使用此功能，请联系您的TikTok销售代表。|
####| tracking_offline_event_set_ids | string[] | 正在追踪的线下事件组ID列表。<br>点击[这里](https://ads.tiktok.com/marketing_api/docs?id=1758051319816193)了解如何创建和管理线下事件组。 <br><p><span style="color:darkred"><b>注意</b></span>：线下事件追踪目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。 |
###|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
{
"message": "OK",
"code": 0,
"data": {
"list": [
{
"open_url": null,
"title_list": [
{
"title": "Testing"
}
],
"open_url_list": [
{
"open_url": ""
}
],
"app_name": null,
"avatar_icon_list": null,
"click_tracking_url": "",
"landing_page_urls": null,
"profile_image": null,
"pixel_id": null,
"landing_page_url": null,
"impression_tracking_url": "",
"page_list": null,
"external_action": null,
"call_to_action_list": [],
"display_name": null,
"display_name_list": [
{
"source": "20210531132544123456",
"app_name": ""
}
],
"ad_id": 1234573413994497,
"page_id": null,
"media_info_list": [
{
"media_info": {
"image_info": [
{
"file_name": null,
"web_uri": "v0201/aa4785144d3894fcce25033c86123456"
}
],
"video_info": {
"file_name": "12345096e244f1dab24a7e40870cc.MP4",
"video_id": "v12345270000bvgsmvthr46s2t1dgm20"
},
"image_mode": "IMAGE_MODE_VIDEO"
}
}
]
}
]
},
"request_id": "xxx"
}
(/code);