TikTok For Business 数据连接器

关注
Avatar
Vaibhav Gupta
Updated
设置 TikTok For Business
成本聚合
设置数据连接器

 

了解 Singular 如何从 TikTok For Business 提取广告成本数据并在您的报表中展示。在 Singular 仪表板中，TikTok For Business 的来源显示为 TikTok Ads。

快速详情

数据连接器技术 API (TikTok marketing API v. 1.3)
数据分类（细分） 您的数据按以下维度进行分类：
  • 平台 
  • 国家（默认）
  • 广告版位
  • DMA
重要提示： 如需使用国家以外的分类维度，请联系 Singular 支持团队。 由于 TikTok API 的限制，我们无法在广告系列层面提取多个分类维度的数据。

如果您不使用国家分类维度，单一定向的广告系列会显示国家值，而多重定向的广告系列将显示为 "N/A"，除非我们能够根据归因数据进行估算。 估算数据可能与 TikTok 的数据不一致。请参阅 "每个国家的成本是如何计算的？"
我们从多长时间前提取数据 7 天
时区 该账户在 TikTok 中配置的时区
创意（广告）层面的数据可用吗？ 是
Singular 是否会显示您的创意资产？ 是

数据映射

提示： 有关 Singular 报表中任何字段的更多信息，请参阅 指标与维度术语表。此外，您还可以查看 TikTok 的广告系列功能与其报表 API 字段的映射关系： 点击此处。

Field in Singular UI Field in Singular API Field in TikTok API
Dimensions
Account ID adn_account_id (Taken from [advertiser/info])
Account Name adn_account_name advertiser_name
App app app_name
App Site ID app_site_id (Taken from the [app_download_url])
Bid Type bid_type bid_type
Campaign Objective campaign_objective objective_type
Campaign Status campaign_status opt_status
Campaign URL adn_campaign_url landing_page_url
Country country_field location
Date date_field stat_time_day
DMA ID dma_id_field dma.id
DMA Name dma_name_field dma.name
Network Campaign ID adn_campaign_id campaign_id
Network Campaign Name adn_campaign_name campaign_name
Network Creative ID adn_creative_id ad_id
Network Creative Name adn_creative_name ad_name
Network Sub Campaign ID adn_sub_campaign_id adgroup_id
Network Sub Campaign Name adn_sub_campaign_name adgroup_name
Original Bid Amount original_bid_amount bid
Original Bid Currency original_metadata_currency currency
Platform platform
  • platform
  • app_type (If platform is empty)
  • operating_system (If both are empty)
Public Id site_public_id mobile_app_id
Region
 		region_field
 		region.name (State or Province; displayed if sub-campaign targets a single region)
Standardized Bid Type standardized_bid_strategy optimize_goal
Timezone adn_timezone timezone
Text creative_text ad_text
TikTok - Campaign Automation Type tiktok_campaign_automation_type campaign_automation_type
TikTok - SmartPlus Ad ID tiktok_smartplus_ad_id ad_id_v2 / smart_plus_ad_id
TikTok - SmartPlus Ad Name tiktok_smartplus_ad_name ad_id_v2 / smart_plus_ad_id
TikTok - Post ID tiktok_post_id post_id
Age age age
Gender gender gender
Metrics
Comments comments comments
Likes likes likes
Network Clicks adn_clicks clicks
Network Impressions adn_impressions impressions
Network Installs adn_installs

real_time_conversion

(backup option: app_installs)

Note: If app_installs is configured as the default Network Installs metric, the Country dimension may not be available in the Audience Report.

Original Cost adn_original_cost stat_cost
Original Currency adn_original_currency currency
Page Follows
 		page_follows follows
Shares
 		shares shares
Video Views video_views total_play
Video Views - 25% video_views_25pct play_first_quartile
Video Views - 50% video_views_50pct play_midpoint
Video Views - 75% video_views_75pct play_third_quartile
Completed Video Views completed_video_views play_over

Singular 也支持提取此合作伙伴的广告系列属性， 请点击此处查看更多详情。

设置说明

设置步骤

要设置 TikTok For Business 数据连接器：

  1. 在您的 Singular 账户中，前往 Settings > Data Connectors。

    screenshot--2019.08.11-12-54-10.png

  2. 点击 Add New Connector 并开始输入 "TikTok"。从出现的列表中选择 "TikTok Ads"。

    Screen_Shot_2021-03-02_at_17.09.53.png

  3. 在打开的配置窗口中，点击 Sign In with TikTok 并登录您的 TikTok For Business 账户。

    Screen_Shot_2021-03-02_at_17.11.10.png

  4. TikTok 平台会询问您是否要授予 Singular 访问 TikTok 数据的权限。勾选 Agree to the Platform Service Agreement 复选框，然后点击 Confirm。

    Screen_Shot_2021-03-02_at_17.20.30.png

  5. 授予权限后，Singular 中的配置窗口会显示您已连接。此时可以关闭该窗口。

  6. 现在 TikTok 会出现在数据连接器列表中。在 Singular 执行首次数据提取期间，数据连接器状态为 "Pending"。首次数据提取完成后，状态将变为 "Active"。

    Screen_Shot_2021-03-02_at_17.31.58.png

  7. 数据连接器成功将数据提取到 Singular 后，您就可以运行包含 TikTok 数据的报表。更多信息，请参阅 报表常见问题、 Singular API 参考、或 Singular 数据目的地常见问题。

    报表示例：

    Screen_Shot_2021-03-02_at_17.49.17.png

其他指标（转化事件）

Singular 从 TikTok For Business 指标列表中提取指标。默认情况下，常规事件从 "in-app events metrics" 部分提取， SKAdNetwork 事件从列表的 "Supported SKAN Metrics" 部分提取。除此之外，您还可以通过在 Singular 中创建转化事件来提取任何指标。

要创建转化事件：

  1. 在 Singular 中，前往 Settings > Events。如果同时存在 Custom Events 和 Conversion Events 两个标签页，请选择 Conversion Events。
  2. 点击 New Event。

  3. 在 TikTok Ads 下拉菜单中选择所需的指标。

    第二天，当 Singular 提取您账户的每日数据时，也会一并提取完成数。

  4. 在新事件填充了一些数据后，在 Reports 页面中运行报表，并从 Events 下拉菜单中选择您创建的转化事件。

screenshot-docs.google.com-2021.11.24-16_28_51.png

TikTok Upgraded Smart+ 广告系列

随着 TikTok 不断完善其自动化产品组合，我们正在更新报表功能，以便全面呈现 Upgraded Smart+ 广告系列结构。TikTok 正在从 Smart Campaigns （即将停用）迁移到 Upgraded Smart+ 模式。

此次更新的主要目标是在这些新的自动化类型中兼顾细分数据与合并数据。

有哪些变化？

为支持此次迁移，我们将从 2026 年 3 月起新增以下报表字段：

  • TikTok - Campaign Automation: 此字段用于标识所使用的自动化逻辑，将广告系列分类为 Manual、 Smart或 Upgraded Smart+。
  • TikTok - Upgraded Smart+ Ad ID & Name: 这些字段代表位于创意之上的新报表层级。该层级充当多个创意的容器。

注意： Upgraded Smart+ Ad ID 和 Name 仅为 网络侧字段。虽然这增加了一个新的结构层级，但您的 创意数据 仍将继续合并，以确保全面的效果追踪。