菜单

TikTok 接入指引

神策分析 3.0.5 及以上版本支持 TikTok 

使用限制：使用该功能前，需先开通「海外人群包推送」，并安装 TikTok Ads 对应平台插件。完成插件配置与账号授权后，即可在分群页面创建推送任务，选择 TikTok Ads 作为目标渠道，并提交人群包推送。

 

1. 适用场景

适用于将神策分群同步到 TikTok Ads，用于广告定向投放、排除人群或相似人群扩展。推送成功后，可在 TikTok Ads Manager 中查看对应受众。

 

2. 接入前准备

在神策中创建 TikTok Ads 推送连接前，请按以下页面依次准备 App ID、App Secret、Access Token 和广告账户 ID，用于后续接口调用鉴权。TikTok Ads 平台页面可能随版本调整，具体入口以 TikTok Ads 页面实际展示为准。

步骤 说明

第一步：登录 TikTok 开发者门户
  1. 使用 TikTok Ads 管理员或开发者账号登录 TikTok API for Business 平台。
  2. 如果没有开发者账号，先按页面提示完成注册和企业信息认证。

完成后，应能进入「我的应用」页面。

第二步：创建 Marketing API 应用
  1. 进入「我的应用」。
  2. 点击「创建应用」。
  3. 填写应用名称。
  4. 在应用用途或场景中选择/填写 Marketing API 相关场景。
  5. 提交应用创建。

完成后，系统会生成一个开发者应用。
第三步：申请 Audiences 权限
  1. 进入刚创建的应用详情页。
  2. 找到「App 权限」或「权限管理」。
  3. 勾选 Audiences 相关权限。
  4. 按页面要求填写用途说明。
  5. 提交审核。

说明：Audiences 权限用于创建、更新和管理 TikTok Ads 受众。未开通该权限时，后续人群包推送可能失败。
第四步：获取 App ID 和 App Secret
  1. 应用审核通过后，进入应用详情页。
  2. 复制 App ID。
  3. 复制 App Secret。
  4. 妥善保存，后续需填写到神策连接配置中。
第五步：生成 Access Token
  1. 进入「授权管理」或「Access Token 申请」页面。
  2. 选择已创建的应用。
  3. 选择需要授权的 TikTok Ads 广告账号。
  4. 勾选 Audiences 相关授权范围。
  5. 生成 long-term access token。
  6. 复制并保存 Access Token。

建议选择长期有效 Token，避免 Token 过期导致推送失败。
第六步：获取广告账号 ID
  1. 登录 TikTok Ads 管理后台。
  2. 进入「账号管理」或广告账号详情页。
  3. 找到需要接收人群包的广告账号。
  4. 复制广告账号 ID，即 Advertiser ID。

注意：广告账号 ID 必须与第五步 Access Token 授权的广告账号一致。

 

3. 神策侧操作步骤

3.1 创建推送通道

操作路径：进入「数据管理 -> 通用数据集成 -> 数据源管理」，在「受众推送」分类下选择 Meta Ads。点击 Meta Ads 连接管理 页面右上角 创建，在弹出的 添加连接 抽屉中填写配置项如下：

配置项 说明
连接名称 自定义填写便于识别的名称，用于在神策中识别该 TikTok Ads 推送连接，例如：华东区-TikTok主投放账号
App ID 填写 TikTok Ads 平台侧准备的 App ID
App Secret 填写 TikTok Ads 平台侧准备的 App Secret
Access Token  填写 TikTok Ads 平台侧准备的 Access Token
推送字段/映射字段 神策字段名称：选择神策 string 类型用户属性或 string 类型虚拟用户属性
推送字段/映射字段 平台字段名称：选择 Meta Ads 支持的匹配字段，如 EMAIL、PHONE、MADID

 

3.2 角色授权

TikTok Ads 属于广告平台通道，需要管理员在「平台管理 -> 成员与角色 -> 角色管理」中配置推送通道和广告账户授权。未授权时，成员在创建推送任务时可能看不到对应通道或广告账户。

具体步骤如下：

  1. 在「平台管理」→「成员与角色」→「角色管理」的在角色列表中定位目标角色，点击「授权对象」进入权限配置页面。
  2.  在列表中，找到「推送插件管理」分类，勾选 「TikTok Ads 推送授权」权限项。
  3. 点击「配置」，设置该角色可使用的推送连接及广告账号范围：
    1. 全部广告账号：授权角色使用系统内所有已配置的 Meta Ads 推送连接及关联账号。
    2. 自定义授权：按推送连接或具体广告账号维度，勾选需授权的资源范围
  4. 完成所有权限配置后，点击「保存」按钮，权限配置即时生效

 

3.3 创建推送任务

3.3.1 手动推送

在分群历史详情中，可对某个已计算完成的分群版本发起手动推送。

操作路径：

  1. 进入「分群管理」。
  2. 打开目标分群详情。
  3. 进入分群历史详情。
  4. 点击「立即推送」。
  5. 选择推送通道、账号或平台所需字段。
  6. 确认后提交推送任务。

3.3.2 自动推送

神策分析 3.5 及以上版本支持自动推送。

创建或编辑分群时开启推送，用于在分群计算完成后自动按已配置规则执行推送。

可在 分群管理 -> 创建分群 中，点击 推送设置中的开启推送 ；也可在 分群管理 -> 分群详情 中，点击 推送设置中的编辑。具体入口以当前产品页面为准

点击 推送设置中的开启推送/编辑后，进行 推送配置 ，配置项如下：

  1. 推送通道：选择已配置的个推通道
  2. 字段映射 / 推送字段：字段配置支持以下方式：
    1. 预设字段：快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
    2. 自定义字段：支持按业务需求新增字段映射，用于补充预设字段无法满足的个性化推送场景。

 

3.4 推送字段映射与与格式建议

在神策创建 TikTok Ads 推送连接时或在创建推送任务时，需要配置「神策字段名称」与「平台字段名称」的映射关系。平台字段名称指 TikTok Ads 可识别的用户匹配字段；神策字段名称指神策项目中用于存放对应用户标识的 string 类型用户属性或 string 类型虚拟用户属性。

Tiktok Ads 平台字段名称 神策字段要求 客户侧数据准备 神策推送前处理
Email 选择存放邮箱的 string 类型用户属性或 string 类型虚拟用户属性

建议格式

  1. 去除首尾空格并转为小写
  2. 需为完整合规的有效邮箱，包含用户名、@符号及合法域名；
  3. 内容不得包含空格、冗余符号及 #、&、* 等非法特殊字符。
  4. 示例：test@example.com、lisi.123@gmail.com。
 检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送
Phone 选择存放手机号的 string 类型用户属性或 string 类型虚拟用户属性

建议格式

  1. 统一采用 E.164 国际标准格式：以 + 开头，依次拼接国家代码、区号、电话号码，禁止使用空格、括号、横杠等分隔符号。
  2. 中国手机号示例：+8613800138000（+86 为中国国家代码）。
 检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送
MAID 选择存放移动广告 ID 的 string 类型用户属性或 string 类型虚拟用户属性

保持平台要求的移动广告 ID 格式

 是否需要哈希处理以目标平台要求为准

说明：

  • 可用平台字段以神策创建推送连接页面实际展示为准。
  • MAID 属于移动广告 ID。若神策字段中存在空值或格式不符合平台要求，该用户可能无法被推送或无法被 TikTok Ads 成功匹配。
  • 请勿在文档、截图或问题排查记录中粘贴真实用户手机号、邮箱或设备标识。

 

4. 推送后查看结果

4.1 在 神策数据上查看人群包

推送任务创建后，可在神策侧（分群>推送详情>推送记录 / 数据管理 > 通用数据集成 >推送任务）查看任务执行状态、推送人数、失败原因等信息。任务状态以页面展示为准。

状态 说明
等待中 任务已创建，等待执行
推送中 系统正在向目标平台推送数据
成功 目标平台已接收本次推送
失败 推送未成功，需查看失败原因
部分成功 部分子任务成功，部分子任务失败，需查看明细

失败任务支持在有效期内（3天）手动重试。若失败原因是授权失效、账号权限不足或平台凭证错误，请先修复连接配置后再重试。

4.2 在 TikTok Ads 查看受众

推送成功后，可在 TikTok Ads Manager「Tools -> Audience Manager（工具 -> 受众管理）」中查看对应受众。平台侧可能存在处理延迟，神策显示成功后，TikTok Ads 后台规模不一定立即更新。

 

5. 平台特有问题

5.1 为什么 TikTok Ads 推送失败？

请优先检查 App ID、App Secret、Access Token、广告账户 ID 是否正确，以及 Token 对应账号是否具备目标广告账户权限。

5.2 MAID 和 MADID 是一回事吗？

在本文中可以按同一类字段理解，均指移动广告 ID。Meta Ads 常见字段名为 MADID，TikTok Ads 常见字段名为 MAID，配置时以页面展示的平台字段名称为准。

 

 

最近修改: 2026-07-24