迁移至 Spark Ads
如果你正在使用自定义身份创建在包含 TikTok 的广告位上投放的非 Spark Ads,请阅读本文档了解相关变更以及应采取的措施。
背景信息
为改善业务和用户体验,TikTok 正逐步弃用在广告位为自动广告位或包含 TikTok 的手动广告位的广告组中使用自定义身份(即使用自定义头像或显示名称)创建广告的功能。2026 年 1 月 15 日及以后新建的广告账号,无法在上述广告位使用“自定义身份” 创建 TikTok 广告推广系列(即不支持非 Spark Ads)。现有广告账号已无法再使用“自定义身份” 创建这类广告(即不支持非 Spark Ads)。现有广告不受影响且可修改。这项调整旨在营造更安全、更具互动性的用户体验,同时帮助提升推广效果。 请注意,仅投放 Pangle 或全球化应用组合广告位的推广系列不受自定义身份弃用的影响。详细了解即将变更的“自定义身份”功能。
变更内容
- 影响范围: 以下是目前不受此变更影响的推广系列类型:
- 采用“品牌任务”推广目标的推广系列
- 采用“销量 - TikTok Shop”推广目标的推广系列
- 启用“使用智能创意创建广告”的推广系列
- 使用商品库的推广系列
-
仅投放 Pangle/Global App Bundle 广告位的推广系列
-
在 TikTok 弃用“自定义身份”功能后,针对创建和更新手动广告的操作,以下字段将受到影响:
| 接口 | 字段 | 变更前 | 变更后 |
|---|---|---|---|
| /ad/create/ | identity_type |
广告发布身份类型。 枚举值: CUSTOMIZED_USER、AUTH_CODE、TT_USER、BC_AUTH_TT。查看广告发布身份文档,详细了解广告发布身份。 |
广告发布身份类型。 枚举值: CUSTOMIZED_USER、AUTH_CODE、TT_USER、BC_AUTH_TT。查看广告发布身份文档,详细了解广告发布身份。 投放自动广告位或包含 TikTok 的手动广告位的广告中不再支持枚举值 CUSTOMIZED_USER。如果传入 CUSTOMIZED_USER,系统将报错。 |
identity_id |
任何广告发布身份 ID。 | 如果广告发布身份 ID 属于 CUSTOMIZED_USER 广告发布身份类型,系统将报错。 |
|
| /ad/update/ | identity_type |
广告发布身份类型。 枚举值: CUSTOMIZED_USER、AUTH_CODE、TT_USER、BC_AUTH_TT。查看广告发布身份文档,详细了解广告发布身份。 |
广告发布身份类型。 枚举值: CUSTOMIZED_USER、AUTH_CODE、TT_USER、BC_AUTH_TT。查看广告发布身份文档,详细了解广告发布身份。 投放自动广告位或包含 TikTok 的手动广告位的广告中不再支持枚举值 CUSTOMIZED_USER。如果传入 CUSTOMIZED_USER,系统将报错。 |
identity_id |
任何广告发布身份 ID。 | 如果广告发布身份 ID 属于 CUSTOMIZED_USER 广告发布身份类型,系统将报错。 |
- 查看[创建 Spark Ads](1739470744631298.html) 文档,详细了解如何使用 TikTok 广告发布身份创建手动 Spark Ads。
- 在 TikTok 弃用“自定义身份”功能后,针对创建和更新 Smart+ 推广系列的操作,以下字段将受到影响:
| 接口 | 字段 | 变更前 | 变更后 |
|---|---|---|---|
| /campaign/spc/create/ | identity_type 条件必填 | 未使用 Spark Ads (tiktok_item_id) 时,此为必填字段。非 Spark Ads 的广告发布身份类型。 枚举值: CUSTOMIZED_USER。 |
此字段不再支持在投放自动广告位或包含 TikTok 的手动广告位的广告中使用。 |
| identity_id 条件必填 | 未使用 Spark Ads (tiktok_item_id) 时,此为必填字段。非 Spark Ads 的广告发布身份 ID。 |
此字段不再支持在投放自动广告位或包含 TikTok 的手动广告位的广告中使用。 | |
| /campaign/spc/update/ | identity_id | 未使用 Spark Ads 时的广告发布身份 ID。 |
- 在 TikTok 弃用“自定义身份”功能后,针对创建和更新升级版 Smart+ 推广系列的操作,以下字段将受到影响:
| 接口 | 字段 | 变更前 | 变更后 |
|---|---|---|---|
| /smart_plus/ad/create/ | ad_configuration.identity_type 条件必填 |
当创建非 Spark Ads 时,此为必填字段。 非 Spark Ads 广告发布身份类型。 枚举值: CUSTOMIZED_USER。查看广告发布身份文档,详细了解广告发布身份。 |
无法再在投放自动广告位或包含 TikTok 的手动广告位的广告组中创建非 Spark Ads。现有广告不受影响且可修改。详细了解即将变更的“自定义身份”功能和迁移至 Spark Ads。 |
ad_configuration..identity_id 条件必填 |
当创建非 Spark Ads 时,此为必填字段。 非 Spark Ads 广告发布身份 ID。 |
无法再在投放自动广告位或包含 TikTok 的手动广告位的广告组中创建非 Spark Ads。现有广告不受影响且可修改。详细了解即将变更的“自定义身份”功能和迁移至 Spark Ads。 | |
| /smart_plus/ad/update/ | ad_configuration.identity_type |
非 Spark Ads 广告发布身份类型。 枚举值: CUSTOMIZED_USER。查看广告发布身份文档,详细了解广告发布身份。 |
|
ad_configuration.identity_id |
非 Spark Ads 广告发布身份 ID。 |
- “只在广告中显示”功能的默认设置已生效:
自 2026 年 1 月 27 日起,所有广告创建 API 接口(/smart_plus/ad/create/、/ad/create/ 和 /campaign/spc/create/)中的dark_post_status请求参数的默认值已由OFF变更为ON。若不传入该参数,当你通过 API 创建广告时将默认启用“只在广告中显示”(又称“仅通过广告显示”功能)。这意味着,使用推送方式创建 Spark Ads 时,相关 TikTok 账号主页将不会显示该 TikTok 贴子。建议你在集成中将“仅通过广告显示”设置为默认值,以确保与 TikTok 广告管理平台的广告创建流程一致。
所需操作
前提条件
拥有用于创建广告的 TikTok 账号。
步骤
1. 将 TikTok 账号关联到广告账号
你需要将 TikTok 账号关联到拥有广告投放权限的广告账号,才能在创建广告时选择该 TikTok 账号作为广告发布身份。
方案 1:通过 TikTok 商务中心关联(推荐)
通过此方案,你可以将多个 TikTok 账号关联到多个广告账号(包括外部合作伙伴账号),便于集中管理权限。TikTok 账号与广告账号关联后,任何可以访问该广告账号的用户均可使用该 TikTok 账号投放广告。这样就无需为每个用户授予 TikTok 账号访问权限,有助于简化跨团队和代理商的工作流程。建议大多数企业使用这一方案。
要将拥有广告投放权限的 TikTok 账号关联到商务中心的广告账号,请执行以下步骤:
-
使用 /bc/asset/account/authorization/ 接口生成授权 URL,用于向 TikTok 账号请求广告投放权限。
-
通过二维码生成器将授权 URL 转换为二维码,并将二维码分享给 TikTok 账号所有者。TikTok 账号所有者扫描二维码后,即可向商务中心授权,将“现有帖子”用于 Spark Ads 提取,以及将“TikTok 帖子”用于 Spark Ads 推送。
-
使用 /bc/asset/advertiser/assign/ 接口将 TikTok 账号关联到商务中心广告账号。
现在,你的 TikTok 账号可用于投放广告。
方案 2:直接在 TikTok 广告管理平台界面操作
通过这种方式关联的 TikTok 账号,只能由关联该账号的个人用户访问,无法实现集中管理,也不能与其他团队成员或代理商共享。如果需要团队或代理商协作,建议通过 TikTok 商务中心关联。
要在 TikTok 广告管理平台界面将 TikTok 账号关联到广告账号,请执行以下步骤:
-
在推广系列创建流程中,点击“推广对象”版块下的“关联账号”。
-
按照说明关联你的 TikTok 账号。
注意
此功能变更正在逐步推出,因此你可能还没有看到这一变化。受影响的客户可能会注意到,更新后的广告创建流程中不再提供“自定义身份”选项。
2. 为广告账号获取可用的广告发布身份
/identity/get/ 和 /identity/info/ 等接口仍支持枚举值 CUSTOMIZED_USER。查看广告发布身份文档,了解广告发布身份接口的完整列表。
使用以下接口获取广告账号可用广告发布身份的信息,以及使用特定广告发布身份发布的帖子:
-
广告发布身份列表:使用 /identity/get/ 接口获取广告账号下的广告发布身份列表。你可以按照广告发布身份类型或显示名称筛选结果。
-
广告发布身份信息:使用 /identity/info/ 接口获取特定广告发布身份的详细信息。
-
使用广告发布身份发布的帖子:使用 /identity/video/get/ 接口列出所有属于
AUTH_CODE、TT_USER或BC_AUTH_TT类型广告发布身份下的帖子。 -
TikTok 帖子信息:使用 /identity/video/info/ 接口获取使用
AUTH_CODE、TT_USER或BC_AUTH_TT广告发布身份发布的一个或多个 TikTok 帖子的信息。
3. (可选)授权 TikTok 帖子
注意
这些接口无变更。
以下接口用于创建或更新使用 TikTok 授权帖子的广告:
-
应用 TikTok 帖子授权码:使用 /tt_video/authorize/ 接口应用授权码。获得帖子所有者的授权码后,授权并不会自动生效。你需要应用授权码,将广告账号与 Spark Ads 帖子相关联。
-
获取 Spark Ads 授权帖子:使用 /tt_video/list/ 接口,获取已授权给广告账号的 Spark Ads 帖子列表。
-
获取 TikTok 授权帖子信息:使用 /tt_video/info/ 接口,获取已获授权、可用于投放广告的 Spark Ads 帖子信息。需提供从帖子所有者那里获取的授权码。
-
解除与 TikTok 授权帖子的绑定:使用 /tt_video/unbind/ 接口,在授权过期或被撤销后解绑 Spark Ads 帖子。解除绑定后,该帖子将从广告账号的 Spark Ads 授权帖子列表中移除。
4. 使用 TikTok 广告发布身份创建广告
以下列出了创建和更新不同广告或推广系列的接口,适用于不同推广系列类型:
- 手动推广系列
- 创建广告:使用 /ad/create/ 接口上传广告创意(图片、视频、文案、行动引导文案)并创建手动广告。查看此文档,了解如何创建手动广告。
- 更新广告:使用 /ad/update/ 接口修改手动广告的创意,例如行动引导文案、广告名称、文案、图片和视频素材。
- 以下字段可用于设置广告是否出现在 TikTok 账号的主页上。
| 字段 | 类型 | 描述 |
|---|---|---|
dark_post_status |
string | 仅当你使用 Spark Ads 推送创建 Spark Ads 时合法。 关于你的创意是否“只在广告中显示”的状态。 枚举值:
ON。 |
-
Smart+ 推广系列
- 创建 Smart+ 推广系列:使用 /campaign/spc/create/ 接口创建 Smart+ 推广系列。
- 更新 Smart+ 推广系列:使用 /campaign/spc/update/ 接口更新 Smart+ 推广系列。此接口支持增量更新。
-
升级版 Smart+ 推广系列
- 创建升级版 Smart+ 推广系列:使用 /smart_plus/campaign/create/ 接口创建升级版 Smart+ 推广系列。
- 更新升级版 Smart+ 推广系列:使用 /smart_plus/campaign/update/ 接口更新升级版 Smart+ 推广系列。
重要说明
自 2026 年 1 月 27 日起,现有广告账号将不支持使用自定义身份创建非 Spark Ads。2026 年 1 月 15 日及以后新建的所有广告账号都无法使用自定义身份创建非 Spark Ads。现有广告不受影响且可修改。详细了解即将变更的“自定义身份”功能和迁移至 Spark Ads。