イベントとクエスト

Google Playゲームのイベントサービスでは、ゲームプレイ中にあなたのプレイヤーによって生成された累積的なデータを収集し、それらをゲームの分析のために Googleのサーバに格納できるようにします。 あなたのゲームが何のプレイヤーデータを収集するべきかを柔軟に定義することができます; これにはどのくらいの頻度といったメトリクスを含むかもしれません:

• プレイヤーが特定のアイテムを使用した
• プレイヤーが一定のレベルに到達した
• プレイヤーがいくつかの特定のゲームアクションを実行した

イベントデータをあなたのゲームを改善する方法についてのフィードバックとして使用することができます。 例えば、プレイヤーがあまりにも難しくて完了することができないと感じているあなたのゲーム内の特定のレベルの難易度を調整することができます。

Google Playゲームのクエストサービスは、イベントデータに基づいた新たな期限付きの挑戦(あるいはクエスト)を導入できるようにすることによってイベントサービスを補完します。 クエストは、あなたの全体のゲームを Google Play Consoleにて再公開することなく、プレイヤーを再エンゲージできるようにし、彼らが成功した場合には、彼らに幾つかのゲーム内の報酬あるいは特典をインセンティブできるようにします。

あなたのプラットフォーム用のイベントとクエストを実装する方法については、クライアントの実装を参照してください。

あなたのゲームにてイベントとクエストを統合する

次のワークフローでは、あなたのゲームにてイベントとクエストを適用する方法について説明します:

1. イベントを定義する。 あなたのゲームに捕捉するための新しいイベントを定義するには:
   1. Google Play Consoleにてあなたのゲームの Eventsページに移動します。
   2. Add new eventボタンをクリックし、イベントのプロパティを設定します。
   3. あなたのゲームの変更を公開するに記載されている手順に従って、あなたのイベント定義を公開します。

2. イベント APIを使用して、あなたのゲームにイベントの捕捉を実装します。 例えば、あなたの Androidのコードでは、あなたのゲームが、関心があるイベントがトリガされたことを検出したときに、イベントの incrementメソッドを呼び出します。

3. イベントデータを表示する。 捕捉されたイベントのための統計情報を表示するには、Google Play Consoleにてあなたのゲームの Eventsページに移動します。

4. クエストを定義する。 あなたのゲームのための新しいクエストと報酬を定義するには:
   1. Google Play Consoleにてあなたのゲームの Questsページに移動します。
   2. Add a new questボタンをクリックし、クエストのプロパティを設定します。
   3. クエストの定義では、クエストを完了するために必要となるプレイヤーのアクションあるいはマイルストーンを表すイベントを指定します。
   4. Google Play Consoleから個々のクエストを公開することができます。 新しいクエストによって必要とされるイベントが既に公開されているということであれば、あなたのゲームを再公開する必要はありません。
5. プレイヤーに新しいクエストを提示する。
   • もしあなたのゲームがプレイヤーの端末上にインストールされているならば、あなたの新しいクエストは自動的に、プレイヤーが Google Play Games appをオープンしたときに表示されます。
   • さらには、新しいクエストを、Playゲーム SDKによって提供されたデフォルトのクエストリストユーザインタフェイス(UI)を介して、あるいはあなた自身がカスタムした UIを介してあなたのゲーム内からプレイヤーに提示することもできます。 もし独自の UIを実装しているならば、プレイヤーにそれぞれのクエストを完了するための方法の説明を提供することを確認してください。
6. プレイヤーのクエストの進行状況を更新する。
   • イベントとクエストの APIを使用することによって、プレイヤーの進行状況を用いて Google Playゲームサービスを更新します。
   • もし彼らがクエストを完了したならば、プレイヤーに報酬を与えます。 もしプレイヤーが与えられた期間内にクエストを完了することに失敗したならば、クエストリスト UIはクエストを失効したとして示します。

イベントの基本

イベント APIは、興味深いゲームプレイのメトリクスを定義し、収集し、これらのメトリクスを Google Playゲームサービスにアップロードする方法を提供します。

Google Playゲームサービスのイベントはこれらの重要なプロパティを含みます:

プロパティ	説明
ID	このイベントのために Google Play Consoleによって生成された一意の文字列。 あなたのゲームクライアントにてイベントを参照するには、この一意の IDを使用します。
Name	イベントの短い名前。 名前は 100文字まで可能です。 この値は Google Play Consoleによって使用され、あなたのゲームにて表示されることができます。 例: "Zombies Killed" "Red Gems Collected"
Description	イベントのより長い説明(例えば、 "Number of times a player has killed a zombie" あるいは "The total number of red gems the player has eliminated and matched")。 説明は 500文字まで可能です。 この値は Google Play Consoleによって使用され、あなたのゲームにて表示されることができます。
Event type	イベントが追跡しているデータ型を宣言するフィールド。 この値は、プレイヤー分析レポートをサポートするために、Google Play Consoleによって使用されます。 2つのイベント型がサポートされています: Premium currency source プレミアムな通貨の発生源を追跡するイベント用にこの型を選択します。 例えば: “Gold coins earned” “Emeralds bought” Premium currency sink プレミアムな通貨の減少あるいは消費を追跡するイベント用にこの型を選択します。 例えば: “Gold coins spent” “Emeralds used”
Icon	あなたのクエストに関連付けられた四角いアイコン。

イベントを作成する

あなたのゲームのための新しいイベントを作成するには、次の手順を実行します:

1. もしまだそうしていなければ、Google Play Consoleにてあなたのゲームを追加します。
2. Google Play Consoleにて左側のゲームサービスのアイコンをクリックし、あなたのゲームのエントリを選択します。
3. 左側の Eventsタブを選択し、Add eventボタンをクリックします。
4. 作成したいイベントの詳細を入力します。
5. Saveをクリックします。 もしエラーがなければ、あなたのイベントは "Ready to publish" 状態に配置されます。 今、あなたのゲームの変更を公開するに進むことができます。

イベントを編集する

作成したイベントを編集するには:

1. Google Play Consoleにて Eventsタブを開き、編集したいイベント用のエントリを選択します。 イベントを作成したときに使用したものと同じフォームが表示されるはずです。
2. 編集の変更をします。
3. イベントの編集を終えたら、Saveボタンをクリックします。
4. 修正されたイベントを確認するためにあなたのゲームをテストします。 もしそれが正常に動作しているならば、あなたのゲームの変更を再公開します。

イベントを削除する

イベントがクエストによって使用されていない限り、ドラフト状態にある、あるいは、公開されているイベントを削除することができます。 Google Play Consoleにてイベントを削除するには、そのイベントのフォームの下部にある Deleteとラベルされたボタンをクリックします。

イベントデータをリセットする

あなたのイベントのテスターのためにプレイヤーの進捗データをリセットすることができます。

• Google Play Consoleにてドラフトのイベントをリセットするには、そのイベントのフォームの下部にある Reset event progressとラベルされたボタンをクリックします。
• イベントデータをプログラム的にリセットするには、Management API Events methodsを呼び出します。

クエストの基本

クエスト APIは、プレイヤーのためにあらかじめ定義された期間内に完了しようとするためのゲーム内の挑戦を作成できるようにします。

Google Playゲームサービスのクエストはこれらの重要なプロパティを含みます:

プロパティ	説明
ID	Google Play Consoleが生成したユニークな文字列。 特定のクエストを受け付けること、そして、クエストの報酬を主張することを実装するために、あなたのゲームにてこの IDを使用します。 あなたのゲーム内でこの値をハードコーディングする必要はありません; この値を *クエストリスト* UIから取得することができます。
Name	クエストの短い名前。 これは 100文字まで可能です。 あなたのクエスト名に意味を持たせ、プレイヤーをエンゲージさせるには、これらの推奨事項に従ってください: 現在形を使用します。 ユーザをエンゲージさせるためのアクションへの呼び出しを使用します。 名前は命令形の動詞で始まる必要があります。 プレイヤーに直接的に呼び掛けます、ただし、必要であれば "you" を使用します。 例: "Collect 50 coins" "Eat 100 pancakes"
Description	クエストのより長い説明。 あなたのクエストの説明は、プレイヤーに、彼らがクエストを完了するために何をする必要があるかを知らせる必要があります。 説明は 500文字まで可能です。 最初の 150文字は、Gppgle Playゲームアプリにて示されるようなカードにてプレイヤーに表示されます。 Playゲームの *クエストリスト* UIはゲームののための特徴づけられた画像を含むので、ゲーム名に言及することは説明では必要ではありません。 例: "Zombies are taking over the town this weekend. Help take it back by killing all the zombies!" "In honor of May Day, we’ve decided to paint the town red! Get as many red gems as you can on May 1st."
Icon	あなたのイベントに関連付けられた四角いアイコン。
Banner	あなたのクエストを促すために使用される長方形の画像。
Completion Criteria	Playゲームが、クエストが完了されたかどうかを決定する方法。 これは、イベント(それは名前によって入力することができる)、および、この基準を完了するために発生しなければならないイベントの回数から構成されます(例えば、“Kill Zombie” を 100回)。
Schedule	プレイヤーがクエストを受け入れ、参加することができる期間を指定します。 日付と時刻の値を入力したとき、Google Playサービスはあなたのローカルなタイムゾーンを使用しますが、UTCとして値を格納します。 プレイヤーには、これらの値は、Google Play Games appおよびデフォルトのクエストリスト UIでは彼らのローカルなタイムゾーンで表示されることを見るでしょう。 また、毎週あるいは毎月の単位で繰り返すイベントとして、クエストをセットアップすることができます。
Reward Data	このクエストを完了したあなたのプレイヤーのための報酬を指定します。 このプロパティにデータを格納するときは、独自のゲーム固有のデータ形式を使用することができます。 詳細については、報酬データを指定するを参照してください。
Notifications	クエストが終了しようとするときに、参加しているプレイヤーに通知を送るかどうかを示すブール値。 複数の日にまたがるクエストでは、これは、クエストの最終日の開始時に発生します。 より短いクエストでは、これは、クエストで許された時間の 80%が経過したときに発生します。

クエストを作成する

あなたのゲームのための新しいクエストを作成するには、次の手順を実行します:

1. もしまだそうしていなければ、Google Play Consoleにてあなたのゲームを追加します。
2. Google Play Consoleにて左側のゲームサービスのアイコンをクリックし、あなたのゲームのエントリを選択します。
3. 左側の Questsタブを選択し、Add questボタンをクリックします。 (もしまだそうしていなければ、まず、イベントを作成しなければなりません。)
4. 作成したいクエストの詳細を入力します。
5. Saveをクリックします。 もしエラーがなければ、Google Play Consoleは Publish Questボタンを表示します。 しかしながら、あなたのクエストを公開することを進める前に、新しいクエストを確認するためにあなたのゲームをテストしてください。

Repeating questチェックボックスをチェックすることによって、毎週あるいは毎月実行するクエストを作成することができます。 これは、あなたのプレイヤーを定期的に発生する挑戦にエンゲージさせることをより容易にします。

もし以前に統合されたクエストを持っているならば、それらを繰り返しクエストに変換することができます:

1. 開発者コンソールの Questsタブに移動し、既存のクエストを開きます。 ページ上部の Copy questボタンをクリックします。
2. Questフォームの Scheduleセクションまでスクロールし、“Repeating quest” ボックスをチェックし、クエストを毎月あるいは毎週繰り返すかどうかを選択し、“Ends:” フィールドを “Never” にセットします。 ひとたびあなたの設定を保存したならば、クエストは、あなたがそれを終了することを決定するまで、毎週あるいは毎月実行されるでしょう。

クエストを編集する

作成したクエストを編集するには、次の手順を実行します:

1. Google Play Consoleにて Questsタブを開き、あなたが編集したいクエスト用のエントリを選択します。 クエストを作成したときに使用したものと同じフォームが表示されるはずです。
2. 変更します。
3. イベントの編集を終えたら、Saveボタンをクリックします。
4. あなたの変更を公開する前に、修正されたクエストを確認するためにあなたのゲームをテストします。

クエストを削除する

ドラフト状態にあるクエストを削除することができます。 Google Play Consoleにてクエストを削除するには、そのクエストのフォームの下部にある Delete questとラベルされたボタンをクリックします。

クエストデータをリセットする

プレイヤーのクエスト用の進捗データをリセットすることができます。 ドラフトおよび公開されたクエストをプログラム的にリセットするには、あなたのゲームにてクエストデータをリセットするために Management API Quests methodsを呼び出します。

報酬データを指定する

定義したそれぞれのクエストには、カスタマイズされたゲーム固有の形式にて報酬のデータ値が含まれています。 あなたのゲームクライアントでは、あなたのクエストを正常に完了したプレイヤーに付与するための対応するゲームアイテムあるいは特典を何にするか決定するために、報酬のデータ値を使用することができます。

Google Playゲームサービスは、報酬データのためにいかなる特別なセキュリティを含んでいないので、あなたのクエストにていかなる金銭的な値の報酬を指定しないことを強く勧めます。

次の例は、プレイヤーがクエストを完了したときに受信するゲーム内のアイテムをリストする JSON文字列を使用することによって、報酬データ値を指定する方法を示しています。 あなたのゲームが報酬のデータ値を解析し解釈することができる限り、あなたのゲームの実装にて任意のデータ形式を自由に使用することができます。

{
    "bonusGems": 2134,
    "extraSeconds": 12
}

さらには、プレイヤーがクエストを受け入れたとき、ゲームプレイをカスタマイズするために報酬データ値のコンテンツを使用することもできます。 例えば、プレイヤーがあなたのクエストを受け入れたときに、あなたのゲームが表示する必要がある短いアニメーションあるいは動画を指し示すリンクを格納するために報酬データを使用することができます。

クエストをテストする

それらを公開する前にクエストをテストするには:

1. Google Play Consoleにて、クエストを作成し、そのスケジュールの日付を現在の日と重なるものに設定します。 まだクエストを公開しないでください。
2. あなたのゲームへのテストアクセス持ったユーザにクエストを試してもらいます。 テストのためにユーザを有効にするには、ゲームの変更をテストし公開するに記載された手順に従ってください。 クエストが受け入れられるまで、クエストの進捗は更新されません。 さらには、Google Play Consoleにて指定されていることが利用可能になるまで、クエストは受け入れられることができず、クエストピッカーにてアクティブになることができません。 報酬データをチェックするためのテストをする方法の例については、management tools sample appを参照してください。
3. あなたのクエストが正常に動作していることに満足したとき、そのスケジュールの日付を、プレイヤーがあなたのクエストに参加できるようにさせたいものに変更します。
4. Google Play Consoleからあなたのクエストを公開します。

クライアントの実装

あなたのプラットフォーム用のイベントとクエストを実装する方法については、次のリソースを参照してください:

• Android
• Web
• C++ API
• イベントとクエストを実装するためのベストプラクティス