广告或创意素材预览
你可以使用本接口预览广告或创意素材。
v1.2与v1.3版本对比
以下表格概括了v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/creative/ads_preview/create/|/v1.3/creative/ads_preview/create/|
|请求参数名称|material_type<br>dpa_video_package_id<br>placement|preview_type<br>shopping_ads_video_template_id<br>placements|
|请求参数类型|advertiser_id: number <br>bc_id: number <br>ad_id: number<br>catalog_id: number <br>product_ids: number[] <br>call_to_action_id: number |advertiser_id: string <br>bc_id: string <br>ad_id: string<br>catalog_id: string <br>product_ids: string[] <br>call_to_action_id: string |
|新增请求参数|/|identity_id<br>identity_type<br>identity_authorized_bc_id<br>objective_type<br>shopping_ads_type<br>promotion_type<br>dynamic_format<br>card_id<br>card_type<br>product_set_id<br>sku_ids<br>product_specific_type<br>item_group_ids<br>vertical_video_strategy<br>card_tags<br>card_show_price<br>card_image_id<br>page_id<br>dynamic_destination<br>instant_product_page_used<br>catalog_authorized_bc_id<br>landing_page_url<br>placement(<strong>预览已有广告</strong>和<strong>预览计划创建的广告</strong>中)<br>preview_format<br>ad_format<br>image_id<br>carousel_image_index(<strong>预览计划创建的广告</strong>中)<br>music_id(<strong>预览计划创建的广告</strong>中)<br>is_smart_performance_campaign(<strong>预览计划创建的广告</strong>中)<br>image_ids(<strong>预览计划创建的广告</strong>中)<br>product_source<br>store_id<br>store_authorized_bc_id<br>showcase_products<br>tiktok_subplacement`(预览计划创建的广告中)|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/creative/ads_preview/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。<br><br><p><span style="color:darkred"><b>注意</b></span>：您需对广告账户有操作员或管理员权限。若想查看您对某个广告账户的权限，可使用[/bc/asset/get/](1739432717798401.html)，返回的 `advertiser_role` 需为 `ADMIN` 或 `OPERATOR`。 |
| preview_type{必填} | string | 预览类型。<br>若想根据广告创建参数预览广告，需传入`ADS_CREATION`。|
| objective_type {必填} {-即将废弃} |string| 推广目标。<br><br>枚举值详见[推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737585562434561)。<br><br><p><span style="color:darkred"><b>注意</b></span>：目前仅支持下列推广目标: `REACH`，`TRAFFIC`, `VIDEO_VIEWS`，`ENGAGEMENT`，`APP_PROMOTION`，`LEAD_GENERATION`，`WEB_CONVERSIONS` ，`PRODUCT_SALES`，和`RF_REACH`。|
| is_smart_performance_campaign {-即将废弃} | boolean| 推广系列是否为 Smart+ 推广系列。<br>默认值：`false`。<br><p><span style="color:darkred"><b>注意</b></span>：在以下任意情况下，本字段均只支持设置为`false` ：<ul><li>`ad_fomat` 设置为 `CAROUSEL_ADS` 或 `CATALOG_CAROUSEL` 时。</li><li>`placement` 设置为 `PLACEMENT_PANGLE`或 `ALL` 时。</li><li>`objective_type` 设置为 `TRAFFIC` ， `REACH` ， `VIDEO_VIEWS` 或 `PRODUCT_SALES` 。</li></ul> |
| placement | string |广告版位。<br>`ad_format`设置为`CAROUSEL_ADS`或`CATALOG_CAROUSEL`时，将本字段设置为`PLACEMENT_TIKTOK`，或不传入本字段。<br>枚举值：<ul><li>`PLACEMENT_TIKTOK`：仅在`objective_type` 为`REACH`，`TRAFFIC`, `VIDEO_VIEWS`，`ENGAGEMENT`，`APP_PROMOTION`，`LEAD_GENERATION`， `WEB_CONVERSIONS` 或 `PRODUCT_SALES` 时支持。</li><li>`PLACEMENT_PANGLE`：仅在`objective_type` 为`TRAFFIC`，`APP_PROMOTION`，`LEAD_GENERATION`（仅当 `promotion_type`为`LEAD_GENERATION`时）或 `WEB_CONVERSIONS` 时支持。</li><li>`PLACEMENT_GLOBAL_APP_BUNDLE`：仅在`objective_type` 为`REACH`时支持。</li><li>`ALL`：仅在`objective_type` 为`TRAFFIC`，`APP_PROMOTION`，`LEAD_GENERATION`（仅当 `promotion_type`为`LEAD_GENERATION`时）或 `WEB_CONVERSIONS` 时支持。</li></ul> |
|tiktok_subplacement|string|仅当同时满足以下两个条件时生效：<ul><li>`objective_type` 为 `REACH`。</li><li>`placement` 为 `PLACEMENT_TIKTOK`。</li></ul><br>TikTok 子版位，用于选择广告出现的具体位置。<br><br>枚举值：<ul><li>`LEMON8`：Lemon8，一款生活方式内容社区应用，内容包含真实生活体验分享、小贴士、指南和商品测评。如果在子版位中包含 Lemon8，广告将展示在其推荐页信息流、搜索信息流和沉浸式视频信息流中。 [了解 Lemon8 的详情](https://ads.tiktok.com/help/article/about-lemon8-in-tiktok-ads-manager)。</li><li>`UNSET`：未设置。</li></ul>|
| preview_format | string |不同`placement`的预览格式有所不同：<ul><li>当`placement`为`PLACEMENT_TIKTOK`时，允许的预览格式为：<ul><li>`IN_FEED`：信息流。广告将投放在“推荐”动态中，可能投放在“个人资料页”和“关注”推荐内容中。</li><li>`SEARCH_RESULTS`：搜索结果页面。 </li><li>`SEARCH_FEED`：搜索推荐内容。</li><li>`TIKTOK_LITE`：TikTok Lite，占用内容更小、视频加载速度更快的精简版 TikTok 应用。TikTok Lite 子版位仅支持定向日本或韩国时使用。 <li>`PRODUCT_SEARCH`: 搜索结果页面（Shopping Center）。在“商城”选项卡的搜索结果页面以及 TikTok 应用的常规搜索结果页面中展示您的商品。了解[关于可投放店铺广告的“商城”选项卡广告位](https://ads.tiktok.com/help/article/about-onsite-shopping-placements)的详情。</li><li>`PRODUCT_SHOP_CENTER`: “为你推荐”板块（Shopping Center）。在“为你推荐”板块，将您的商品展示给可能会购买的用户。</li></ul></li><li>当 `placement` 为 `PLACEMENT_TIKTOK` 且 `tiktok_subplacement` 为 `LEMON8` 时，允许的预览格式为：<ul><li>`IN_FEED`: 信息流。广告将以全屏格式展示，提供沉浸且不受干扰的观看体验。</li><li>`IN_FEED_TWO_COLUMNS`：信息流（双列）。广告将在推荐页信息流中以两列布局展示，使多个内容可以并列显示。</li></ul></li><li>当 `placement` 为 `PLACEMENT_GLOBAL_APP_BUNDLE` 时，允许的预览格式为：<ul><li>`APP_OPEN`：开屏广告。广告将在打开 Capcut 应用时展示，标志着用户会话的开始。此全屏优质版位确保了广告作为用户看到的第一个画面而具有高可见性。</li><li>`IN_FEED`: 信息流。广告将以全屏格式展示，提供沉浸且不受干扰的观看体验。</li><li>`IN_FEED_TWO_COLUMNS`：信息流（双列）。广告将在推荐页信息流中以两列布局展示，使多个内容可以并列显示。</li></ul></li></ul>默认值：`IN_FEED`。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>`SEARCH_FEED` 和`TIKTOK_LITE` 仅在满足以下条件时生效： <ul><li>`objective_type` 为 `REACH`、`VIDEO_VIEWS` 或 `ENGAGEMENT`。 </li><li>`placement` 为 `PLACEMENT_TIKTOK`。</li></ul></li><li>`PRODUCT_SEARCH` 和 `PRODUCT_SHOP_CENTER` 枚举值仅对视频购物广告和商品购物广告可用。</li></li><li>当 `placement` 为 `PLACEMENT_PANGLE`时，不支持本字段。</li></ul> |
| shopping_ads_type{+条件必填} | string |当 `objective_type` 为 `PRODUCT_SALES` 且未传入 `catalog_id` 时必填。<br><br>购物广告类型。<br><br>枚举值：<ul><li>`VIDEO`：视频购物广告。</li><li>`LIVE`：直播购物广告。</li><li>`PRODUCT_SHOPPING_ADS`: 商品购物广告。</li></ul><br>`ad_format`设置为`CATALOG_CAROUSEL`时，将本字段设置为`VIDEO`，或不传入本字段。 |
| product_source {+条件必填} | string | 当为视频购物广告和商品购物广告时必填。<br><br>您希望从中获取推广商品的产品来源。<br><br>枚举值：`STORE` (TikTok Shop),`SHOWCASE`(TikTok Showcase)。<ul><li>对于视频购物广告，您可以将此字段设为 `STORE` 或 `SHOWCASE`。</li><li>对于商品购物广告，将此字段设为 `STORE`。</li></ul> |
| store_id {+条件必填} | string | <ul><li>在以下任一场景必填：<ul><li>`shopping_ads_type` 为 `VIDEO` 且 `product_source` 为 `STORE`。</li><li>`shopping_ads_type` 为 `PRODUCT_SHOPPING_ADS` 且 `product_source` 为 `STORE`。</li></ul></li><li>当 `shopping_ads_type` 为 `LIVE` 时，此字段选填。</li></ul> <br>TikTok Shop ID。<br><br>若想获取 TikTok Shop ID，可调用 [/bc/asset/get/](1739432717798401.html) 并将 `asset_type` 设置为 `TIKTOK_SHOP`。返回的 `asset_id` 将是 TikTok Shop ID。 |
| store_authorized_bc_id {+条件必填} | string | 当传入 `store_id` 时必填。<br><br>有权管理该 TikTok Shop (`store_id`) 的商务中心的 ID。 |
| showcase_products {+条件必填} | object[] | 当 `shopping_ads_type` 为 `VIDEO` 且 `product_source` 为 `SHOWCASE` 时必填。<br><br>了解详情请查看[创建商品来源为橱窗的视频购物广告](1759232259360770.html)。<br><br>您想要用在广告中的橱窗商品列表。<br><br>最大数量：20。<br><br>若想获取可用的橱窗商品，可调用 [/showcase/product/get/](1759233576199169.html)。 |
#| item_group_id {+条件必填} | string | 当传入 `showcase_products` 时必填。<br><br>商品的 SPU ID。 |
#| store_id {+条件必填} | string | 当传入 `showcase_products` 时必填。<br><br>商品（`item_group_id`）所属的 TikTok Shop ID。 |
|promotion_type {+条件必填} {-即将废弃} |string|推广对象类型。<br><br>枚举值：<ul><li>`APP_ANDROID`：Android应用。</li><li>`APP_IOS`：iOS应用。</li><li>`WEBSITE`：落地页。</li><li>`LEAD_GENERATION`: 即时表单（线索表单）或落地页。</li><li>`LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`: TikTok 私信。</li><li>`LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE`: 即时通讯应用。</li><li>`LEAD_GEN_CLICK_TO_CALL`: 电话通话。</li></ul> <br><p><span style="color:darkred"><b>注意</b></span>：以下枚举值仅支持在 `objective_type` 为 `LEAD_GENERATION` 时使用：<ul><li>`LEAD_GENERATION`</li><li>`LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE` </li><li>`LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE` </li><li>`LEAD_GEN_CLICK_TO_CALL`</li></ul>|
|identity_id {必填}|string|认证身份 ID。<br><br>如果您不使用 Spark Ads，传入 `identity_id` 和 `identity_type`（`CUSTOMIZED_USER`类型）可帮助您更好地管理广告信息。|
|identity_type{必填}|string|认证身份类型。<br><br>枚举值：`CUSTOMIZED_USER`，`AUTH_CODE` ，`TT_USER`，`BC_AUTH_TT`。<br>对于自定义认证身份，请使用`CUSTOMIZED_USER`，在 Spark Ads 中使用`AUTH_CODE` ，`TT_USER`，`BC_AUTH_TT`。<br>参阅[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)获取详细信息。<br><br><ul><li>`ad_format`设置为`CATALOG_CAROUSEL`时，仅可将本字段设置为`CUSTOMIZED_USER`。</li><li>`objective_type` 为 `LEAD_GENERATION` 时：<ul><li>若 `promotion_type` 为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE` ，必须使用 Spark Ads 且 `identity_type` 需设置为 `TT_USER` 或 `BC_AUTH_TT`。</li><li>若 `promotion_type` 非 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE` ，支持 Spark Ads 和非 Spark Ads，`identity_type` 可设置为任意枚举值。</li></ul> </li><li> `objective_type` 为 `ENGAGEMENT` 时，必须使用 Spark Ads 且`identity_type` 需设置为`AUTH_CODE`，`TT_USER` 或 `BC_AUTH_TT`。</li></ul>|
|identity_authorized_bc_id{+条件必填}|string|当`identity_type` 为 `BC_AUTH_TT`时必填。<br><br>与添加到商务中心的TikTok用户这一认证身份绑定的商务中心的 ID。|
| ad_format{必填} |string|广告样式。<br><ul><li>对于单视频广告，将此字段设为 `SINGLE_VIDEO`。</li><li>对于单图片广告，将此字段设为 `SINGLE_IMAGE`。</li><li>对于 TikTok 标准轮播广告，将此字段设为 `CAROUSEL_ADS`。<ul><li>若想使用此广告样式，您需将 `objective_type` 设置为 `REACH`、`WEB_CONVERSIONS`、`APP_PROMOTION`、`LEAD_GENERATION` 或 `TRAFFIC`。</li></ul></li><li>对于 TikTok 商品库轮播广告，将此字段设为 `CATALOG_CAROUSEL`。<br>点击[这里](1766217791987713.html)查看创建轮播广告的步骤。</li><li>对于直播购物广告，将此字段设为 `LIVE_CONTENT`。</li></ul>|
|video_id {+条件必填}|string| 视频素材 ID。<br>`ad_format`为`SINGLE_VIDEO`时必填。<br>`ad_format`为`SINGLE_IMAGE`，`CAROUSEL_ADS`或`CATALOG_CAROUSEL`时不支持本字段。<br><ul><li>若想创建非 Spark Ads 视频广告或通过 Spark Ads 推送创建 [Spark Ads](https://ads.tiktok.com/marketing_api/docs?id=1739470744631298) 视频广告 ，需使用`video_id`。您可以使用[/file/video/ad/search/](https://ads.tiktok.com/marketing_api/docs?id=1740050472224769)接口查询视频素材 ID。</li><li>若想通过 Spark Ads 拉取创建 Spark Ads 视频广告，需使用`tiktok_item_id`指定TikTok 帖子 ID。</li></ul>|
| image_ids{+条件必填} | string[] | 仅在以下任意场景必填：<ul><li>`ad_format` 为`SINGLE_IMAGE` 。</li><li>`ad_format` 为 `CAROUSEL_ADS` 且您想创建非 Spark Ads 标准轮播广告或通过 Spark Ads 推送创建 Spark Ads 标准轮播广告。</li></ul><br><br>图片 ID 列表（图片素材或视频封面）。 <br><br><ul><li>当 `ad_format` 设置为 `CAROUSEL_ADS` 时，本字段的 ID 数量范围为[1, 35]，且本字段指定的图片ID的顺序即为轮播广告中对应图片的展示顺序。 <br>请查看[创建轮播广告](https://ads.tiktok.com/marketing_api/docs?id=1766217791987713)，了解可在 TikTok 轮播广告中使用的图片的要求。</li><li>当 `ad_format` 设置为 `SINGLE_IMAGE` 时，仅可向本字段传入一个图片 ID。<br>若想了解单图片广告中的图片要求，请查看[创建单图片广告](1777633230937090.html)。</li></ul>|
|music_id{+条件必填} | string |仅在以下任意场景必填：<ul><li>`ad_format` 为 `CATALOG_CAROUSEL`。</li><li>`ad_format` 为 `CAROUSEL_ADS` 且您创建非 Spark Ads 标准轮播广告或通过 Spark Ads 推送创建 Spark Ads 标准轮播广告。</li></ul><br>想要在 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>：使用此功能，代表您声明拥有该视频中音乐的版权，可用于营销使用。 |
| carousel_image_index |integer| 仅当`ad_format`设置为`CATALOG_CAROUSEL`，且所指定的商品已设置对应的附加图片列表时生效。<br><br>用于指定视频购物类型的轮播广告中要使用的附加图片的索引。若未传入本字段，将在视频购物类型的轮播广告中使用商品库商品的主图。<br>取值范围：[0, 9]。<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的数量，将忽略本字段，使用商品的主图（`image_url`）。您可通过[/catalog/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1740564136678402)返回的`image_url` 字段获取商品对应的主图。</li></ul> |
|ad_text{+条件必填} |string| 广告文案，将作为广告创意的一部分展示给你的受众，向他们传达你想要推广的信息。不知道怎么写？试试[智能文案](https://ads.tiktok.com/marketing_api/docs?id=1739084248002626)。<ul><li>对于非Spark Ads广告，本字段必填。</li><li>广告文案长度允许值为 1-100 字符，不能包含emoji。</li><li>中文或日文每个字占用2个字符，每个英语字符占用1个字符。</li></ul>|
| call_to_action{+条件必填} | string | 行动引导文案，引导用户在看到你的广告后完成你期望的行为。对于TikTok广告，本字段或者 `call_to_action_id` 必须传入一个，如果同时传入，此字段将被忽略。枚举值见[枚举值 - 行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。直播购物事件下，此字段的值必须为 `WATCH_LIVE`。<br><p><span style="color:darkred"><b>注意</b></span><ul><li>如果`objective_type`为`REACH`或`VIDEO_VIEW`，且您已传入`landing_page_url`或`page_id`，则必须传入`call_to_action`或 `call_to_action_id`其中一个字段。</li><li>如果`objective_type`为`APP_PROMOTION`， `WEB_CONVERSIONS`，或`TRAFFIC`，则必须传入`call_to_action`或 `call_to_action_id`其中一个字段。</li><li>如果 `objective_type` 为 `LEAD_GENERATION` ：<ul><li>`promotion_type` 为 `LEAD_GENERATION` 时，需传入 `call_to_action` 和 `call_to_action_id` 其中之一。</li><li> `promotion_type` 为`LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`时，必须传入`call_to_action`，且必须设置为 `SEND_MESSAGE`。</li><li> `promotion_type` 为 `LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE` 时，必须传入`call_to_action`，且不允许设置为`CALL_NOW`。</li><li>`promotion_type` 为 `LEAD_GEN_CLICK_TO_CALL`时，必须传入`call_to_action`。</li></ul> </li><li>如果`objective_type`为`PRODUCT_SALES`，则必须传入`call_to_action`。</li></ul>|
| call_to_action_id{+条件必填} |string| 行动引导文案素材包ID。行动引导文案素材包指的是一组自动优化的行动引导文案。如果本字段和 `call_to_action` 都传入，`call_to_action` 会被忽略。关于自动优化行动引导文案的更多信息，请参见[智能推荐CTA > 动态优选CTA](https://ads.tiktok.com/marketing_api/docs?id=1740307296329730)。<br><p><span style="color:darkred"><b>注意</b></span><ul><li>如果`objective_type`为`REACH`或`VIDEO_VIEW`，且您已传入`landing_page_url`或`page_id`，则必须传入`call_to_action`或 `call_to_action_id`其中一个字段。</li><li>如果`objective_type`为`APP_PROMOTION`， `WEB_CONVERSIONS`，或`TRAFFIC`，则必须传入`call_to_action`或 `call_to_action_id`其中一个字段。</li><li>如果`ad_format`为`CAROUSEL_ADS`或`CATALOG_CAROUSEL`，则不支持传入`call_to_action_id`。</li><li>如果`objective_type` 为 `LEAD_GENERATION`：<ul><li>`promotion_type` 为 `LEAD_GENERATION` 时，需传入 `call_to_action` 和`call_to_action_id` 其中之一。</li><li>`promotion_type` 为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`，`LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE` 或 `LEAD_GEN_CLICK_TO_CALL` 时，不支持 `call_to_action_id` 。</li></ul></li></ul>|
|card_id|string|创意素材包 ID。<br><br>传入以下类型的创意素材包的 ID：<ul><li>展示卡片（又称图片卡片）。</li><li>网站信息卡片。</li><li>商品卡片。</li><li>商品磁贴。</li><li>倒计时贴纸。</li><li>礼品码贴纸。</li><li>交互手势。</li><li>点赞彩蛋。</li></ul> <br>若想创建素材包，可使用 [/creative/portfolio/create/](1739091950439426.html)。<br><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>当`objective_type`= `REACH`，`promotion_type`= `WEBSITE`，`placements`= `PLACEMENT_TIKTOK`，且`ad_format` = `SINGLE_VIDEO`。</li><li>当`objective_type`= `TRAFFIC`，`promotion_type`= `WEBSITE`，`placements`= `PLACEMENT_TIKTOK`，且`ad_format` = `SINGLE_VIDEO`。</li><li>当`objective_type`= `VIDEO_VIEWS`，`placements`= `PLACEMENT_TIKTOK`，且`ad_format` = `SINGLE_VIDEO`。</li><li>当 `objective_type` = `ENGAGEMENT` ，仅支持通过本字段指定倒计时贴纸素材包。</li><li>当`objective_type`= `APP_PROMOTION`，`promotion_type`= `WEBSITE`，`placements`= `PLACEMENT_TIKTOK`，且`ad_format` = `SINGLE_VIDEO`。</li><li>当 `objective_type` = `LEAD_GENERATION` ，仅支持通过本字段指定展示卡片素材包。</li><li>当`objective_type`=`WEB_CONVERSIONS`，`placements`= `PLACEMENT_TIKTOK`，且`ad_format` = `SINGLE_VIDEO`。</li><li>当`objective_type`=`PRODUCT_SALES`，`placements`= `PLACEMENT_TIKTOK`，且 `ad_format` = `SINGLE_VIDEO`。|
|landing_page_url {+条件必填}|string|落地页URL。<br><p><span style="color:darkred"><b>注意</b></span><ul><li>当`objective_type`为`APP_PROMOTION`，`WEB_CONVERSIONS`或`TRAFFIC`，且`promotion_type`为`WEBSITE`时，`page_id`或`landing_page_url`必须传入其中一个。</li><li>如果`objective_type`为`APP_PROMOTION`或 `TRAFFIC`，且`promotion_type`为`APP_ANDROID`/`APP_IOS`，`page_id`或`landing_page_url`都不需要传入。</li></ul>|
|page_id {+条件必填}|string| 页面 ID。 <br><p><span style="color:darkred"><b>注意</b></span><ul><li>当`objective_type`为`APP_PROMOTION`，`WEB_CONVERSIONS`或`TRAFFIC`，且`promotion_type`为`WEBSITE`时，`page_id`或`landing_page_url`必须传入其中一个。</li><li>如果`objective_type`为`APP_PROMOTION`或 `TRAFFIC`，且`promotion_type`为`APP_ANDROID`/`APP_IOS`，`page_id`或`landing_page_url`都不需要传入。</li><li>如果`ad_format`为`CATALOG_CAROUSEL`，不支持本字段。</li></ul>|
| catalog_id {+条件必填} | string |商品库 ID。广告中的商品来自该商品库。<br>`ad_format`设置为`CATALOG_CAROUSEL`时，本字段必填。<br><br><p><span style="color:darkred"><b>注意</b></span>：您需对商品库有广告推广或商品库管理权限。若想查看您对某个商品库的权限，可使用[/bc/asset/get/](1739432717798401.html)，返回的 `catalog_role` 需 为 `ADMIN` 或 `AD_PROMOTE`。 |
|product_specific_type{+条件必填} |string|选择商品的维度。<br>`ad_format`设置为`CATALOG_CAROUSEL`时，本字段必填。轮播图片将从所指定的商品库商品范围中动态选取，且所指定的商品库商品范围需包含至少两个商品。<br>枚举值：<ul><li>`ALL`：允许TikTok动态选择商品库中的所有商品。</li><li>`PRODUCT_SET`：请选择一个商品系列。TikTok将动态选择该商品系列中的商品。</li><li>`CUSTOMIZED_PRODUCTS`：最多可从您的商品库中选择20个商品。</li></ul><p><span style="color:darkred"><b>注意</b>：</span><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><p><span style="color:darkred"><b>注意</b></span>:<ul><li>当 `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></li><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>若指定了 `catalog_id`且`product_specific_type`设置为`PRODUCT_SET`，需传入`item_group_ids`或`product_set_id`。</li><li>在以下任一场景中必填：<ul><li>`shopping_ads_type` 为 `VIDEO` 且 `product_source` 为 `STORE`。</li><li>`shopping_ads_type` 为 `PRODUCT_SHOPPING_ADS`，`product_source` 为 `STORE`，且 `product_specific_type` 为 `CUSTOMIZED_PRODUCTS`。</li></ul></li></ul><br>商品的 SPU（标准化产品单元） ID列表。|
|product_set_id{+条件必填} |string|若指定了 `catalog_id`且`product_specific_type`设置为`PRODUCT_SET`，需传入`item_group_ids`或`product_set_id`。<br><br>商品系列 ID。|
|sku_ids{+条件必填} |string[]|当指定了 `catalog_id`且`product_specific_type`设置为`CUSTOMIZED_PRODUCTS`时必填。<br><br>SKU（库存量单位）ID 列表。<br><br>最大数量：20。|
|hotel_ids |string[] |酒店 ID 列表。<br><br>最大数量：20。|
|flight_ids|string[] |航班 ID 列表。 <br><br>最大数量：20。|
|destination_ids |string[] |目的地 ID 列表。<br><br>最大数量：20。|
| catalog_authorized_bc_id | string |拥有商品库权限的商务中心ID。预览商品库商品时，请使用该字段。|
| dynamic_format | string |`ad_format` 设置为 `CAROUSEL_ADS`或`CATALOG_CAROUSEL` 时不支持本字段。<br>动态样式。<br>枚举值：<ul><li>`UNSET`：未设置。</li><li>`DYNAMIC_CREATIVE`：智能创意。根据用户的购买意图向每位用户展示不同的视频，商品卡片和目标页面，从而最大限度地提高广告转化量。 </li></ul>|
| vertical_video_strategy | string |`ad_format` 设置为 `CAROUSEL_ADS`或`CATALOG_CAROUSEL` 时不支持本字段。<br>视频策略。<br>枚举值：<ul><li>`SINGLE_VIDEO`：利用视频创意推广您的商品。</li><li>`CATALOG_VIDEOS`：基于商品库中的信息生成动态视频。</li><li>`LIVE_STREAM`: 使用直播推广您的商品。本枚举值仅适用于广告样式为实时直播的直播购物广告。</li><li>`UNSET`：未设置。</li></ul>若`dynamic_format`为`DYNAMIC_CREATIVE`，该字段必须设置为`UNSET`。|
|shopping_ads_video_template_id {-即将废弃} |string| 商品视频包 ID。<br>使用[/catalog/video/get/](https://ads.tiktok.com/marketing_api/docs?id=1740574099715073)接口获取视频包 ID。|
|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>`shopping_ads_type` 为 `VIDEO` （视频购物广告）</li><li> `product_source` 为 `CATALOG`</li><li> `ad_format` 为 `SINGLE_VIDEO` 且 `vertical_video_strategy` 为 `SINGLE_VIDEO` 或 `ad_format` 为 `CATALOG_CAROUSEL`</li></ul></li></ul><br>若想了解失败路径的支持场景，请查看“[深度链接 - 支持范围 - 失败路径](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-失败路径)”小节。|
| dynamic_destination | string | `ad_format` 设置为 `CAROUSEL_ADS`或`CATALOG_CAROUSEL` 时不支持本字段。<br>动态目标页面策略。<br>枚举值：<ul><li>`DLP`：动态落地页。基于用户的主页、行为和意向，向每位用户展示不同的目标页面，包括自定义网站或即时体验商品页面等，从而最大限度地提高广告转化量。</li><li>`UNSET`：未设置。</li></ul>|
| instant_product_page_used | boolean |`ad_format` 设置为 `CAROUSEL_ADS`或`CATALOG_CAROUSEL` 时不支持本字段。<br>是否使用TikTok即时体验商品页面（自动生成的TikTok即时体验页面，展示多种商品，提供原生落地页体验）。<ul><li>若`dynamic_destination`为`DLP`, 则不需要该参数。</li><li>若`dynamic_destination`为`UNSET`, 您可以将本字段设置为`true`，且无需同时传入`page_id`。</li></ul>|
请求示例
预览商品来源为 TikTok Shop 的视频购物广告
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"objective_type": "PRODUCT_SALES",
"shopping_ads_type": "VIDEO",
"product_source": "STORE",
"placement": "PLACEMENT_TIKTOK",
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER",
"ad_format": "SINGLE_VIDEO",
"item_group_ids": ["{{item_group_id_1}}", "{{item_group_id_2}}"],
"vertical_video_strategy": "SINGLE_VIDEO",
"video_id": "{{video_id}}",
"ad_text": "{{ad_text}}"
}'
(/code)
预览商品来源为橱窗的视频购物广告
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"objective_type": "PRODUCT_SALES",
"shopping_ads_type": "VIDEO",
"product_source": "SHOWCASE",
"placement": "PLACEMENT_TIKTOK",
"identity_id": "{{identity_id}}",
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_type": "BC_AUTH_TT",
"showcase_products" : [
{
"item_group_id": "{{item_group_id_1}}",
"store_id": "{{store_id_1}}"
},
{
"item_group_id": "{{item_group_id_2}}",
"store_id": "{{store_id_2}}"
}
],
"ad_format": "SINGLE_VIDEO",
"vertical_video_strategy": "SINGLE_VIDEO",
"video_id": "{{video_id}}",
"call_to_action": "BOOK_NOW",
"ad_text": "{{ad_text}}",
"card_id": "{{card_id}}"
}'
(/code)
预览商品购物广告
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"objective_type": "PRODUCT_SALES",
"shopping_ads_type": "PRODUCT_SHOPPING_ADS",
"product_source": "STORE",
"store_id": "{{store_id}}",
"placement": "PLACEMENT_TIKTOK",
"product_specific_type": "ALL",
"item_group_ids": ["{{item_group_id_1}}", "{{item_group_id_2}}"]
}'
(/code)
预览广告样式为单视频的直播购物广告
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"objective_type": "PRODUCT_SALES",
"shopping_ads_type": "LIVE",
"placement": "PLACEMENT_TIKTOK",
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER",
"ad_format": "LIVE_CONTENT",
"vertical_video_strategy": "SINGLE_VIDEO",
"video_id": "{{video_id}}",
"ad_text": "{{ad_text}}"
}'
(/code)
预览广告样式为实时直播的直播购物广告
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"objective_type": "PRODUCT_SALES",
"placement": "PLACEMENT_TIKTOK",
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER",
"shopping_ads_type": "LIVE",
"ad_format": "LIVE_CONTENT",
"vertical_video_strategy": "LIVE_STREAM"
}'
(/code)
预览使用所有版位的广告
(code curl http)
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"objective_type": "TRAFFIC",
"ad_format": "SINGLE_VIDEO",
"promotion_type": "WEBSITE",
"ad_text": "{{ad_text}}",
"call_to_action": "SHOP_NOW",
"placement": "ALL",
"video_id": "{{video_id}}"
}'
(/code)
预览使用单一版位的广告
(code curl http)
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"objective_type": "TRAFFIC",
"ad_format": "SINGLE_VIDEO",
"promotion_type": "WEBSITE",
"ad_text": "{{ad_text}}",
"call_to_action": "SHOP_NOW",
"placement": "PLACEMENT_TIKTOK",
"preview_format": "SEARCH_RESULTS",
"video_id": "{{video_id}}"
}'
(/code)
预览计划创建的非视频购物类型的轮播广告
(code curl http)
curl --location 'https://business-api.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"objective_type": "APP_PROMOTION",
"is_smart_performance_campaign": false,
"promotion_type": "APP_ANDROID",
"placement": "PLACEMENT_TIKTOK",
"ad_format": "CAROUSEL_ADS",
"ad_text": "{{ad_text}}",
"call_to_action": "DOWNLOAD_NOW",
"instant_product_page_used": false,
"image_ids": ["{{image_id}}", "{{image_id}}"],
"music_id": "{{music_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER"
}'
(/code)
预览计划创建的视频购物类型的轮播广告
(code curl http)
# VSA Carousel Ads with images from All products
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"objective_type": "PRODUCT_SALES",
"placement": "PLACEMENT_TIKTOK",
"preview_format": "IN_FEED",
"ad_format": "CATALOG_CAROUSEL",
"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"call_to_action": "SHOP_NOW",
"music_id": "{{music_id}}",
"catalog_id": "{{catalog_id}}",
"product_specific_type": "ALL",
"carousel_image_index": 2,
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
"ad_text": "{{ad_text}}",
}'
# VSA Carousel Ads with images from Customized products
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"objective_type": "PRODUCT_SALES",
"placement": "PLACEMENT_TIKTOK",
"preview_format": "IN_FEED",
"ad_format": "CATALOG_CAROUSEL",
"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"call_to_action": "SHOP_NOW",
"music_id": "{{music_id}}",
"catalog_id": "{{catalog_id}}",
"product_specific_type": "CUSTOMIZED_PRODUCTS",
"sku_ids": [
"{{sku_id}}",
"{{sku_id}}"
],
"carousel_image_index": 0,
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
"ad_text": "AD_TEXT Testing"
}'
# VSA Carousel Ads with images from Product Set
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "ADS_CREATION",
"objective_type": "PRODUCT_SALES",
"placement": "PLACEMENT_TIKTOK",
"preview_format": "IN_FEED",
"ad_format": "CATALOG_CAROUSEL",
"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"call_to_action": "SHOP_NOW",
"music_id": "{{music_id}}",
"catalog_id": "{{catalog_id}}",
"product_specific_type": "PRODUCT_SET",
"product_set_id": "{{product_set_id}}",
"carousel_image_index": 0,
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
"ad_text": "AD_TEXT Testing"
}'
(/code)
预览已有广告
|字段|类型|描述|
|-|-|-|
| advertiser_id{必填} | string| 广告主 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>您需对广告账户有操作员或管理员权限。若想查看您对某个广告账户的权限，可使用[/bc/asset/get/](1739432717798401.html)，返回的 `advertiser_role` 需为 `ADMIN` 或 `OPERATOR`。 </li><li>若广告中使用了商品库，您还需对商品库有广告推广或商品库管理权限。若想查看您对某个商品库的权限，可使用[/bc/asset/get/](1739432717798401.html)，返回的 `catalog_role` 需 为 `ADMIN` 或 `AD_PROMOTE`。 </li></ul> |
| preview_type{必填} | string | 您想要预览的广告类型。预览已有的常规广告，请选择`AD`。<br><br><p><span style="color:darkred"><b>注意</b></span>：目前仅支持下列推广目标: `REACH`， `TRAFFIC`, `VIDEO_VIEWS`，`ENGAGEMENT`，`APP_PROMOTION`，`LEAD_GENERATION`，`WEB_CONVERSIONS`， `PRODUCT_SALES`和`RF_REACH`。|
|ad_id {必填}| string| 您想要预览的广告 ID。|
|device|string[]| 设备型号列表。<br>枚举值见[/tool/device_model/](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)。|
|language|string| 广告所用语言。 <br><br>枚举值: `ENGLISH`, `CHINESE`, `JAPANESE`。<br>默认值: `ENGLISH`。|
| placement | string |广告版位。<br><br>枚举值：<ul><li>`PLACEMENT_TIKTOK`：仅在`objective_type` 为`REACH`， `TRAFFIC`, `VIDEO_VIEWS`，`ENGAGEMENT`，`APP_PROMOTION`， `LEAD_GENERATION`，`WEB_CONVERSIONS` 或 `PRODUCT_SALES`时支持。</li><li>`PLACEMENT_PANGLE`：仅在`objective_type` 为`TRAFFIC`，`LEAD_GENERATION`（仅当 `promotion_type`为`LEAD_GENERATION`时），`APP_PROMOTION` 或 `WEB_CONVERSIONS` 时支持。</li><li>`ALL`：仅在`objective_type` 为`TRAFFIC`，`LEAD_GENERATION`（仅当 `promotion_type`为`LEAD_GENERATION`时），`APP_PROMOTION` 或 `WEB_CONVERSIONS` 时支持。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：若想为广告设置非 TikTok 版位，需在传入本字段进行设置。否则，本字段将默认设置为 TikTok 版位 (`PLACEMENT_TIKTOK`) 。|
示例
(code curl http)
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "AD",
"ad_id": "{{ad_id}}"
}'
(/code)
预览已有创新互动样式
|字段|类型|描述|
|-|-|-|
| advertiser_id{必填} | string | 广告主 ID。 |
| preview_type {必填} | string | 预览类型。<br><br>若想预览创新互动样式，需传入`CARD`。|
|card_id|string|创意素材包 ID。<br><br>传入以下类型的创意素材包的 ID：<ul><li>展示卡片（又称图片卡片）。</li><li>倒计时贴纸。</li><li>礼品码贴纸。</li></ul><br>若想创建素材包，可使用 [/creative/portfolio/create/](1739091950439426.html)。<ul><li>若想了解如何获取展示卡片的 ID，请参考[卡片](1749019652141058.html)。</li><li>若想了解如何获取倒计时贴纸或礼品码贴纸素材包的 ID，请参考[贴纸](1749019667506177.html)。</li></ul>|
示例
(code curl http)
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "CARD",
"card_id": "{{card_id}}"
}'
(/code)
预览页面
|字段|类型|描述|
|-|-|-|
| advertiser_id{必填} | string | 广告主 ID。 |
| preview_type {必填} | string | 您想要预览的广告类型。预览商品落地页，请选择`PAGE`。|
|page_id {+条件必填}|string| 页面 ID。<br><br><ul><li>若想创建即时体验页面，可使用[即时体验页面编辑器](1740307202170881.html)并将 `businessType`设置为 `6`。 </li><li>创建即时体验页面后，可使用[/page/get/](1820826387779586.html)获取页面 ID。</li></ul>|
示例
(code curl http)
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "PAGE",
"page_id": "{{page_id}}"
}'
(/code)
预览视频
|字段|类型|描述|
|-|-|-|
| advertiser_id{必填} | string | 广告主 ID。 |
|preview_type{必填} | string | 您想要预览的广告类型。根据参数预览视频广告，请选择`SINGLE_VIDEO`。|
| video_id{必填} | string | 视频ID。不同版位对素材的要求不同。详情请参阅[广告格式介绍](https://ads.tiktok.com/help/article?aid=9629)。|
| thumbnail | string | 封面图片ID。可以通过 [获取视频智能封面](https://ads.tiktok.com/marketing_api/docs?id=1740051189071873)接口获取。 |
| profile_image | string | 头像对应的图片ID。 |
| display_name{必填} | string |品牌名称。长度限制：1-40个英文字符或1-20个中文/日文/韩文字符。|
| ad_text{必填} | string | 广告文案。字符数限制: 1-100。|
| call_to_action{+条件必填} | string | 行动引导文案，引导用户在看到你的广告后完成你期望的行为。对于TikTok广告，本字段或者 `call_to_action_id` 必须传入一个，如果同时传入，此字段将被忽略。枚举值见[枚举值 - 行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。直播购物事件下，此字段的值必须为 `WATCH_LIVE`。 |
| call_to_action_id{+条件必填} |string| 行动引导文案素材包ID。行动引导文案素材包指的是一组自动优化的行动引导文案。如果本字段和 `call_to_action` 都传入，`call_to_action` 会被忽略。关于自动优化行动引导文案的更多信息，请参见[智能推荐CTA > 动态优选CTA](https://ads.tiktok.com/marketing_api/docs?id=1740307296329730)。 |
| placements{必填} {-即将废弃} | string[] |版位。枚举值见[枚举值 - 版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。不同版位对素材的要求不同。详情请参阅[广告格式介绍](https://ads.tiktok.com/help/article?aid=9629)。|
|device {-即将废弃} |string[]| 设备型号列表。枚举值见[获取设备型号](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)。|
|language {-即将废弃} |string| 广告所用语言。 枚举值: `ENGLISH`, `CHINESE`, `JAPANESE`。默认值: `ENGLISH`。|
示例
(code curl http)
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "SINGLE_VIDEO",
"video_id": "{{video_id}}",
"display_name": "{{display_name}}",
"ad_text": "{{ad_text}}",
"call_to_action": "APPLY_NOW",
"placements": [
"PLACEMENT_TIKTOK"
],
"device": [
"{{device}}"
],
"language": "CHINESE"
}'
(/code)
预览图片
|字段|类型|描述|
|-|-|-|
| advertiser_id{必填} | string | 广告主ID。 |
| preview_type{必填} | string | 你想要预览的广告类型。根据参数预览图片广告，请选择`SINGLE_IMAGE`。 |
| image_id{必填} | string | 图片ID。不同版位对素材的要求不同。详情请参阅[广告格式介绍](https://ads.tiktok.com/help/article?aid=9629)。|
| display_name{必填} | string |品牌名称。长度限制：1-40个英文字符或1-20个中文/日文/韩文字符。|
| ad_text{必填} | string | 广告文案。字符数限制: 1-100。|
| call_to_action{+条件必填} | string | 行动引导文案，引导用户在看到你的广告后完成你期望的行为。对于TikTok广告，本字段或者 `call_to_action_id` 必须传入一个，如果同时传入，此字段将被忽略。枚举值见[枚举值 - 行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。直播购物事件下，此字段的值必须为 `WATCH_LIVE`。 |
| call_to_action_id{+条件必填} |string| 行动引导文案素材包ID。行动引导文案素材包指的是一组自动优化的行动引导文案。如果本字段和 `call_to_action` 都传入，`call_to_action` 会被忽略。关于自动优化行动引导文案的更多信息，请参见[智能推荐CTA > 动态优选CTA](https://ads.tiktok.com/marketing_api/docs?id=1740307296329730)。 |
| placements{必填} {-即将废弃} | string[] |版位。枚举值见[枚举值 - 版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。不同版位对素材的要求不同。详情请参阅[广告格式介绍](https://ads.tiktok.com/help/article?aid=9629)。|
|device {-即将废弃} |string[]| 设备型号列表。枚举值见[获取设备型号](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)。|
|language {-即将废弃} |string| 广告所用语言。 枚举值: `ENGLISH`, `CHINESE`, `JAPANESE`。默认值: `ENGLISH`。|
示例
(code curl http)
curl --location 'https://ads.tiktok.com/open_api/v1.3/creative/ads_preview/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"preview_type": "SINGLE_IMAGE",
"image_id": "{{image_id}}",
"ad_text": "{{ad_text}}",
"display_name": "{{display_name}}",
"call_to_action": "CONTACT_US",
"placements": [
"PLACEMENT_PANGLE"
],
"device": [
"{{device}}"
],
"language": "CHINESE"
}'
(/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|返回数据。|
#| preview_link | string | 预览链接。<br><br>有效期：<ul><li> `preview_type` 设置为 `ADS_CREATION` 或 `AD`时：30 天。</li><li>`preview_type` 设置为 `CARD`，`PAGE`，`SINGLE_VIDEO` 或 `SINGLE_IMAGE`时：24 小时。 </li></ul>|
#|iframe|string|包含预览链接的iframe代码。您可以将iframe代码嵌入HTML。|
#| tips | list | 修改建议。根据提示修改使用的素材，获取更佳显示效果。|
##| placement{+ 条件返回} | string | 错误版位。枚举值见[枚举值 - 版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。如果该字段缺失，那么表示通用提示信息（即适用于所有版位）。 |
##| messages | string[] | 提示信息。 |
示例
(code curl http)
{
"message": "OK",
"code": 0,
"data": {
"tips": [
{
"messages": [
"The resolution should be 1280*720 at least."
],
"placement": "PLACEMENT_TIKTOK"
}
],
"preview_link": "https://ads.tiktok.com/ad_preview_tool?ad_preview_id=5681cba0fcd211eab33c351a98xxxxx",
"iframe": "<iframe src="https://ads.tiktok.com/ad_preview_tool?ad_preview_id=5681cba0fcd211eab33c351a98xxxxx"></iframe>"
},
"request_id": "202009221251300101151531921B1D3F96"
}
(/code)