创建轮播广告

本文介绍了创建轮播广告的具体步骤。

简介

轮播广告是TikTok上的新增广告样式，支持在信息流广告中使用图片。轮播广告中多张图片将以轮播形式顺序播放，用户可根据自身兴趣左右滑动图片，实现转化。轮播样式的示例可参阅轮播广告。

您可以使用推广系列 API 创建轮播广告。这将帮助您简化广告创建流程，提高推广系列的运营效率和管理规模。

前提条件

您已经拥有TikTok API for Business的使用权限。详见快速入门 - 具体步骤。
若要创建轮播广告，您需要获取相关的权限。参阅API参考了解使用相关接口（包括“步骤”部分列出的接口）所需的权限。参阅更新应用权限范围了解如何设置权限。

步骤

根据您对将视频购物广告与轮播样式是否结合使用的偏好，您可以选择标准轮播广告或视频购物类型的轮播广告。欲了解相关创建步骤，请查看对应小节：“创建标准轮播广告的步骤”和“创建视频购物类型的轮播广告的步骤”。

创建标准轮播广告的步骤

使用/campaign/create/接口创建一个推广系列。需确保满足以下要求：

| 设置 {20%}| 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 推广目标 | 使用以下目标之一： <ul><li>应用推广 </li><li>网站转化量</li><li>访问量</li><li>线索收集</li><li>覆盖人数</li></ul>| `objective_type` | 使用以下任一值：<ul><li>`APP_PROMOTION`</li><li>`WEB_CONVERSIONS`</li><li> `TRAFFIC` </li><li> `LEAD_GENERATION` </li><li> `REACH` </li></ul> |

注意
轮播推广系列不可同时启用 Smart+ 推广系列设置。若您想查看推广系列是否启用了 Smart+ 推广系列设置，可使用/campaign/get/返回的is_smart_performance_campaign字段进行确认。

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id":"{{advertiser_id}}",
    "budget_mode":"BUDGET_MODE_TOTAL",
    "objective_type":"APP_PROMOTION",
    "campaign_name": "{{campaign_name}}",
    "app_promotion_type":"APP_INSTALL",
    "budget":{{budget}}
}'
(/code)

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "app_promotion_type": "APP_INSTALL",
        "deep_bid_type": null,
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "modify_time": "2023-05-15 05:14:35",
        "budget": {{budget}},
        "objective_type": "APP_PROMOTION",
        "operation_status": "ENABLE",
        "campaign_app_profile_page_state": "UNSET",
        "campaign_id": "{{campaign_id}}",
        "is_new_structure": true,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "create_time": "2023-05-15 05:14:35",
        "campaign_type": "REGULAR_CAMPAIGN",
        "campaign_name": "{{campaign_name}}",
        "is_smart_performance_campaign": false,
        "advertiser_id": "{{advertiser_id}}",
        "objective": "APP",
        "roas_bid": 0
    }
}
(/code)

使用/adgroup/create/接口创建一个广告组。需确保满足以下要求：

| 设置 {20%}| 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 版位 | <ul><li><strong>自动版位</strong> 或</li><li><strong> 编辑版位</strong> （需包含TikTok版位）  </li></ul> | `placement_type` 和 `placements` |<ul><li>`placement_type` 设置为 `PLACEMENT_TYPE_AUTOMATIC`，或</li><li>`placement_type` 设置为 `PLACEMENT_TYPE_NORMAL`，且 `placements` 的值中需包含 `PLACEMENT_TIKTOK`</li></ul>  |
| 程序化创意（ACO） | 未启用 | `creative_material_mode` | `CUSTOM` 或不传入 |

注意
轮播广告组可传入/split_test/create/ ，用于创建拆分对比测试。

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "app_id": "{{app_id}}",
    "promotion_type": "APP_ANDROID",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"],
    "location_ids": ["1733045"],
    "languages":["en"],
    "gender": "GENDER_UNLIMITED",
    "age_groups":["AGE_13_17","AGE_18_24","AGE_25_34","AGE_35_44","AGE_45_54","AGE_55_100"],
    "operating_systems": ["ANDROID"],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "CLICK",
    "bid_type": "BID_TYPE_NO_BID",
    "bid_price": 0.0,
    "billing_event": "CPC",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "schedule_infos": null,
        "languages": [
            "en"
        ],
        "skip_learning_phase": false,
        "inventory_filter_enabled": false,
        "bid_display_mode": "CPMV",
        "schedule_start_time": "{{schedule_start_time}}",
        "actions": [],
        "frequency_schedule": null,
        "schedule_type": "SCHEDULE_START_END",
        "promotion_type": "APP_ANDROID",
        "create_time": "2023-05-15 05:49:33",
        "adgroup_id": "{{adgroup_id}}",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "interest_category_ids": [],
        "network_types": [],
        "auto_targeting_enabled": false,
        "pixel_id": null,
        "video_download_disabled": false,
        "app_download_url": "{{app_download_url}}",
        "keywords": null,
        "bid_type": "BID_TYPE_NO_BID",
        "ios14_quota_type": "UNOCCUPIED",
        "app_type": "APP_ANDROID",
        "statistic_type": null,
        "category_id": "0",
        "secondary_optimization_event": null,
        "age_groups": [
            "AGE_13_17",
            "AGE_18_24",
            "AGE_25_34",
            "AGE_35_44",
            "AGE_45_54",
            "AGE_55_100"
        ],
        "isp_ids": [],
        "adgroup_app_profile_page_state": null,
        "is_new_structure": true,
        "scheduled_budget": 0,
        "operation_status": "ENABLE",
        "search_result_enabled": true,
        "audience_ids": [],
        "share_disabled": false,
        "app_id": "{{app_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "operating_systems": [
            "ANDROID"
        ],
        "location_ids": [
            "1733045"
        ],
        "is_hfss": false,
        "pacing": "PACING_MODE_SMOOTH",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "brand_safety_partner": null,
        "rf_estimated_cpr": null,
        "placements": [
            "PLACEMENT_TIKTOK",
            "PLACEMENT_PANGLE"
        ],
        "rf_estimated_frequency": null,
        "modify_time": "2023-05-15 05:49:33",
        "comment_disabled": false,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "advertiser_id": "{{advertiser_id}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "schedule_end_time": "{{schedule_end_time}}",
        "purchased_reach": null,
        "feed_type": null,
        "optimization_goal": "CLICK",
        "optimization_event": null,
        "device_price_ranges": null,
        "delivery_mode": null,
        "billing_event": "CPC",
        "purchased_impression": null,
        "interest_keyword_ids": [],
        "gender": "GENDER_UNLIMITED",
        "excluded_audience_ids": [],
        "conversion_window": null,
        "bid_price": 0,
        "conversion_bid_price": 0,
        "package": "{{package}}",
        "campaign_name": "{{campaign_name}}",
        "rf_purchased_type": null,
        "frequency": null,
        "next_day_retention": null,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "creative_material_mode": "CUSTOM",
        "budget": 400,
        "deep_cpa_bid": 0,
        "deep_bid_type": null,
        "campaign_id": "{{campaign_id}}"
    }
}
(/code)

使用/ad/create/接口创建一个广告。需确保满足以下要求：

对于非 Spark Ads 的标准轮播广告或通过 Spark Ads 推送创建的 Spark Ads 标准轮播广告

| 设置 {20%}| 要求{20%} | 参数{20%} | 如何设置该参数{40%} |
|---|---|---|---|
| 认证身份（广告发布身份） | 以下任意选项：<ul><li>自定义用户（自定义身份） </li><li> TikTok 用户</li><li>添加到商务中心的 TikTok 用户</li></ul> | `identity_type` | 以下任意值：<ul><li>`CUSTOMIZED_USER`</li> <li> `TT_USER`</li><li>`BC_AUTH_TT` </li></ul><br>若想了解 Spark Ads详情，请查看[创建 Spark Ads](1739470744631298.html)。 |
| 广告样式 | 轮播 | `ad_format` | `CAROUSEL_ADS` |
| 广告创意 - 图片 | 轮播广告中支持的 1 至 35 张图片 | `image_ids` | 传入 1 至 35 个图片 ID。<br>需使用 [/file/image/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1739067433456642)和[/file/image/ad/search/](https://ads.tiktok.com/marketing_api/docs?id=1740052016789506)接口。<br>用于轮播广告的图片需<strong>同时</strong>满足：<ul><li>规格要求：<ul><li>文件类型: JPG，JPEG，或PNG </li><li>图片分辨率：最大为1242 x 2340 像素 或 2340 x 1242 像素 </li><li>图片宽高比：最大为 9:20 或 20:9 </li><li>文件大小：小于 50 MB </li></ul></li><li>[/file/image/ad/search/](https://ads.tiktok.com/marketing_api/docs?id=1740052016789506)返回的图片对应 `is_carousel_usable` 的值为`true`。</li></ul> |
| 广告创意 - 音乐 | 轮播广告中支持的1首音乐 | `music_id` | 传入一个非视频购物类型的轮播广告中支持的音乐ID。<br>若想获取有效的音乐ID，您可以：<ul><li>通过在[/file/music/get/](https://ads.tiktok.com/marketing_api/docs?id=1740053909509122)中将`music_scene`设置为`CAROUSEL_ADS`，筛选广告账号下可用于非视频购物类型的轮播广告的音乐，</li><li>或将可用于非视频购物类型的轮播广告的自定义音乐上传至广告账号中：<ul><li>可在[/file/music/upload/](https://ads.tiktok.com/marketing_api/docs?id=1740052650395650)中将 `music_scene`设置为 `CAROUSEL_ADS` ，并同时传入`music_file` 和`music_signature`，</li><li>或在[/file/music/upload/](https://ads.tiktok.com/marketing_api/docs?id=1740052650395650)中将 `music_scene` 设置为 `CAROUSEL_ADS` ，将 `upload_type` 设置为 `UPLOAD_BY_FILE_ID`，并同时传入`file_id` 。</li></ul></li></ul> |
| 创新互动样式 | 未启用 | `card_id` | 不传入 |

对于通过 Spark Ads 提取创建的 Spark Ads 标准轮播广告

| 设置 {20%}| 要求{20%} | 参数{20%} | 如何设置该参数{40%} |
|---|---|---|---|
| 认证身份 | 以下任意选项：<ul><li>授权用户 </li><li> TikTok 用户</li><li>添加到商务中心的 TikTok 用户</li></ul> | `identity_type` | 以下任意值：<ul><li>`AUTH_CODE`</li> <li> `TT_USER`</li><li>`BC_AUTH_TT` </li></ul> <br>若想了解 Spark Ads详情，请查看[创建 Spark Ads](1739470744631298.html)。 |
| 广告样式 | 轮播 | `ad_format` | `CAROUSEL_ADS` |
| 广告创意- 帖子 | 未启用 | `tiktok_item_id` | 传入合法值。<br><br>若想筛选认证身份下的照片帖子，请使用[/identity/video/get/](1740218475032577.html)或[/identity/video/info/](1740218522178562.html)，并将`item_type` 设置为 `CAROUSEL`。 |
| 广告创意 - 帖子 - 拼接与合拍 | 未启用 | <ul><li>`item_duet_status`</li><li>`item_stitch_status` </li></ul> | 不传入 |
| 广告创意 - 图片 & 音乐| 未启用 | <ul><li>`image_ids`</li><li> `music_id` </li></ul> | 不传入|
| 创新互动样式 | 未启用 | `card_id` | 不传入 |

示例

请求

(code curl http)
{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_format": "CAROUSEL_ADS",
        "ad_name": "{{ad_name}}",
        "ad_text": "{{ad_text}}",
        "call_to_action": "SHOP_NOW",
        "image_ids":["{{image_id}}", "{{image_id}}"],
        "music_id":"{{music_id}}",
        "identity_id":"{{identity_id}}",
        "identity_type":"CUSTOMIZED_USER",
        "landing_page_url":"{{landing_page_url}}"
    }]
}
(/code)

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "ad_texts": null,
                "vast_moat_enabled": false,
                "tracking_app_id": "{{tracking_app_id}}",
                "identity_id": "{{identity_id}}",
                "ad_id": "{{ad_id}}",
                "call_to_action_id": null,
                "operation_status": "ENABLE",
                "creative_type": null,
                "deeplink_type": "NORMAL",
                "brand_safety_postbid_partner": "UNSET",
                "call_to_action": "SHOP_NOW",
                "campaign_id": "{{campaign_id}}",
                "is_new_structure": true,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "advertiser_id": "{{advertiser_id}}",
                "optimization_event": null,
                "landing_page_urls": null,
                "adgroup_id": "{{adgroup_id}}",
                "ad_name": "{{ad_name}}",
                "campaign_name": "{{campaign_name}}",
                "landing_page_url": "",
                "impression_tracking_url": null,
                "deeplink": "",
                "modify_time": "2023-05-15 06:39:22",
                "music_id": "{{}}",
                "ad_format": "CAROUSEL_ADS",
                "profile_image_url": "{{profile_image_url}}",
                "viewability_postbid_partner": "UNSET",
                "video_id": null,
                "click_tracking_url": null,
                "page_id": null,
                "viewability_vast_url": null,
                "adgroup_name": "{{adgroup_name}}",
                "ad_text": "{{ad_text}}",
                "is_aco": false,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "tracking_pixel_id": 0,
                "playable_url": "",
                "brand_safety_vast_url": null,
                "creative_authorized": false,
                "card_id": null,
                "identity_type": "CUSTOMIZED_USER",
                "app_name": "{{app_name}}",
                "display_name": "",
                "create_time": "2023-05-15 06:39:22",
                "image_ids": [
                    "{{image_id}}",
                    "{{image_id}}"
                ]
            }
        ]
    }
}
(/code)

创建视频购物类型的轮播广告的步骤

使用/campaign/create/接口创建一个推广系列。需注意在满足创建商品来源为商品库的视频购物广告-1.创建推广系列小节所列出的参数要求基础上，还需满足以下参数要求：

| 设置 {20%}| 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 推广系列预算优化 | 需申请白名单才可启用 | `budget_optimize_on` | `false`或 `true`<br><br><p><span style="color:darkred"><b>注意</b></span>：在商品来源为商品库的视频购物广告中使用推广系列预算优化目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 |
|推广系列商品来源 | 商品库 | `campaign_product_source` | `CATALOG` |