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 參考資料