← 返回目录
📁 Use Cases › Campaign creation › Create Shopping Ads

(即将废弃)创建产品目录广告

本文介绍了如何创建产品目录广告。

注意
我们即将下线产品目录广告(CLA),并关闭所有正在投放的CLA推广系列。在未来几个月,我们将把CLA与视频购物广告整合为一个统一的解决方案:购物广告。我们将在近期分享更多有关该全新解决方案的集成机会,并期待推出以商品库驱动的全新版位和格式,为我们的广告主创造更加直接的价值。

注意
下列参数表中必填/ 条件必填 标记只适用于视频购物广告场景。

1.创建推广系列

使用 /campaign/create/接口创建一个推广系列。下表列出了相关参数。

注意
目前购物广告不支持推广系列预算优化(CBO)。

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。 |
|objective_type {必填}|string|推广目标。购物广告需将此字段设置为`PRODUCT_SALES`。|
|budget_mode {+条件必填}|string| 预算模式。例如可以设置日预算。欲了解如何设置预算类型,请查看[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。|
|budget {+条件必填}|float| 推广系列预算。当 `budget_mode`设置为 `BUDGET_MODE_DAY`或`BUDGET_MODE_TOTAL`时必填。欲了解最低预算和如何设置预算类型,请查看[预算](https://ads.tiktok.com/marketing_api/docs?id=1739381246298114)。 |
|campaign_name {必填}|string|推广系列名称。最长为512个字符,不支持emoji。 <br data-tomark-pass>注意: 每个汉字或日文单字算作两个字符,每个英文字母算作一个字符。|
|campaign_type|string|枚举值: `REGULAR_CAMPAIGN`,` IOS14_CAMPAIGN`。<br> 注意: 产品目录广告不支持`IOS14_CAMPAIGN` 。|

2.创建、管理商品库

使用商品库接口或TikTok商务中心创建、管理商品库。 * 商品库接口: 所有商品库接口,请查看这里。

  1. 使用/catalog/create/接口创建一个商品库。
  2. 使用/catalog/product/file/ 或/catalog/product/upload/接口上传产品至产品库。
  3. 使用/bc/member/invite/接口邀请成员加入商务中心,并授予管理员权限。您可以同时为受邀成员指定advertiser_role。
  4. 使用/bc/asset/assign/接口将商品库共享给商务中心成员,并授予商品库管理权限。请确保将asset_type字段设置为CATALOG,且将catalog_role字段设置为 ADMIN。
  • TikTok 商务中心 1. 在商务中心中创建一个商品库。具体指南请查看在TikTok 商务中心管理商品库。 2. 将您的产品上传至商品库。 3. 邀请成员加入商务中心,并授予管理员权限。具体指南请查看在 TikTok 商务中心管理用户。 4. 选择要分享的广告主账户,将成员添加至账户并授予管理员权限。 5. 将商品库共享给商务中心成员,并授予商品库管理权限。具体指南请查看在TikTok 商务中心管理商品库中的与成员共享商品库部分。

## 3.创建广告组 使用/adgroup/create/接口创建一个广告组。下表列出了相关参数。

注意
目前购物广告不支持程序化创意(ACO)。
产品目录广告是基于图片的广告,不支持所有视频相关的字段。

|字段|类型|描述|
|---|---|---|
|promotion_type{+条件必填} |string|推广对象类型。您可以使用此字段指定推广产品的对象。若对应的推广系列推广目标不是`REACH`,`VIDEO_VIEWS`或`ENGAGEMENT`,则此字段必填。<br>枚举值参见[枚举值 - 推广对象类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
|product_source{必填}|string|枚举值:`UNSET` ,`CATALOG`(商品库)。购物广告需将此字段设置为 `CATALOG`。 |
|shopping_ads_type{必填}|string|购物广告种类。枚举值: `UNSET`, `VIDEO`(视频购物广告),`LIVE`(直播购物广告), `CATALOG_LISTING_ADS`(产品目录广告)。产品目录广告需将此字段设置为`CATALOG_LISTING_ADS`。|
|pixel_id |string| Pixel ID。仅适用于落地页,且需同时传入`optimization_event`字段。可使用[/pixel/list/](https://ads.tiktok.com/marketing_api/docs?id=1740858697598978)接口获取所有Pixel ID。<br> 若`optimization_goal`为 `CONVERT`时, `pixel_id`不得为空。|
|optimization_event|string|广告组的目标转化事件。当推广对象为带有监测 URL的App,或传入`pixel_id`时,此字段必填。支持的App事件和Pixel事件可查看[转化事件](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)。可以使用[/app/optimization_event/](https://ads.tiktok.com/marketing_api/docs?id=1740859338750977)接口获取您的App所支持的事件。<br><span style="color: darkred"><b>注意</b>: 当推广目标(objective_type)为`REACH` ,`VIDEO_VIEWS`或`TRAFFIC`,且传入`pixel_id`时,不支持`optimization_event`字段。 </span>|
|placement_type |string| 版位类型,即您的广告投放的版位策略。<br>产品目录广告需将此字段设置为`PLACEMENT_TYPE_NORMAL`。默认值:`PLACEMENT_TYPE_NORMAL`。|
|placements {必填}|string[]|版位,即想要在哪些app投放广告。当 `placement_type`为`PLACEMENT_TYPE_NORMAL`时必填,当`placement_type`为 `PLACEMENT_TYPE_AUTOMATIC`时选填。<br>产品目录广告需将此字段设置为`PLACEMENT_TIKTOK`。|
|auto_targeting_enabled|boolean|是否开启自动定向。产品目录广告需将此字段设置为`True`。|
|schedule_type {必填} |string|广告投放计划类型。可设置为`SCHEDULE_START_END`或`SCHEDULE_FROM_NOW`。如果选择`SCHEDULE_START_END`,您需要设置开始及结束时间。如果选择`SCHEDULE_FROM_NOW`, 您只需要设置一个开始时间。如果`budget_mode`为`BUDGET_MODE_TOTAL`,本字段只能设置为`SCHEDULE_START_END`。|
|catalog_id{必填}|string|商品库ID。|
|catalog_authorized_bc_id {必填}|string| 拥有商品库权限的商务中心的ID。对于商务中心中的商品库,您必须传入所属商务中心的ID。|
|optimization_goal{必填}|string|优化目标,即希望通过广告实现的可衡量结果。产品目录广告需将此字段设置为`CONVERT`或 `CLICK`。|
|billing_event {必填}|string|计费事件。产品目录广告需将此字段设置为`OCPC` 或 `CPC`。 若`optimization_goal`为 `CLICK`,必须将`billing_event`设置为 `CPC`。|
|bid_type {必填} |string|竞价策略,决定了系统如何管理您的单次成效费用,花费预算和投放广告。产品目录广告需将此字段设置为`BID_TYPE_CUSTOM`。|
|conversion_bid_price{+条件必填} |float| oCPM转化出价,即oCPM的目标转化成本。当 `billing_event` 为 `OCPM` 且 `bid_type` 为 `BID_TYPE_CUSTOM` 时必填。|
|pacing |string| 广告投放速度类型。您可以选择`PACING_MODE_SMOOTH`(在预定的时间内平均分配预算)或`PACING_MODE_FAST`(尽快消耗预算并产出结果)。当您开启推广系列预算优化(`budget_optimize_on`)时,该字段将忽略您的设置并自动设置为为`PACING_MODE_SMOOTH`。否则您需要填写该字段。 |

## 4.创建广告 使用/ad/create/接口创建广告。下表列出了相关参数。

注意
产品目录广告是基于图片的广告,不支持所有视频相关的字段。

|字段|类型|描述|
|---|---|---|
|identity_id {必填}|string|认证身份ID。|
|identity_type {必填}|string| 认证身份类型。枚举值: `CUSTOMIZED_USER`(自定义用户), `AUTH_CODE`(授权用户), `TT_USER`(TikTok用户),`BC_AUTH_TT`(已添加到商务中心的TikTok用户)。 购物广告需将此字段设置为`CUSTOMIZED_USER` 。<br>关于认证身份的更多信息,请查看[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。 <br> 注意: 当 `identity_type`为 `CUSTOMIZED_USER`时, 不可传入`identity_authorized_bc_id`。|
|ad_name {必填}|string| 广告名称。 |
|catalog_id{必填}|string| 商品库ID。|
|product_specific_type{必填}|string|选择商品的维度。枚举值: `ALL`,` PRODUCT_SET`, `CUSTOMIZED_PRODUCTS`。<br>设置为`ALL`时,不需传入`sku_ids` ,`item_group_ids`或`product_set_id`。若本字段设置为`PRODUCT_SET`,需传入`item_group_ids`或`product_set_id`。若本字段设置为`CUSTOMIZED_PRODUCTS`,`sku_ids`字段必传。 |
|item_group_ids {+条件必填}|string[]|商品的SPU(标准化产品单元) ID。最多可传入20个ID。|
|product_set_id {+条件必填}|string|商品库的商品系列ID。|
|sku_ids {+条件必填}|string|SKU(库存量单位)ID。最多可传入20个ID。|

## 5.预览广告 创建广告后, 使用/creative/ads_preview/create/接口预览广告。

我们支持的预览类型包括:AD和 ADS_CREATION。AD类型可以预览当前广告,而 ADS_CREATION类型可预览还未创建的广告。

内容来源: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 每日平台更新简报 →