整合遊戲統計資料

本文說明如何使用 Google Play 管理中心，將遊戲統計資料整合至遊戲。內容涵蓋基本的 CSV 和 ZIP 檔案格式，並說明如何建立、匯入及管理這些檔案。

建立或匯入活動

新手透過 Google Play 管理中心新增活動的方式有兩種：

• 建立活動：一次新增一個活動。
• 匯入活動：匯入多個活動。

建立事件

如要為遊戲建立活動，請完成下列步驟：

1. 在 Google Play 管理中心選取遊戲。
2. 在「Play 遊戲服務 - 遊戲統計資料」頁面 (依序點選「開發更多使用者」>「Play 遊戲服務」>「設定與管理」>「遊戲統計資料」)，選取「新增事件」>「建立事件」。
3. 在「建立活動」頁面中填寫表單。
4. 按一下 [儲存變更]。

匯入活動

如要一次新增多個遊戲事件，請按照下列步驟操作：

1. 建立事件 CSV 檔案 PlayerGameEvent.csv。
2. 在 Google Play 管理中心選取遊戲。
3. 在「Play Games 服務 - 遊戲統計資料」頁面 (依序點選「開發更多使用者」>「Play Games 服務」>「設定與管理」>「遊戲統計資料」)，選取「新增事件」>「透過 CSV 匯入」。
4. 在「活動設定」頁面中，拖曳 CSV 檔案即可上傳。
5. 建立活動後，請設定統計資料。

建立或匯入統計資料

新手透過 Google Play 管理中心新增統計資料的方式有兩種：

• 建立統計資料：一次新增一項統計資料。
• 匯入統計資料：匯入多項統計資料。

建立統計資料

如要為遊戲建立統計資料，請完成下列步驟：

1. 在 Google Play 管理中心選取遊戲。
2. 在「Play Games 服務 - 遊戲統計資料」頁面 (依序點選「開發更多使用者」>「Play Games 服務」>「設定與管理」>「遊戲統計資料」)，選取「新增統計資料」>「建立統計資料」。
3. 在「建立統計資料」頁面中填寫表單。
4. 按一下 [儲存變更]。
5. 建立統計資料後，請發布遊戲。

匯入統計資料

如要匯入統計資料，請按照下列步驟操作：

1. 請按照統計資料的 ZIP 檔案指南，建立包含統計資料、在地化內容和圖示檔案的 ZIP 檔案。
2. 在 Google Play 管理中心選取遊戲。
3. 在「Play 遊戲服務 - 遊戲統計資料」頁面 (依序點選「開發更多使用者」>「Play 遊戲服務」>「設定與管理」>「遊戲統計資料」)，選取「新增統計資料」>「透過 ZIP 匯入」。
4. 在「遊戲統計資料設定」頁面中，拖曳 ZIP 檔案即可上傳。
5. 上傳所有統計資料後，請發布遊戲。

測試遊戲統計資料

如要確認遊戲統計資料功能是否正常運作，請按照下列步驟進行測試：

• 在 Play 管理中心設定內部測試群組。
• 為測試人員新增測試帳戶至遊戲專案。
• 使用 Play Games 應用程式，為其中一個測試帳戶建立 Play Games 服務設定檔。
• 使用建立 Play 遊戲服務設定檔的測試帳戶開啟遊戲。
• 確認畫面上是否顯示 Play 遊戲服務「歡迎訊息」，確認遊戲啟動時已成功自動驗證。
• 測試帳戶使用者可以玩遊戲來觸發事件。檢查 API 回應，確認事件是否已記錄。

在裝置上管理遊戲統計資料的顯示設定，以便進行測試

在 Play 管理中心開放測試人員存取遊戲後，請按照下列步驟在裝置上查看「遊戲統計資料」：

1. 清除 Google Play 商店快取：

   1. 開啟裝置上的「設定」應用程式。
   2. 依序輕觸「應用程式」 >「Google Play 商店」。
   3. 依序輕觸「儲存空間和快取」和「清除快取」。

2. 開啟 Google Play 商店應用程式。

3. 如要查看遊戲統計資料，請使用「追蹤遊戲時間」部分或玩家個人資料：

方法 1：使用「追蹤遊戲時間」部分

前往「追蹤遊戲時間」部分，然後輕觸該部分即可查看遊戲統計資料。

方法 2：使用玩家個人資料

1. 輕觸「個人中心」分頁標籤，然後輕觸玩家個人資料。
2. 前往「遊戲統計資料」部分。
3. 選取「不限時間」。
4. 如果找不到所需遊戲，請輕觸「查看所有遊戲」。
5. 選取遊戲即可查看統計資料。

查看裝置上的記錄

如要確認遊戲統計資料是否正常運作，請在裝置上開啟記錄：

1. 在裝置上啟用 adb 偵錯，然後在終端機中執行下列指令：

   adb shell setprop log.tag.Games INFO
   adb logcat -s "PlayGamesServices[GameStatsAgent]:I"

2. 確認顯示成功記錄訊息，如下列範例所示：

   Successfully uploaded batch of X events.
   

   注意：由於 API 支援部分上傳，這份資訊記錄表示批次已處理完畢。如果批次中的任何個別事件未通過結構定義驗證，這則訊息之前會顯示錯誤記錄。

3. 如果提交的任何事件未通過驗證，系統會顯示詳細說明失敗原因的錯誤訊息：

   BatchRecordEvents validation failed for X event(s): ...
   

發布遊戲統計資料

測試完成後，請務必發布遊戲。 遊戲的所有活動和統計資料都會一併發布。

如要發布，請按照下列步驟操作：

1. 在 Google Play 管理中心選取遊戲。
2. 在「Play 遊戲服務 - 遊戲統計資料」頁面 (依序點選「開發更多使用者」>「Play 遊戲服務」>「設定與管理」>「遊戲統計資料」)，按一下「檢查並發布」。
3. 在「Play 遊戲服務 - 發布」頁面 (依序點選「開發更多使用者」>「Play 遊戲服務」>「設定與管理」>「發布」)，查看動作並修正問題。
4. 按一下「發布」。 所有遊戲統計資料都會發布。

編輯遊戲統計資料

如要編輯現有的遊戲統計資料，請按照下列步驟操作：

1. 在 Google Play 管理中心選取遊戲。
2. 前往「Play Games 服務 - 遊戲統計資料」頁面 (依序點選「開發更多使用者」>「Play Games 服務」>「設定與管理」>「遊戲統計資料」)。
3. 如要編輯活動：
   1. 在「事件設定」部分，選取事件。
   2. 您可以新增或刪除事件屬性。
      • 您無法編輯「活動名稱」。
   3. 按一下 [儲存變更]。
4. 如要編輯「狀態」：
   1. 在「遊戲統計資料設定」部分中，選取一項統計資料。
   2. 您可以編輯「統計資料名稱」、「統計資料說明」和「圖示檔案名稱」欄位。
      • 您無法編輯「統計資料 ID」和「進展方向」。 統計單元和相關事件詳細資料。
   3. 按一下 [儲存變更]。
5. 在「Play Games 服務 - 遊戲統計資料」頁面中，編輯後的統計資料會處於「可供測試人員使用」狀態。
6. 測試完畢後，請按一下「檢查並發布」。 這會重新發布遊戲以及所有更新過的統計資料。

刪除遊戲統計資料

遊戲統計資料發布後即無法刪除。

您可以刪除「可供測試人員使用」狀態的事件或統計資料。

1. 在 Google Play 管理中心選取遊戲。
2. 前往「Play Games 服務 - 遊戲統計資料」頁面 (依序點選「開發更多使用者」>「Play Games 服務」>「設定與管理」>「遊戲統計資料」)。
3. 如要刪除活動：
   1. 在「事件設定」部分，選取事件。
   2. 按一下「刪除活動」。
4. 如要刪除「統計資料」：
   1. 在「遊戲統計資料設定」中，選取要刪除的統計資料。
   2. 按一下「刪除遊戲統計資料」。

活動的 CSV 檔案指南

CSV 檔案的第一列是標題列。您必須使用活動 CSV 檔案匯入活動，例如 PlayerGameEvent.csv。

PlayerGameEvent.csv 格式

CSV 檔案包含以半形逗號分隔的已聲明事件及其屬性，順序如下：

 Event Name,Property Name,Property Type

如果您傳送 progressUpdate 事件以進行 progressionStat，請為這個事件新增一列。這個事件至少須包含 INT 或 STRING 類型的 currentProgress 屬性，以及您想傳送的任何其他屬性。

下表提供這些欄位的說明：

PlayerGameEvent.csv 檔案相關規定：

• 檔案最多可包含 20 個不重複的事件名稱，每個事件最多可有 20 個屬性。
• 檔案內容不得為空白，且至少須包含 1 列。

統計資料的 ZIP 檔案指南

你可以透過 ZIP 檔案一次匯入統計資料。請參閱下表，瞭解適合在 ZIP 檔案中使用的確切檔案名稱：

ZIP 檔案必須符合下列規定：

• ZIP 檔案大小限制：解壓縮後的總大小不得超過 10 MB。
• 檔案數量上限：ZIP 封存檔內最多可有 53 個檔案 (3 個 CSV 檔案和 50 個圖示)。
• 統計資料總數上限：ProgressionStatConfig.csv 和 RepetitiveStatsConfig.csv 的統計資料總數最多為 50 個。
• 支援的 CSV 檔案： ProgressionStatConfig.csv、 RepetitiveStatsConfig.csv 和 StatLocalizations.csv (選用)。 如要只上傳進展統計資料，請勿在 ZIP 檔案中納入重複統計資料 CSV 檔案，否則控制台會發出錯誤。如果只想上傳重複的統計資料，也適用相同做法。
• 圖示圖片檔案：PNG (.png) 或 JPEG (.jpg、.jpeg)。
  • CSV 檔案中參照的所有圖示都必須位於 ZIP 檔案的根目錄。
  • ZIP 檔案中的所有圖片檔案都必須至少由一項統計資料參照。
• 目錄結構：所有檔案都必須位於 ZIP 檔案的根目錄中。 不得含有子目錄。

RepetitiveStatsConfig.csv 格式

CSV 檔案包含以半形逗號分隔的已聲明事件及其屬性，順序如下：

Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit

下表提供這些欄位的說明：

如果不想使用篩選條件，請將儲存格留空。

ProgressionStatConfig.csv 格式

CSV 檔案包含以半形逗號分隔的已宣告事件及其屬性，順序如下：

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

玩家在「玩家個人資料」中會看到的第一個統計資料就是進度統計資料。

下表提供這些欄位的說明：

StatLocalizations.csv 格式

CSV 檔案包含以半形逗號分隔的已宣告事件及其屬性，順序如下：

Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description

下表提供這些欄位的說明：

圖示檔案

CSV 檔案中參照的圖示，必須包含在匯入的現有 ZIP 封存檔中。

圖示驗證規則如下：

圖示規範

圖示大小為 512 x 512，檔案格式為 PNG、JPEG 或 JPG，且背景必須為透明。

所有語言代碼都會使用相同的圖示，因此建議不要在圖示中加入任何文字或本地化內容。

單元規格

「單位」欄會控管原始統計資料值的格式，並為玩家進行本地化。

數值統計資料屬性 (INT64、DOUBLE)

時間長度統計資料屬性 (DURATION)

非數值統計資料屬性 (STRING、BOOL)

單位欄位必須留空。