整合遊戲統計資料

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

建立事件

如要為未發布的全新遊戲建立活動，請完成下列步驟：

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

設定統計資料

建立活動後，請設定統計資料：

1. 建立包含統計資料、本地化和圖示檔案的 ZIP 檔案。統計資料的 ZIP 檔案指南。
2. 在 Google Play 管理中心選取遊戲。
3. 在「Play 遊戲服務 - 遊戲統計資料」頁面 (依序點選「拓展使用者數量」>「Play 遊戲服務」>「設定與管理」>「遊戲統計資料」)，選取「設定統計資料」。
4. 在「遊戲統計資料設定」頁面中，拖曳 ZIP 檔案即可上傳。
5. 上傳所有統計資料後，即可發布遊戲。

測試遊戲統計資料

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

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

發布遊戲統計資料

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

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

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

刪除遊戲統計資料

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

活動的 CSV 檔案指南

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

PlayerGameEvent.csv 格式

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

 Event Name,Property Name,Property Type

如果傳送 progressionStat 的 progressUpdate 事件，請為此事件新增資料列。這個事件必須至少包含 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)

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

請將單元欄留空。