适用于 SA3.0.5 及以上版本。
该功能由独立 license 控制，若有需求，请联系您的客户经理。
若您的 App 正在通过 TikTok Ads 投放海外广告，并希望将广告展示、点击、消耗、转化等聚合数据接入神策平台，可使用 TikTok Ads 广告数据集成功能。
功能概述
TikTok Ads 广告数据集成通过 TikTok Marketing API 拉取广告聚合数据，并以事件形式写入神策平台。您可以在分析模型中查看广告展示、点击、消耗等指标，也可以结合 Google Ads、Tiktok Ads 等渠道数据进行对比分析。同时可以与后链路中的用户行为数据关联分析。
|
接口
|
数据粒度
|
数据更新频率
|
归因
|
成本
|
展示
|
点击
|
转化
|
|---|---|---|---|---|---|---|---|
| Marketing API | 聚合数据 | 天粒度 | ✅ | ✅ | ✅ | ✅ |
功能入口
渠道追踪 > 三方数据集成 > 广告生态 > Tiktok Ads
接入说明
Tiktok Ads 数据说明
支持通过Tiktok Ads 的Marketing API拉取广告数据，包含5个模版的数据。API详情可参考：Tiktok Ads API 官方文档
- Campaign 模板：Campaign层级的广告数据，原始内容可查看 官方文档。通过该模版可获取的指标及维度如下
| metrics |
|
| group by |
|
- Ad Group 模版
| metrics |
|
| group by |
|
- Ad 模版
| metrics |
|
| group by |
|
- Country 模版
| metrics |
|
| group by |
|
- Keyword 模版
| metrics |
|
| group by |
|
接入前准备
需要完成与Tiktok Ads的授权认证，方可通过Tiktok Ads API获取广告数据。详情可参考官方文档：Tiktok Ads API官方文档
第一步：注册开发者账号
-
注册 账号
- 注册 Tiktok for Business Developers 账号
-
完成开发者注册流程（需提交企业信息，审核1-2个工作日）
第二步：创建应用并获取凭证
-
在Developer Portal中点击「My Apps」→「Create New」
-
配置应用信息：
-
Application name：应用名称（如"神策数据集成"）
-
App Description：应用描述
-
Callback Address：授权回调地址（初始创建时可以先任意填一个，后续替换为神策产品中提供的数据接收地址）
-
Scope of Permission：必选 Reporting 权限、Ads Management 权限
-
-
提交审核，等待状态变为「Approved」（1-2个工作日）
-
获取 App ID 和 Secret
第三步：授权广告账号访问权限
-
在TikTok Business Center中，进入用户列表，选择授予权限，向已有的用户分配后续希望拉取广告数据的广告主账号
-
记录需要拉取数据的 Advertiser ID
配置Tiktok Ads接入方案
主要包括以下3个部分的配置：
1. 方案基本信息
2. 授权配置
-
- 该部分填入的字段主要用于与Tiktok Ads进行鉴权以及明确要拉取的广告账号范围。请参考上一段落「接入前准备」中的内容，从Tiktok Ads平台获取相应的字段
- 最多支持拉取100个Tiktok Ads广告账号的数据，如果用户有超过100个Tiktok Ads广告账号，则可以创建多个拉取方案
3. 数据拉取配置
点击「确认创建」后，需要完成与Tiktok Ads的授权流程，方案方可创建成功。授权流程包括如下三步。
点击蓝字「去授权」后，将跳转至Tiktok Ads授权页面，登录Tiktok账号。（注意此处登录时，需要以创建Tiktok Business manager账号对应的Tiktok账号登录）。
以上步骤都完成后，在神策弹窗中选择「已完成授权」。如果此次授权不成功，将通过Error Code告知报错信息。
方案创建成功后，每天将按照模版内容定时拉取Tiktok Ads数据。
数据回溯
支持「数据回溯」，可以选择最长180天时长的时间段，拉取该时间段内的广告数据。
数据入库说明
拉取的Tiktok Ads统一以事件入库，原始字段将进行标准化，以sensors_ad开头作为属性入库。
这部分事件将使用一个固定值作为其用户标识，可理解为用户标识是一个虚拟用户。
不同模版对应的入库事件如下：
Campaign 模板：tiktok_ads_campaign
Ad Group模板：tiktok_ads_adgroup
Ad模板：tiktok_ads_ad
Country模版：tiktok_ads_country
Keyword模版：tiktok_ads_keyword
以下列举一些常见的原始数据及相应的入库属性：
| 入库字段 | |
|---|---|
| advertiser_id | sensors_ad_customer_id |
| advertiser_name | sensors_ad_customer_name |
| advertiser_timezone | sensors_ad_customer_timezone |
| campaign_id | sensors_ad_campaign_id |
| campaign_name | sensors_ad_campaign_name |
| adgroup_id | sensors_ad_ad_group_id |
| adgroup_name | sensors_ad_ad_group_name |
| ad_id | sensors_ad_ad_id |
| ad_name | sensors_ad_ad_name |
| search_keyword | sensors_ad_search_keyword |
| country_code | sensors_ad_country_code |
| stat_time_day | sensors_ad_date |
| currency | sensors_ad_currency |
| spend | sensors_ad_metrics_cost |
| impressions | sensors_ad_metrics_impressions |
| clicks | sensors_ad_metrics_clicks |
| ctr | sensors_ad_metrics_ctr |
| conversion | sensors_ad_metrics_conversions |
| app_install | sensors_ad_metrics_installs |
在分析模型中进行分析
将Tiktok Ads数据作为事件入库后，可在事件分析中选择相应事件，分析Tiktok Ads的展示数、点击数、花费等指标。
权限
管理员角色默认可进行Tiktok Ads方案的配置。也可将配置方案与查看方案的权限点分配给普通用户。