事件 API：网站事件 · Marketing API / Ad Measurement / Guides / Events API 1.0
本章节介绍了如何通过事件 API 管理网站事件。 快速入门 报告网站事件和参数 设置高级匹配 设置 TikTok Click ID 与 Cookie 设置外部 ID 验证事件设置 事件去重 常见问题
完整资料目录
共 1986 份资料 · 第 9 / 20 页
快速入门 · Marketing API / Ad Measurement / Guides / Events API 1.0 / Events API : Web
重要提示 使用事件 API 接口代表您同意遵守 TikTok 商业产品（数据）条款 ，并且不会与 TikTok 分享敏感数据。 本指南介绍了设置事件API的详细流程。 开始前须知 您应具备访问 TikTok 广告管理平台的权限。 TikTok 广告管理平台提供了测试事件功能和诊断工具，助力您的开发测试以及集成后的验证。 您需已在TikTok 广告管理平台 工
设置 TikTok Click ID 和 Cookie
Cookie（ _ttp ）的定义 如果您正在使用TikTok Pixel，并在事件管理平台的Pixel设置中启用了第一方 Cookie，那么 TikTok 会将唯一标识符自动保存至 _ttp 第一方 Cookie。 我们强烈建议事件API用户传回 _ttp 的值。您可以提取 _ttp 的值并将其添加至事件API有效负载中的 ttp 字段。您可以使用该 Co
验证事件设置
本文介绍了如何验证网站事件追踪设置，主要包括以下流程： 验证事件是否被正确接收 验证事件的配置和触发是否正确 验证事件去重设置（当您同时从 Pixel SDK 和事件 API 发送事件时需要进行这一操作） 验证事件是否被正确接收 您可以通过 Pixel 详情页来确认我们是否已接收到您的事件。点击进入 Pixel 详情页的 概览 标签： 如果我们接收到了由事件
事件去重 · Marketing API / Ad Measurement / Guides / Events API 1.0 / Events API : Web
为获得理想的广告投放效果，我们建议广告主同时设置 Tiktok Pixel SDK 和事件 API，以确保数据覆盖达到最大化。 获取事件去重的详细介绍，请参考 此处 。 如果广告主同时使用 TikTok Pixel SDK 和事件 API 发送同一事件，则有必要删除重复事件。例如，如果您同时通过 TikTok Pixel SDK 和事件 API 发送 Pur
发布历史记录
日期 版本 更新 6/30/2026 1.7.0 [功能] Android：适用于 Google Pay 结算库 V8 的自动 IAP 报告功能 [功能] iOS：适用于 StoreKit 2.0 的自动 IAP 报告功能，支持 Objective-C 和 Swift 混合编程。提供动态库和静态库两种发布包。 [修复] 性能优化，确保及时清除本地缓存。 [修
iOS 集成步骤
重要提示 TikTok 应用事件 SDK 的使用受 TikTok for Business 商业服务条款 的约束。使用 TikTok 应用事件 SDK，即表示你还同意遵守 TikTok 商业产品（数据）条款 ，并且你不会与 TikTok 分享敏感数据。 适用于 iOS 的 TikTok 应用事件 SDK 在 公共 GitHub 仓库 中维护。 前提条件 在开
Android 集成步骤
重要说明 TikTok 应用事件 SDK 的使用受 TikTok for Business 商业服务条款 的约束。使用 TikTok 应用事件 SDK，即表示你还同意遵守 TikTok 商业产品（数据）条款 ，并且你不会与 TikTok 分享敏感数据。 适用于 Android 的 TikTok 应用事件 SDK 在 公共 GitHub 仓库 中维护。 前提条
支持的应用事件类型
注意 用于事件追踪( event 字段)的事件名称和用于广告创编 ( optimization_event 字段）的事件名称是不同的，请通过相应的列来获取正确的值。 用于事件追踪的事件名 (event字段的值){25} 描述 properties字段中的推荐值 对应创编事件(optimization_event字段的值) AchieveLevel 达到等级
Pixel 事件类型
Pixel 事件 所有支持的 18 个 Pixel 事件类型见下表。 用于广告创编的事件名称 （对应 optimization_event 字段） 用于事件监测的事件名称 （对应 event 字段） 描述 properties 对象中的推荐字段 ON_WEB_DETAIL ViewContent 查看页面。 content_type , quantity ,
高级匹配
关于高级匹配 高级匹配将客户信息与 TikTok 用户相匹配，从而帮助您优化 TikTok 广告，提高广告表现。经加密的客户信息可通过任意 TikTok 事件共享，进而增加归因的转化数，构建规模更大的受众群，优化推广系列效果。 您可以通过两种方式启用高级匹配：手动或自动。 手动高级匹配 指手动将客户信息从您的网站传到TikTok。这需要您为网站上的每个事件执
使用代码安装Pixel
使用须知 您必须已经在事件管理平台上创建了一个Pixel，并且能够获取Pixel基础代码。您可以通过这篇 帮助中心 的文章，了解如何创建一个Pixel。 您必须具备技术资源。 您必须能够获取网站的源代码。 安装 Pixel 如果您已经创建了一个Pixel，但还未将其安装在网站上，您需要先完成Pixel安装，才能进行事件配置。 直接从设置屏幕中获取Pixel基
CSP 配置
如果您的网站启用了内容安全策略（CSP），为了让 TikTok Pixel 正常运行，您需要向多个 CSP 指令添加配置和域。 对于 frame-src ，添加以下配置： bytedance: sslocal: 注意 frame-src 是一条内容安全策略（Content Security Policy, CSP）指令，用于控制 <iframe>\ 或 <f
调试模式
如果您在调试你的Pixel设置时需要更多的细节，您可以开启调试模式。 如何开启调试模式 您可以通过以下两种方式开启调试模式。 打开 SDK链接 ，运行 document.cookie="pixel_debug=true; expires=Thu, 18 Dec 2043 12:00:00 GMT; path=/; SameSite=None; Secure"
更新广告组
您可以使用本接口更新广告组。部分内容无法更新（比如 版位 ）。 重要 本接口使用的是全量更新模式。即使您只想要更新一个字段，也需要传入所有的必填字段。 注意 若您已在推广系列层级设置 special_industries ，需确保该推广系列中的广告组满足对于的定向要求，参见 使用特殊广告分类的推广系列中广告组的定向要求 。 v1.2与v1.3版本对比 以下表
更新广告组预算
您可以使用本接口更新广告组的总预算或设置广告组日预算或动态日预算的预定预算更改。 预定预算更改将在广告账户时区的第二天凌晨 00:00 左右生效。请注意，在广告账户时区的预算锁定期间（23:55 - 00:00），您无法修改或设置预定预算更改。 请查看 币种 ，了解推广预算限制。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变
更新广告组状态
您可以使用本接口更新广告组的状态： 开启广告组，在规定时间进行投放。 暂停广告组，停止广告投放。 删除广告组。 注意 您无法直接删除专属推广系列的广告组。若要删除此类广告组，您需要删除相应推广系列。 对于已删除的广告组，或已删除的推广系列中的广告组，其操作状态无法修改。您可以使用[/campaign/get/](https://ads.tiktok.com/
获取广告账号信息
您可以使用本接口获取一个广告账户的详细信息。 若您希望添加合作伙伴并向合作伙伴分配广告账号，请使用 /bc/partner/add/ 接口。将 asset_type 设置为 ADVERTISER ，并在 asset_ids 字段传入广告账号ID。您可以通过 /advertiser/info/ 的返回字段 advertiser_id 获取广告账号ID。 v1.
删除资产
商务中心管理员用户可以使用本接口删除商务中心下的资产。 目前支持删除的资产类型包括线索和TikTok账号。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/asset/admin/delete/ /v1.3/bc/asset/admin/delete/ 请求参数类型 ass
事件 1.0
提示 以下 6 个事件 API 1.0 接口将于 2024 年下半年废弃。若您仍在使用这些接口，强烈推荐您尽快升级至事件 API 2.0 接口。 /pixel/track/ 和 /pixel/batch/ /offline/track/ 和 /offline/batch/ /app/track/ 和 /app/batch/ 推荐使用事件 API 2.0 （
Pixel管理
您可以使用这些接口将pixel转移至商务中心、将pixel和广告账户绑定或解绑以及获取绑定了某个pixel的所有广告账户列表。 本组包含以下接口： 将Pixel转移至商务中心 将Pixel和广告账户绑定/解绑 获取与Pixel绑定的广告账户列表
根据资产获取成员
商务中心的管理员用户可以使用本接口获取对某资产有访问权限的成员列表。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/asset/member/get/ /v1.3/bc/asset/member/get/ 请求参数类型 bc_id : number asset_id :
获取资产绑定信息
您可以使用本接口查看资产已经绑定了多少广告以及剩下可以绑定的广告数。每个资产仅可用于创建一定数量的广告。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/asset/ad/bind_info/ /v1.3/asset/bind/quota/ 请求参数类型 advertiser_i
获取合作伙伴
商务中心账户管理员可以使用本接口获取合作伙伴列表。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/partner/get/ /v1.3/bc/partner/get/ 请求参数类型 bc_id : number bc_id : string 请求参数名称 keyword
添加合作伙伴
商务中心的管理员用户可以使用本接口添加合作伙伴或合作伙伴资产至商务中心。商务中心只能分享其拥有的资产。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3 接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/partner/add/ /v1.3/bc/partner/add/ 请求参数类型 bc_id : number par
删除合作伙伴
商务中心的管理员用户可以使用本接口删除合作伙伴。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3 接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/partner/delete/ /v1.3/bc/partner/delete/ 请求参数类型 bc_id : number partner_id : number bc_i
取消资产分享
商务中心的管理员用户可以使用本接口取消与某个合作伙伴分享资产。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3 接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/partner/asset/delete/ /v1.3/bc/partner/asset/delete/ 请求参数类型 bc_id : number partn
获取合作伙伴资产
商务中心的管理员用户可以使用本接口获取分享给合作伙伴的资产以及由合作伙伴分享的资产。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3 接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/partner/asset/get/ /v1.3/bc/partner/asset/get/ 请求参数类型 bc_id : number
根据资产获取合作伙伴
商务中心的管理员用户可以使用本接口获取某个资产曾经被分享给的合作伙伴。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/asset/partner/get/ /v1.3/bc/asset/partner/get/ 请求参数类型 bc_id : number asset_id
用户信息
获取用户信息 您可以使用本接口获取已获得访问某一开发者应用的授权的用户信息。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/user/info/ /v1.3/user/info/ 返回参数名称和类型 id : number core_user_id : string 新增返回参
修改成员信息
商务中心的管理员用户可以使用本接口修改成员的用户名以及他们在商务中心的角色。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/member/update/ /v1.3/bc/member/update/ 请求参数类型 bc_id : number user_id : num
检查更改日志下载任务状态
您可以使用本接口检查更改日志下载任务是否完成。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/activities/task/check/ /v1.3/changelog/task/check/ 请求参数类型 advertiser_id : number advertiser_
下载更改日志文件
您可以使用本接口下载更改日志文件。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/activities/task/download/ /v1.3/changelog/task/download/ 请求参数类型 advertiser_id : number advertiser_
上传资质证书
您可以使用本接口上传资质证书。您必须是商务中心管理员用户。 当您在商务中心为注册地为中国大陆、中国香港地区、法国、巴西或墨西哥的广告主创建广告账户时，您需要先上传营业执照或其他资质证明。 本接口将返回资质证书图片 ID（ image_id ）。您可以将该字段的值传入 /bc/advertiser/create/ 接口的 license_image_id 字段
创建广告账户
您可以使用本接口为 代理商 或 直客 商务中心创建竞价广告账户。您必须是商务中心管理员用户。 若想创建竞价广告账户，请在 advertiser_info 下的 type 字段指定 AUCTION 。 若广告账户的注册地在中国大陆、中国香港地区、法国、巴西或墨西哥，那么在创建广告账户之前，您需要使用 /bc/image/upload/ 上传营业执照或其他认证资
更新广告账户
您可以使用本接口更新商务中心下的广告账户。您还可以使用本接口来更新自动分配模式下商务中心的广告账户月度预算。支持增量更新。您必须是商务中心管理员用户。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/advertiser/update/ /v1.3/advertiser/upda
商务中心-资金管理
商务中心是面向各类规模组织和机构的一站式业务中心。通过商务中心，各组织和机构可以在 TikTok 上合作开展营销活动，让宣传内容覆盖目标受众。您可以使用商务中心-资金管理API向广告账号充值或扣款，获取广告账户或商务中心的余额，获取广告账户或商务中心的交易记录，以及获取广告账户或商务中心的消耗记录。 本组包含以下接口： 充值或扣款 获取广告账号余额 获取商务
充值或扣款
您可以使用本接口向商务中心下广告账号充值或者扣款，或为商务中心增加或减少信用额度。 代理商商务中心和直客商务中心都能执行资金管理相关操作。 注意 只有拥有财务经理权限的用户才能在商务中心执行充值或者扣款操作。您可以使用 /bc/member/invite/ 和 /bc/member/update/ 设置或更改成员权限。 v1.2与v1.3版本对比 以下表格概
获取广告账户余额和预算
您可以使用本接口获取商务中心下的广告账户余额，或获取自动分配模式下商务中心的广告账户的预算。 本接口只返回该商务中心对广告账户具有管理员权限的广告账户。 代理商商务中心和直客商务中心都能执行资金管理相关操作。 注意 只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用 /bc/member/invite/ 和 /bc/
获取广告账户交易记录
您可以使用本接口获取商务中心下的广告账户交易记录。本接口只返回该商务中心对广告账户具有管理员权限的广告账户。 代理商商务中心和直客商务中心都能执行资金管理相关操作。 注意 只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用 /bc/member/invite/ 和 /bc/member/update/ 设置或更改成员
获取商务中心余额
您可以使用本接口对商务中心中的广告账号进行充值和扣款，也可以获取商务中心资金余额，以及商务中心内广告账户的资金余额。 代理商商务中心和直客商务中心都能执行资金管理相关操作。 注意 只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用 /bc/member/invite/ 和 /bc/member/update/ 设置或
获取商务中心交易记录
您可以使用本接口获取商务中心下的交易记录（转入及转出记录）。 代理商商务中心和直客商务中心都能执行资金管理相关操作。 注意 只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用 /bc/member/invite/ 和 /bc/member/update/ 设置或更改成员权限。 v1.2与v1.3版本对比 以下表格概括
获取成员列表
商务中心的管理员用户可以使用本接口获取商务中心下的成员列表及信息。 如果您需要获取某个成员的资产信息，可以使用 /bc/asset/get/ 接口。您需要传入 user_id 或 user_email 。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/member/get
邀请成员
商务中心的管理员用户可以使用本接口邀请成员加入商务中心，并给成员分配权限和资产。 每个商务中心最多支持4000个成员，最多支持20个管理员用户同时在线。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/member/invite/ /v1.3/bc/member/invit
删除成员或撤销成员邀请
商务中心的管理员用户可以使用本接口在商务中心删除成员或撤销成员邀请。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/bc/member/delete/ /v1.3/bc/member/delete/ 请求参数类型 bc_id : number user_id : number
受众管理 · API Reference
受众是一种广告定向选项，它能够帮助您在设置广告投放时对特定用户进行精准投放或排除投放。 欲了解受众管理API简介及其优势，请参阅 概览 。 欲了解受众类型，客户文件API与流式API之间的区别，以及如何创建、管理受众，请参阅 用户指南 。 本组包含以下接口： 客户文件 上传受众文件 通过文件创建受众 受众细分 创建/取消受众细分群 映射受众细分群 修改受众
客户文件
您可以使用该组接口，使用上传的数据建立您的自定义目标受众。了解更多关于客户文件API和流式API的区别，请参阅 流式API 。 本组包含以下接口： 上传受众文件 通过文件创建受众
流式 API · API Reference / Audience
使用流式 API，您可以使用第一方或第三方数据，一次性为多个广告主建立自定义受众。若您对API的吞吐量需求高，或者在受众信息准备好后，需要批量发送信息流数据至服务器，您可以使用这个接口。 数据合作伙伴公司需要使用流式API。 注意 要申请访问流式API，可以从下拉菜单中选择“流式API”，在开发者门户网站上使用 白名单管理 功能。我们会持续审核申请。 了解更
获取受众列表
您可以使用本接口获取一个广告主账号下所有受众的信息。返回列表是分页的，最大分页大小为100。该接口返回的信息包括每个受众的ID、名称、类型、创建时间、过期时间等。该接口会返回属于您的受众和共享受众。您可以使用 is_creator 查看您是否为该受众的拥有者。 如果需要获取受众详细信息，例如当前状态以及历史操作记录详情，请使用 /dmp/custom_aud
获取受众详情
您可以使用本接口获取指定受众群体的详细信息，包括受众群体当前状态以及历史操作记录详情。该接口将返回属于您的受众和与您分享的受众。您可以使用 is_creator 查看您是否为该受众的拥有者。 注意 单次请求最多获取 100 个受众群体的详细信息。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路
通过规则创建受众 · API Reference / Audience
您可以使用本接口通过规则创建受众。 您需要传入一系列的包含规则及可选的排除规则来创建受众。 注意 新建的受众最多需要48小时来处理，然后才能使用。 请使用 /dmp/custom_audience/get/ 接口来检查新建受众的状态，只有状态是“可用”（ is_valid = true ）才能被使用。 受众过期后，其状态将变为“已过期”（ is_valid
创建相似受众 · API Reference / Audience
您可以使用本接口创建相似受众。您需要使用广告主账号下已有的受众人群创建相似受众。 注意 新建的受众最多需要48小时来处理，然后才能使用。 请使用 /dmp/custom_audience/get/ 接口来检查新建受众的状态，只有状态是 is_valid 的受众才能被使用。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容
删除受众
您可以使用本接口删除指定的受众群体。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/dmp/custom_audience/delete/ /v1.3/dmp/custom_audience/delete/ 请求参数类型 advertiser_id : number custo
上传受众文件
您可以使用本接口上传受众数据文件。文件上传后，您将得到一个全局唯一的 file_path ，可用于后续创建或更新受众。 查看 身份标识符标准化指南 ，了解身份标识符标准化的相关步骤。 提示 请查看下表了解本接口相关的文件大小、文件格式、加密和文件上传的要求。欲获取关于文件限制的更多信息以及客户文件示例模板，请参考 客户文件 。 类型 详情 文件大小 请确保上
通过文件创建受众
您可以使用本接口通过上传的文件创建受众。您需要先上传受众数据文件，获得一个全局唯一的 file_path ，并使用该 file_path 创建一个对应的受众群体。 查看 身份标识符标准化指南 ，了解身份标识符标准化的相关步骤。 提示 请查看下表了解本接口相关的文件大小，受众生效时间，受众状态和定向设置限制。 类型 详情 文件大小 单个广告主账户中最多可创建4
修改受众
您可以使用本接口修改已创建的受众群体。 对于客户文件受众，TikTok API for Business支持以下三种修改操作： REPLACE （替换）：用参数中的数据文件去替换之前（所有）的数据文件 APPEND （新增） ：增加新的数据文件 REMOVE （移除）：移除指定的数据文件 提示 请查看下表了解本接口相关的限额，任务并行和支持范围限制。 类型
创建/删除受众细分群
您可以使用本接口创建/删除受众细分群。 请查看 流式API - 流式API相关提示 ，了解同一个企业号下有多个广告账号和在受众细分中混用IDFA/AAID加密类型的相关提示，以及 身份标识符标准化指南 ，了解身份标识符标准化的相关步骤。 注意 要申请访问流式API，可以从下拉菜单中选择“流式API”，在开发者门户网站上使用 白名单管理 功能。我们会持续审核申
添加或删除受众细分群映射
您可以使用本接口添加或删除受众细分群的映射。支持的映射包括单一ID映射（每个用户或设备对应一个受众ID）和多ID映射（每个用户或设备对应多个受众ID）。 请查看 流式API - 流式API相关提示 ，了解同一个企业号下有多个广告账号的相关提示，以及 身份标识符标准化指南 ，了解身份标识符标准化的相关步骤。 注意 要申请访问流式 API，可以从下拉菜单中选择“
即时体验页面
即时体验页面是一种加载快速的轻量级网页，在 TikTok 上的加载速度比标准网页快 11 倍。 目前，您可以使用 TikTok 即时体验页面编辑器 SDK 创建以下类型的即时体验页面： 自定义页面：自定义的即时体验页面，为您的目标受众提供更佳的体验。 即时表单（线索表单）：一种瞬间页面，使广告商能够直接在 TikTok 应用内收集线索的即时体验页面类型，使客
使用免责声明
在推销某些类别产品（例如制药产品）时，广告主需要在广告中同时显示免责声明。TikTok For Business支持在广告中使用免责声明。用户可以使用纯文本免责声明或者文字链免责声明。 本文介绍了如何在广告中设置免责声明，以及使用免责声明需要满足的要求。 要求 支持的推广目标： 手动广告： APP_PROMOTION 、 WEB_CONVERSIONS 、
创建广告 · API Reference / Ads
你可以使用本接口上传广告素材（图片、视频、标题，行动引导文案）以创建普通广告。 重要提示 对于现有广告账号，如果广告组采用自动广告位或选择的广告位包含 TikTok 时，不再支持使用自定义身份创建非 Spark Ads。2026 年 1 月 15 日及以后新建的所有广告账号，都无法使用自定义身份创建投放到这些广告位的非 Spark Ads。现有广告不受影响且
更新广告
你可以使用本接口修改普通广告的创意素材，包括行动引导文案，广告名称，图片、视频素材等。 重要提示 对于现有广告账号，如果广告组采用自动广告位或选择的广告位包含 TikTok 时，不再支持使用自定义身份创建非 Spark Ads。2026 年 1 月 15 日及以后新建的所有广告账号，都无法使用自定义身份创建投放到这些广告位的非 Spark Ads。现有广告不
更新广告状态
您可以使用本接口关停，开启或者删除广告。 注意 对于已删除的广告，或已删除的推广系列或广告组中的广告，其操作状态无法修改。您可以使用 /campaign/get/ ， /adgroup/get/ 或 /ad/get/ ，并通过 operation_status 字段获取推广系列、广告组或广告的操作状态。 v1.2与v1.3版本对比 以下表格概括了 v1.2与
访问令牌
访问令牌 API 使您能够获取或撤销长期访问令牌，以及获取、刷新或撤销短期访问令牌。 您可从广告账户、商务中心账号或 TikTok One Creator Marketplace 账号获取授权从而生成长期访问令牌，或从 TikTok 账号获取授权从而生成短期访问令牌。 若想了解不同 API 的授权及访问令牌生成流程的差异，请查看 不同 API 的授权流程对比
获取长期访问令牌
您可以使用 /oauth2/access_token/ 或 /oauth/token/ 生成长期访问令牌。 长期访问令牌是从广告账户、商务中心账户或 TikTok One Creator Marketplace 账户获取授权后生成的访问令牌类型。该令牌不会过期。若您想撤销长期访问令牌，可使用 /oauth2/revoke_token/ 。 注意 /oauth
撤销长期访问令牌
您可以使用本接口撤销长期访问令牌。本接口是 TikTok API for Business v1.3 中的全新接口。 长期访问令牌是从广告账户、商务中心账户或 TikTok One Creator Marketplace 账户获取授权后生成的访问令牌类型。该令牌不会过期。 您需先使用 /oauth2/access_token/ 或 /oauth/token/
获取 Spark Ads 授权
本文概述了如何使用 TikTok One (TTO) API 为达人的帖子申请 Spark Ads 授权。 步骤 广告主在创建营销活动期间或之后申请 Spark Ads 授权： 广告主使用 /tcm/tt_video/status/ 接口确认授权状态并获取授权码。 广告主使用 /tt_video/authorize/ 接口将视频添加至广告主账户。 广告主使用
功能更新
参阅下表，了解 TikTok API for Business 的功能更新情况。 2026年 2026年7月 日期 更新类型 类别 更新内容 2026年7月31日 产品优化 推广系列管理 我们已在使用 Messenger 和 WhatsApp 应用的升级版 Smart+ 即时通讯广告中新增自动添加新生成素材的能力，此功能由 /smart_plus/ad/cr
版本管理
TikTok API For Business v1.3于2022年8月15号发布，开发者有一年的时间从v1.2迁移到v1.3。2023年8月15号后, v1.2版本被废弃， 我们不再为v1.2版本开发新功能或提供技术支持。 关于v1.3的更多信息，您可参考 这里 。 版本是如何管理的？ 所有的重大更新将会包含在新API版本中。我们会给开发者一段时间（比如，
频控规则 · Get Started
调用 API 需要遵循 API 系统本身的限制，我们对 API 所有的接口都设定了调用频次限制。本篇将为您介绍我们的频控限制。我们的频控限制分为全局限制和某些接口的请求限制。 全局频控限制指的是每一个开发者应用在单位时间内总共能够发起的请求数。 接口特定频控限制适用于特定的接口或者接口组。接口特定频控对于不同接口是独立的。例如，开发者应用A调用 /campa
专属推广系列
专属推广系列是一种特殊类型的推广系列，专门定向运行 iOS 14.5 及更高版本的设备。 使用 iOS 14.5 或 iOS 更高版本的设备在访问量中占有很大份额。创建专属推广系列以确保您的广告能够覆盖到这些用户。若您创建普通推广系列，您的广告将不会覆盖到使用 iOS 14.5 或 iOS 更高版本的设备的用户。 根据用于创建专属推广系列的应用是否启用了 S
常见问题 · TikTok API for Business
本文汇总了API for Business的常见问题。 快速入门 在创建广告组时，我需要传入App ID参数。这个参数是我的开发者应用的App ID吗？ 在创建广告组时需要传入的App ID（ app_id ）是您想推广的移动应用的ID。您可以通过向 /app/list/ 接口发起一个GET请求来获取此ID。返回值中会包含当前广告账号下的所有推广应用ID。根
账户结构
每个开发者账号最多可以拥有5个开发者应用。这些开发者应用可以对应不同的广告账户。 广告账户是 TikTok For Business 的基础账户。广告主在创建和管理广告前，必须拥有某个广告账户或是被授予管理某个广告账户的权限。开发者应用与广告账户之间是多对多的关系（关系见下图）。当广告主完成授权后，开发者应用查看或管理的广告账户的权限取决于广告主与广告账户之
获取表单库
您可以使用本接口获取您可以访问的表单库信息。表单库位于商务中心下，被用于存储表单和相关线索。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/pages/library/get/ /v1.3/page/library/get/ 新增请求参数 / page : number pag
迁移线索到商务中心
您可以使用本接口将线索从广告账户迁移至商务中心。迁移时将自动创建一个表单库，用来存储迁移的线索。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/pages/library/transfer/ /v1.3/page/library/transfer/ 请求参数类型 adverti
修改图片名
您可以使用本接口修改图片名称。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/file/image/ad/update/ /v1.3/file/image/ad/update/ 请求参数类型 advertiser_id : number advertiser_id : stri
获取Pangle屏蔽列表
您可以使用本接口查询广告账户的 Pangle 媒体屏蔽列表。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/pangle_block_list/get/ /v1.3/pangle_block_list/get/ 请求参数类型 advertiser_id : number adv
修改Pangle屏蔽列表
您可以使用本接口修改 Pangle 媒体屏蔽列表。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/pangle_block_list/update/ /v1.3/pangle_block_list/update/ 请求参数类型 advertiser_id : number ad
获取Pangle人群包
您可以使用本接口获取广告主可用 Pangle 人群包（受众）。 人群包仅作用于Pangle版位，与其他定向条件共同生效，不影响其他版位的投放。人群包能够会缩小投放范围，帮助您的广告投放至更合适的人群。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/pangle_flow_pac
更新视频名称
您可以使用本接口更新视频名称。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/file/video/ad/update/ /v1.3/file/video/ad/update/ 请求参数类型 advertiser_id : number advertiser_id : stri
获取视频信息
您可以使用本接口获取素材库中可用于创建广告的视频的信息。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/file/video/ad/info/ /v1.3/file/video/ad/info/ 请求参数类型 advertiser_id : number advertiser_
搜索视频
您可以使用本接口获取某一广告账号的素材库中可用于创建广告的视频素材。 最多只按照素材修改时间返回前 10,000 条数据。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/file/video/ad/search/ /v1.3/file/video/ad/search/ 请求参数
获取视频推荐封面
您可以使用本接口获取根据视频素材推荐的一系列封面图片。返回中的URL可用于预览封面，您可预览后为自己的视频设置封面图片。 注意 若想为刚上传的视频获取推荐封面，建议您等待 30 秒至 5 分钟，待视频转码处理完成后再调用本接口。若视频转码尚未完成便调用本接口，可能导致报错 Insufficient permissions for some videos （对
获取图片信息
您可以使用本接口从素材库中获取指定图片的信息。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/file/image/ad/info/ /v1.3/file/image/ad/info/ 请求参数类型 advertiser_id : number advertiser_id :
搜索图片
您可以使用本接口从素材库中获取广告账号下的图片素材。 最多只会返回前 10000 条数据（按照素材修改时间 modify_time 排序），10000 条之后的数据不支持查询。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/file/image/ad/search/ /v1.3
音乐管理
音乐是一种创意素材，您可查看 上传视频、图片和音乐-上传文件 了解查找合适音乐的流程。您还可以在创意工具如 智能微电影 和 智能配乐 中使用音乐ID。此外，音乐还可用于 /catalog/video_package/create/ 创建的视频包中，您需要通过 music_id 指定音乐。 音乐可用于轮播广告中，点击 这里 查看如何创建轮播广告。 本组包含以下
上传音乐
您可以使用本接口将音乐上传。上传成功后，您将会得到一个音乐ID。您还可以使用本接口将音乐添加至收藏列表，添加至历史列表，或从收藏列表中移除。 版权声明 请确保您对该音乐具有使用权。如果您侵犯了作者的版权，一切责任由您承担。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/file
获取音乐列表
您可以使用本接口获取可用于创建视频或轮播广告的音乐列表。列表中包括广告主上传的私有音乐素材（简称用户音乐）或者音频库（ Audio Library ，又称 商用音乐库 ）中提供的公用音乐素材（简称系统音乐）。音频库更新频率比较低，不需要频繁获取。建议本地缓存，一个月更新一次即可。 版权声明 受音乐版权限制，使用系统提供的音乐制作的视频仅可在TikTok投放。
商务中心-发票
商务中心是面向各类规模组织和机构的一站式业务中心。通过商务中心，各组织和机构可以在 TikTok 上合作开展营销活动，让宣传内容覆盖目标受众。您可以使用商务中心-发票API管理商务中心的发票。 本组包含以下接口： 获取商务中心发票 获取商务中心未还款总金额 下载商务中心发票 同步下载 异步下载 创建异步下载任务 获取异步下载任务 获取异步下载任务列表
商品库管理
重要提示 使用商品库 API，表示您同意并愿意遵守 TikTok 广告投放政策 。 请仔细阅读这些政策，确保上传到商品库中的内容符合政策要求。 商品库（商品目录）是一种资产，供您存储您希望在TikTok上推广的商品的信息。使用商品库可高效创建、管理多种商品的广告，对于在线零售商等用户十分适用。商品库管理API使您能够在商务中心中管理商品库，以及商品库迁移至商
商品库事件源
重要提示 使用商品库 API，表示您同意并愿意遵守 商品库管理工具条款 和 TikTok 广告投放政策 。 请仔细阅读这些政策，确保上传到商品库中的内容符合政策要求。 商品库（商品目录）是一种资产，供您存储您希望在TikTok上推广的商品的信息。使用商品库可高效创建、管理多种商品的广告，对于在线零售商等用户十分适用。商品库事件源指与商务中心中的商品库绑定的应
商品库更新源
重要提示 使用商品库 API，表示您同意并愿意遵守 商品库管理工具条款 和 TikTok 广告投放政策 。 请仔细阅读这些政策，确保上传到商品库中的内容符合政策要求。 商品库（商品目录）是一种资产，供您存储您希望在TikTok上推广的商品的信息。使用商品库可高效创建、管理多种商品的广告，对于在线零售商等用户十分适用。您可以使用更新源，定期从商品数据库中获取商
商品
重要提示 使用商品库 API，表示您同意并愿意遵守 商品库管理工具条款 和 TikTok 广告投放政策 。 请仔细阅读这些政策，确保上传到商品库中的内容符合政策要求。 商品库（商品目录）是一种资产，供您存储您希望在TikTok上推广的商品的信息。使用商品库可高效创建、管理多种商品的广告，对于在线零售商等用户十分适用。商品API使您能够管理商务中心下商品库中的
商品系列
重要提示 使用商品库 API，表示您同意并愿意遵守 商品库管理工具条款 和 TikTok 广告投放政策 。 请仔细阅读这些政策，确保上传到商品库中的内容符合政策要求。 商品库（商品目录）是一种资产，供您存储您希望在TikTok上推广的商品的信息。使用商品库可高效创建、管理多种商品的广告，对于在线零售商等用户十分适用。商品系列API使您能够管理商务中心下商品库
商品库视频模板
重要提示 使用商品库 API，表示您同意并愿意遵守 商品库管理工具条款 和 TikTok 广告投放政策 。 请仔细阅读这些政策，确保上传到商品库中的内容符合政策要求。 商品库（商品目录）是一种资产，供您存储您希望在 TikTok 上推广的商品的信息。使用商品库可高效创建、管理多种商品的广告，对于在线零售商等用户十分适用。商品库视频模板 API 使您能够检索商
（已废弃）动态场景 · API Reference
动态场景提供素材自动化方案，通过机器学习，将各个广告主提供的场景与其他广告组件（例如背景音乐，转场特效等）动态组合，从而生成创意素材，提升广告创建效率与广告表现。参考 这里 了解更多。 本组包含以下接口： 提交素材 创建异步任务 获取异步任务结果 获取视频 获取报表
认证身份 · API Reference
认证身份功能允许您选择广告的发布身份。认证身份 API 使您能够创建或删除自定义用户类型的认证身份，获取广告账户下的认证身份，认证身份下的帖子，以及认证身份或 TikTok 帖子的详情。 请查看 认证身份 ，了解认证身份的类型。 本组包含以下接口： 创建认证身份 删除认证身份 获取认证身份列表 获取认证身份详情 获取认证身份下帖子 获取认证身份下直播视频 获
获取认证身份列表
您可以使用本接口获取广告账户下的认证身份列表。您可以根据身份类型或显示名称筛选结果。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/identity/get/ /v1.3/identity/get/ 请求参数类型 advertiser_id : number advertise
获取认证身份详情
您可以使用本接口获取一个认证身份的详情。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/identity/info/ /v1.3/identity/info/ 请求参数名称 profile_image profile_image_url 请求参数类型 advertiser_id
获取广告发布身份下的帖子
此接口可用于获取某个广告发布身份下的所有帖子。 v1.2 与 v1.3 接口对比 下表概述了 v1.2 接口与 v1.3 接口之间的差异。 变更 v1.2 v1.3 接口路径 /v1.2/identity/video/get/ /v1.3/identity/video/get/ 请求参数类型 advertiser_id : number advertiser