Threads 數據後台太陽春？行銷人學會串 API，不會程式也能輕鬆打造自動化報表！|經理人

如果你是行銷人，一定已經開始使用 Threads 來經營品牌，然而，與 Instagram 或 Facebook 相比，Threads 的後台功能相對簡陋，目前甚至沒有提供貼文數據查詢或下載功能，對社群經營者來說，會面臨 2 個大問題：

想查看歷史貼文表現，得一篇一篇點開看。
要製作成效報告，需要人工整理多個數據。

但每天處理其他庶務的時間都不夠，怎麼會有時間整理這些繁瑣的數據？因此此篇文章將教你如何利用 Meta 提供的 Threads API，自己打造一個自動化報表系統。這樣做有以下好處：

完全客製化：只擷取你真正需要的數據。
省時又高效：省去翻找報表的麻煩，輕鬆掌握精準數據。

即便日後 Meta 提供 Threads 的數據分析工具，在你了解如何透過 API 自己串接資料後，就能省去翻找報表的時間，只抓你想看的數據出來。

什麼是 API ?

API 就像外送平台，而你是訂餐的顧客，當你在外送平台下單時，外送平台（API）會把你的需求傳達給餐廳（系統後台），餐廳會準備餐點（數據結果），再由外送員（API）送到你面前。因此只需要將數據需求送出，API 就會幫忙拉出資料。

實作前，先認識 Threads API 文件可取得哪些資料

Threads API 提供豐富的數據分析功能。在開始實作前，建議先了解可收集的數據類型及其定義。例如在 Threads Insights API 中，你可以取得以下常見的貼文數據：

觀看數
互動回覆數
分享數

在使用 Threads API 時，請注意以下重要限制：

2024年6月1日前的使用者數據分析功能不保證可靠性。
無法查詢 2024年4月13日之前的歷史數據。
只有粉絲數達到 100 人以上的帳號才能使用數據分析功能。

首先，需要先完成基本前置作業

第一步：設定 Meta 應用程式

前往 Meta for Developers，使用你的 Facebook 帳號登入，如果還沒有開發者帳號，流程中會引導你完成帳號註冊。

登入後，建立新應用程式：
1.在首頁點擊右上角的「建立應用程式」按鈕。

2.填寫應用程式名稱（例如：Threads_品牌名稱）。
3.填寫聯絡信箱：使用你的主要聯絡信箱。

4.新增使用案例：選擇「存取 Threads API」。
5.選擇想連結應用程式到哪個商家資產管理組合：可選擇企業帳號或選擇不想連結。

然後，進入應用程式主控版：
1.點擊右側欄位「主控版」，存取 Threads API 並新增以下權限：

threads_basic
threads_manage_insights
threads_read_replies

2.點選右側欄位「應用程式角色」新增用戶：將想要拉出數據的 Threads 帳號加進來，並到 Threads 帳號裡面「授權網站權限」。

3.點選右側欄位「測試」：點選「測試使用案例」，並開啟「圖形 API 測試工具」，將網址切換到 Threads.net 後 Generates Threads Access Token，再按提交，看是否能正常跑出資料，如都正常，則已完成初步設定。

第二步：取得存取權杖（Access Token）

先理解 Token 是什麼？
Token 就像是一張門禁卡，當你要進入大樓時，需要刷門禁卡來確認你的身份，在使用 API 時，Token 就是你的門禁卡，它告訴 API 這個請求是來自經過授權的使用者，因此需要好好保存！
不要傳給他人或在網路上分享！Token 是你的「通行證」，拿到的人就能「假冒」你、使用你的權限，比如輸出機密數據、刪除貼文等等！

什麼是長期＆短期 Token？

短期 Token 就像是一張期限很短的門禁卡，可以讓你進入某處，但過期後需要重新申請，適合臨時使用或測試。
長期 Token 則是期限較長的門禁卡，功能與短期 Token 一樣，但省去頻繁更新的麻煩，更適合需要長期運作的場景，例如自動化數據撈取。

取得長期 Token 有兩個步驟：

1. 先取得短期 Token

a. 先取得「應用程式密鑰」
i. 進入應用程式主控板，點選「應用程式設定」- 「基本資料」後，下滑找到 Threads 應用程式密鑰欄位並點擊「顯示」，此串代碼即為應用程式密鑰。

b. 再取得「短期 Token」
i. 進入此串網址：https://developers.facebook.com/tools/explorer/。
ii. 右側 Meta 應用程式選擇剛建立的應用程式。
iii. 將左側的網址切成 threads.net。
iv. 點擊「 Generates Threads Access Token」，上方的存取權杖即為短期 Token。
備註：若先前已經在基礎設定時完成圖形 API 測試，那當時產出的存取權杖即為短期 Token。

c. 將以下 URL中的 <你的應用程式密鑰> 和 <短期 Token> 位置填入相應內容，再將完整的 URL 貼到瀏覽器網址欄中執行，就會看到一個長期 Token。

2. 將短期 Token 換成長期 Token

a. 將剛剛取得的短期 Token 填入以下網址中的 <剛才網頁上取得的TOKEN>，並將完整的 URL 貼到瀏覽器中執行。

完成以後先將整串長期 Token 筆記下來，等等串接 API 時會用到！ 也再次提醒，不要傳給他人或在網路上分享！

接下來，兩個步驟完成 Threads API 串接

第一步：透過 AI 產出 Google Apps Script 所需指令

以撈貼文數據為例，假設理想中的流程是：
透過 Google Sheets 自動匯入 Threads 資料，並能選定特定日期區間的數據。

指令就可以這樣下（可依照需求修改）：

○ 概述需求：
幫我生成一段 Google Apps Script 指令，從 Threads API 中拉出特定日期範圍的貼文數據。

○ 需要匯入的數據：
從 Threads API 中擷取以下數據：

貼文 ID
貼文發布時間
貼文內容
觀看數
按讚數
回覆數
轉發數
引用數
分享數

○ 程式碼需要包含以下功能：

增加前台執行選單，選項包括擷取數據。
用戶輸入日期範圍（格式為 YYYY/MM/DD - YYYY/MM/DD）後，程式會根據日期範圍，篩選貼文並擷取數據。
將數據匯入 Google Sheets，包含標題列（如貼文 ID、觀看數等）並自動格式化欄位（例如數字格式）。

○ 參數設定：
程式碼須包含以下參數，確保執行過程順利。

ACCESS_TOKEN：用於 API 驗證的 Token。
USER_ID：Threads 帳號的使用者 ID。
SPREADSHEET_ID：Google 試算表的 ID。
APP_SECRET：API 應用程式密鑰。

第二步：將指令放入 Google Sheet 裡面

完成後，你會得到類似下圖的指令：

（備註：圖片僅為示意，非完整程式碼）

打開 Google Sheets 中的「擴充功能」並選擇 App Script ，並將 ChatGPT 提供的程式碼貼上。

將需要替換的參數貼上後儲存，按下執行並授權權限，跑出數據的話就成功了！

參數怎麼替換？

ACCESS_TOKEN
填入剛剛設定的長期 Token。
USER_ID
填入前面測試圖形 API 時跑出的 ID。
SPREADSHEET_ID
填入 Google Sheets 網址中的試算表 ID （https://docs.google.com/spreadsheets/d/<試算表 ID>/edit ）。
APP_SECRET
填入 Meta for Developers 裡，應用程式設定 -> 基本資料 -> Threads 應用程式密鑰。

無法正常新增前台執行選單？
需要注意變成函式（function）後的程式碼如何顯示，例如「新增 Google Sheets 選單」的函式為「onOpen() 」，需要確認確實為相對應的函式後再按下執行，否則會無法新增成功！