创建升级版 Smart+ 流媒体广告

升级版 Smart+ 流媒体广告是一种升级版 Smart+ 网站推广系列，使用娱乐商品库中的商品来投放广告。

对于这类推广系列，你需要在推广系列层级将 catalog_enabled 设置为 true 以及将 catalog_type 设置为 TRAVEL_ENTERTAINMENT，并在广告组层级通过 catalog_id 传入娱乐商品库。借助升级版 Smart+ 流媒体广告，你可以自动生成商品库视频、商品库轮播和单视频广告等不同样式的广告。

前提条件

若想创建 Smart+ 流媒体广告，需先在商务中心设置娱乐商品库。

设置商品库的步骤：

1. 使用 /catalog/create/ 接口创建一个娱乐商品库。

注意： 娱乐商品库目前正在进行 Alpha 测试，现为白名单功能，仅限受邀用户使用。如需使用此功能，请联系你的 TikTok 销售代表。但是，我们不保证你一定能参与 Alpha 测试。

2. 使用 /catalog/product/upload/ 接口（JSON 结构）、/catalog/product/file/ 接口（CSV 文件模板）或 /catalog/feed/create/ 接口（在线数据流上传）将商品上传至商品库。若想使用多影片广告样式，需确保设置满足多影片设置的规格要求。

3. 查看商品处理结果。

   • 对于 CSV 信息流和 JSON 结构，需使用 /catalog/product/log/ 接口。
     • 传入第 2 步获得的 feed_log_id。如果返回的 error_affected_products 字段不为空，查看问题详细信息，并回到第 2 步重新上传商品。
   • 对于在线信息流，需使用 /catalog/feed/log/ 接口。
     • 传入第 2 步获得的 feed_id。如果返回的 error_count 字段不为 0，查看在线信息流，并回到第 2 步重新上传商品。

4. 通过 /catalog/overview/ 接口返回的 approved 值，确认商品库包含一个或多个可用的商品。只有可用商品才能在广告中投放。根据你想选择的广告样式，商品库中所需的最低可用商品数量会有所不同：

   • 若想使用单视频广告或商品库视频广告样式，需确保商品库至少包含一个可用的商品。
   • 若想使用商品库轮播广告样式，需确保商品库至少包含两个可用的商品。

5.（可选）使用 /catalog/set/create/ 接口创建商品系列。
若想从商品系列中选择商品，必须创建商品系列。否则可跳过这一步。

6.（可选）使用 /bc/member/invite/ 接口邀请成员加入商务中心并授予管理员权限。
你还可以选择要分配给受邀成员的 advertiser_role。

7.（可选）使用 /bc/asset/assign/ 接口向成员分享商品库，并授予商品库管理权限。
务必在 asset_type 字段中传入 CATALOG，在 catalog_role 字段中传入 ADMIN。

多影片设置的规格要求

下表概述多影片设置的具体规格要求。

|设置{20%}|对应字段{35%}|规格要求{45%}|
|---|---|---|
|视频磁贴|<ul><li>上传到 [/catalog/product/file/](https://business-api.tiktok.com/portal/docs/upload-products-via-a-file-url/v1.3) 接口的 CSV 文件中的 `video_link` 字段</li></ul><ul><li>上传到 [/catalog/product/upload/](https://business-api.tiktok.com/portal/docs/upload-products-via-a-json-schema/v1.3) 接口的 JSON 有效负载中的 `video_url` 字段|<ul><li>宽高比：3:4（竖屏）。宽高比为 9:16 的视频将自动调整尺寸，以满足样式要求。</li></ul><ul><li>时长：6-15 秒（建议越短越好）</li><li>尺寸：不小于 720 x 960 px</li><li>分辨率：≥ 720p (HD)</li><li>TikTok 广告位的建议比特率：≥ 516 kbps|
|封面图片|<ul><li>上传到 [/catalog/product/file/](https://business-api.tiktok.com/portal/docs/upload-products-via-a-file-url/v1.3) 接口的 CSV 文件中的 `image_link` 字段</li></ul><ul><li>上传到 [/catalog/product/upload/](https://business-api.tiktok.com/portal/docs/upload-products-via-a-json-schema/v1.3) 接口的 JSON 有效负载中的 `image_url` 字段|<ul><li>宽高比：3:4（竖屏）。宽高比为 9:16 的图片将自动调整尺寸，以满足样式要求。</li></ul><ul><li>尺寸：不小于 720 x 960 px</li><li>格式：.JPG、.JPEG 或 .PNG 格式|
|标题|<ul><li>上传到 [/catalog/product/file/](https://business-api.tiktok.com/portal/docs/upload-products-via-a-file-url/v1.3) 接口的 CSV 文件中的 `title` 字段</li></ul><ul><li>上传到 [/catalog/product/upload/](https://business-api.tiktok.com/portal/docs/upload-products-via-a-json-schema/v1.3) 接口的 JSON 有效负载中的 `title` 字段|<ul><li>显示：会截断，以单行显示</li></ul><ul><li>建议字符数：不超过 20 个|
|说明文字|<ul><li>[/smart_plus/ad/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad/v1.3) 接口中的 `ad_text_list` 字段</li></ul>|<ul><li>显示：会截断，以单行显示</li></ul><ul><li>建议字符数：不超过 35 个|

步骤

1. 创建推广系列

使用 /smart_plus/campaign/create/ 接口创建推广系列。

需确保满足以下要求。完整参数列表参见 /smart_plus/campaign/create/ 接口。

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "request_id": "{{request_id}}",
    "objective_type": "WEB_CONVERSIONS",
    "sales_destination": "WEBSITE",
    "catalog_enabled": true,
    "catalog_type": "TRAVEL_ENTERTAINMENT",
    "campaign_name": "{{campaign_name}}",
    "budget": {{budget}}
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "advertiser_id": "{{advertiser_id}}",
        "budget": {{budget}},
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "budget_optimize_on": true,
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "campaign_type": "REGULAR_CAMPAIGN",
        "catalog_enabled": true,
        "catalog_type": "TRAVEL_ENTERTAINMENT",
        "create_time": "{{create_time}}",
        "modify_time": "{{modify_time}}",
        "objective_type": "WEB_CONVERSIONS",
        "operation_status": "ENABLE",
        "sales_destination": "WEBSITE",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "smart_plus_adgroup_mode": "MULTIPLE"
    }
}
(/code)

2. 创建广告组

使用 /smart_plus/adgroup/create/ 接口创建广告组。

需确保满足以下要求。完整参数列表参见 /smart_plus/adgroup/create/ 接口。

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "request_id": "{{request_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "WEBSITE",
    "optimization_goal": "CONVERT",
    "pixel_id": "{{pixel_id}}",
    "optimization_event": "ADD_BILLING",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "targeting_spec": {
        "location_ids": ["3686110"]
    }
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "advertiser_id": "{{advertiser_id}}",
        "attribution_event_count": "EVERY",
        "bid_type": "BID_TYPE_CUSTOM",
        "billing_event": "OCPM",
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "catalog_id": "{{catalog_id}}",
        "click_attribution_window": "SEVEN_DAYS",
        "comment_disabled": false,
        "conversion_bid_price": {{conversion_bid_price}},
        "create_time": "{{create_time}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "modify_time": "{{modify_time}}",
        "optimization_event": "ADD_BILLING",
        "optimization_goal": "CONVERT",
        "pixel_id": "{{pixel_id}}",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "placements": ["PLACEMENT_TIKTOK"],
        "product_source": "CATALOG",
        "promotion_type": "WEBSITE",
        "promotion_website_type": "UNSET",
        "schedule_end_time": "{{schedule_end_time}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "search_result_enabled": true,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "share_disabled": false,
        "skip_learning_phase": true,
        "targeting_optimization_mode": "AUTOMATIC",
        "targeting_spec": {
            "age_groups": [
                "AGE_18_24",
                "AGE_25_34",
                "AGE_35_44",
                "AGE_45_54",
                "AGE_55_100"
            ],
            "brand_safety_type": "EXPANDED_INVENTORY",
            "gender": "GENDER_UNLIMITED",
            "location_ids": ["3686110"],
            "spc_audience_age": "OVER_EIGHTEEN"
        },
        "video_download_disabled": false,
        "view_attribution_window": "ONE_DAY"
    }
}
(/code)

3. 创建广告

使用 /smart_plus/ad/create/ 接口创建广告。

需确保满足以下要求。完整参数列表参见 /smart_plus/ad/create/ 接口。

自定义升级版 Smart+ 流媒体广告中的广告样式组合

如果启用自动选择商品库创意（catalog_creative_toggle 为 true），系统将使用 3 种可能的样式组合自动创建广告：多影片、商品库视频和单视频广告。

下表列出了升级版 Smart+ 流媒体广告的可用广告样式组合。

为确保某些广告样式可在升级版 Smart+ 流媒体广告中使用，请遵循下表中的说明。

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "ad_name": "{{ad_name}}",
    "landing_page_url_list": [
        {
            "landing_page_url": "{{landing_page_url}}"
        }
    ],
    "ad_text_list": [
        {"ad_text": "{{ad_text}}"},
        {"ad_text": "{{ad_text}}"},
        {"ad_text": "{{ad_text}}"},
        {"ad_text": "{{ad_text}}"},
        {"ad_text": "{{ad_text}}"}
    ],
    "ad_configuration": {
        "product_specific_type": "ALL",
        "identity_type": "BC_AUTH_TT",
        "identity_id": "{{identity_id}}",
        "identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
        "catalog_creative_toggle": true,
        "catalog_creative_info": {
            "catalog_media_settings": [
                "TEMPLATE_VIDEO",
                "MULTI_SHOW"
            ]
        },
        "utm_params": [
            {
                "key": "{{key}}",
                "value": "{{value}}"
            }
        ],
        "call_to_action_id": "{{call_to_action_id}}"
    }
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_configuration": {
            "call_to_action_id": "{{call_to_action_id}}",
            "catalog_creative_info": {
                "catalog_media_settings": [
                    "TEMPLATE_VIDEO",
                    "MULTI_SHOW"
                ]
            },
            "catalog_creative_toggle": true,
            "dark_post_status": "ON",
            "deeplink_utm_params": [],
            "identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
            "identity_id": "{{identity_id}}",
            "identity_type": "BC_AUTH_TT",
            "phone_info": {},
            "product_info": {
                "product_image_list": []
            },
            "product_specific_type": "ALL",
            "tracking_info": {
                "app_tracking_info_list": [],
                "tracking_pixel_id": "{{tracking_pixel_id}}"
            },
            "utm_params": [
                {
                    "key": "{{key}}",
                    "value": "{{value}}"
                }
            ]
        },
        "ad_name": "{{ad_name}}",
        "ad_text_list": [
            {"ad_text": "{{ad_text}}"},
            {"ad_text": "{{ad_text}}"},
            {"ad_text": "{{ad_text}}"},
            {"ad_text": "{{ad_text}}"},
            {"ad_text": "{{ad_text}}"}
        ],
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "advertiser_id": "{{advertiser_id}}",
        "auto_message_list": [],
        "call_to_action_list": [],
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "create_time": "2026-06-01 15:42:25",
        "creative_list": [],
        "custom_product_page_list": [],
        "deeplink_list": [],
        "disclaimer": {},
        "interactive_add_on_list": [],
        "landing_page_url_list": [
            {"landing_page_url": "{{landing_page_url}}"}
        ],
        "modify_time": "2026-06-01 15:42:25",
        "operation_status": "ENABLE",
        "page_list": [],
        "secondary_status": "AD_STATUS_AUDIT",
        "smart_plus_ad_id": "{{smart_plus_ad_id}}"
    }
}
(/code)