跨平台總覽

整合各大平台核心經營數據

AI 數據摘要
YouTube 訂閱者
-- --
本週新增: --
Instagram 粉絲
-- --
本週新增: --
Twitch 追隨者
-- --
本週新增: --

全平台粉絲成長趨勢

多週跨平台數據對比折線圖

歷史週次數據總覽

以週次為單位之各平台核心追隨指標

週次 YT 訂閱 YT 觀看率 IG 粉絲 IG 互動率 IG 觸及→追蹤 Twitch 追隨 Twitch 轉換率 三平台總和
總訂閱人數
--
週末累計訂閱數
影片觀看（7天）
--
本週影片 7天加總
Shorts 觀看（7天）
--
本週 Shorts 7天加總
新觀眾比
-- %
未訂閱者觀看佔比
平均觀看比例
-- %
頻道整體留存率

YouTube 週訂閱成長趨勢

各週新增訂閱數與新觀眾比對照

個別影片 / Shorts 成效

本週發佈之影片與 Shorts 追蹤數據（資料由 Google Sheets 自動同步）

影片名稱 類型 片長 觀看數 平均觀看% 帶來訂閱
粉絲總數
--
帳號追隨規模
貼文與Shorts觀看數(發佈後7天)
--
曝光熱度指標
觸及人數
--
去重複曝光對象人數
互動數
--
互動率: 0%

受眾性別比例

當週男女性讀者比率分析

觀看與互動關聯趨勢

多週播放數與讀者按讚留言關聯性

本週貼文 / Reels 明細

數據來源：Instagram Graph API 自動抓取 → Google Sheets「IG貼文明細」工作表

日期 標題 觀看數 按讚 觸及人數
追隨者數
--
本週新增：--
訂閱人數
--
T1 -- T2 -- T3 --
訂閱估算月收入
-- USD
依訂閱層級估算（T1×$2.5 / T2×$5 / T3×$12.5）
Bits 收入
-- bits
≈ $-- USD（CSV 匯入）
直播觀看數
--
本週 VOD 累計觀看
不重複觀眾
--
CSV 匯入
峰值觀眾
--
本週各場最高值
平均觀眾
--
聊天熱度：0%
直播總時數
--
本週開台時間
不重複聊天
--
有發言觀眾人數

不重複觀眾 vs 直播觀看人次

檢視粉絲黏著度與擴散效果

每場直播紀錄

數據來源：Google Sheets「Twitch直播明細」工作表（透過 GAS 匯入 CSV 自動更新）

日期 開播 主題 時數 觀看數 不重複觀眾 最高觀眾 平均觀眾 不重複聊天 操作

影片7天成效追蹤

每支影片發布後第7天的累計數據，由 GAS 每日自動抓取

週次 發布日期 主題 類型 片長 7天觀看 平均觀看% 帶來訂閱

尚無追蹤數據。
請先在 GAS 執行 testVideoTracking() 匯入初始數據，
之後每天會自動更新。

Google Sheets 試算表串接

數據來源已設定，由管理員統一維護

已連接 Google Sheets 試算表與 Apps Script
上次同步：尚未同步

數據由 Google Apps Script 自動更新，每次開啟網頁時自動同步

本地快取管理

清空瀏覽器快取（真實數據請從 Google Sheets 重新同步）

每週例行工作流程

建議在每週固定時間（例如週一）確認以下步驟
  1. YouTube 全自動。GAS 每日 09:00 自動追蹤影片 7 天觀看數；每週一 10:00 寫入訂閱數、新觀眾比例至「週數據」。確認 API設定 中 youtubeChannelId 已填寫且觸發器啟用即可。
  2. Instagram 全自動。GAS 每日 09:15 追蹤 Reels 7 天觀看里程碑；每週一 10:00 抓取粉絲數、週觸及、互動數，並將 Reels 7 天觀看數聚合寫入「週數據」。首次需完成 IG API 初始設定（見下方）。
  3. Twitch 追隨數全自動（每日 09:30）。直播明細需手動：前往 Twitch 數據中心 匯出 CSV，貼入「Twitch匯入CSV」工作表後執行 importTwitchStreamCsv()。
  4. 儀表板 前往「數據管理與設定」→ 點擊 「立即從試算表更新數據」 同步最新數據至儀表板。

GAS 函式說明

在 Google Sheets → 擴充功能 → Apps Script 中執行
函式名稱用途執行時機
fetchSocialMetrics() 每週主函式。抓取 YouTube 訂閱/觀看、Instagram 粉絲/觸及/互動、Twitch 追隨數，寫入「週數據」對應週次；結束後自動呼叫 aggregateIgPostsToMainSheet() 每週一 10:00 自動觸發；或手動執行
trackDailyIgReelsPerformance() 抓取近 15 天內的 Reels，記錄每日觀看數至「IG貼文明細」，第 7 天結算為「7天」里程碑 每日 09:15 自動觸發
aggregateIgPostsToMainSheet() 從「IG貼文明細」彙總各週 Reels 7 天觀看數，寫入「週數據」的「IG貼文Reels觀看7天」欄 由 fetchSocialMetrics 自動呼叫；或手動執行修正
backfillInstagramData() 補抓 IG 歷史貼文資料（預設 90 天），填入「IG貼文明細」，結束後自動呼叫 aggregateIgPostsToMainSheet() 首次部署後手動執行一次
importTwitchStreamCsv() 讀取「Twitch匯入CSV」工作表，解析後寫入「Twitch直播明細」，並自動重算「週數據」W～AA 欄 每次匯入 Twitch 直播 CSV 後手動執行
aggregateStreamsToMainSheet() 重新從「Twitch直播明細」計算各週聚合值，寫入「週數據」 資料修正後手動執行；或由 importTwitchStreamCsv 自動呼叫
refreshVideoViewsForWeek() 重新計算指定週次的 YT 影片/Shorts 觀看數並寫回「週數據」（不填參數自動抓上週）。用於修正觸發器時序導致的 0 值 YT 觀看數顯示 0 時手動執行
refreshIgAccessToken() 刷新 IG Access Token（60 天過期，執行後自動寫回 API設定） 每月 1 日 08:00 自動觸發；或 Token 即將過期時手動執行
installDailyTrigger() 重設所有觸發器：① 09:00 YT 影片追蹤 ② 09:15 IG Reels 追蹤 ③ 09:30 Twitch 追隨 ④ 週一 10:00 週摘要 ⑤ 每月 1 日 IG Token 刷新 首次部署或觸發器異常時手動執行一次
getIgUserIdHelper() ★ 首次設定：查詢並寫入 Instagram User ID（igUserId）。需先填入 igAccessToken 首次設定 IG API 後執行一次

IG API 初始設定（一次性）

完成後 IG 數據即可全自動抓取，無需每週手動
  1. 前往 developers.facebook.com/apps，點擊「建立應用程式」→ 選擇「Business」→ 填入名稱 → 建立。
  2. App 設定頁面左側「產品」→ 點擊「Instagram Graph API」→「設定」加入。
  3. 前往 Graph API Explorer，選取應用程式 → 產生 Access Token，勾選權限：
    • instagram_basic
    • instagram_manage_insights
    • pages_show_list
    • pages_read_engagement
  4. 前往 Access Token Debugger → 「Extend Access Token」取得 長效 Token（60天）。
  5. 開啟 Google Sheets → 「API設定」工作表，填入：
    設定項目填入內容
    igAccessToken步驟 4 的長效 Token
    igAppIdApp 設定頁的「應用程式 ID」
    igAppSecretApp 設定頁的「應用程式密鑰」
    igUserId下一步自動填入，先留空
  6. Apps Script 執行 getIgUserIdHelper()，成功後 igUserId 自動寫入。
  7. 執行 backfillInstagramData() 補抓歷史資料。
  8. 執行 installDailyTrigger() 啟用所有自動觸發器。完成！
Token 有效期：長效 Token 60 天，GAS 每月 1 日自動刷新。若意外過期（超過 90 天），需重新至 Graph API Explorer 取得新 Token 填入 igAccessToken。

Twitch 直播 CSV 匯入步驟

從 Twitch 數據中心下載 CSV 並匯入試算表
  1. 前往 Twitch 數據中心 → 直播分析，選取日期區間 → 匯出 CSV。
  2. 開啟 Google Sheets → 切換至「Twitch匯入CSV」工作表 → 清空原有內容 → 貼上 CSV 原始文字。
  3. Apps Script 執行 importTwitchStreamCsv()。
  4. 執行完成後「Twitch直播明細」更新，「週數據」W～AA 欄自動重算。
  5. 回到儀表板 →「數據管理與設定」→「立即從試算表更新數據」完成同步。
CSV 需包含：開始時間、標題、時數、VOD觀看數、不重複觀眾、峰值觀眾、平均觀眾、不重複聊天、VOD ID。欄位名稱如有差異，請對照 GAS 的 TWITCH_CSV_HEADERS 常數調整。

Google Sheets 工作表結構

各工作表說明與欄位對應
週數據（社群數據庫）
主資料表，每列代表一週。欄位：週次（A）、YouTube（B～F）、Instagram（G～M，含 IG貼文Reels觀看7天）、Twitch 追隨訂閱收入（N～V）、Twitch 直播聚合（W～AA）。YT、IG、Twitch 追隨由 GAS 自動更新；Twitch 直播聚合需手動匯入 CSV 觸發。
IG貼文明細
每列代表一則貼文或 Reels，欄位：週次、日期、標題、類型、觀看數、按讚、觸及、媒體ID、里程碑（「進行中」→ 第 7 天結算為「7天」）。由 trackDailyIgReelsPerformance() 每日自動更新，以「媒體ID」去重。
影片追蹤
追蹤每支 YouTube 影片發布後 7 天的成效。由 trackDailyVideoPerformance() 每日 09:00 自動更新觀看數、平均觀看比例，第 7 天結算里程碑。
Twitch直播明細
每列代表一場直播，欄位：週次、日期、開始時間、標題、時數、VOD觀看、不重複觀眾、峰值觀眾、平均觀眾、不重複聊天、VOD_ID。由 importTwitchStreamCsv() 自動填入。
Twitch匯入CSV
暫存 Twitch 原始 CSV 內容。每次匯入前先清空，貼上新 CSV 後執行 GAS 函式即可。
API設定
儲存所有 API 金鑰與帳號 ID：youtubeChannelId、igAccessToken、igUserId、igAppId、igAppSecret、Twitch Client ID / Secret。

常見問題

排查數據異常的快速指引
Q：YouTube 影片觀看數 / Shorts 觀看數顯示為 0？
觸發器時序問題：fetchSocialMetrics 週一凌晨執行時，部分影片尚未完成 7 天追蹤。修正方式：等 trackDailyVideoPerformance 執行後，手動執行 refreshVideoViewsForWeek()（不填參數自動抓上週），再到儀表板點「立即從試算表更新數據」。
Q：IG Reels 觀看數顯示為 0 或沒有更新？
① 尚未補歷史資料：執行 backfillInstagramData() 補抓過去 90 天資料。
② Token 過期：手動執行 refreshIgAccessToken()；超過 90 天需重新至 Graph API Explorer 取得新 Token。
③ 觸發器未設定：執行 installDailyTrigger() 重設所有觸發器。
排查：Apps Script 手動執行 fetchSocialMetrics() 後查看「執行紀錄」。
Q：儀表板數據沒有更新？
點擊「立即從試算表更新數據」。若顯示錯誤，請確認 GAS 已重新部署（新版本）且部署設定為「任何人皆可存取」。
Q：直播週次顯示錯誤？
GAS 使用 UTC 正午計算 ISO 週次，避免台灣時區跨日誤算。若舊資料有誤，直接在「Twitch直播明細」手動修改週次欄位後，執行 aggregateStreamsToMainSheet()。
Q：如何新增新的週次？
在「週數據」工作表末尾新增一列，填入週次（格式 2026-W25），儲存後儀表板點「立即從試算表更新數據」即可。GAS 觸發後會自動補齊各平台數據。
Q：如何設定 / 重設所有自動觸發器？
在 Apps Script 執行 installDailyTrigger()，會刪除所有舊觸發器並重新建立：
① trackDailyVideoPerformance：每日 09:00，YT 影片 7 天追蹤
② trackDailyIgReelsPerformance：每日 09:15，IG Reels 7 天追蹤
③ trackDailyStreamPerformance：每日 09:30，Twitch 追隨更新
④ fetchSocialMetrics：每週一 10:00，全平台週摘要
⑤ refreshIgAccessToken：每月 1 日 08:00，IG Token 自動刷新
Q：「✨ 生成摘要」按鈕沒有反應或報錯？
AI 摘要功能使用 Groq API（Llama 3.3 70B）。若出現錯誤請確認網路連線正常。免費 tier 每分鐘 30 次請求，一般使用不會超限。選取 3 週以上區間時會自動加入 SWOT 分析。