创建智能创意广告
您可以使用本接口上传必要的广告素材从而创建智能创意广告。支持上传多个广告文案,标题,素材以及行动引导文案,系统将自动组合您的创意素材进行投放。本接口不会返回ad_id。本接口是v1.3中的全新接口。
注意
API 已不再支持程序化创意广告。为保证流畅的 API 体验,推荐您迁移到智能创意广告。
提示
请查看下表了解本接口相关的提示,包括返回数据、最大广告数量、最大素材数量、素材要求、广告组设置要求以及智能创意接口所支持的推广目标。
|类型 {35%} | 详情 {65%} |
|---|---|---|
| 返回数据 |由于数据处理需要时间,`/ad/aco/create/`接口将返回模拟结果,其中包含您传入的请求参数。若想获取准确数据,请调用接口 `/ad/aco/create/`完成后等待2-3秒再使用[/ad/aco/get/]( https://ads.tiktok.com/marketing_api/docs?id=1739473020978177)接口。|
| 最大广告数量|每次调用`/ad/aco/create/`最多可创建 450 个智能创意广告, 且单个广告主账户中每天最多可创建5000个广告。 |
| 最大素材数量 | <ul><li>广告标题个数:1-5。</li><li> 行动引导文案个数:1-3。 </li><li> 图片及视频素材个数 1-30。</li><li> 页面ID个数: 1-3。</li></ul> |
| 素材要求| 创意素材(广告标题、素材以及行动引导文案)不允许重复。 |
| 支持的推广目标 | 为使用智能创意接口,您需为推广系列设置以下推广目标 (`objective_type`)之一:<ul><li>应用推广 (<code>APP_PROMOTION</code>)</li><li>网站转化量 (<code>WEB_CONVERSIONS</code>)</li><li>访问量 (<code>TRAFFIC</code>)</li><li>线索收集 ( <code>LEAD_GENERATION</code>)</li></ul>|
广告名生成规则
- 如果
ad_name字段传入的是有效非空字符,且image_info或video_info下的file_name字段有值传入,则广告名将以"adName_"后接序列号的格式生成。例如,"adName_001"。 - 如果
ad_name字段传入的是空字符,且image_info或video_info下的file_name字段有值传入,则广告名将以"{file_name}_"后接序列号的格式生成。例如,"image_001"或"video_002"。 - 如果
ad_name字段传入的是空字符,但image_info或video_info下的file_name字段没有传入,则广告名将以"_"后接序列号的格式生成。例如,"_001"或"_002"。为了让广告名有意义,请尽量避免这种情况。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/ad/aco/create/
方法 POST
Header
|字段|类型|描述|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求消息类型。<br>允许值: `"application/json"`。|
参数
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|adgroup_id {必填}|string| 广告组 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>:需传入您将要开启智能创意的广告组的ID,且广告组的`creative_material_mode` 字段需为`SMART_CREATIVE`。|
|media_info_list {必填}|object[]| 创意信息列表。<br><br>最大数量:30。|
#|media_info{必填}|object|创意信息。|
##|video_info{+条件必填} |object| 当素材类型为视频且未传入`tiktok_item_id`时必填。<br><br>视频信息。|
###|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[]| 当素材类型为视频或图片且未传入`tiktok_item_id`时必填。<br><br>图片信息。<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|未传入 `image_info` 和 `video_info` 时必填。<br><br>用作 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>若您传入了 `tiktok_item_id`,则不必再传入`image_info`, `video_info`, 和`title_list`字段。<br><br><p><span style="color:darkred"><b>注意</b></span>: 使用 Spark Ads 意味着您已确认您有权将 TikTok 视频中的音乐用于商业目的。|
##| identity_id{+条件必填}|string|使用 Spark Ads(`tiktok_item_id`)时本字段必填。<br><br>认证身份 ID。|
##| identity_type{+条件必填}|string|使用 Spark Ads(`tiktok_item_id`)时本字段必填。<br><br>认证身份类型。<br><br>枚举值: `AUTH_CODE`, `TT_USER`。<br><br>欲了解详情,请查看[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。|
|title_list|object[]|广告文案列表。广告文案作为您的广告素材一部分向受众展示,传递您想传达的信息。<br>若您传入了 `tiktok_item_id`,则不必再传入`image_info`, `video_info`, 和`title_list`字段。|
#|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><p><span style="color:darkred"><b>注意</b></span>: <ul><li>对于TikTok广告,该字段或`call_to_action_id`必须传一个。如果您两个字段都传入,该字段将被忽略。</li><li>您在每个`call_to_action_list`对象中最多可以传入3条CTA文案。</li></ul>|
#|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 个字符。 |
|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)。|
|landing_page_urls {+条件必填}|object[]| 落地页URL列表。 <br><br>每个`landing_page_urls` 对象中仅可传入一个`landing_page_url`。<br><br><p><span style="color:darkred"><b>注意</b></span>:本字段设置后不允许修改。 |
#|landing_page_url{+条件必填}|string|传入 `landing_page_urls` 时必填。<br><br>落地页 URL。|
|common_material|object|常用素材。|
#|ad_name|string| 广告名称。传入 `""` (空字符串)代表自动生成。自动生成广告名格式:素材名 + 创建时间(例如 adcreative20210111190739)。广告名称不能超过512字符,不能包含emoji。请查看上文的<strong>"广告名生成规则"</strong>部分了解广告名称的生成机制。<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 版位生效。可通过[/playable/get/](https://ads.tiktok.com/marketing_api/docs?id=1737732758495234)接口获取。请注意:同一个广告组共用同一个试玩广告。 |
#|fallback_type |string|失败路径。如果用户没有安装过应用,您可以选择让用户返回去安装应用,或者去您想推广的网页。 枚举值:`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></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`)时必填。目前仅支持`CUSTOMIZED_USER`。|
#|is_smart_creative|boolean|是否为广告组启用智能创意。<br><br>默认值:`true`。<br><br>若想了解如何创建智能创意广告,请查看[智能创意](1767322784934914.html)。|
示例
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/aco/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"adgroup_id": "{{adgroup_id}}",
"media_info_list": [
{
"media_info": {
"video_info":{
"video_id":"{{video_id}}"
},
"image_info":[
{"web_uri":"{{web_uri}}"}
]
}
}
],
"title_list": [
{
"title": "{{title}}"
}
],
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"common_material": {
"identity_type": "CUSTOMIZED_USER",
"identity_id": "{{identity_id}}",
"call_to_action_id": "{{call_to_action_id}}",
"is_smart_creative":true
}
}'
(/code)
返回
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|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|创意信息。|
###|video_info|object| 视频信息。 |
####|video_id|string| 视频 ID。 |
####|file_name |string| 视频名称。 |
###|image_info|object[]| 图片信息。 |
####|web_uri |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 Ads 的认证身份 ID。|
###| identity_type|string|Spark Ads 的认证身份类型。枚举值: `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|落地页名称。|
#|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。你可以使用此字段追踪发生在外部网站的事件。 |
###|tracking_app_id | string| 正在追踪的 App 的 ID。|
###| tracking_offline_event_set_ids | string[] | 正在追踪的线下事件组 ID 列表。 |
##|identity_id|string|当您不使用 Spark Ads(`tiktok_item_id`)时的认证身份 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": {
"title_list": [
{
"title": "{{title}}"
}
],
"common_material": {
"call_to_action_id": "{{call_to_action_id}}",
"identity_id": "{{identity_id}}",
"is_smart_creative": true,
"identity_type": "CUSTOMIZED_USER"
},
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"adgroup_id": "{{adgroup_id}}",
"media_info_list": [
{
"media_info": {
"video_info": {
"video_id": "{{video_id}}"
},
"image_info": [
{
"web_uri": "{{web_uri}}"
}
]
}
}
],
"advertiser_id": "{{advertiser_id}}"
}
}
(/code);