菜单

TikTok Ads 广告数据同步方案介绍

 

适用场景

在 TikTok Ads 推广网页场景,支持通过 TikTok Ads 转化 API , 将归因到 TikTok Ads 渠道的用户转化行为同步到 TikTok Ads ,更有效的跟踪转化以及优化广告投放效果。一般媒体建议与 TikTok Pixel 搭配使用,以获得更全面的数据反馈。

使用流程

  1. 网页安装神策 Web JS SDK ,并引入 Channel 插件
  2. 集成 Pixel 像素代码
  3. 广告数据同步方案
  4. 配置网页转化归因窗口期
  5. 在渠道追踪中创建 TikTok Ads 渠道推广链接
  6. 在广告平台后台,填写上述步骤生成的推广链接,并开启广告投放

转化去重 ID 设置

此步骤 非必须 ,请根据实际情况选择是否设置。

需要设置去重ID的场景:当既通过 TikTok Pixel 发送转化行为,同时又通过同步方案(转化 API 接口)发送相同的转化行为,即同一用户的同一个转化行为通过两种方式发送。为避免TikTok Ads 将同一笔转化识别为两笔,则需要设置去重 ID,即两次转化行为设置同一 ID。 

  1. 在 TikTok Business  中创建数据源后,添加网页转化事件
  2. 在网页代码中,为转化定义唯一的 ID,例如值为 1616318632825_357
  3. 在网页代码中触发网页转化行为的位置,添加 Pixel 网页事件转化代码,并添加 event_id=1616318632825_357
    ttq.track('eventcode',
     { "contents":
     [ {
     "content_name": "<content_name>" // string. The name of the page or product. Example: "shirt". 
    } 
    ] }, 
    { "event_id": "1616318632825_357" // string. A hashed ID that can identify a unique event. Example: "1616318632825_357". 
    }); 
  4. 相同用户行为上报到神策时,为当前事件设置 sensors_abroad_transaction_id 属性,属性值与上述 TikTok Pixel 设置的值保持一致如何为事件设置属性,请参考 技术文档

同步方案参数准备

在配置广告数据同步方案时,需要提供用于接口身份验证等相关信息以及设置

需要准备的参数如下

准备项 用途 备注
Pixel ID 表示转化事件同步到哪个 Pixel 或 Web 数据源  
Access Token 用于转化 API 调用的凭证  
Test Event Code 用于把测试回传事件发送到事件管理工具的测试码  

详细步骤

如果已经为网站设置 Pixel 像素代码,需要为网页和 TikTok Ads 转化API 使用相同的 Pixel ID。

使用 TikTok Business 创建数据集并设置 Pixel 像素代码

步骤说明 截图
  1. 登录 TikTok Business ,并进入 Event Manager 中,点击 Connect data source, 并选择 Web
  2. 点击 Next ,在页面中添加要推广的网页域名
  3. 选择合适的链接方式,本次选择  Manual setup,点击 Next

  1. 按照推荐的方式选择 TikTok Pixel + Event API,点击 Next ,为 Pixel 输入名称,并继
  2. 根据事件管理中的提示,在网页汇总安装 Pixel 代码,并完成相关设置,继续后续步骤
  3. 接上述步骤,根据业务选择对应的事件参数, 神策支持如下参数,其他不支持
    • event_time
    • url
    • event_id
    • currency
    • value
    • external_id
    • ttclid
    • ip
    • ua
  4. 参数选择完成后,点击 Next

  1.  事件 API 配置部分,保存 Pixel ID 、生成访问令牌,并保存此令牌。后续同步方案配置中会使用此令牌
  2. 进入验证 API 设置部分,获取 test event code ,后续用于测试同步方案的连通性

  

广告同步方案配置步骤

创建同步方案

操作路径:进入渠道追踪 > 广告数据同步 ,点击 TikTok Ads  卡片中的「查看同步方案」 。点击 页面右上角 「创建同步方案」,在页面配置如下内容:

分类 配置项 说明
基础信息 同步方案名称 自定义填写便于识别的名称
方案状态 标识当前方案是否启用
Pixel ID  填写目标数据源 ID
Access Token 填写目标数据源 ID 对应的接口凭证
Test Event Code 测试 code ,用于测试事件是否可以正常发送到 TikTok Ads
 
 事件与属性选择
 
 
 
 
 

通用属性:sensors_abroad_transaction_id

事件去重 ID,当通过 Pixel 代码以及事件 API 接口(同步方案)发送同一行为到媒体时,需要设置去重 ID,否则无需设置。

通用属性:User ID

客户参数中的外部 ID (来自客户的任何唯一 ID,例如会员 ID、用户 ID和外部 Cookie ID ),神策按照用户 ID 进行同步,按需选择
 标准事件名称 TikTok Ads 中提供的标准事件 Code,eg: AddPaymentInfo、AddToCart、AddToWishlist 等
 采集事件  选择需要同步到 TikTok Ads  数据源的用户行为
 采集事件-筛选  根据实际业务情况添加 采集事件的筛选条件,符合筛选条件的事件方可同步到 TikTok Ads
频次  支持首次、每次两种方式同步数据,控制指定事件同步的频次
转化价值  如每次转化行为价值不同,并且需要同步转化价值,则选择事件中代表转化价值的属性,
币种 转化价值对应的币种,建议与 TikTok Ads 中对应的转化的币种保持一致

方案配置完成后,点击「连通性测试」,确保填写的 Pixel ID、Access Token 等正确,测试通过,在 TikTok Pixel  Test events 页面可显示已经发送的事件。

连通性测试通过后,点击「确定创建」,方案即可保存。

同步方案创建又如下注意事项:

  • 在同一个方案中采集事件与 标准事件名称 的映射关系最多添加 20 个
  • 同一个 Pixel ID 关联的方案中,采集事件不可重复选择
  • 不同 Pixel ID 下的采集事件可重复选择,但请添加筛选条件(例如地区等)以区分不同 Pixel ID下发生的事件,否则采集事件均会同步到对应的 Pixel ID下。

同步方案管理

操作路径:进入渠道追踪 > 广告数据同步 ,点击 TikTok Ads  卡片中的「查看同步方案」 ,进入同步方案列表页面,显示已经创建的同步方案。支持对同步方案进行筛选、查看、编辑删除等操作。

查看数据同步详情

操作路径:进入渠道追踪 >  广告数据同步 ,点击 TikTok Ads  卡片中的「查看同步方案」 ,进入同步方案列表页面,点击页面右上角的「查看数据同步详细」,显示已经同步到 TikTok Ads 的数据明细。
 
支持按照时间区间、方案名称、采集事件、媒体接口返回接口进行查询同步到媒体的数据。帮助用户查询同步到媒体的数据、回传是否发生异常以及异常的排查,同时支持下载同步数据详细。

角色授权

使用广告数据同步功能,需要管理员在「平台管理 -> 成员与角色 -> 角色管理」中配置对应的权限。

TikTok Ads 同步方案涉及到的权限为:「查看 TikTok Ads 广告数据同步」、「配置 TikTok Ads 广告数据同步」

注意事项

1. 请确保所有事件在 Pixel 和事件 API 中的设置保持一致

 

上一个
Meta Ads 广告数据同步方案介绍
下一个
海外媒体渠道事件属性说明
最近修改: 2026-07-24