事件

您可以透過 Google Play 遊戲事件服務,收集玩家在遊戲過程持續產生的資料,並儲存在 Google 伺服器做為遊戲分析。您可以靈活決定遊戲要收集的玩家資料,包括玩家從事以下行為的頻率:

  • 使用特定物品
  • 進入特定關卡
  • 進行特定遊戲操作

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

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

在遊戲中整合事件

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

  1. 定義事件。若要定義遊戲需擷取的新事件:
    1. 開啟 Google Play 管理中心,前往遊戲的「事件」頁面。
    2. 按一下「新增事件」按鈕,設定事件屬性
    3. 按照「發布遊戲變更」說明,發布事件定義。
  2. 使用事件 API 在遊戲內實作事件擷取。舉例來說,您可以這樣設定:只要遊戲偵測到關注事件遭觸發,就在 Android 程式碼呼叫事件 increment 方法。

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

事件基礎知識

事件 API 可定義並收集有意義的遊戲玩法指標,並將指標上傳到 Play 遊戲 SDK。

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

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

例如:

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

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

可支援兩種事件類型:

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

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

建立事件

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

  1. Google Play 管理中心中,按一下左側的「遊戲服務」圖示,然後選取遊戲項目。
  2. 選取左側的「事件」分頁標籤,然後按一下「新增事件」按鈕。
  3. 為要建立的事件填寫詳細資料。
  4. 按一下「儲存」。如果沒有錯誤,事件就會進入「已可發布」狀態。您現在可以發布遊戲變更內容了。

編輯事件

若要編輯建立好的事件:

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

刪除事件

您可以刪除處於草稿狀態或已經發布的事件。若要在 Google Play 管理中心刪除事件,請在表單底部為該事件點選「刪除」按鈕。

重設事件資料

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

  • 如要在 Google Play 管理中心重設草稿事件,請在表單底部為該事件點選「重設事件進度」按鈕。
  • 如要透過程式輔助方式重設事件資料,請呼叫 Management API Events 方法

用戶端實作

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