事件

您可以藉由 Google Play 遊戲事件服務收集玩家藉由遊戲過程所累積產生的資料,並將這些資料儲存在 Google 伺服器內,以便分析。您可以彈性決定遊戲要收集的玩家資料,包括以下頻率指標:

  • 玩家使用特定物品的頻率
  • 玩家進入特定關卡的頻率
  • 玩家進行特定遊戲操作的頻率

您可以用這些事件資料瞭解如何改善遊戲品質。舉例來說,您可以針對玩家認為太困難的遊戲關卡調整難度等級。

如果想瞭解如何在平台中實作事件,請參閱「用戶端實作」。

在遊戲中整合事件

以下工作流程表將說明如何為遊戲套用事件:

  1. 定義事件。若要定義遊戲需擷取的新事件:
    1. 開啟 Google Play 管理中心,前往遊戲的「Events」(事件) 頁面。
    2. 按一下「Add new event」(新增事件) 按鈕並設定事件屬性
    3. 按照「發布遊戲變更」說明的步驟操作,以便發布事件定義。
  2. 使用事件 API 在遊戲內實作事件擷取。舉例來說,您可以在遊戲每次偵測到觸發想追蹤的事件時,在 Android 程式碼內呼叫事件 increment 方法。

  3. 檢視事件資料。前往 Google Play 管理中心的「Events」(事件) 頁面查看擷取事件的統計資料。

事件基礎知識

事件 API 可以讓您定義並收集有意義的遊戲過程指標,並將這些指標上傳到 Play 遊戲 SDK。

Play 遊戲 SDK 事件內含以下重要屬性:

資源 說明
ID Google Play 管理中心為此事件產生的專用字串。請用這個專屬 ID 在遊戲用戶端裡參照事件。
名稱 事件簡稱。名稱字數上限為 100 個字元。Google Play 管理中心會使用這個值,並可以在遊戲中顯示。

例如:

  • 「殺死的殭屍數量」
  • 「收集的紅寶石」
說明 更詳細的事件說明 (例如「玩家殺死殭屍的次數」或「玩家消除並配對紅寶石的總次數」)。說明字數上限為 500 個字元。Google Play 管理中心會使用這個值,並可以在遊戲中顯示。
事件類型

宣告事件追蹤資料類型的欄位。Google Play 管理中心會使用這個值支援玩家分析報告。

可支援兩種事件類型:

付費貨幣來源
選擇這項事件類型,以便追蹤付費貨幣的來源。例如:
  • 「賺取的金幣」
  • 「購買的翡翠」
付費貨幣使用方式
選擇這項事件類型,以便追蹤付費貨幣的使用方式或消費行為。例如:
  • 「花費金幣數」
  • 「使用翡翠數」

圖示 和事件有關的方形圖示。

建立事件

若要為遊戲建立新的事件,請按照以下步驟操作:

  1. 如果還沒的話,請把遊戲新增至 Google Play 管理中心
  2. 按一下 Google Play 管理中心左側的遊戲服務圖示,然後點選遊戲的項目。
  3. 點選左側的「Events」(事件) 分頁標籤,然後按一下「Add event」(新增事件) 按鈕。
  4. 填寫您想建立的事件詳細資料。
  5. 按一下「Save」(儲存),如果沒有發生錯誤,您的事件就會進入「Ready to publish」(已可發布) 狀態。您現在可以發布遊戲變更內容了。

編輯事件

若要編輯建立好的事件:

  1. 在 Google Play 管理中心內開啟「Events」(事件) 分頁標籤,然後點選想編輯的事件項目。您應該可以看到跟建立事件時一樣的表單。
  2. 按照需求編輯內容。
  3. 事件編輯完畢後,按一下「Save」(儲存) 按鈕。
  4. 測試遊戲,確認事件修改後的結果。如果運作一切正常,請重新發布遊戲變更內容

刪除事件

您可以刪除草稿狀態或已經發布的事件。若要在 Google Play 管理中心刪除事件,請按該事件表單底部標記「Delete」(刪除) 的按鈕。

重設事件資料

您可以重設玩家的進度資料,以便讓人員測試事件。

  • 如要在 Google Play 管理中心重設草稿事件,請在表單底部按一下該活動的「Reset event progress」(重設事件進度) 按鈕。
  • 如要透過程式輔助方式重設事件資料,請呼叫 Management API Events 方法

用戶端實作

如要瞭解如何實作平台中的事件,請參閱以下資源: