ゲームの統計データを統合する

このドキュメントでは、Google Play Console を使用してゲームにゲームの統計データを統合する方法について説明します。基本的な CSV ファイルと ZIP ファイルの形式について説明し、それらの作成、インポート、管理方法について解説します。

イベントを作成する

新しい未公開のゲームのイベントを作成する手順は次のとおりです。

  1. イベント CSV ファイル PlayerGameEvent.csv を作成する
  2. Google Play Console でゲームを選択します。
  3. [Play Games サービス - ゲームの統計データ] ページ（[ユーザーを増やす] > [Play Games サービス] > [設定と管理] > [ゲームの統計データ]）で、[イベントを設定] を選択します。
  4. [イベント設定] ページで、アップロードする CSV ファイルをドロップします。
  5. イベントを作成したら、統計情報を設定する必要があります。

統計情報を設定する

イベントを作成したら、統計情報を設定する必要があります。

  1. 統計情報、ローカライズ、アイコン ファイルを含む ZIP ファイルを作成します。統計情報の ZIP ファイルに関するガイドラインをご覧ください。
  2. Google Play Console でゲームを選択します。
  3. [Play Games サービス - ゲームの統計データ] ページ（[ユーザーを増やす] > [Play Games サービス] > [設定と管理] > [ゲームの統計データ]）で、[統計データを設定] を選択します。
  4. [ゲームの統計データの設定] ページで、アップロードする ZIP ファイルをドロップします。
  5. すべての統計情報をアップロードしたら、ゲームを公開できます。

テストゲームの統計データ

ゲームの統計データが意図したとおりに動作することを確認するには、次の手順でテストします。

  • 内部テストトラックを設定します。
  • テスター用にゲーム プロジェクトにテスト アカウントを追加します。
  • Google Play Games アプリを使用して、テスト アカウントの 1 つの Google Play Games サービス プロフィールを作成します。
  • Play Games サービス プロフィールを作成したのと同じテスト アカウントを使用してゲームを開きます。
  • ゲームの起動時に自動認証が成功したことを確認する Play Games サービスの「ウェルカム トースト」が画面に表示されることを確認します。
  • テスト アカウントのユーザーは、ゲームをプレイしてイベントをトリガーできます。イベントが記録されたかどうかを確認するには、API レスポンスを確認します。

ゲームの統計データを公開する

テストが完了したら、ゲームを公開する必要があります。ゲームのイベントと統計情報もすべて公開されます。

公開する手順は次のとおりです。

  1. Google Play Console でゲームを選択します。
  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 プロパティと、送信するその他のプロパティを少なくとも 1 つ含める必要があります。

各フィールドについては、以下の表をご覧ください。

CSV の列ヘッダー 必須 / 省略可 指定可能な値
イベント名 必須 最大 50 文字

英数字とアンダースコアのみで構成する必要があります。

特殊なイベント名 progressUpdate を使用する場合は、INT64 または STRING 型の currentProgress という名前のプロパティを含める必要があります。
プロパティ名 必須 最大 50 文字

英数字とアンダースコアのみで構成する必要があります。

イベントごとに一意: プロパティ名は同じイベント内で一意である必要があります。

次の予約済みキーワードは使用しないでください。 id、count、key、value、where、from、and、or、true、false。
プロパティのタイプ 必須 大文字と小文字を区別する列挙型文字列。サポートされているデータ型（INT64、DOUBLE、STRING、BOOL）のいずれかに一致します。

PlayerGameEvent.csv ファイルの要件:

  • ファイルでは、最大 20 個の一意のイベント名と、イベントごとに最大 20 個のプロパティがサポートされています。
  • ファイルの内容は空にできません。少なくとも 1 行は必要です。
表の例
イベント名 プロパティ名 プロパティ タイプ
matchCompleted duration DOUBLE
matchCompleted kill INT64
matchCompleted isWinner BOOL
matchCompleted matchType STRING
itemCollected coinsAmount INT64
itemCollected weaponType STRING
progressUpdate currentProgress INT64

統計情報の ZIP ファイルに関するガイドライン

ZIP ファイルを使用して統計情報を一度にインポートできます。ZIP ファイルで使用する正確なファイル名については、以下の表をご覧ください。

ファイル名 必須 / 省略可 指定可能な値
RepetitiveStatsConfig.csv 必須 繰り返し統計データは、プレーヤーが定期的に行うゲーム内アクションを表します。
ProgressionStatConfig.csv 必須 進行状況の統計情報は、プレーヤーのゲームの進行状況を表します。
StatLocalizations.csv 省略可 ゲームの統計データの名前と説明の翻訳を提供する。
アイコン ファイル 必須 512 x 512 の PNG、JPEG、JPG 形式のアイコン。

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 に含まれるすべての画像ファイルは、少なくとも 1 つの統計情報で参照されている必要があります。
  • ディレクトリ構造: すべてのファイルは 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

各フィールドについては、以下の表をご覧ください。

CSV の列ヘッダー 必須 / 省略可 指定可能な値
Stat Id 必須 最大 100 文字

英数字とアンダースコアのみで構成する必要があります。ゲーム内のすべての統計情報の中で一意である必要があります。
イベント プロパティ名 必須 最大 50 文字
統計の表示名 必須 最大 50 文字
統計情報のデフォルトの表示名（デフォルトのロケール）。統計情報全体で一意である必要があります。
Stat Description 必須 最大 500 文字
統計情報のデフォルトの説明。
集計タイプ 必須 最大 50 文字
SUM、MAX、MIN、COUNT。
フィルタ プロパティ 省略可 最大 50 文字
PlayerGameEvent.csv で定義されているプロパティ名である必要があります。
フィルタ演算子 省略可 =, !=, >, <, >=, <=
フィルタ比較演算子。
フィルタ値 省略可 Filter プロパティとの比較。 フィルタ値は INT64, DOUBLE, BOOL, STRING にする必要があります。
競争的 必須 true, false
最小値 Is Competitive が true の場合は必須 競争統計情報の許容最小スコア。
最大値 Is Competitive が true の場合は必須 競合相手の統計情報の許容最大スコア。
アイコンのファイル名 必須 ZIP ファイルのルートに含まれるアイコン画像のファイル名。繰り返し統計で使用されるアイコン ファイル名と競合することはできません。
お得感のあるお店の方向性 必須 値が高い方が良いか INCREASING、値が低い方が良いか DECREASING を指定します。
ユニット 省略可 未加工の数値または期間の値の測定単位。たとえば、KILOMETER、SECOND、PERCENTAGE、UNITLESS などです。

フィルタ条件を使用しない場合は、セルを空白のままにします。

表の例
統計情報 ID イベント名 プロパティ名 集計 統計の表示名 Stat Description フィルタ プロパティ（省略可） フィルタ演算子（省略可） フィルタ値（省略可） 競争的 minLimit maxLimit Icon filename シーケンス番号 お得感のあるお店の方向性 ユニット
1 matchCompleted duration MAX Longest Match Survival これは、任意の試合でのプレーヤーの生存時間を示します。 isWinner = TRUE TRUE 0 50 stat1.png 1 減少 秒
2 matchCompleted isWinner COUNT 勝利試合数 これは、プレーヤーが勝利した試合の数を示します。 isWinner = TRUE TRUE 0 50 stat3.png 2 増加
3 matchCompleted kill SUM 1 対 1 の試合でのキル数 1 対 1 の試合でのキル数 matchType = "1-on-1" FALSE stat4.png 4 増加
4 itemCollected coinsAmount SUM 合計ゴールド収集量 試合中にコインを集めるプレーヤー weaponType = "sword" FALSE stat2.png 3 増加

ProgressionStatConfig.csv 形式

CSV には、宣言されたイベントとそのプロパティがカンマ区切り値として次の順序で含まれています。

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

進行状況の統計情報は、ゲーマー プロフィールの最初の統計情報としてプレーヤーに表示されます。

各フィールドについては、以下の表をご覧ください。

CSV の列ヘッダー 必須 / 省略可 指定可能な値
Stat Id 必須 最大 100 文字

英数字とアンダースコアのみで構成する必要があります。ゲーム内のすべての統計情報の中で一意である必要があります。
イベント名 必須 最大 50 文字

PlayerGameEvent.csv 形式で定義されているイベント名を参照する必要があります。
イベント プロパティ名 必須 最大 50 文字

PlayerGameEvent.csv で定義されているプロパティ名である必要があります。
統計の表示名 必須 一意の名前である必要があります。
Stat Description 必須 最大 50 文字
統計情報のデフォルトの説明。
アイコンのファイル名 必須 ZIP ファイルのルートに含まれるアイコン画像のファイル名。繰り返し統計で使用されるアイコン ファイル名と競合することはできません。
お得感のあるお店の方向性 必須 値が高い方が良いか INCREASING、値が低い方が良いか DECREASING を指定します。
ユニット 省略可 未加工の数値または期間の値の測定単位。たとえば、KILOMETER、SECOND、PERCENTAGE、UNITLESS などです。
表の例
統計情報 ID イベント プロパティ名 Stat Display Name 統計情報の説明 アイコン ファイル名 コスパが良い
5 currentProgress レベル プレーヤーは試合をプレイして XP を獲得し、レベルアップします。 Level.png 増加しています

StatLocalizations.csv 形式

CSV には、宣言されたイベントとそのプロパティがカンマ区切り値として次の順序で含まれています。

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

各フィールドについては、以下の表をご覧ください。

CSV の列ヘッダー 必須 / 省略可 指定可能な値
Stat Id 必須 最大 100 文字

英数字とアンダースコアのみで構成する必要があります。ゲーム内のすべての統計情報の中で一意である必要があります。
統計の表示名 必須 一意の名前である必要があります。
言語/地域 必須 言語 / 地域コード（en-US など）。
言語 / 地域を指定する前に、ゲームの翻訳を追加する。デフォルトの言語 / 地域を指定することはできません。

サポートされている言語 / 地域コードについては、 サポートされている言語のリストをご覧ください。
ローカライズされた統計情報の表示名 省略可 最大 50 文字。指定されたロケールの統計情報の翻訳された表示名。
ローカライズされた統計情報の説明 省略可 最大半角 500 文字（全角 250 文字）。指定された言語 / 地域での統計情報の翻訳された説明。
表の例
統計情報 ID Stat Display Name 言語コード ローカライズされた統計情報の名前（UTF-8） ローカライズされた統計情報の説明（UTF-8） 1 Longest Match Survival es Supervivencia más larga en partidos Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. 1 Longest Match Survival fr Survie du match le plus long Cela indique la durée de survie d'un joueur dans n'importe quel match. 4 合計ゴールド獲得量 es Oro total recolectado La jugadora recoge monedas mientras juega en un partido 4 合計ゴールド獲得量 fr または total collecté Le joueur collecte des pièces en jouant un match

アイコン ファイル

.csv ファイルで参照するアイコンは、インポートする現在の ZIP アーカイブに含まれている必要があります。

アイコンの検証ルールは次のとおりです。

検証プロパティ 適用された制約 / ルール
最大ファイルサイズ アイコン ファイルあたり最大 1 MB（1,048,576 バイト）。
サイズ 512 × 512 ピクセル（幅 = 512、高さ = 512）
アスペクト比 1:1（スクエア アスペクト比）
許可されるフォーマット PNG（.png）と JPEG（.jpg、.jpeg）
ZIP 内の配置 ZIP ファイルのルート ディレクトリに配置する必要があります。
参照されるチェック [アイコン ファイル名] 列で指定されたすべてのアイコン ファイル名は、ZIP 内に存在している必要があります。
孤立チェック ZIP 内のすべての画像ファイルは、少なくとも 1 つの統計情報で参照されている必要があります。
競合の確認 ProgressionStatConfig.csv のアイコン ファイル名は、RepetitiveStatsConfig.csv と競合しないようにする必要があります。
見た目が重複している画像 重複するアイコンにはフラグが付けられます。

アイコンのガイドライン

アイコンは、512 x 512 の PNG、JPEG、または JPG ファイルとして作成する必要があります。

すべての言語 / 地域で同じアイコンが使用されるため、アイコンにテキストやローカライズされたコンテンツを含めることはおすすめしません。

単位の仕様

[Unit] 列は、プレーヤー向けに未加工の統計情報の値を書式設定してローカライズする方法を制御します。

数値統計情報プロパティ（INT64、DOUBLE）

使用できる単位値 元の値の例
（空） / UNITLESS / NONE 1234567
% / PERCENTAGE / PERCENT 0.857
距離/長さ: CENTIMETER、METER、KILOMETER、FOOT、INCH、MILE、YARD、MILLIMETER、NANOMETER 15（キロメートル）
Speed: KILOMETER_PER_HOUR、METER_PER_SECOND、MILE_PER_HOUR 60（MILE_PER_HOUR）

数値以外の統計情報プロパティ（STRING、BOOL）

単位の列は空のままにする必要があります。