Facebook 遊戲平台應用程式事件

透過應用程式事件，您可以衡量廣告成效，以及為您在 Facebook 上的遊戲建立廣告受眾以設定廣告目標，

方法是使用 Facebook JavaScript SDK，從您的應用程式傳送一個事件。您可以從 預先定義事件中選擇其中一個事件（例如若是商務應用程式，可選擇「加到購物車」；若是遊戲，可選擇「過關」），或是選擇其他自訂事件。

必要條件

在加入可以衡量事件的程式碼之前，您需要先在 Facebook 註冊您的應用程式。若您尚未在 Facebook 註冊您的應用程式，可以在此註冊：Facebook 遊戲平台快速入門。

執行

您在 Facebook 上的遊戲應該已經安裝 Facebook JavaScript SDK。如果沒有的話，請詳閱 JavaScript 快速入門指南。

您可以使用 Facebook 事件管理工具查看已記錄的事件。

自動記錄事件

Facebook 遊戲平台會自動記錄下列事件：

• 應用程式安裝：用戶首次接受應用程式的服務條款。
• 啟動應用程式：每當用戶開啟包含應用程式的網頁。

若您啟用了透過 Facebook 付款的功能，下列其他事件也會一併被記錄：

• 開始結帳：用戶開始付款流程準備完成購買交易。
• 購買：用戶成功於應用程式內完成付款。
• 已取消購買：用戶取消付款，包括手動取消付款以及付款方式無法使用。

備註：如果用戶在購買過程中關閉瀏覽器視窗，則該「取消購買」事件可能不會被記錄。因此，「取消購買」事件可能不等於「開始結帳」事件和「購買」事件之間的差異值。

您可以使用 Facebook 事件管理工具查看已記錄的事件。

使用參數記錄事件

除了自動記錄事件，您也可以記錄其他資料，從而更準確地衡量應用程式在 Facebook.com 的成效。例如，您可以設定一個事件，讓系統在每當用戶闖關成功時記錄。

下列範例展示了如何記錄事件及描述事件的參數：

var params = {};
params[FB.AppEvents.ParameterNames.LEVEL] = '12'; //player level
FB.AppEvents.logEvent(
  FB.AppEvents.EventNames.ACHIEVED_LEVEL,
  null,  // numeric value for this event - in this case, none
  params
);

建議您從預先定義事件選擇一個事件。但是，我們也可以記錄自訂事件。

記錄購買

Facebook SDK 設有記錄購買事件的專屬功能，使用前必須先設定貨幣。

所有透過 Facebook 遊戲平台完成的付款，都會被自動記錄為購買事件。只有實體商品的銷售才需要使用下列程式碼。

var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = 'QW-12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

若要使用預先定義的參數，請建立參數物件，再傳遞到如下所示的函數。

var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = '12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

自訂應用程式事件

您也可以選擇建立自訂事件，方法是以字串為事件命名：

FB.AppEvents.logEvent('battledAnOrc');

自訂事件名稱的長度限制為 40 個字元，且只能由字母數字字元、下底線或破折號所組成。

捕獲例外情況

若您使用錯誤的參數呼叫所提供的 SDK JavaScript 函數，該函數會就拋出例外情況。請確保您的程式碼傳遞正確的參數，並可以捕獲所有例外情況。

除錯

為改善成效，JavaScript SDK 載入時已被極簡化。您也可以載入 JavaScript SDK 的除錯版本，其中包含更多記錄以及更嚴格的引數檢查，且為非極簡化版本。若要按此方式操作，請將載入程式碼中的 js.src 值更改為：

js.src = "https://connect.facebook.net/en_US/sdk/debug.js";

參考資料

• Javascript SDK
• AppEvents.LogEvents 參考資料