サポートされているイベントと報酬を統合する

Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要​

AccelByte Gaming Services（AGS）報酬サービスを使用すると、ゲーム内で特定のチャレンジや目標を達成したことへの認識として、仮想アイテムやその他のエンタイトルメントを付与できます。これは、Identity and Access Management（IAM）、統計、実績などのAGSの他のサービスと統合することで機能し、プレイヤーが報酬を獲得するために達成する必要がある目標を定義するために使用されます。

このガイドでは、AGSの他のサービスからサポートされているイベントと報酬を統合する方法を学習します。

目標​

  • 報酬設定に関する理解と概要を提供する。
  • プレイヤーに報酬を付与するために利用可能なイベントを活用する方法についての理解を提供する。

前提条件​

  • AGS管理ポータルへのアクセス。
  • AccelByteプラットフォームAPIドキュメントへのアクセス。
  • 必要な情報を設定するためのAccelByte実績および統計APIへのアクセス。

サポートされているイベント​

AGS報酬サービスは、IAM、統計、実績などの他のサービスによって公開されるいくつかのイベントによってトリガーされる、プレイヤーへの報酬付与をサポートしています。

以下のイベント名と使用方法を理解することで、報酬と統合したいイベントを選択しやすくなります。

イベントトピックイベント名使用方法
統計statItemCreated特定の統計値を作成したときにプレイヤーが報酬を受け取るようにしたい場合に適しています。
統計statItemUpdated特定の統計値に達したときにプレイヤーが報酬を受け取るようにしたい場合に適しています。
実績userAchievementUnlocked特定の実績を獲得したときにプレイヤーが報酬を受け取るようにしたい場合に適しています。
実績achievementRewardClaimedグローバル実績の請求に成功したときにプレイヤーが報酬を受け取るようにしたい場合に適しています。
ユーザーアカウントuserAccountCreatedパブリッシャーネームスペースを使用してプラットフォームにアカウントを作成したときにプレイヤーが報酬を受け取るようにしたい場合に適しています。
ユーザーアカウントgameUserAccountCreatedゲームネームスペースを使用してプラットフォームにアカウントを作成したときにプレイヤーが報酬を受け取るようにしたい場合に適しています。
ユーザーアカウントuserAccountVerifiedゲームネームスペースを使用してプラットフォームでアカウントが確認されたときにプレイヤーが報酬を受け取るようにしたい場合に適しています。
ユーザーアカウントuserAccountLinkedゲームネームスペースを使用してプラットフォームのアカウントをサードパーティアカウントとリンクしたときにプレイヤーが報酬を受け取るようにしたい場合に適しています。
ユーザーアカウントuserAccountUpgradedゲームネームスペースを使用してヘッドレスアカウントからフルアカウントにアップグレードしたときにプレイヤーが報酬を受け取るようにしたい場合に適しています。
ユーザーアカウントthirdPartyAccountCreatedサードパーティプラットフォームからプラットフォームにアカウントを作成したときにプレイヤーが報酬を受け取るようにしたい場合に適しています。userAccountCreatedとthirdPartyAccountCreatedの両方がユーザーアカウントイベントトピックに含まれています。

新しい報酬設定を作成する​

  1. AGS管理ポータルで、エンゲージメント > 報酬に移動します。

    AGS管理ポータル報酬メニュー

  2. 報酬ページで、設定を追加ボタンをクリックします。

    設定を追加をクリック

  3. 報酬を追加フォームで、必要な情報を入力します:

    報酬を追加フォーム

    • 許可された形式（例: road-to-champion）で報酬の一意の識別子として報酬コードを入力し、作成した報酬に関する追加情報を提供するために説明を入力する必要があります。

    • イベントトピックドロップダウンから報酬のトリガーを選択します。統計、実績、またはユーザーアカウントのいずれかを選択できます。

    • 詳細設定:

      • オプションのUserID Expressionフィールドがあり、JSONパス形式を使用してイベントペイロード内のターゲットユーザーIDを示す条件を指定できます。空白のままにすると、デフォルト値は$.[0].userIdです。形式:

        $.eventPayloadObject.userId

      • もう1つのオプションフィールドはNamespace Expressionです。これを使用して、JSONパス形式を使用してイベントペイロード内のターゲットネームスペースを示す条件を指定できます。空白のままにすると、デフォルト値は$.[0].namespaceです。形式:

        $.eventPayloadObject.namespace

    • また、最大付与数フィールドにゲームネームスペースで報酬を獲得できる最大回数、およびユーザーごとの最大付与数フィールドに単一のプレイヤーが報酬を獲得できる最大回数を入力する必要があります。

  4. 追加をクリックします。新しい報酬が報酬リストに追加されます。

報酬条件を追加する​

  1. 管理ポータルの報酬ページで、更新したい報酬を見つけて、その表示オプションをクリックします。

    報酬を表示するためにクリック

  2. 報酬詳細ページで、報酬条件を追加をクリックします。

    報酬条件を設定するためにクリック

  3. 報酬条件を追加フォームで、必要な情報を入力します:

    報酬条件を追加フォーム

    • イベント名フィールドに、報酬をトリガーするために使用するイベントを入力します。詳細については、サポートされているイベントのリストを参照してください。

    • 条件名フィールドに、報酬をトリガーする特定のイベント条件の名前を入力します。

    • 条件フィールドに、JSONパス形式で報酬をトリガーする特定の条件を入力します。各イベントトピックの形式は以下のとおりです。

      • イベントトピック: 統計: これは、特定の統計値に達したプレイヤーに報酬を付与するためのものです。

        $.[?(@.statCode == "input-your-stat-code" && @.latestValue == x)]

        • 使用している統計設定のstatCodeを入力します。このコードは、管理ポータルの統計ページで確認できます。

        • プレイヤーのlatestValueと一致した場合に報酬が付与される統計値を入力します。

        • この例では、プレイヤーがrewardpoints統計で150ポイントに達すると報酬を受け取ります:

          $.[?(@.statCode == "rewardpoints " && @.latestValue == 150)]

      • イベントトピック: 実績: これは、特定の実績をアンロックしたプレイヤーに報酬を付与するためのものです。

        $.[?(@.status == 2 && @.achievementCode == "input-your-achievement code")]
        • Statusを定義します。これにより、プレイヤーが報酬を受け取るタイミングが決まります。
          • 実績が進行中のときにプレイヤーが報酬を受け取る場合は1を入力します。
          • プレイヤーが実績を受け取ったときに報酬が付与される場合は2を入力します。
        • 使用している実績設定のachievementCodeを入力します。このコードは、管理ポータルの実績ページで確認できます。
        • この例では、プレイヤーがkillingmachine実績をアンロックすると報酬を受け取ります:
        $.[?(@.status == 2 && @.achievementCode == "killingmachine ")]

      • イベントトピック: ユーザーアカウント、サードパーティログイン これは、プラットフォームにアカウントを作成した後、またはSteam、Xbox、PlayStationなどのサードパーティプラットフォームからプラットフォームにアカウントを作成した後にプレイヤーに報酬を付与するためのものです。

        $.[?(@.userId != null && @.emailAddress != null)]
        • userIdフィールドに**!=null**を入力します。これにより、ユーザーIDがnullでないことが確認されます。
        • emailAddressフィールドに**!=nullを入力します。これにより、メールアドレスがnullでないことが確認されます。サードパーティログインの場合は、このフィールドを削除してuserId**のみを使用できます。

    • 報酬アイテムフィールドに必要な情報を入力します:

      報酬アイテムフィールド

      • 報酬として付与するアイテムを選択します。アイテムがストアで既に設定されていることを確認してください（ストアに関するガイドの詳細については、こちらを参照してください）。
      • 数量フィールドに、報酬に含めるアイテムの数量を入力します。
      • 報酬アイテムがサブスクリプションの場合は、期間フィールドにサブスクリプションが続く日数を入力します。選択したアイテムが他のタイプの場合は、このフィールドを空白のままにできます。
      • 報酬にさらにアイテムを追加するには、さらにアイテムを追加をクリックします。

  4. アイテムの追加が完了したら、保存をクリックします。新しい報酬条件がリストに追加されます。

に最終更新
On this page