報酬システム

用語集

どのように動作するか

この報酬システムにより、実際通貨を使用してストアで商品を購入するようユーザーを促すことができます。ユーザーがクランに所属している場合、その購入額に応じてクラン全体にバリューポイントが加算されます。

個人用およびクラン用の報酬チェーンを作成し、購入したアイテムに対してユーザーに報酬を付与できます。ゲームには、任意のタイプのリワードチェーンを複数含めることができます。各チェーンの最大ステップ数は31です。各レベルについて、それを完了するために必要なバリューポイント数を定義します。

パーソナライズされた報酬チェーンを作成することも可能です。個人用設定機能により、ユーザーの属性に基づいて、特定の認証されたユーザーグループにのみそのチェーンを表示できます。パーソナライズされた報酬チェーンは、個々のユーザーまたはクラン向けに設計できます。

報酬チェーンの各ステップで、ユーザーは1から10個の報酬を受け取ることができます。クランも、各ステップでメンバーあたり1から10個の報酬を受け取ることができます。

次のアイテムタイプをユーザーに報酬として提供できます：

• 仮想アイテム
• 仮想通貨
• 仮想通貨パッケージ
• バンドル

報酬システムが正しく機能するためには、ユーザー認証を設定する必要があります。未認証のユーザーの場合、個人用とクラン用の両方の報酬チェーンが進行状況なしで表示されます。クランに所属していない認証済みユーザーは、自分の個人用報酬チェーンのみが表示されます。クラン用の報酬チェーンは利用不可として表示されます。

ユーザーフロー

1. ユーザーがサイトに移動します。
2. ユーザーは、アイテムカタログ、報酬システム、そして各アイテムで利用可能なバリューポイント数を見ることができます。
3. ユーザーがログインします。
4. ユーザーは報酬システムで現在の進捗状況を確認できます。
5. ユーザーは購入を行い、報酬チェーンに沿って進みます。

入手方法

報酬システムを設定するには、以下の詳細が必要です：

• 報酬システムの開始日と終了日

• 個人とクラン報酬チェーンの進行を可能にする画像、説明、SKU、およびバリューポイントの名前
• バリューポイント数
• 報酬チェーン内のアイテム

以下の例を参照してください。

報酬チェーン：

説明	例
名前	シャード
説明文書	報酬を獲得するには、シャードを集めてください。
SKU	ExampleSKU003
画像またはそのURL

以下のことをあなたの側で実装します：

• ストア内の報酬システムの要素の表示：
  • カタログに掲載されているアイテムを購入した際に付与されるバリューポイント数
  • バリューポイント
  • ステップ
  • 報酬チェーン
  • 許可されたユーザーのバリューポイントの残高
  • 報酬
• ユーザーのクランデータをエクソーラログインに送信する

報酬システムを設定するには、次のAPIメソッドを実装します：

• 仮想アイテムリストを取得する
• 現在のユーザーの報酬チェーンを取得する
• 現在のユーザーのバリューポイント残高を取得する
• ステップ報酬を受け取る
• 現在のユーザーのクランを更新する
• クランの報酬チェーンに上位10人の貢献者を獲得する

ユーザーのクランを定義する

エクソーラサイトビルダーを使用していない場合は、クラン報酬チェーンが正しく機能するように、ユーザー属性にユーザーのクランを渡す必要があります。

ユーザーにクラン属性を追加するには、属性更新メソッドを使用し、リクエストボディにクランの値を含むattributes配列を渡してください。

例：

 1
 2{
 3"attributes": [
 4{
 5
 6"key": "clan_id",
 7"value": "beetles"
 8}
 9],
10"publisher_id": 000000,
11"publisher_project_id": 000000
12}

カスタムID経由での認証するAPIを使用している場合は、ユーザー認証時に現在の属性値を直接渡すことができます。

APIを使用して、ユーザーの現在のクランを更新することもできます。まず、エクソーラログインでユーザーの属性を更新し、次に現在のユーザーのクランを更新するAPIを呼び出します。属性に新しいクランが含まれている場合、ユーザーは以前のクランのリワードチェーンから未請求の報酬を受け取り、そのクラン所属が更新されます。ユーザーが以前クランのメンバーであったが、現在は所属していない場合、そのクランメンバーシップは取り消されます。このメソッドからの応答には、ユーザーがすでに請求した報酬が含まれます。

パブリッシャーアカウント経由のセットアップ

報酬チェーンを作成する前に、ユーザーとクランがバリューポイントを獲得するために購入できるバリューポイント、報酬、およびアイテムを作成する必要があります。

バリューポイントを作成する

バリューポイントを作成するには：

1. パブリッシャーアカウントのプロジェクトで、ストア > Live-opsとプロモーションツールセクションに移動します。
2. 「報酬」タブで、「バリューポイントを作成」をクリックします。

3. 以下のパラメータを指定します：
   • 画像を追加する（任意）。
   • バリューポイントの一意なSKUを入力する。
   • バリューポイントがクランで使用されるかどうかを示す。
   • バリューポイント名を入力する。

4. 「次へ」をクリックします。
5. 仮想アイテムのSKUを選び、ユーザーが購入1回ごとに獲得できるバリューポイント数を入力します。
6. 必要な数のアイテムを追加するには、「+」をクリックしてください。
7. 「保存」をクリックします。

作成されたバリューポイントは、報酬チェーンの上に表示されます。クラン用のバリューポイントは、それに応じてマークされます。特定のバリューポイントの設定を変更するには、対応する行の「編集」をクリックしてください。

報酬チェーンを作成する

報酬チェーンを作成するには：

1. パブリッシャーアカウントのプロジェクトで、ストア > Live-opsとプロモーションツールセクションに移動します。
2. 「報酬を作成」をクリックします。

3. 新規報酬チェーンタイプを、個人報酬チェーンまたはクラン報酬チェーンから選択します。
4. 以下のパラメータを指定してください。個人報酬チェーンを選択した場合：
   1. 報酬チェーンの名前を指定します。
   2. 説明を入力します。
   3. ドロップダウンリストから、バリューポイントを選択します。

クラン報酬チェーンを選択する場合：
1. クランタイプのドロップダウンリストで、クランのタイプを選択します。
2. クラン報酬チェーンのパラメータを設定します：
   1. 報酬チェーン名を設定します。
   2. 説明を提供します。
   3. 報酬チェーンのポップアップヘッダーのタイトルを設定します。
   4. ポップアップのヒントテキスト（ユーザーが自分のクランのために報酬を得るために何をする必要があるか）を設定します。
   5. 画像を追加します（任意）。
   6. ドロップダウンリストで、バリューポイントを選択します。

5. 「次へ」をクリックします。
6. 「新規ステップを追加」をクリックします。
7. 以下のパラメータを指定して「保存」をクリックしてください：
   1. ステップ名。
   2. 報酬を受け取るために必要なバリューポイント数。
   3. このステップに必要な仮想アイテム数。
8. 「次へ」をクリックします。

9. パーソナライズされた報酬チェーンを作成したい場合は：

   1. パーソナライズされた報酬チェーンのトグルを有効にします。
   2. チェーンの表示オプションをいずれか選択し、「次へ」をクリックします：
      • 特定のユーザーに報酬チェーンを表示します。有効にすると、指定された条件を満たす承認されたユーザーにのみチェーンが表示されます。
      • 条件を満たさないユーザーに報酬チェーンを表示します。有効にすると、ユーザーに一致する報酬チェーンが見つからない場合にのみチェーンが表示されます。たとえば、ユーザーが認証されていない場合や、その属性がいずれのパーソナライズされたチェーンとも一致しない場合などです。
   3. 特定のユーザーにチェーンを表示することを選択した場合：
      1. 「条件を追加する」をクリックし、パーソナライズ条件を設定します：
         • ユーザー属性はユーザーの国や年齢などの特性です。属性はログインセクションで設定されます。
         • 属性タイプは属性値の形式（文字列、数値、日付）を定義します。
         • 比較演算子はユーザー属性値と指定された条件をどのように比較するかを決定します（例: 等しい、より大きい、より小さいまたは含む）。
         • 属性値は比較に使用する特定の値です。たとえば、ユーザー属性が年齢、属性タイプが数値、比較演算子が「より大きい」、属性値が18の場合、チェーンは18歳以上のユーザーにのみ表示されます。
      2. 別の個人用設定条件を追加するには、「条件を追加する」をクリックします。
   4. 「次へ」をクリックします。

10. 必要なステップ数を作成し、「保存」をクリックします。

11. 「次へ」をクリックします。
12. 報酬チェーンの有効期間を指定します。
13. 特定の日時にリワードチェーンを更新したい場合は、「報酬チェーンを更新可能にする」トグルを「オン」にし、更新モードを指定してください。

12. 「保存」をクリックします。

1. 報酬カタログで、報酬チェーンを選択します。
2. 「•••」をクリックしてドロップダウンリストから「アクティブ化」を選択します。

APIコール経由のセットアップ

報酬システムを管理するには、「報酬チェーンと価値ポイント」メソッドグループの管理者サブセクションのメソッドを使用できます。

1. バリューポイントを作成するAPIを介して報酬へのアクセスを許可するバリューポイントを作成します。
2. アイテムの価値ポイントを設定するAPIを介して特定のアイテムに価値ポイントを割り当てます。ユーザーはアイテムを購入した後にこれらのポイントを受け取ります。

3. 報酬チェーンを作成するAPI を使用して報酬システムを作成します。パーソナライズされた報酬チェーンを作成するには、表示条件をattribute_conditions配列に渡してください。

   条件で定義された属性を持たないユーザーにも、パーソナライズされた報酬チェーンを表示するかどうかを指定できます。これを行うには、can_be_missingパラメータにtrueを渡してください。

   該当するパーソナライズされた報酬チェーンが見つからないユーザーに対して表示する、既定の報酬チェーンを定義できます。定義するには、is_always_visibleパラメータにfalseを設定してください。

4. 報酬チェーンを切り替えるAPIを介して報酬システムをアクティブ化します。

報酬システムを修正、無効化、または削除したり、アイテムからバリューポイントを削除したりすることもできます。