文件Experience Platform來源連接器指南

[Beta]{class="badge informative"}

TikTok Ads

最後更新： 2026年10月9日

建立對象：

  • 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
Campaign
paidMedia.campaignID
廣告群組
paidMedia.adGroupID
廣告
paidMedia.adID
資產
paidMedia.assetID

疑難排解

使用下表來疑難排解TikTok Ads來源的常見問題。

問題
原因
連線成功，但沒有廣告商帳戶可供選取。
授權TikTok使用者沒有任何廣告商帳戶的廣告管理存取權，或應用程式尚未完成業務驗證。 在TikTok for Business Developer Portal中檢查應用程式狀態。
資料流會執行，但資料不會進入資料集。
應用程式可能仍處於沙箱稽核狀態。 即使連線本身成功，TikTok在應用程式通過檢閱之前不會傳回生產資料。
回填作業在中途失敗，並出現速率限制錯誤。
應用程式的預設費率限制層級對於請求的日期範圍太低。 在執行大型回填之前，請先要求從TikTok提高速率限制。
特定量度劃分（例如資產效能）傳回的列數少於預期或錯誤。
並非每個報告維度組合都支援每個量度。 在生產環境中依賴測試廣告商帳戶之前，請驗證受影響的劃分。

後續步驟

在您確認擁有包含現有行銷活動和廣告的合格TikTok廣告商帳戶後，請使用UI🔗繼續將TikTok Ads連線至Experience Platform。

有關此主題的更多說明

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