一、集成方案介紹

概要

本文介紹將 TikTok for Business 數據回傳到本地數據庫的方案，該方案支持：

通過 Report API 獲取小時/天級別的聚合數據，其中包含展示、點擊、轉化和成本數據。指標數據既可以按照廣告維度進行分組聚合，也可以按照客戶羣體的特徵進行聚合分組

流程

在對接階段需要您做的事情有：

• 獲取 TikTok APP_ID，Secret 和廣告主 ID (廣告賬號 ID)，登錄用戶ID，並將相關信息寫入數據庫；
• 在 TikTok 後臺配置回調地址、設置授權 URL 並完成授權；

二、 集成前準備工作

2.1 註冊開發者賬號創建 TikTok 應用

1. 首先，您需要訪問 Tiktok API Business 頁面，需要登錄或註冊一個TikTok 廣告賬號
2. 接下來，按照步驟註冊成爲開發者
3. 註冊成爲開發者後，您需要創建一個應用，如下圖所示。創建時的參數，可以按如下方式配置：

• App Description：項目描述，可以添加一些備註信息
• Callback Address：回調地址，在創建時可以填寫您的公司官網或 https://www.google.com，之後再改爲你自己設定好的數據回調地址
• Scope of Permission：可訪問的數據權限，此處請務必選擇 Reporting 權限，其他權限按需配置

4. 點擊「Confirm」確認後，您的應用最初將處於待定狀態。大約一到兩天左右，應用可以通過審覈（即狀態爲 Approved）。獲取您應用的 App ID 和 Secret，注意App ID和Secret要保存好

2.2 獲取 Access Token

拿到Tiktok APP ID 和 Secret 之後，創建好回調地址。登錄 Tiktok 後臺，進入「My Apps」頁面並選中您需要接入的項目，在藍框填入回調地址，接下來將紅框中的 URL 複製下來：

接着，將剛剛複製的地址粘貼到瀏覽器中，並打開：

打開後會跳轉到一個授權頁面，頁面上顯示了你申請的權限列表，單擊「Confirm」確認：

之後將會跳轉到一個新頁面，此時建議您將瀏覽器地址欄中的 auth_code 部分複製下來（如下圖所示），用來獲取 Access Token 。

2.3 確認一下所獲取的信息

此處總結了中您需要提供的所有信息：

• Tiktok 項目的 App ID 以及 Secret
• 廣告賬戶 ID
• 授權碼 auth_code

三、TA 服務器數據拉取

目前我只拉回了 Tiktok Marketing API 的「Basic Report」以及「Audience Report」兩種數據類型，以下我所熟悉的Tiktok Marketing API 的基本信息，應該可以覆蓋大部分的數據和應用場景

接口基本信息

3.1基本報告

Basic Report 提供了廣告維度的聚合分組，返回數據中涵蓋展示、點擊、轉化、買量成本等一系列指標數據。

3.1.1 聚合維度

Basic Report 提供了以下聚合維度，請注意，Basic Report 僅可以選擇一個廣告維度以及一個時間維度，如果需要按國家（地區）分組，則只能使用 country_code 這一個維度：

注意，不同的廣告維度能夠獲取到的指標字段以及支持的篩選條件不同，請務必注意返回字段以及篩選中的備註信息，瞭解您所選用的廣告維度的數據能力。

3.1.2 指標字段

Basic Report 支持的指標非常豐富，本章節僅展示最爲常見的屬性指標以及基礎指標，如果想要了解完整的指標列表，請參考 TikTok 的指標列表。

3.1.3 接口參數

• 時間：
  • 拉取的時間是以天爲單位，以廣告主設置的時區爲查詢時區的。當時間聚合粒度爲天時，查詢時間範圍不能超過 30 天，當時間聚合粒度爲小時，查詢時間範圍不能超過 1 天。
• 廣告服務類型：
  • Tiktok 的廣告服務類型分爲競價廣告和品牌廣告（也成爲合約廣告）兩種，目前 TA 僅支持競價廣告（即廣告服務類型爲 auction）的數據接入
• 廣告賬號：
  • 拉取數據時必須要提供廣告賬號 ID

3.1.4 入庫數據結構

• 由於 Tiktok Marketing API 返回的是聚合數據，因此我將使用一個固定值作爲該數據的用戶標識，你可以認爲所有數據掛載在一個虛擬用戶上
• 我們將使用數據中的 stat_time_day 或 stat_time_hour 字段，作爲聚合數據的 #event_time
• 數據的事件名爲 — tiktok_marketing_api_data

3.2聽衆報告

Audience Report 相比 Basic Report，提供了更多用戶的聚合分組維度（被稱爲受衆維度），但返回的指標種類相對較少，並且存在 6-12 小時的處理延遲。

3.2.1 聚合維度

Audience Report 提供了以下聚合維度，

請注意，Audience Report 僅可以選擇一個受衆維度、一個廣告維度以及一個時間維度，其中受衆維度是必選的，其他兩種維度可選。也存在部分特例，請從下表備註欄中獲得更多信息。

另外，如果需要按國家（地區）分組，則只能使用 country_code 這一個維度：

3.2.2 指標字段

Audience Report 支持的指標相比 Basic Report 會少一些，但是常見的屬性指標以及基礎指標都是支持的。

3.2.2 指標字段

Audience Report 支持的指標相比 Basic Report 會少一些，但是常見的屬性指標以及基礎指標都是支持的。

3.2.3 接口參數

• 時間：
  • 拉取的時間是以天爲單位，以廣告主設置的時區爲查詢時區的。當時間聚合粒度爲天時，查詢時間範圍不能超過 30 天，當 時間聚合粒度爲小時，查詢時間範圍不能超過 1 天。
• 廣告服務類型：
  • Tiktok 的廣告服務類型分爲競價廣告和品牌廣告（也成爲合約廣告）兩種，目前 TA 僅支持競價廣告（即廣告服務類型爲 auction）的數據接入
• 廣告賬號：
  • 拉取數據時必須要提供廣告賬號 ID

3.2.4 入庫數據結構

• 由於 Tiktok Marketing API 返回的是聚合數據，因此我將使用一個固定值作爲該數據的用戶標識，你可以認爲所有數據掛載在一個虛擬用戶上
• 我們將使用數據中的 stat_time_day 或 stat_time_hour 字段，作爲聚合數據的 #event_time
• 目前默認事件拉取緯度請參照以下表格，您可以選擇您需要的緯度事件入庫：

四、數據集成配置信息模板

在閱讀完以上文檔之後，建議您完成以下信息模板，完成 TikTok Marketing API 的數據拉取：

数据接收地址 push_url：XXX
---------
Tiktok 项目的 App ID：xxx
Tiktok 项目的 Secret：xxx
授权码 auth_code：xxxx
广告主 ID (advertiser_ids）列表：XXX
---------
数据类型：[Basic Report/Audience Report]
聚合维度：xxx, xxx
获取指标：xxx, xxx
历史数据拉取时间范围：yyyy/mm/dd - yyyy/mm/dd（仅支持拉取按天聚合的近一个月的数据）
定时拉取时间：xxx

五、問題解答

在對接任何廣告平台API時，若遇到無論是棘手的技術或者產品問題，歡迎聯繫我幫你解答，查看我的履歷

姓名 *

Email *

留言

Submit