這份文件已更新。
中文(台灣) 的翻譯尚未完成。
英文更新時間:5月4日

洞察報告

您可以使用 Instagram 圖形 API 取得 IG 用戶及其 IG 影音內容物件的社群互動衡量指標。每個衡量指標的數量是根據 API 要求進行計算。

基於隱私規定,部分衡量指標計算不再包含部分地區用戶所進行的訊息相關限時動態 IG 影音內容互動。這些地區包括:歐洲(2020 年 12 月 1 日起)和日本(2021 年 4 月 14 日起)。

  • 若是受影響地區的用戶所建立的限時動態,replies 衡量指標現在將傳回 0 值。
  • 若是受影響地區之外的用戶所建立的限時動態,replies 衡量指標將傳回回覆次數,但計算時不會包含受影響地區用戶所進行的回覆次數。

限制

  • 部分衡量指標不適用於粉絲不到 100 人的 IG 用戶。
  • API 只會回報自主互動衡量指標,內含影音素材物件之廣告的互動不算在內。
  • 影音素材衡量指標資料的儲存期限最多是 2 年。用戶衡量指標資料的儲存期限最多是 90 天。
  • 您一次只能取得一位用戶的洞察報告。
  • 您無法取得 Facebook 粉絲專頁的洞察報告。
  • 即使已將限時動態封存或設為精選,限時動態洞察報告的有效期間仍然只有 24 小時。如果您要在限時動態過期之前取得最新的洞察報告,請設定 Instagram 主題的 Webhook 並訂閱 story_insights 欄位。
  • 不支援相簿子 IG 影音內容的洞察報告。
  • 如果您要求的洞察報告資料不存在或目前無法使用,API 將傳回空白資料集,而不是用於個別衡量指標的 0

世界協調時間

API 回應中的時間戳記使用零偏移的世界協調時間(UTC),並統一採用 ISO-8601 格式。例如:2019-04-05T07:56:32+0000

端點

API 包含以下端點:

請參閱每個端點的參考說明文件,瞭解可用的衡量指標、參數和權限規定。

範例

取得帳號衡量指標

若要取得 Instagram Business 或創作者帳號的衡量指標,請查詢 GET /{ig-user-id}/insights 關係連線並指定要傳回的衡量指標。

範例要求

GET graph.facebook.com/17841405822304914/insights
    ?metric=impressions,reach,profile_views
    &period=day

範例回應

{
  "data": [
    {
      "name": "impressions",
      "period": "day",
      "values": [
        {
          "value": 32,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 32,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the Business Account's media objects have been viewed",
      "id": "instagram_business_account_id/insights/impressions/day"
    },
    {
      "name": "reach",
      "period": "day",
      "values": [
        {
          "value": 12,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 12,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Reach",
      "description": "Total number of times the Business Account's media objects have been uniquely viewed",
      "id": "instagram_business_account_id/insights/reach/day"
    },
    {
      "name": "profile_views",
      "period": "day",
      "values": [
        {
          "value": 15,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 15,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Profile Views",
      "description": "Total number of users who have viewed the Business Account's profile within the specified period",
      "id": "instagram_business_account_id/insights/profile_views/day"
    }
  ]
}

取得影音內容衡量指標

若要取得影音內容物件的衡量指標,請查詢 GET /{ig-media-id}/insights 關係連線並指定要傳回的衡量指標。

範例要求

GET graph.facebook.com/{media-id}/insights
    ?metric=engagement,impressions,reach

範例回應

{
  "data": [
    {
      "name": "engagement",
      "period": "lifetime",
      "values": [
        {
          "value": 8
        }
      ],
      "title": "Engagement",
      "description": "Total number of likes and comments on the media object",
      "id": "media_id/insights/engagement/lifetime"
    },
    {
      "name": "impressions",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the media object has been seen",
      "id": "media_id/insights/impressions/lifetime"
    },
    {
      "name": "reach",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen the media object",
      "id": "media_id/insights/reach/lifetime"
    }
  ]
}