訊息洞察報告 API 參考資料

訊息洞察報告 API 可讓您以程式設計的方式，擷取在 Facebook 粉絲專頁的「粉絲專頁洞察報告」頁籤中顯示的相同資訊。

如需訊息洞察報告 API 和其他可用的 Messenger 平台分析工具的相關資訊，請參閱分析工具。

如需粉絲專頁洞察報告 API 的詳細資訊，包括其他指標的資訊和必要權限，請參閱粉絲專頁洞察報告文件或洞察報告物件參考資料。

權限

必須要有具備 read_insights 權限的粉絲專頁存取權杖，才能與此端點互動。

要求範例

curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=

回應範例

{ 
  "data": [ 
    { 
      "name": "

參數

參數	說明
`breakdowns`	回應分組所依據的維度。可能為 `messaging_channel`（Messenger 或 Instagram）、`recurring_notification_topic`、`recurring_notifications_freuency`
`date_preset`	可以用來代替 `since` 和 `until` 的相對日期範圍。可能為 `last_week`、`last_month`、`last_quarter` 和更多項目。
`metric`	欲傳回的衡量指標逗號分隔清單
`period`	在 since/until 或 date_preset 範圍內提供的彙總項目。`total_over_range` 數值會針對特定日期範圍的衡量指標提供單一數值。可能為 `day`、`week`、`month`、`days_28`、`total_over_range`
`since`	開始取得指標的 UNIX 時間戳記
`until`	停止取得指標的 UNIX 時間戳記

可用的衡量指標

以下衡量指標可透過訊息洞察報告 API 取得：

`metric` 名稱	說明
`recurring_notification_tokens`	帳戶訂閱以接收您企業商家的行銷訊息的次數。如果一個帳號訂閱了多個主題，每個主題都會計算一次。計算方式：這項衡量指標會計算帳號同意接收定期訊息的次數減去帳號取消訂閱的次數。可能的 `breakdowns` 值： `messaging_channel` `recurring_notifications_frequency` `recurring_notifications_topic` 此衡量指標仍在調整中。
`page_messages_engagement`	用戶透過點按行動呼籲按鈕與您企業商家粉絲專頁上的訊息互動的次數。此衡量指標僅包含行銷訊息的資料。可能的 `breakdowns` 值： `messaging_channel` `recurring_notifications_topic` 此衡量指標仍在調整中。
`page_messages_sent`	您的粉絲專頁傳送訊息給客戶的訊息數量。此衡量指標僅包含行銷訊息的資料。可能的 `breakdowns` 值： `messaging_channel` `recurring_notifications_topic` 此衡量指標仍在調整中。
`page_messages_read_ratio`	已讀訊息數量除以粉絲專頁發送的訊息數量。系統可能無法擷取部分訊息已讀次數，例如在顧客關閉已讀標記的情況下。此衡量指標僅包含行銷訊息的資料。可能的 `breakdowns` 值： `messaging_channel` `recurring_notifications_topic` 此衡量指標仍在調整中。
`page_messages_order_count`	您在訊息對話或用於管理訊息對話的第三方應用程式／網站中建立訂單的次數。此衡量指標仍在調整中。
`page_messages_paid_order_earnings`	您從透過訊息對話或第三方應用程式／網站（用於管理訊息對話）建立的訂單中賺取的大概金額。最終收益可能會因貨幣轉換而有所差異。此衡量指標仍在調整中。
`page_messages_with_business_outcomes`	至少建立一筆訂單的訊息聯繫對象人數。此衡量指標仍在調整中。
`page_messages_blocked_conversations_unique`	遭封鎖的粉絲專頁對話數量。
`page_messages_new_conversations_unique`	在 Messenger 上發起的訊息對話數量，發起者先前從未與您的企業商家傳過訊息。
`page_messages_reported_conversations_unique`	遭用戶以垃圾訊息或包含不當內容等原因檢舉的粉絲專頁對話數量。
`page_messages_total_messaging_connections`	您的企業商家可以傳送訊息的用戶人數。這項指標顯示曾透過 Messenger 向企業商家傳送訊息的人數，但不包含透過 Messenger 封鎖或檢舉企業商家的人數。您發送訊息給聯繫對象的能力可能會受到一些限制，例如限制您在特定時間範圍內可發送的訊息數量。這項指標也會顯示自 2016 年 10 月開放以來的相關資料，但該資料僅納入用戶聯繫人數。

回應屬性

屬性	說明
`data` 物件陣列	衡量指標物件清單
`name` 字串	衡量指標名稱
`period` 字串	蒐集資料的時間範圍
`values` 物件陣列	衡量指標的資料清單
`value` 物件陣列	每日要求的衡量指標計數。針對依類型解析的衡量指標，系統將傳回含各類型計數的物件。
`end_time` unix 時間戳記	衡量指標結束時間的 UTC 時間戳記。

另請參閱

如需訊息洞察報告 API 使用方式的相關資訊，請參閱訊息洞察報告 API 使用方式指南。