文档Experience Platform源连接器指南

[Beta]{class="badge informative"}

TikTok Ads

最近更新： 2026年10月12日

创建对象：

  • Developer
NOTE
TikTok Ads源为测试版。 有关使用带有Beta标记的连接器的更多信息，请阅读源概述。
IMPORTANT
TikTok Ads源作为Customer Journey Analytics SKU的一部分提供。

TikTok Ads源是Adobe Experience Platform付费媒体连接器。 使用此插件可连接您的TikTok广告帐户，并将促销活动、广告和效果数据（如参与量度）摄取到Experience Platform中。

连接器将其捕获的数据发布到付费媒体数据集。 Customer Journey Analytics使用这些数据集分析您的TikTok营销活动。

要连接您的帐户，请登录到TikTok并授权Experience Platform访问您的广告商帐户。 您无需手动生成或提供任何API凭据。

工作原理

在创建TikTok Ads数据流并选择要定位的广告商帐户后，Experience Platform会自动运行以下作业。

  • 如果贵组织尚不存在付费媒体数据集，则Experience Platform会创建这些数据集。
  • 创建数据流后，将运行一次性回填作业。
  • 增量作业每天运行一次，从创建数据流后的第二天开始。

先决条件

在将TikTok Ads连接到Experience Platform之前，请确保您具备以下条件：

  • 已添加具有营销API产品的现有TikTok for Business开发人员应用程序。
  • 来自TikTok的应用程序审批。 应用以沙盒模式启动，并要求TikTok审核和批准该应用，然后才能访问生产广告帐户数据。
  • 业务验证。 这是与应用程序审阅分开的审批流程，对于更高的速率限制层是必需的。
  • 在您首次授权帐户之前已授予以下应用程序权限组。 TikTok不允许您稍后在未重新授权的情况下扩展这些权限：广告管理、报告、广告帐户管理和受众管理。
  • 适用于回填卷的速率限制配额。 默认沙盒层节流幅度很大，因此在运行大型回填之前请求增加。
  • 已在您的TikTok广告帐户中设置营销活动和广告。 连接器从此现有广告数据中读取。 它不会创建、修改或删除TikTok营销活动、广告或其他资源。

架构和数据集配置

TikTok Ads源自动分配目标数据集、架构和字段映射。 在创建数据流时，您不会自己选择目标数据集或映射字段。

连接器为每个实体类型设置一个付费媒体数据集：帐户、营销活动、广告组、广告、资产和摘要量度。 Meta Ads和Google Ads源已填充的规范架构相同。 请阅读以下部分，了解连接器为每个实体映射的核心标识字段。

TikTok Ads XDM架构

请阅读此部分以了解有关TikTok Ads源映射到每个付费媒体架构的核心标识和状态字段的信息。 每个映射的记录还包含标识该实体的entityType值和tiktok的paidMedia.adNetwork值。

帐户字段

帐户架构存储了您的TikTok广告商帐户详细信息。

TikTok字段
XDM字段
描述
advertiser_id
paidMedia.accountID
TikTok内广告商帐户的唯一标识符。
name
paidMedia.metadata.name
广告商帐户的显示名称。
status
paidMedia.metadata.status
帐户状态，如活动。
currency
paidMedia.metadata.currency
帐户报告的币种。
create_time
paidMedia.metadata.createdTime
帐户创建时间戳。

营销活动字段

营销活动架构存储您的TikTok营销活动详细信息。

TikTok字段
XDM字段
描述
campaign_id
paidMedia.campaignID
TikTok中促销活动的唯一标识符。
advertiser_id
paidMedia.accountID
父广告商帐户的标识符。
campaign_name
paidMedia.metadata.name
营销活动显示名称。
operation_status
paidMedia.metadata.status
营销活动状态，如活动或暂停。
create_time
paidMedia.metadata.createdTime
营销活动创建时间戳。
modify_time
paidMedia.metadata.updatedTime
上次活动修改的时间戳。

广告组字段

广告组架构存储您的TikTok广告组详细信息。

TikTok字段
XDM字段
描述
adgroup_id
paidMedia.adGroupID
TikTok中广告组的唯一标识符。
campaign_id
paidMedia.campaignID
父营销活动的标识符。
adgroup_name
paidMedia.metadata.name
广告组显示名称。
operation_status
paidMedia.metadata.status
广告组状态，例如活动或暂停。

广告字段

广告架构存储您的TikTok广告详细信息。

TikTok字段
XDM字段
描述
ad_id
paidMedia.adID
TikTok中广告的唯一标识符。
adgroup_id
paidMedia.adGroupID
父广告组的标识符。
ad_name
paidMedia.metadata.name
广告显示名称。
operation_status
paidMedia.metadata.status
广告状态，例如活动或暂停。

资源字段

资产架构存储您的TikTok图像和视频创作详细信息。

TikTok字段
XDM字段
描述
image_id / video_id
paidMedia.assetID
TikTok中图像或视频资源的唯一标识符。
advertiser_id
paidMedia.accountID
父广告商帐户的标识符。

摘要量度字段

摘要量度架构存储TikTok帐户、营销活动、广告组、广告和资产的性能数据。

每个量度记录都映射到它测量的实体的标识符。

实体
映射到XDM字段
帐户
paidMedia.accountID
营销活动
paidMedia.campaignID
广告组
paidMedia.adGroupID
广告
paidMedia.adID
资产
paidMedia.assetID

故障排除

使用下表对TikTok Ads源的常见问题进行故障诊断。

问题
原因
连接成功，但似乎没有广告商帐户可供选择。
授权TikTok用户不具有任何广告商帐户的广告管理访问权限，或者应用程序尚未完成业务验证。 在TikTok for Business Developer Portal中检查应用状态。
数据流运行，但数据未登陆数据集。
应用程序可能仍处于沙盒审核状态。 在应用程序通过审核之前，TikTok不会返回生产数据，即使连接本身成功。
回填在中途失败，并出现速率限制错误。
对于请求的日期范围，应用程序的默认费率限制层太低。 在运行大型回填之前，请请求从TikTok开始提高速率限制。
特定量度细分（如资产性能）返回的行数少于预期或错误数。
并非每个报表维度组合都支持每个量度。 在生产中使用测试广告商帐户之前，请验证受影响的细分。

后续步骤

在您确认自己拥有包含现有促销活动和广告的合格TikTok广告商帐户后，请使用UI 🔗继续将TikTok广告连接到Experience Platform。

有关此主题的更多帮助

recommendation-more-help
experience-platform-help-sources