洞察報告

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

限制

• 部分衡量指標不適用於粉絲不到 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 包含以下端點：

• GET /{ig-media-id}/insights — 取得影音內容物件的衡量指標
• GET /{ig-user-id}/insights — 取得 Instagram Business 帳號或 Instagram 創作者帳號的衡量指標。

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

範例

取得帳號衡量指標

若要取得 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"
    }
  ]
}