
先整理參與者提供且已核對的貼文連結,以及可取得的帳號擁有者報表。你可以用試算表建立這些資料表。公開資料收集工具能提供公開觀測資料,但身分、帳號連結關係及報表統計範圍,都須由你自行核對。
先決定各項總計的意義
統計單位是指一列資料或一項總計所代表的對象。這套方法使用三種統計單位:
| 統計單位 | 代表的對象 | 計算方式 |
|---|---|---|
| 不重複的活動貼文 | 一則已核對的內容 | 每篇貼文計算一次 |
| 帳號參與關係 | 一項已確認的帳號與貼文連結關係 | 每項已確認的連結關係計算一次 |
| 帳號擁有者成效 | 帳號自身報表中的一項成效 | 依報表所列的統計範圍與日期計算 |
一篇共同發布貼文在第一張表中只占一列,在第二張表中則可有多項連結關係。這兩種總計的意義不同,兩者都不是人數。
Instagram 洞察報告是指透過帳號自身報表存取權限取得的統計資料。請將這些紀錄保存在獨立檢視中。不要假設所有協作者都能存取或匯出相同的報表。
提供的公開提問顯示了區分這些統計單位的重要性。其中一則詢問協作貼文的洞察報告。另一則詢問:若帳號不是貼文的最初發布者,該貼文是否會計入該帳號的分析資料。這些是讀者的問題,不能證明目前的存取規則。請參閱協作貼文洞察報告提問及協作貼文分析提問。
請依帳號的實際情況確認存取權限。製作活動報表時,先確認每份報表描述的是哪篇貼文,以及其中數字衡量的是什麼。
建立活動貼文與帳號資料表
活動明細表用來記錄活動中已核對的貼文。請根據活動清單建立明細表。活動清單應列出預期納入的貼文及參與帳號。
- 收集參與者提供的貼文連結。
- 保留每個原始連結及其來源。
- 核對哪些連結指向同一篇貼文。
- 記錄可證明各帳號與該貼文有關的現有證據。
- 將尚未確認的連結關係保存在待審查表中。
不要只因顯示名稱相似,或兩個個人檔案的貼文格狀版面出現相同內容,就認定它們是協作貼文。僅憑外觀相似,無法確認是否為同一篇共同發布貼文。
若有穩定的貼文識別碼,請使用該識別碼。公開輸出文件將此欄位稱為 `postId`。也請在 `postUrl` 中保留已核對的貼文網址。若缺少識別碼,請保留來源連結,並將貼文身分標記為待審查。不要自行編造平台識別碼,也不要合併尚未確認的資料列。
請建立以下兩張表。表名及審查欄位是建議使用的試算表欄位。Actor 不會替你建立這些表。
| 資料表 | 應保存的欄位 | 資料列規則 |
|---|---|---|
| 貼文 | `postId`、`postUrl`、原始提供連結、活動參照、身分證據參照、審查狀態 | 每篇已核對的不重複貼文占一列 |
| 參與關係 | `postId`、已確認的帳號 ID、帳號使用者名稱、已知角色、證據參照、審查狀態 | 每項已確認的帳號與貼文連結關係占一列 |
| 待釐清關係 | 提供的貼文連結、聲稱參與的帳號、現有證據、待釐清問題 | 每項尚未確認的關係都不納入已確認總計 |
證據參照指向支持某項判定的來源。它可以指向已保存的公開觀測資料,或可取得的協作確認資料。請保留足夠的細節,讓其他分析人員能核對這項關係。
帳號使用者名稱是帳號公開使用的名稱。若有已核對的帳號 ID,請使用該 ID,不要只使用顯示名稱。若創作者清單中有重複的個人檔案紀錄,請另參閱 Instagram 個人檔案身分指南。先處理帳號身分問題,再將該清單用於此處。
不要為了讓資料表一致而刪除待釐清的關係。請明確列出缺口。已確認的貼文可以保留在「貼文」表中,同時讓某項聲稱存在的帳號關係繼續等待證據。
收集已知貼文的公開資料
Actor 是在託管平台上執行的資料收集程式。Instagram Metrics Scraper 的文件說明了公開貼文的收集方式。2026 年 10 月 25 日核對的公開輸入與輸出規格,建置版本為 1.0.35。將 `mode` 設為 `contentUrls` 時,此版本可接受直接內容網址。
這表示文件所列功能適合用來收集已知活動貼文的公開觀測資料,並不表示程式已成功執行。本指南未執行任何收集作業。已核對的規格可見於公開建置紀錄。
首次檢查時,請使用提供的小型輸入設定:
{
"maxItems": 1,
"mode": "contentUrls",
"startUrls": ["https://www.instagram.com/reel/DIwcCZgxVZP/"]
}- 將範例網址替換成一篇已知的公開活動貼文或 Reel 網址。Reel 是 Instagram 的一種影片格式。
- 將 `mode` 維持為 `contentUrls`。這會指示 Actor 直接使用輸入的內容網址。
- 這次只檢查一個網址,請將 `maxItems` 維持為 `1`。此欄位可選填,用來設定資料列總數上限。
- 準備好收集觀測資料後,再執行 Actor。
- 使用指標前,先將傳回的各列資料與目標貼文核對。
請替換範例網址,不要保留範例再加入自己的網址。若上限只有一列,即使輸入更多網址,也不能據此認定已涵蓋所有提供的貼文。後續收集時,請依目標清單設定合適的上限,並將輸出結果與清單逐一核對。
Actor 文件也列出用於探索個人檔案內容的輸入設定。本方法使用已知的內容網址,不能據此建立完整的帳號歷史資料庫。
Task 是已儲存的 Actor 輸入預設設定。公開的 Instagram Brand Campaign Metrics Task 僅確認過公開頁面存在。未透過已登入的帳號檢查其儲存設定,也未執行此 Task。使用前請先檢查輸入設定。
保存觀測紀錄,避免將其算成額外貼文
觀測紀錄是從某個來源在已知時間取得並保存的讀值。快照就是該時間點的讀值。同一篇貼文可以有多筆觀測紀錄,但不會因此變成多篇不重複貼文。
請將公開觀測紀錄保存在獨立資料表中。下列文件所列欄位若有提供,請一併保存。
| 欄位 | 保存原因 |
|---|---|
| `inputUrl`, `postId`, `postUrl` | 將收集到的資料列對應至目標貼文 |
| `profileId`, `profileHandle` | 保留傳回的個人檔案相關資訊 |
| `publishedAt` | 若有提供,保留發布時間 |
| `scrapedAt` | 保留觀測資料的收集時間 |
| `likes`, `comments`, `views` | 分別保留各項公開指標 |
| `postMetricStatus` | 保留各項指標是否可取得及其精確程度 |
| `collaborationCount`, `collaborationProfiles` | 保留公開呈現的協作相關資訊 |
| `status`, `statusReason` | 保留該列的處理結果及回報的問題 |
指標是衡量所得的數值,例如按讚數。精確程度說明數值是精確值、經過四捨五入、無法取得,還是無法判定是否精確。文件所列的 `postMetricStatus` 包含指標、數值、狀態、精確程度及原始值。請將這些資訊與數字一併保存。
文件所列的 `collaborationProfiles` 項目包含 ID、使用者名稱、網址,以及擁有者或協作者角色。請將可取得的項目作為公開證據,並與活動清單核對。缺少協作相關資訊,並不能證明沒有協作者。
請將傳回的個人檔案相關資訊與完整的「參與關係」表分開保存。不要將單一傳回的個人檔案視為所有參與帳號的證明。
缺值不等於零。若 `likes` 缺漏或無法取得,請將計數保留為未知。若來源回報零,且狀態及精確程度合適,請保留這個零。不要將缺漏、收集失敗或未傳回的資料改填為零。
請將每個提供的網址與傳回資料列核對。任何未取得可用結果的目標,都應保留在待審查清單中。請記錄仍待釐清的是身分、指標,還是協作關係。
每篇貼文只選一筆公開觀測紀錄納入總計
資料表聯結是透過共用欄位,連接不同資料表中的資料列。在此,`postId` 用來連接「貼文」表、「參與關係」表及公開觀測紀錄。這種連接可能讓同一篇貼文的指標重複出現在多個帳號資料列旁。這些重複的儲存格不代表新的貼文成效。
計算活動公開指標總計時,每篇貼文的每項指標只選一筆合適的觀測紀錄。加總前,先寫明選取規則。合適的一組紀錄須使用相同指標、具有已知的來源統計範圍,且觀測時間符合報表需求。
- 保留每筆來源觀測紀錄,以及其時間和來源參照。
- 核對兩列資料是否重複記錄同一篇共同發布貼文的計數。
- 為該貼文選擇一筆合適的觀測紀錄,納入活動總計。
- 記錄選擇原因。
- 保留未採用及互相衝突的讀值,以供審查。
兩個帳號匯出的資料可能重複記錄同一項貼文層級計數。請保留兩份匯出資料中的觀測紀錄,但不要將兩份計數都加進活動貼文總計。先確認它們描述的是同一篇貼文及同一項指標。
若兩筆讀值不同,請檢查其時間、來源及精確程度。較晚的讀值可能反映另一個時間點的情況。若選擇較晚的讀值,請在報表中相應標示。不要將不同時間取得的讀值稱為同一時間點的快照。
不要將互相衝突的讀值取平均,製造出虛構的精確計數。若無法選出合適讀值,請將該貼文的指標標記為待釐清。若只加總其餘貼文並呈現小計,請說明涵蓋多少篇貼文,以及缺少哪些貼文。
本指南處理的是共同發布貼文計數重複的問題。若要計算一個月內的變化,則須進行不同的檢查。需要在統計期間起訖點保存計數時,請使用 Instagram 新舊貼文報表指南。目前的觀測資料無法補回過去缺漏的計數。
將帳號擁有者報表保存在獨立檢視中
公開貼文指標與帳號擁有者成效回答的是不同問題。公開按讚數描述的是觀測到的貼文計數,並未將該成效分配給各位協作者。
每收到一份帳號擁有者報表,請保存以下資訊:
| 欄位 | 應記錄的內容 |
|---|---|
| 帳號 | 已核對的帳號身分 |
| 來源 | 匯出資料或報表的參照 |
| 指標 | 報表提供的指標名稱及定義 |
| 統計範圍 | 成效描述的是貼文、帳號,還是其他註明的單位 |
| 日期 | 報表統計期間,以及匯出或觀測時間 |
| 內容身分 | 若有提供,記錄已核對的貼文連結或 ID |
| 存取限制 | 可取得紀錄中的任何缺口 |
請保留報表對指標的定義。不要只因數字相同,就將帳號成效改稱為公開貼文計數。
觸及人數是指報表所列統計範圍內觸及的受眾人數。不要從共同的公開計數推算個別協作者的觸及人數。也不要假設不同帳號的受眾資料完全沒有重複的人。若沒有受眾重疊的證據,將各帳號觸及人數相加,無法得出合併後的不重複受眾人數。
已核對的 Actor 資料集不含非公開的觸及人數、收藏次數、分享次數,也沒有歷史期間起訖點計數欄位。其公開協作欄位並不保證能存取帳號擁有者的洞察報告。這些限制依據已核對的公開規格。
若無法取得帳號擁有者報表,請明確說明這項缺口。不要將公開計數平均分配給各帳號來估算其成效。
計算範例:三篇貼文與四項帳號連結關係
原創虛構範例。以下所有身分及讀值均為虛構。這些資料列用來說明報表製作方法,並非 Actor 輸出或真實活動成效。
帳號 A 與 B 共同發布 P1。帳號 A 也參與 P2。帳號 B 也參與 P3。本範例假設這四項關係都已確認。
| 帳號 | 貼文 | 參與關係 |
|---|---|---|
| A | P1 | 共同發布貼文 |
| B | P1 | 共同發布貼文 |
| A | P2 | 已確認參與 |
| B | P3 | 已確認參與 |
帳號與貼文之間共有四項參與連結關係。不重複貼文則有三篇:P1、P2 及 P3。
本範例提供以下可一併統計的公開按讚數讀值:
| 不重複貼文 | 選用的觀測按讚數 | 納入貼文總計的次數 |
|---|---|---|
| P1 | 100 | 一次 |
| P2 | 20 | 一次 |
| P3 | 30 | 一次 |
貼文層級按讚數 = 100 + 20 + 30 = 150 次觀測到的貼文按讚。
若為每個帳號重複計入 P1,計算就會變成 100 + 100 + 20 + 30 = 250 次按讚。這會將同一篇貼文的 100 次按讚計入兩次。多出的 100 次來自重複計入 P1,並非另一筆觀測到的貼文成效。
請以下列方式呈現本範例:
- 三篇不重複的活動貼文。
- 四項已確認的帳號與貼文參與連結關係。
- 三筆已配對讀值合計有 150 次觀測到的貼文按讚。
帳號參與檢視可以顯示 A 與 B 都與 P1 有連結關係。但不能將共同的 100 次按讚,描述為 A 各自獲得 100 次按讚,且 B 另行獲得 100 次按讚。
這個虛構範例未提供帳號擁有者的觸及報表,也沒有受眾重疊的證據。因此,它無法確定任一帳號對觸及人數的貢獻,也無法確定活動合併後的不重複受眾人數。
交付前先核對明細表
勾稽核對是指依各表所列的規則,檢查資料表是否一致。各項總計不必全部相同。三篇貼文與四項參與連結關係可以同時正確。
- 確認每篇已確認的不重複貼文,在「貼文」表中各有一列。
- 確認「參與關係」表中每一列已確認資料,都指向已核對的貼文及帳號。
- 核對每項帳號與貼文關係的證據參照。
- 確認每項公開指標總計,對每篇貼文最多只採用一筆選定讀值。
- 核對指標名稱、觀測時間、來源統計範圍及精確程度。
- 清楚保留缺值、待釐清身分及互相衝突的讀值。
- 分開保存帳號擁有者報表,並保留其確切統計範圍與日期。
- 說明活動清單的涵蓋範圍,以及缺少的貼文或帳號紀錄。
當其他分析人員能將報表納入的每個數值及每項關係追溯至證據時,報表才算通過驗收。若任何檢查未通過,請暫不提供受影響的總計,或標明其涵蓋範圍有限。不要刪除來源資料列、填入零,或拆分共同計數來強行使資料一致。
來源與延伸閱讀
- Instagram Metrics Scraper 公開產品頁與 README 證據——2026 年 10 月 25 日取得;記載公開資料收集範圍,未驗證任何執行結果
- Instagram Metrics Scraper 預設建置版本 1.0.35——2026 年 10 月 25 日核對;靜態輸入與輸出規格,並非實際執行結果
- Instagram Brand Campaign Metrics Task——2026 年 10 月 25 日核對;僅確認公開頁面存在,未檢查儲存設定,也未執行 Task
- Instagram 協作貼文洞察報告提問——2026 年 4 月 7 日發布,2026 年 10 月 25 日取得;單一公開讀者提問,不能證明存取政策
- 協作貼文分析提問——2023 年 8 月 1 日發布,2026 年 10 月 25 日取得;單一公開讀者提問,不能證明存取政策
作者 Chronometrica · 更新日期
返回頂端 ↑
