使用企業商家訊息功能事件 API 記錄事件

訊息傳送事件 API 停用

訊息傳送事件 API 將於 2025 年 9 月停用。為了對此停用做好準備，自 2024 年 9 月 24 日起，圖形 API 的任何後續版本（從第 21.0 版開始）將不再支援訊息傳送事件 API。
在 2025 年 9 月官方產品停用之前，合作夥伴若選擇不更新至最新版圖形 API，仍可透過呼叫圖形 API 第 20.0 版或先前版本來存取訊息傳送事件 API。
針對未更新至最新版圖形 API 的合作夥伴，我們建議使用轉換 API 進行新的整合。深入瞭解轉換 API。

本指南說明如何記錄應用程式和 Facebook 粉絲專頁事件，以分析用戶如何與其 Messenger 體驗互動。

準備工作

您需要下列項目：

page_events 權限
- 若您的應用程式已經獲准得到 pages_messaging 權限的進階存取權限，且過去 90 天內沒有違反任何政策，則當您提交應用程式審查時，系統將自動授予此權限的進階存取權限
可在查詢中之粉絲專頁執行 ANALYZE 工作的用戶所要求的粉絲專頁存取權杖

限制

目前尚未開放位於歐洲或日本的企業商家或顧客使用此 API。

政策和使用條款

記錄事件

將 POST 要求提交到應用程式的 page_activities 關係連線即可記錄事件：

https://graph.facebook.com/

要求範例：

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "fb_mobile_purchase",
      "_valueToSum": 57.23,
      "fb_currency": "USD"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

建議針對 _eventName 欄位使用標準事件。只有標準事件才能在廣告管理員中進行分析報告，並用於廣告目標設定和最佳化（若可用）。

例如：若要在廣告管理員中記錄購買事件以進行歸因，請使用 fb_mobile_purchase 事件名稱。

如需標準事件名稱和參數的完整清單，請參閱應用程式事件 API 指南（應用程式事件架構部分）。

下表說明記錄 Messenger 事件時，必須提供給端點的屬性和值：

屬性	說明	值
`custom_events`	您想記錄的事件陣列。如需標準事件和適用參數的清單，請參閱應用程式事件 API 指南。您也可使用自己的應用程式事件。您可在陣列中指定多個事件。	使用 JSON 編碼的陣列指定自訂事件的詳細資料。
`page_id`	指定與事件連結的粉絲專頁編號。	使用與 Bot 連結的 Facebook 粉絲專頁編號。
`page_scoped_user_id`	指定與事件記錄專用 Messenger Bot 連結的粉絲專頁範圍用戶編號。	使用提供給 Webhook 的粉絲專頁範圍用戶編號。
`advertiser_tracking_enabled`	指定是否啟用廣告追蹤。	使用 `0` 停用，使用 `1` 啟用
`application_tracking_enabled`	指定是否在應用程式層級啟用廣告追蹤。	使用 `0` 停用，使用 `1` 啟用
`logging_source`	指定事件來源。	使用 `messenger_bot` 字串指出此事件來自 Messenger Bot。
`logging_target`	指定將記錄事件的目標實體。	使用 `app`、`page` 或 `app_and_page` 字串控制將接收此事件的實體。如需詳細資訊，請參閱應用程式事件常見問題

使用訊息功能事件 API 回報潛在顧客

應用程式現在可以開始回報對話串中的潛在顧客提交內容。lead_submitted 事件允許應用程式自動回報視為是銷售潛在顧客的對話串（例如，用戶分享其聯絡資料並經要求針對銷售進行連絡）。

該事件最適合用於將特定用戶區分為潛在顧客，如此應有助於企業商家排定其對話串的優先順序。例如，企業商家可以設定讓用戶有資格成為潛在顧客的自動流程，並在用戶完成此類流程時觸發該事件，以向真人客服標幟為潛在性高的對話串。

該功能目前已推出公開測試版，並預計近期內在廣告管理員中整合分析報告，因此潛在顧客資料將會在廣告管理員 UI 中回報。

回報發生在對話串中的潛在顧客事件的 API 呼叫範例：

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "lead_submitted"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

使用廣告洞察報告 API 回報潛在顧客

回報的潛在顧客事件可用廣告洞察報告 API 視覺化。此 API 可用來建立進階分析主控板，幫助視覺化可歸因於 CTX 行銷活動的潛在顧客。

必要條件

使用此 API 之前，請確定應用程式已完成 ads_read 權限的應用程式審查程序並取得進階存取權。

執行

廣告行銷活動層級上的洞察報告呼叫範例類似於下列所示：

curl -G \
-d "date_preset=last_7d" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"

根據所需的精確度層級，可以在廣告帳號、行銷活動和廣告組合層級呼叫洞察報告 API。

取得潛在顧客的呼叫如下所示：

潛在顧客（可歸因）
- /<OBJECT_ID>/insights?fields=actions
- 在結果中，action_type=onsite_converstion.lead_grouped

如需上述動作類型的詳細定義，請參閱廣告動作統計資料參考。

分類潛在顧客的最佳作法

廣告主屬於經典的潛在客戶開發垂直產業之一（汽車、專業服務、金融服務、B2B、教育、健康）。
廣告主要求提供聯絡資訊，例如電話或電子郵件地址，然後用戶提供。
電話或電子郵件地址問題之前會有某種限定條件（例如 1 至 2 個附加問題）。
如果您在應用程式中提供潛在客戶開發範本，請預設在潛在客戶開發流程尾端新增此訊號。

注意：建議不要自動將每個包含電話號碼或電子郵件地址的對話標記為潛在客戶，尤其是在基於付款/電子商務目的而共享電話號碼的市場中。

驗證事件記錄

如果您是應用程式或粉絲專頁管理員，可以透過在廣告管理員中尋找事件來驗證設定是否正確。

Messenger 專用分析工具特殊須知

單一應用程式可以記錄多個粉絲專頁的互動。在這種情況下，與所有粉絲專頁的互動事件都可在同一應用程式中看到。
單一粉絲專頁可以連結多個應用程式。在這種情況下，當粉絲專頁遭到封鎖時，所有連結該粉絲專頁的應用程式都將收到 fb_messenger_bot_stopped 事件。
已刪除的 Messenger Bot 對話數量可以大於新用戶活動數量。已刪除的 Messenger Bot 對話是用戶刪除對話串的次數。用戶刪除對話串後，粉絲專頁可以啟用進一步的對話。用戶可以刪除額外的對話串，如此會增加已刪除的 Messenger Bot 對話數量。

平台供應商的使用

記錄目標

允許用戶透過視覺介面建置 Messenger 體驗的平台，通常會使用一個中央應用程式來為其連結的所有頁面提供支援。若要讓顧客查看自己的事件，必須將他們記錄到您的顧客粉絲專頁，方法是將 logging_target 設為 page 或 app_and_page。

用戶介面

在視覺編輯器的內文中，您可以提供一個可拖曳的區塊，讓用戶選擇事件並定義額外的參數。如此一來，粉絲專頁管理員就可以為 Messenger 流程規劃合適的事件。理想情況下，用戶應該能夠從下拉式清單中選擇標準事件名稱，因為只有標準事件才能在廣告管理員中進行分析報告，並用於廣告目標設定和最佳化（若可用）。如果沒有標準事件名稱與用戶動作相符且不需要廣告分析報告，您可能會想要提供一個自由格式欄位，允許用戶輸入自訂事件名稱和參數。

權限

您必須在應用程式的「Facebook 登入」流程期間獲得必要的 page_events 權限。您必須將其新增到「登入」按鈕、Facebook JavaScript SDK 呼叫或手動建置登入流程的要求權限範圍，如該指南中所述。

其他資源

應用程式事件最佳作法指南：包括在各類型應用程式中使用何種事件的建議。