（已废弃）创建精品栏广告

精品栏广告是TikTok的一种视频广告，它将您的客户引导至即时页面，用户无需离开应用程序，便可以在该页面购买您的产品。

注意
自2023年2月16日起，您将不能创建精品栏广告。为保证流畅的API体验，我们建议您迁移到商品销量目标下的视频购物广告。您在2023年3月底前仍可以通过API修改已有的精品栏广告。如果您需要额外的迁移时间，请联系您的TikTok销售代表。

通过精品栏广告，商家可以在品牌视频底部设置多个关键商品图片，引导客户浏览即时商品橱窗页面，打造沉浸式购物体验。

注意
精品栏广告目前处于测试阶段。如需使用此功能，请联系您的TikTok销售代表。

创建精品栏广告的流程如下：

设置商品库。您需要创建商品库，随后将商品上传至商品库。
创建并配置商品橱窗页面。
创建精品栏广告。

1. 设置商品库

注意：商品库、商品及商品系列为白名单功能。如果您已开通精品栏广告功能，则这三个功能自动开通。

1.1 创建商品库

使用 /catalog/create/ 接口，填写名称，定向位置和货币单位等主要信息创建商品库。

请求示例：

(code JSON json)
{
  "bc_id": 123,
  "name": "my_catalog",
  "catalog_type": "ECOM",
  "catalog_conf": {
    "region_code": "US",
    "currency": "USD",
    "channel": "CLIENT"
  }
}
(/code)

1.2 将商品上传至商品库

使用/catalog/product/file/或/catalog/product/upload/接口上传商品到之前创建的商品库中。

下面是/catalog/product/upload/接口的请求示例：

(code JSON json)
{
  "bc_id": 123,
  "catalog_id": 456,
  "dpa_products": [
    {
      "sku_id": "tiktok_item_1111",
      "title": "qgs test product1",
      "description": "qgs test product description",
      "availability": "AVAILABLE_FOR_ORDER",
      "image_link": "http://p1.ipstatp.com/origin/ad-site-i18n/xxxxxxx",
      "video_link": "https://www.tiktok.com/tiktok_t_shirt",
      "brand": "xiaoru",
      "additional_image_link": ["xxxxxxx", "http://p1.ipstatp.com/origin/ad-site-i18n/xxxxxxx"],
      "item_group_id": "1.11",
      "google_product_category": "2.22",
      "gtin": "3.33",
      "mpn": "4.44",
      "landing_url": {
        "link": "https://www.tiktok.com",
        "android_url": "https://www.android.com",
        "android_package": "a.b.com",
        "android_app_name": "android_app_name",
        "ios_url": "https://www.ios.com",
        "ios_app_store_id": "https://ios_app_store.com",
        "ios_app_name": "ios_app_name",
        "ipad_url": "https://ipad.com",
        "ipad_app_store_id": "https://ipad_app_store.com",
        "ipad_app_name": "ipad_app_name",
        "iphone_url": "https://iphone.com",
        "iphone_app_store_id": "https://iphone_app_store.com",
        "iphone_app_name": "iphone_app_name"

      },
      "price": {
        "price": "100",
        "sale_price": 30,
        "currency": "USD",
        "sale_price_effective_date": "2021-10-01T0:00/2021-10-31T0:00"
      },
      "profession": {
        "condition": "USED",
        "age_group": "NEW_BORN",
        "color": "red",
        "gender": "MALE",
        "shipping": "US:CA:Ground:9.99 USD",
        "shipping_weight": "1 kg",
        "size": "L",
        "tax": "xxx",
        "material": "cotton",
        "pattern": "stripes1",
        "product_type": "Apparel &amp; Accessories &gt; Clothing &gt; Shirts"
      },
      "ext": {
        "custom_label_0": "a",
        "custom_label_1": "b",
        "custom_label_2": "c",
        "custom_label_3": "d",
        "custom_label_4": "e"
      }
    }
  ]
}
(/code)

2. 创建商品橱窗页面

2.1 创建并配置商品橱窗页面

创建商品橱窗页面。商品橱窗页面是精品栏广告的一种模版，用来展示一系列商品。

2.2 获取页面ID

通过/page/get/接口查询刚刚创建的页面的 page_id。

注意 1. 需要指定 business_type=STORE_FRONT。 2. 同一个橱窗落地页只能绑定在一个广告下，不可在多个广告中复用同一个橱窗落地页。您可以通过/page/get/接口返回的is_associated 字段判断该落地页是否被绑定。

示例：

(code Bash json)
curl --location --request GET 'https://ads.tiktok.com/open_api/v1.3/page/get/?advertiser_id=123&business_type=STORE_FRONT' \
--header 'Access-Token: YOUR_ACCESS_TOKEN'
(/code)

3. 创建精品栏广告

3.1 创建推广系列

使用 /campaign/create/ 接口创建一个精品栏广告推广系列。objective_type可设置为TRAFFIC、 CONVERSION、VIDEO_VIEWS或REACH。

请求参数示例：

(code JSON json)
{
    "advertiser_id": 123,
    "campaign_name": "my-collection-ads-campaign",
    "objective_type": "TRAFFIC",
    "budget_mode": "BUDGET_MODE_INFINITE"
}
(/code)

3.2 创建广告组

使用/adgroup/create/接口，创建一个精品栏广告组。

参数设置：

推广对象（promotion_type)：必须选择 WEBSITE。
版位（placements）：仅支持 TikTok (PLACEMENT_TIKTOK)。

请求示例：

(code JSON json)
{
    "advertiser_id": 123,
    "campaign_id": 456,
    "optimization_goal": "CLICK",
    "adgroup_name": "test-wjm-collection_ads",
    "location": [
        1668284
    ],
    "promotion_type": "WEBSITE",
    "budget_mode": "BUDGET_MODE_DAY",
    "billing_event": "CPC",
    "bid": 1,
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "schedule_start_time": "2021-03-15 00:00:00",
    "schedule_end_time": "2021-03-16 00:00:00",
    "schedule_type": "SCHEDULE_START_END",
    "budget": 50,
    "pacing": "PACING_MODE_SMOOTH",
    "bid_type": "BID_TYPE_CUSTOM"
}
(/code)

3.3 创建广告

使用广告中的/ad/create/接口创建精品栏广告。

参数设置：

您需要指定 page_id。本参数的值已在2.2获取落地页ID这一步中获取。
媒体素材必须为单视频： ad_format = SINGLE_VIDEO。
落地页链接和行动引导文案将包含在 page_id 中，您无需填入这两个字段。

请求示例：

(code JSON json)
{
    "advertiser_id": 123,
    "adgroup_id": 456,
    "creatives": [
        {
            "ad_format": "SINGLE_VIDEO",
            "image_ids": ["your_image_id"],
            "video_id": "your_video_id",
            "ad_text": "your ad text",
            "ad_name": "your_ad_name",
            "display_name": "your display name",
            "page_id": 789
        }
    ]
}
(/code)