创建 Spark Ads

本文介绍了创建 Spark Ads 的具体步骤。

重要提示
- 为改善业务和用户体验，TikTok 正逐步弃用在广告位为自动广告位或包含 TikTok 的手动广告位的广告组中使用自定义身份（即使用自定义头像或显示名称）创建广告的功能。 - 2026 年 1 月 15 日及以后新建的广告账号，无法在上述广告位使用“自定义身份” 创建 TikTok 广告推广系列（即不支持非 Spark Ads）。 - 现有广告账号已无法再使用“自定义身份” 创建这类广告（即不支持非 Spark Ads）。 - 请注意，仅投放 Pangle 或全球化应用组合广告位的推广系列不受自定义身份弃用的影响。 - 已生效的对仅广告模式的改动：
自 2026 年 1 月 27 日起，所有广告创建接口（/smart_plus/ad/create/，/ad/create/ 和 /campaign/spc/create/）中的 dark_post_status 请求参数的默认值已由 OFF 改为 ON。若未指定该参数，API 创建广告时将默认启用仅广告模式（又称“仅通过广告展示”功能）。这意味着，使用推送方式创建 Spark Ads 时，相关 TikTok 账号主页将不会显示该 TikTok 贴子。建议您在集成中将“只通过广告展示”设置为默认值，以确保与 TikTok 广告管理平台的广告创建流程一致。

简介

Spark Ads（原名为 Boosted TikToks）是 TikTok 推出的一种强原生广告形式。品牌可以利用 Spark Ads，将原生 TikTok 帖子，包括视频帖子和照片帖子，变为 TikTok 信息流广告或合约广告（例如 TopView 广告），从而进行推广。广告主在获得帖子所有者的授权后，才能用这些帖子进行推广。您可以点击此处了解 Spark Ads 与非 Spark Ads 的区别以及 Spark Ads 案例研究。

您可以使用推广系列 API，选择以下其中一种方式创建 Spark Ads。这将帮助您简化广告创建流程，提高推广系列的运营效率和管理规模。 - 如果您想创建并推广新帖子，可将帖子推送到已关联的企业号或商务中心中的授权 TikTok 账户。 - 如果您想推广关联的企业号下的现有 TikTok 帖子，可从已关联的企业号中提取帖子。 - 如果您想推广关联账户（如创作者账户）下的现有 TikTok 帖子，可提取已授权的帖子。 - 如果您想推广商务中心中的授权账号下的现有 TikTok 帖子，可从从商务中心中的授权 TikTok 账户提取帖子。

Spark Ads 的优势:

流畅体验：区别于传统的引流广告，Spark Ads 的交互体验更接近自然流量的广告样式，即每一个广告都有一个关联的 TikTok 账号，左滑/点击昵称/点击头像会跳转到关联的TT账号主页。
用户信任：广告来自一个真实运营的账户，可以有蓝V等认证信息，塑造品牌人设，提升用户信任度。
长效转化：用户与广告主之间建立长期关联，有助于促进长期转化。
高用户留存率：相较于单一视频的引流广告，更多的视频内容有更大的概率留住用户。
仅广告模式 （dark_post_status）：创作者可以通过创建仅广告模式的 Spark Ads，达到为广告主创建推广视频，但同时又不影响自己主页里的视频风格的效果。

前提条件

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

步骤

如何创建 Spark Ads

Spark Ads 可以通过两种模式创建：Spark Ads 推送和 Spark Ads 提取。两种模式在 TikTok 上创建和管理广告的方式各不相同。 - Spark Ads 推送 - 此模式使用提供的创意在 TikTok 账户内创建新的 TikTok 帖子。 - 使用推送模式创建 Spark Ads 的两种方法包括： - 将帖子推送到关联的企业号。 - 将帖子推送到商务中心中授权 TikTok 账户。 - Spark Ads 提取 - 此模式从 TikTok 账户中提取现有的帖子。 - 使用提取模式创建 Spark Ads 的三种方法包括： - 从关联的企业号中提取原生帖子。 - 通过授权码提取原生帖子。 - 从商务中心中的授权 TikTok 账户中提取原生帖子。

请查看下文，了解创建 Spark Ads 的不同步骤。

Spark Ads 推送

将帖子推送至关联的企业号

将您的 TikTok For Business 账号与企业号绑定。

您可点击这里查看账户绑定的步骤。您需注意若已经将 TikTok For Business 账号与普通 TikTok 账户绑定，您需将普通 TikTok 账户升级为企业号。

获取您想要向其推送帖子的 TikTok 用户认证身份的 ID。

若想筛选 TikTok 用户类型的认证身份，调用 /identity/get/ ，将identity_type 设置为 TT_USER。返回中将包含 TikTok 用户类型的认证身份的 ID（identity_id）。需从返回的 ID 列表中挑选支持推送帖子（can_push_video 为 true）的认证身份 ID。

示例

请求

(code curl http)
curl --location --request POST  'https://business-api.tiktok.com/open_api/v1.3/identity/get/?advertiser_id={{advertiser_id}}&identity_type=TT_USER' \
--header 'Access-Token: {{Access-Token}}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "identity_list": [
            {
                "identity_id": "{{identity_id}}",
                "identity_authorized_bc_id": null,
                "can_push_video": true,
                "profile_image": "{{profile_image}}",
                "can_use_live_ads": false,
                "can_pull_video": true,
                "available_status": "AVAILABLE",
                "display_name": "{{display_name}}",
                "identity_type": "TT_USER"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 20,
            "total_number": 1,
            "total_page": 1
        }
    }
}
(/code)

获取您想要用在 Spark Ads 中的广告素材。

若想将视频帖子推送到关联企业号，您需要视频 ID 和视频封面图片 ID。
若想获取视频 ID，可使用/file/video/ad/search/搜索您的广告账户的素材库中现有的视频，或通过/file/video/ad/upload/上传新视频至素材库。
若想视频封面图片 ID，可使用/file/image/ad/search/搜索您的广告账户的素材库中现有的图片，或通过 /file/image/ad/upload/上传新图片至素材库。
若想将照片帖子推送到关联企业号，您需要轮播广告中支持的 1 至 35 张图片和 1 首音乐。若想了解轮播广告中广告素材的详细要求，请查看创建轮播广告 - 创建标准轮播广告的步骤。

创建 Spark Ads。

对于手动广告：
调用/ad/create/创建手动广告时，需要在请求中指定以下设置： - 认证身份 ID （identity_id） - 认证身份类型（identity_type 设置为 TT_USER） - 从第 3 步获取的广告素材 - 广告文案（ad_text） - 行动引导文案（call_to_action 或 call_to_action_id）

对于升级版 Smart+ 广告：
调用/smart_plus/ad/create/创建升级版 Smart+ 广告时，需要在请求中指定以下设置： - 认证身份 ID （creative_info.identity_id） - 认证身份类型（creative_info.identity_type 设置为 TT_USER） - 从第 3 步获取的广告素材 - 广告文案（ad_text_list） - 行动引导文案（call_to_action_id）

对于手动广告的示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
             "ad_name": "{{ad_name}}",
             "identity_type": "TT_USER",
             "identity_id": "{{identity_id}}",
             "ad_format": "SINGLE_VIDEO",
             "video_id":"{{video_id}}",
             "image_ids":["{{image_id}}"],
             "ad_text": "{{ad_text}}",
             "call_to_action": "LEARN_MORE"
         }]
}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "viewability_postbid_partner": "UNSET",
                "deeplink_type": "NORMAL",
                "modify_time": "{{modify_time}}",
                "click_tracking_url": null,
                "music_id": null,
                "identity_type": "TT_USER",
                "playable_url": "",
                "display_name": "{{display_name}}",
                "viewability_vast_url": null,
                "create_time": "{{create_time}}",
                "creative_authorized": false,
                "identity_id": "{{identity_id}}",
                "ad_id": "{{ad_id}}",
                "ad_name": "{{ad_name}}",
                "ad_format": "SINGLE_VIDEO",
                "tracking_pixel_id": 0,
                "branded_content_disabled": false,
                "call_to_action_id": null,
                "adgroup_id": "{{adgroup_id}}",
                "page_id": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "campaign_id": "{{campaign_id}}",
                "campaign_name": "{{campaign_name}}",
                "is_new_structure": true,
                "deeplink": "",
                "impression_tracking_url": null,
                "landing_page_urls": null,
                "creative_type": null,
                "operation_status": "ENABLE",
                "advertiser_id": "{{advertiser_id}}",
                "is_aco": false,
                "ad_texts": null,
                "dark_post_status": "OFF",
                "optimization_event": "ACTIVE",
                "card_id": null,
                "landing_page_url": "",
                "app_name": "{{app_name}}",
                "image_ids": [
                    "{{image_id}}"
                ],
                "adgroup_name": "{{adgroup_name}}",
                "vast_moat_enabled": false,
                "avatar_icon_web_uri": "",
                "brand_safety_vast_url": null,
                "tracking_app_id": "{{tracking_app_id}}",
                "profile_image_url": "",
                "call_to_action": "LEARN_MORE",
                "ad_text": "{{ad_text}}",
                "video_id": "{{video_id}}"
            }
        ]
    }
}
(/code)

将帖子推送至商务中心中授权的 TikTok 账户

将您想向其推送帖子的 TikTok 账户作为资产添加进商务中心。

您需要在商务中心中生成二维码，将二维码分享给 TikTok 账户拥有者从而请求 TikTok 账户的权限。需确保商务中心对 TikTok 账号有必要权限，即视频权限（现有帖子）。

您可查看如何在商务中心管理 TikTok 账户-第 1 步：请求 TikTok 账号访问权限，了解对应步骤。

（可选步骤）将 TikTok 账号权限分享给商务中心成员。

先调用/bc/asset/admin/get/获取 TikTok 账户的资产 ID（asset_id）。

再调用/bc/asset/assign/将该 TikTok 账户作为资产分配给需要创建 Spark Ads 的商务中心成员。

获取添加到商务中心的 TikTok 用户认证身份的 ID。

若想筛选添加到商务中心的 TikTok 用户类型的认证身份，需调用/identity/get/，将identity_type 设置为 BC_AUTH_TT。返回中将包含添加到商务中心的 TikTok 用户类型的认证身份的 ID（identity_id）。需从返回的 ID 列表中挑选支持推送帖子（can_push_video 为true）的认证身份 ID。

示例

请求

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/identity/get/?advertiser_id={{advertiser_id}}&identity_type=BC_AUTH_TT' \
--header 'Access-Token: {{Access-Token}}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "identity_list": [
            {
                "identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
                "available_status": "AVAILABLE",
                "can_pull_video": true,
                "display_name": "{{display_name}}",
                "can_use_live_ads": true,
                "profile_image": "{{profile_image}}",
                "can_push_video": true,
                "identity_id": "{{identity_id}}",
                "identity_type": "BC_AUTH_TT"
            }
        ],
        "page_info": {
            "page_size": 0,
            "total_page": 0,
            "page": 0,
            "total_number": 0
        }
    }
}
(/code)

获取您想要用在 Spark Ads 中的广告素材。

若想将视频帖子推送到关联企业号，您需要视频 ID 和视频封面图片 ID。
若想获取视频 ID，可使用/file/video/ad/search/搜索您的广告账户的素材库中现有的视频，或通过/file/video/ad/upload/上传新视频至素材库。
若想视频封面图片 ID，可使用/file/image/ad/search/搜索您的广告账户的素材库中现有的图片，或通过 /file/image/ad/upload/上传新图片至素材库。
若想将照片帖子推送到关联企业号，您需要轮播广告中支持的 1 至 35 张图片和 1 首音乐。若想了解轮播广告中广告素材的详细要求，请查看创建轮播广告 - 创建标准轮播广告的步骤。

创建 Spark Ads。

对于手动广告：
调用/ad/create/创建手动广告时，需要在请求中指定以下设置： - 认证身份 ID （identity_id） - 认证身份类型（identity_type 设置为 BC_AUTH_TT） - 商务中心 ID （identity_authorized_bc_id） - 从第 4 步获取的广告素材 - 广告文案（ad_text） - 行动引导文案（call_to_action 或 call_to_action_id）

对于升级版 Smart+ 广告：
调用/smart_plus/ad/create/创建升级版 Smart+ 广告时，需要在请求中指定以下设置： - 认证身份 ID （creative_info.identity_id） - 认证身份类型（creative_info.identity_type 设置为 BC_AUTH_TT） - 商务中心 ID （identity_authorized_bc_id） - 从第 4 步获取的广告素材 - 广告文案（ad_text_list） - 行动引导文案（call_to_action_id）

对于手动广告的示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
             "ad_name": "{{ad_name}}",
             "identity_type": "BC_AUTH_TT",
             "identity_id": "{{identity_id}}",
             "identity_authorized_bc_id":"{{identity_authorized_bc_id}}",
             "ad_format": "SINGLE_VIDEO",
             "video_id":"{{video_id}}",
             "image_ids":["{{image_id}}"],
             "ad_text": "{{ad_text}}",
             "call_to_action": "LEARN_MORE"
         }]
}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "creative_type": null,
                "is_new_structure": true,
                "click_tracking_url": null,
                "advertiser_id": "{{advertiser_id}}",
                "is_aco": false,
                "viewability_postbid_partner": "UNSET",
                "identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
                "identity_type": "BC_AUTH_TT",
                "landing_page_url": "",
                "brand_safety_vast_url": null,
                "ad_text": "{{ad_text}}",
                "deeplink": "",
                "avatar_icon_web_uri": "",
                "deeplink_type": "NORMAL",
                "ad_format": "SINGLE_VIDEO",
                "ad_texts": null,
                "video_id": "{{video_id}}",
                "call_to_action_id": null,
                "playable_url": "",
                "ad_name": "{{ad_name}}",
                "campaign_id": "{{campaign_id}}",
                "branded_content_disabled": false,
                "display_name": "{{display_name}}",
                "viewability_vast_url": null,
                "create_time": "{{create_time}}",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "page_id": null,
                "app_name": "{{app_name}}",
                "call_to_action": "LEARN_MORE",
                "adgroup_name": "{{adgroup_name}}",
                "tracking_app_id": "{{tracking_app_id}}",
                "image_ids": [
                    "{{image_id}}"
                ],
                "card_id": null,
                "dark_post_status": "OFF",
                "campaign_name": "{{campaign_name}}",
                "vast_moat_enabled": false,
                "music_id": null,
                "modify_time": "{{modify_time}}",
                "identity_id": "{{identity_id}}",
                "impression_tracking_url": null,
                "ad_id": "{{ad_id}}",
                "tracking_pixel_id": 0,
                "adgroup_id": "{{adgroup_id}}",
                "profile_image_url": "",
                "creative_authorized": false,
                "landing_page_urls": null,
                "optimization_event": "ACTIVE",
                "operation_status": "ENABLE"
            }
        ]
    }
}
(/code)

Spark Ads 提取

从关联的企业号提取原生视频

将您的 TikTok For Business 账号与企业号绑定。

您可点击这里查看账户绑定的步骤。您需注意若已经将 TikTok For Business 账号与普通 TikTok 账户绑定，您需将普通 TikTok 账户升级为企业号。

获取您想要从中提取帖子的 TikTok 用户认证身份的 ID。

若想筛选 TikTok 用户类型的认证身份，需调用/identity/get/，将identity_type设置为TT_USER。返回中将包含 TikTok 用户类型的认证身份的 ID（identity_id）。需从返回的 ID 列表中挑选支持提取帖子（can_pull_video 为 true）的认证身份 ID。

示例

请求

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/identity/get/?advertiser_id={{advertiser_id}}&identity_type=TT_USER' \
--header 'Access-Token: {{Access-Token}}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "identity_list": [
            {
                "identity_id": "{{identity_id}}",
                "identity_authorized_bc_id": null,
                "can_push_video": false,
                "profile_image": "{{profile_image}}",
                "can_use_live_ads": false,
                "can_pull_video": true,
                "available_status": "AVAILABLE",
                "display_name": "{{display_name}}",
                "identity_type": "TT_USER"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 20,
            "total_number": 1,
            "total_page": 1
        }
    }
}
(/code)

获取该身份下的 TikTok 帖子。

调用/identity/video/get/，通过返回中的item_id获取您想要用在 Spark Ads 中的 TikTok 帖子的 ID。请求中需将identity_type设置为TT_USER并传入从第 2 步获取的 identity_id。

从/identity/video/get/中获取的 TikTok 帖子默认为视频帖子。若想筛选照片帖子，需将 item_type 设置为 CAROUSEL。

示例

请求

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/identity/video/get/?advertiser_id={{advertiser_id}}&identity_id={{identity_id}}&identity_type=TT_USER' \
--header 'Access-Token: {{Access-Token}}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "has_more": true,
        "cursor": "1697448007",
        "video_list": [
            {
                "anchor_list": null,
                "item_id": "{{item_id}}",
                "text": "",
                "auth_info": null,
                "status": "ITEM_STATUS_HESITATE_RECOMMEND",
                "video_info": {
                    "bit_rate": 1223985,
                    "format": "mp4",
                    "width": 720,
                    "url": "{{url}}",
                    "duration": 1.6,
                    "height": 1280,
                    "size": 244797,
                    "signature": "{{signature}}",
                    "poster_url": "{{poster_url}}"
                }
            }
        ]
    }
}
(/code)

创建 Spark Ads。

对于手动广告：
调用/ad/create/创建手动广告时，请求中传入identity_id，identity_type，tiktok_item_id，以及行动引导文案（call_to_action 或 call_to_action_id）。您需将identity_type设置为TT_USER，并将tiktok_item_id设置为您从第 3 步获取的item_id 的值。

对于升级版 Smart+ 广告：
调用/smart_plus/ad/create/创建升级版 Smart+ 广告时，请求中传入creative_info.identity_id，creative_info.identity_type，creative_info.tiktok_item_id，以及行动引导文案（ call_to_action_id）。您需将creative_info.identity_type设置为TT_USER，并将creative_info.tiktok_item_id设置为您从第 3 步获取的item_id 的值。

对于手动广告的示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
             "ad_name": "{{ad_name}}",
             "identity_type": "TT_USER",
             "identity_id": "{{identity_id}}",
             "ad_format": "SINGLE_VIDEO",
             "tiktok_item_id":"{{tiktok_item_id}}",             
             "call_to_action": "LEARN_MORE"
         }]
}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "promotional_music_disabled": true,
                "tracking_app_id": "{{tracking_app_id}}",
                "ad_text": "{{ad_text}}",
                "is_new_structure": true,
                "modify_time": "{{modify_time}}",
                "display_name": "{{display_name}}",
                "vast_moat_enabled": false,
                "landing_page_urls": null,
                "image_ids": [],
                "deeplink_type": "NORMAL",
                "optimization_event": "ACTIVE",
                "app_name": "{{app_name}}",
                "operation_status": "ENABLE",
                "call_to_action": "LEARN_MORE",
                "music_id": null,
                "deeplink": "",
                "is_aco": false,
                "creative_type": null,
                "landing_page_url": "",
                "campaign_name": "{{campaign_name}}",
                "video_id": null,
                "identity_type": "TT_USER",
                "create_time": "{{create_time}}",
                "tiktok_item_id": "{{tiktok_item_id}}",
                "profile_image_url": "",
                "viewability_vast_url": null,
                "avatar_icon_web_uri": "",
                "ad_texts": null,
                "brand_safety_vast_url": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "page_id": null,
                "adgroup_id": "{{adgroup_id}}",
                "viewability_postbid_partner": "UNSET",
                "advertiser_id": "{{advertiser_id}}",
                "impression_tracking_url": null,
                "playable_url": "",
                "creative_authorized": false,
                "call_to_action_id": null,
                "click_tracking_url": null,
                "ad_format": "SINGLE_VIDEO",
                "ad_name": "{{ad_name}}",
                "campaign_id": "{{campaign_id}}",
                "adgroup_name": "{{adgroup_name}}",
                "ad_id": "{{ad_id}}",
                "card_id": null,
                "identity_id": "{{identity_id}}",
                "tracking_pixel_id": 0
            }
        ]
    }
}
(/code)

通过授权码提取原生帖子

确定您想要用在 Spark Ads 中的 TikTok 帖子，请求帖子所有者生成帖子的授权码。
从帖子所有者处获取帖子的授权码，申请帖子授权。

请查看Spark Ads 制作指南-方法 2：使用其他创作者授权的账户或帖子，了解在 TikTok App上生成授权码及申请帖子授权的步骤。

调用/tt_video/authorize/，将授权帖子与您的广告账户（即 TikTok For Business 账户）绑定。

示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/tt_video/authorize/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id":"{{advertiser_id}}",
    "auth_code":"{{auth_code}}"
}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {}
}
(/code)

调用/tt_video/info/或/tt_video/list/，获取身份 ID（identity_id）及 TikTok 帖子 ID （item_id）。

示例

请求

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/tt_video/list/?advertiser_id={{advertiser_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "page_info": {
            "page": 1,
            "total_number": 1,
            "total_page": 1,
            "page_size": 20
        },
        "list": [
            {
                "item_info": {
                    "status": "HESITATE_RECOMMEND",
                    "auth_code": "{{auth_code}}",
                    "text": "{{text}}",
                    "item_id": "{{item_id}}",
                    "anchor_list": null
                },
                "auth_info": {
                    "auth_end_time": "{{auth_end_time}}",
                    "ad_auth_status": "AUTHORIZED",
                    "invite_start_time": "{{invite_start_time}}",
                    "auth_start_time": "{{auth_start_time}}"
                },
                "video_info": {
                    "duration": 13.538,
                    "width": 720,
                    "size": 13861358,
                    "preview_url": "{{preview_url}}",
                    "height": 1280,
                    "signature": "{{signature}}",
                    "bit_rate": 8191081,
                    "poster_url": "{{poster_url}}"
                },
                "user_info": {
                    "identity_id": "{{identity_id}}",
                    "identity_type": "AUTH_CODE",
                    "tiktok_name": "{{tiktok_name}}"
                }
            }
        ]
    }
}
(/code)

创建 Spark Ads。

对于手动广告：
调用/ad/create/创建手动广告时，请求中传入identity_id，identity_type，tiktok_item_id，以及行动引导文案（call_to_action 或 call_to_action_id）。您需将identity_type设置为AUTH_CODE，并将tiktok_item_id设置为您从第4步获取的item_id 的值。

对于升级版 Smart+ 广告：
调用/smart_plus/ad/create/创建升级版 Smart+ 广告时，请求中传入creative_info.identity_id，creative_info.identity_type，creative_info.tiktok_item_id，以及行动引导文案（ call_to_action_id）。您需将creative_info.identity_type设置为AUTH_CODE，并将creative_info.tiktok_item_id设置为您从第 4 步获取的item_id 的值。

对于手动广告的示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{Access-Token}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
             "ad_name": "{{ad_name}}",
             "identity_type": "AUTH_CODE",
             "identity_id": "{{identity_id}}",
             "ad_format": "SINGLE_VIDEO",
             "tiktok_item_id":"{{tiktok_item_id}}",             
             "call_to_action": "LEARN_MORE"
         }]
}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "is_aco": false,
                "viewability_postbid_partner": "UNSET",
                "creative_type": null,
                "tiktok_item_id": "{{tiktok_item_id}}",
                "landing_page_urls": null,
                "music_id": null,
                "app_name": "{{app_name}}",
                "playable_url": "",
                "call_to_action": "LEARN_MORE",
                "identity_id": "{{identity_id}}",
                "avatar_icon_web_uri": "",
                "ad_texts": null,
                "ad_format": "SINGLE_VIDEO",
                "click_tracking_url": null,
                "brand_safety_vast_url": null,
                "ad_name": "{{ad_name}}",
                "landing_page_url": "",
                "page_id": null,
                "tracking_pixel_id": 0,
                "tracking_app_id": "{{tracking_app_id}}",
                "create_time": "{{create_time}}",
                "advertiser_id": "{{advertiser_id}}",
                "vast_moat_enabled": false,
                "identity_type": "AUTH_CODE",
                "creative_authorized": false,
                "deeplink_type": "NORMAL",
                "promotional_music_disabled": true,
                "display_name": "{{display_name}}",
                "profile_image_url": "",
                "modify_time": "{{modify_time}}",
                "campaign_name": "{{campaign_name}}",
                "campaign_id": "{{campaign_id}}",
                "is_new_structure": true,
                "card_id": null,
                "operation_status": "ENABLE",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "ad_id": "{{ad_id}}",
                "image_ids": [],
                "adgroup_name": "{{adgroup_name}}",
                "ad_text": "",
                "call_to_action_id": null,
                "deeplink": "",
                "optimization_event": "ACTIVE",
                "adgroup_id": "{{adgroup_id}}",
                "viewability_vast_url": null,
                "impression_tracking_url": null,
                "video_id": null
            }
        ]
    }
}
(/code)

从商务中心中的授权 TikTok 账号提取原生帖子

将您想从中提取帖子的 TikTok 账户作为资产添加进商务中心。

您可查看如何在商务中心管理 TikTok 账户-第 1 步：请求 TikTok 账号访问权限，了解对应步骤。

（可选步骤）将 TikTok 账号权限分享给商务中心成员

先调用/bc/asset/admin/get/获取 TikTok 账户的资产 ID（asset_id）。

再调用/bc/asset/assign/将该 TikTok 账户作为资产分配给需要创建 Spark Ads 的商务中心成员。

获取添加到商务中心的 TikTok 用户认证身份的ID。

若想筛选添加到商务中心的 TikTok 用户类型的认证身份，需调用/identity/get/，将identity_type 设置为 BC_AUTH_TT。返回中将包含添加到商务中心的 TikTok 用户类型的认证身份的 ID（identity_id）。需从返回的 ID 列表中挑选支持提取帖子（can_pull_video 为true）的认证身份 ID。

示例

请求

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/identity/get/?advertiser_id={{advertiser_id}}&identity_type=BC_AUTH_TT' \
--header 'Access-Token: {{Access-Token}}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "identity_list": [
            {
                "identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
                "available_status": "AVAILABLE",
                "can_pull_video": true,
                "display_name": "{{display_name}}",
                "can_use_live_ads": true,
                "profile_image": "{{profile_image}}",
                "can_push_video": false,
                "identity_id": "{{identity_id}}",
                "identity_type": "BC_AUTH_TT"
            }
        ],
        "page_info": {
            "page_size": 0,
            "total_page": 0,
            "page": 0,
            "total_number": 0
        }
    }
}
(/code)

获取该身份下的TikTok帖子。

调用/identity/video/get/，通过返回中的item_id获取想要用在 Spark Ads 中的 TikTok 帖子的 ID。请求中需将identity_type设置为 BC_AUTH_TT并传入从第 3 步获取的identity_id 和 identity_authorized_bc_id。

从/identity/video/get/中获取的 TikTok 帖子默认为视频帖子。若想筛选照片帖子，需将 item_type 设置为 CAROUSEL。

示例

请求

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/identity/video/get/?advertiser_id={{advertiser_id}}&identity_type=BC_AUTH_TT&identity_id={{identity_id}}&identity_authorized_bc_id={{identity_authorized_bc_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "has_more": false,
        "cursor": "1629342953",
        "video_list": [
            {
                "anchor_list": null,
                "text": "{{text}}",
                "item_id": "{{item_id}}",
                "video_info": {
                    "signature": "{{signature}}",
                    "bit_rate": 4002871,
                    "duration": 6.268,
                    "poster_url": "{{poster_url}}",
                    "format": "mp4",
                    "height": 1280,
                    "size": 3136250,
                    "width": 720,
                    "url": "{{url}}"
                },
                "status": "ITEM_STATUS_HESITATE_RECOMMEND",
                "auth_info": null
            }
        ]
    }
}
(/code)

创建 Spark Ads。

对于手动广告：
调用/ad/create/创建手动广告时，请求中需传入identity_id，identity_type，identity_authorized_bc_id，tiktok_item_id，以及行动引导文案（call_to_action 或 call_to_action_id）。需将identity_type设置为BC_AUTH_TT，并将tiktok_item_id设置为从第 4 步获取的item_id 的值。

对于升级版 Smart+ 广告：
调用/smart_plus/ad/create/创建升级版 Smart+ 广告时，请求中传入creative_info.identity_id，creative_info.identity_type，creative_info.identity_authorized_bc_id，creative_info.tiktok_item_id，以及行动引导文案（ call_to_action_id）。您需将creative_info.identity_type设置为BC_AUTH_TT，并将creative_info.tiktok_item_id设置为您从第 4 步获取的item_id 的值。

对于手动广告的示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
             "ad_name": "{{ad_name}}",
             "identity_type": "BC_AUTH_TT",
             "identity_id": "{{identity_id}}",
             "identity_authorized_bc_id":"{{identity_authorized_bc_id}}",
             "ad_format": "SINGLE_VIDEO",
             "tiktok_item_id":"{{tiktok_item_id}}",             
             "call_to_action": "LEARN_MORE"
         }]
}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "identity_type": "BC_AUTH_TT",
                "call_to_action": "LEARN_MORE",
                "landing_page_urls": null,
                "click_tracking_url": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "brand_safety_vast_url": null,
                "card_id": null,
                "ad_name": "{{ad_name}}",
                "ad_id": "{{ad_id}}",
                "operation_status": "ENABLE",
                "video_id": null,
                "is_new_structure": true,
                "campaign_id": "{{campaign_id}}",
                "music_id": null,
                "advertiser_id": "{{advertiser_id}}",
                "creative_authorized": false,
                "impression_tracking_url": null,
                "display_name": "{{display_name}}",
                "viewability_vast_url": null,
                "is_aco": false,
                "viewability_postbid_partner": "UNSET",
                "campaign_name": "{{campaign_name}}",
                "promotional_music_disabled": true,
                "vast_moat_enabled": false,
                "playable_url": "",
                "modify_time": "{{modify_time}}",
                "ad_texts": null,
                "adgroup_id": "{{adgroup_id}}",
                "identity_id": "{{identity_id}}",
                "adgroup_name": "{{adgroup_name}}",
                "identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
                "app_name": "{{app_name}}",
                "tracking_pixel_id": 0,
                "optimization_event": "ACTIVE",
                "image_ids": [],
                "creative_type": null,
                "ad_text": "{{ad_text}}",
                "profile_image_url": "",
                "ad_format": "SINGLE_VIDEO",
                "tracking_app_id": "{{tracking_app_id}}",
                "create_time": "{{create_time}}",
                "tiktok_item_id": "{{tiktok_item_id}}",
                "deeplink": "",
                "page_id": null,
                "landing_page_url": "",
                "deeplink_type": "NORMAL",
                "call_to_action_id": null,
                "avatar_icon_web_uri": ""
            }
        ]
    }
}
(/code)

API参考

您可以使用以下接口管理 Spark Ads：

创建 Spark Ads

简介

前提条件

步骤

如何创建 Spark Ads

Spark Ads 推送

将帖子推送至关联的企业号

将帖子推送至商务中心中授权的 TikTok 账户

Spark Ads 提取

从关联的企业号提取原生视频

通过授权码提取原生帖子

从商务中心中的授权 TikTok 账号提取原生帖子

相关文档

API参考