TikTok ADS 对接指南
本文用于指导您准备 TikTok API for Business 开发者应用资质，并在观远数据连接器中创建 “TikTok ADS” 数据账户、完成授权和测试连接。
1. 适用范围
本指南适用于需要同步 TikTok 广告账户、商务中心、推广系列、广告报表，以及 GMV Max 相关店铺和商品数据的客户。本文所述平台为 TikTok ADS，不是 TikTok Shop 订单连接器。
TikTok ADS 采用 OAuth 授权。客户需要准备 TikTok for Business 开发者应用的 App ID 和 Secret；授权成功后，访问令牌由连接器维护，不需要手工填写 Access Token 或 Refresh Token。
2. 申请 TikTok 对接资质
2.1 注册 TikTok for Business 开发者
- 打开 TikTok API for Business 开发者门户，登录或注册 TikTok for Business 账号。
- 按照 TikTok 官方接入流程 完成开发者注册。
- 确认登录账号对需要授权的广告账户或商务中心拥有足够权限；否则后续授权页可能无法显示目标账户。
2.2 创建开发者应用并申请权限
- 在开发者门户进入 My Apps，创建开发者应用。
- 根据需要同步的数据申请 Marketing API 相关权限。观远当前对接范围包括广告账户、商务中心、推广系列、报表及 GMV Max 店铺/商品数据。
- 按 TikTok 后台要求配置应用基本信息和回调地址，并提交审核。具体审核项和可申请权限以 TikTok 后台当前页面为准。
- 应用可用后，进入 My Apps > App Detail > Basic Information，保存页面展示的 App ID 和 Secret。TikTok 官方认证说明也在该路径下说明凭据的获取位置。
公开资料脱敏示例，仅用于辅助识别字段名称；实际页面以 TikTok API for Business 开发者后台为准。图中 App ID 填入连接器 client_id，Secret 填入 client_secret。Secret 默认以掩码显示，可使用页面上的复制功能获取；不要在截图或沟通记录中展示明文。
查看 TikTok 官方授权说明；查看 TikTok Marketing API 官方认证说明。
安全提示：Secret 属于敏感信息，请勿通过群聊、工单正文或截图明文传播。文档截图中若出现真实 Secret、账号名称、邮箱或客户信息，必须先脱敏。
2.3 需要准备的资质字段
3. 创建观远数据账户
3.1 选择 TikTok ADS 平台
在观远连接器中进入数据账户管理，点击新增数据账户，在所属平台中选择 TikTok ADS。请勿误选 TikTok Shop。
选择 TikTok ADS 后，依次填写账户名称、customer_id、client_id 和 client_secret，再点击“立即授权”。图中表单为空，不包含真实密钥或客户数据。
3.2 字段映射关系
| 第三方平台字段或信息 | 连接器字段或动作 | 是否必填 | 官方获取入口 | 说明 |
|---|
| 无，不需要从 TikTok 获取 | customer_id | 是 | 不涉及 | 观远内部数据账户唯一标识。可自定义，例如 tiktok_ads_001；同一批数据账户中的值必须唯一。 |
| App ID | client_id | 是 | 查看 TikTok 官方凭据位置 | 字段名称不同，但含义对应 TikTok 开发者应用的 App ID。 |
| Secret | client_secret | 是 | 查看 TikTok 官方凭据位置 | 字段名称不同，但含义对应 TikTok 开发者应用的 Secret；属于敏感信息。 |
| TikTok 账号及广告资产权限 | 授权页面确认 | 是 | 查看 TikTok 官方授权说明 | 使用有权访问目标广告账户或商务中心的账号登录并确认授权。 |
3.3 填写、授权、测试连接并保存
- 在
customer_id 中填写本数据账户的唯一内部标识。创建多个 TikTok ADS 数据账户时，每个值都必须不同。
- 将 TikTok 开发者应用的 App ID 填入
client_id，将 Secret 填入 client_secret。
- 发起授权后，在 TikTok 官方页面登录并确认所需广告账户或商务中心的数据权限。
- 返回观远数据账户页面，点击测试连接。测试成功后保存数据账户。
如果授权页面要求验证码、MFA、选择组织或切换账号，请直接在 TikTok 官方页面完成；不要把验证码、Cookie、Token 或密钥发送给他人。
4. 常见问题
| 问题 | 处理建议 |
|---|
client_id 和 client_secret 从哪里获取？ | 进入 TikTok 开发者门户的 My Apps > App Detail > Basic Information，分别复制 App ID 和 Secret。 |
customer_id 是 TikTok 广告账户 ID 吗？ | 不是。它是观远内部用于区分数据账户和隔离授权缓存的唯一标识，可自行填写；不要把它误当作 TikTok 广告账户 ID。 |
| 授权页看不到目标广告账户 | 确认当前 TikTok for Business 登录账号对目标广告账户或商务中心有权限，并检查应用是否已获得相应 API 权限；必要时切换账号或联系 TikTok 侧管理员。 |
| 测试连接提示凭据错误 | 核对 App ID 与 Secret 是否来自同一个开发者应用，复制时是否带入空格，并确认应用状态、权限和回调配置有效。 |
| 需要同步多个客户或授权主体 | 分别创建多个 TikTok ADS 数据账户，为每个数据账户使用唯一的 customer_id，并完成对应主体的授权。 |
| 授权后仍无法拉取部分数据 | 检查授权账号是否拥有对应广告账户/商务中心资产权限，以及开发者应用是否已申请相关接口权限。不同接口的数据范围以 TikTok 官方权限和实际授权结果为准。 |
5. 官方参考
| 
