訊息洞察報告 API 參考資料

使用訊息洞察報告 API，您便可透過程式輔助的方式，擷取同樣顯示在 Facebook 專頁「專頁洞察報告」分頁中的資訊。

若要進一步了解訊息洞察報告 API 以及 Messenger 平台中可用的其他分析，請參閱分析。

若要進一步了解專頁洞察報告 API，包括其他可用衡量數據的資料以及必要權限，請參閱專頁洞察報告文件或洞察報告物件參考資料。

權限

專頁存取憑證必須擁有 pages_messaging 權限，才可與此端點互動。

要求範例

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`	在開始／結束時間或 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 時戳。

另請參閱

如需進一步了解 Messaging 洞察報告 API 的使用情況，請瀏覽 Messaging 洞察報告 API 使用情況指南。