チャレンジを管理する
注釈:本資料はAI技術を用いて翻訳されています。
概要
AccelByte Gaming Services (AGS) 管理者ポータルで複数のチャレンジを設定し、それらがアクティブになるタイミングとプレイヤーへの割り当て方法を制御できます。
この記事では、AGS管理者ポータルまたはAGS CLIを使用してチャレンジを作成・設定する方法について、基本情報、アクティブ期間とローテーションサイクル、ゴール、報酬の設定を含めて説明します。
前提条件
- AGS管理者ポータルへのアクセス権限
- パブリッシャーまたはゲームネームスペース
- AccelByte ChallengeサービスAPIドキュメントへのアクセス権限
- Challengeサービスの主要概念の理解。Challengeの概要を参照してください。
- AGS CLIの手順に従うには、AGS CLIをインストールし、これらの機能へのアクセス権を持つアカウントでサインインしてください。インストールとサインインを参照してください。例ではBashシェルを使用しています。
チャレンジを表示する
- Admin Portal
- AGS CLI
-
AGS管理者ポータルで、Engagement > Challengesに移動します。Challengeページが表示されます。
-
チャレンジのリストから、表示または編集したいチャレンジを見つけてクリックします。チャレンジの詳細ページが表示されます。
-
ネームスペース内のチャレンジを一覧表示します。チャレンジコードでリストを絞り込むには、
--keyword <ChallengeCode>を追加します。ags challenge challenges list --namespace <YourNamespace> -
チャレンジの詳細を取得します:
ags challenge challenges get --namespace <YourNamespace> --challenge-code <ChallengeCode>
チャレンジを作成する
- Admin Portal
- AGS CLI
-
Challengeページで、ページの右上にある**+ Create Challenge**ボタンをクリックします。
-
Basic Informationセクションで、必要な情報を入力します:
-
基本情報
- Challenge Name: チャレンジの名前を入力します。これはゲーム内でプレイヤーに表示されるチャレンジの名前になります。
- Challenge Code: チャレンジを識別するコードを作成します。
- Description: (オプション) チャレンジの説明を入力します。
-
期間
- Start Date: チャレンジの開始日時を設定します。次のいずれかのオプションを設定することもできます:
- Never: チャレンジは常にアクティブで、プレイヤーはいつでもゴールを完了できます。
- After: チャレンジは数回のローテーション期間後に非アクティブになります。
- Goals Rotation: チャレンジ内のゴールのローテーション方法を設定します。利用可能なオプションは:None、Daily、Weekly、Monthlyです。これらのローテーションオプションの詳細については、ゴールローテーションを参照してください。このオプションを設定すると、その下にGoals Assignmentセクションが表示されます。
- Start Date: チャレンジの開始日時を設定します。次のいずれかのオプションを設定することもできます:
-
ゴール割り当て
- Assignment Rule: プレイヤーへのゴールの割り当て方法を設定します。
- Fixed assignment: ローテーションまたはサイクルの各期間でプレイヤーに割り当てるゴールを手動で選択する必要があります。チャレンジでゴールを作成または編集する際に、各ゴールの期間を選択できます。ゴールと報酬を作成するを参照してください。
- Randomized assignment: ローテーションまたはサイクルの各期間でプレイヤーに割り当てるゴールをサービスがランダムに選択できるようにします。例えば、チャレンジで33個のゴールを作成し、Challengeサービスが毎週3つのゴールをランダムに選択してプレイヤーに割り当てるようにします。
- Unscheduled: チャレンジ内のすべてのゴールがプレイヤーに公開され、チャレンジ期間中いつでも開始して完了できます。
- Goals Visibility For Players: プレイヤーに対するチャレンジの表示設定を構成します。
- Goals visible in all rotations: プレイヤーはローテーション期間全体で利用可能なすべてのゴールを確認できます。
- Goals visible only in active rotation: プレイヤーはアクティブ(現在)のローテーション中にのみ利用可能なゴールを確認できます。
- Total Goals For Each Rotation: 指定された期間にプレイヤーに割り当てられるゴールの数を設定します。これらのゴールは、指定された期間内にプレイヤーがアクセスして達成できます。この設定はランダム割り当てルールでのみ有効です。
- Assignment Rule: プレイヤーへのゴールの割り当て方法を設定します。
-
-
NextをクリックしてGoals and Rewardsセクションに進みます。この時点で、チャレンジが作成され、INIT(初期化中)ステータスでChallengeリストに追加されます。その後、チャレンジにゴールを追加できます。ゴールと報酬を作成するに進んでください。
-
チャレンジの設定を含む JSON ファイルを作成します。ファイル名は任意です。この例では
challenge.jsonを使用し、ローテーションなしで、プレイヤーがいつでもゴールを完了できるチャレンジを作成します:{
"code": "<ChallengeCode>",
"name": "<ChallengeName>",
"description": "<Description>",
"startDate": "<StartDate>",
"rotation": "NONE",
"assignmentRule": "UNSCHEDULED",
"goalsVisibility": "SHOWALL"
}code: 小文字の英字、数字、ハイフンを使用できます。先頭と末尾は英字である必要があります。startDate: UTC 時刻で指定します(例:2026-11-01T00:00:00Z)。rotation:NONE、DAILY、WEEKLY、またはMONTHLY。NONEを使用する場合は、管理者ポータルと同様にassignmentRuleをUNSCHEDULEDに設定します。
これらのフィールドは管理者ポータルの設定に対応しています。すべてのフィールドを確認するには、
ags challenge challenges create --skeletonを実行します。管理者ポータルの設定 リクエストボディのフィールド Challenge Name nameChallenge Code codeDescription descriptionStart Date startDateNever(終了) endDateとendAfterを省略しますAfter(終了) endAfter: ローテーション期間の数Goals Rotation rotationAssignment Rule assignmentRule:FIXED、RANDOMIZED、またはUNSCHEDULEDGoals Visibility For Players goalsVisibility: すべてのローテーションでゴールを表示する場合はSHOWALL、アクティブなローテーションでのみゴールを表示する場合はPERIODONLYTotal Goals For Each Rotation activeGoalsPerRotation -
チャレンジを作成します。
@の後に JSON ファイルのパスを指定します:ags challenge challenges create --namespace <YourNamespace> --json @challenge.jsonチャレンジは INIT ステータスで作成されます。その後、チャレンジにゴールを追加できます。ゴールと報酬を作成するに進んでください。
ゴールと報酬を作成する
各チャレンジ設定は最大100個のゴール設定をサポートできます。
- Admin Portal
- AGS CLI
-
Goals and Rewardsセクションで、+Create Goalsボタンをクリックします。Create Goalsフォームが表示されます。
-
Create Goalsフォームで、必要な情報を入力します:
- Goal Name: ゴールの名前を入力します。
- Goal Code: ゴールを識別するコードを入力します。
- Description: ゴールの説明を入力します。
- Tags: ゴールのタグを作成または選択します。タグはチャレンジ内のゴールをグループ化およびフィルタリングするのに役立ちます。
- Status: ゴールを有効または無効にします。後で必要に応じてステータスを変更できます。
- Requirements: ゴールの要件を追加します。ゴールの要件とは、プレイヤーがゴールを達成するために完了する必要があることを指します。ORまたはANDロジックを使用して、単一のゴールに対する要件の組み合わせを作成できます。サポートされている要件の詳細については、チャレンジゴールのサポートされている要件を参照してください。
注記選択した要件によっては、パラメータまたは条件を指定する必要がある場合があります。例えば:
-
Rewardsセクションで、プレイヤーが要件を満たした後に付与するRewardsを追加します。利用可能なオプションは:
- Entitlement: アイテムを報酬として選択します。
- Statistics: 統計を報酬として選択します。
-
Saveをクリックします。ゴールがチャレンジのGoals and Rewardsリストに追加されます。手順4から7を繰り返して、さらにゴールと報酬を作成します。
-
チャレンジのゴールと報酬を作成した後、Saveをクリックします。
チャレンジとそのゴールは、設定したアクティブローテーションと割り当てルールに基づいて公開され、プレイヤーに割り当てられます。
Fixed assignment ルールを使用するチャレンジの場合は、各ゴールの期間を選択できる Admin Portal タブの手順を使用してください。以下の手順は、それ以外の割り当てルールで使用できます。
-
ゴールの設定を含む JSON ファイルを作成します。ファイル名は任意です。この例では
goal.jsonを使用します:{
"code": "<GoalCode>",
"name": "<GoalName>",
"description": "<Description>",
"isActive": true,
"tags": ["<Tag>"],
"requirementGroups": [
{
"operator": "AND",
"predicates": [
{
"parameterType": "STATISTIC",
"parameterName": "<StatisticCode>",
"matcher": "GREATER_THAN_EQUAL",
"targetValue": 10
}
]
}
],
"rewards": [
{
"type": "ENTITLEMENT",
"itemId": "<ItemId>",
"itemName": "<ItemName>",
"qty": 1
}
]
}isActive: ゴールの Status。有効にするにはtrueを使用します。requirementGroups: 要件のグループごとに 1 つのオブジェクトを追加します。プレイヤーは、いずれか 1 つのグループ内のすべての条件(predicate)を満たすとゴールを完了します。parameterType:STATISTIC、STATISTIC_CYCLE、ACHIEVEMENT、ENTITLEMENT、またはUSERACCOUNT。STATISTIC_CYCLEの場合は、statCycleIdも設定します。parameterName:parameterTypeに応じて、統計またはアチーブメントのコード、あるいは追跡するその他の値。matcher:EQUAL、GREATER_THAN、GREATER_THAN_EQUAL、LESS_THAN、またはLESS_THAN_EQUAL。rewards:typeはENTITLEMENTまたはSTATISTICです。STATISTICの場合は、itemIdに統計コード、itemNameにその名前を設定します。
すべてのフィールドを確認するには、
ags challenge goals create --skeletonを実行します。 -
ゴールを作成します。
@の後に JSON ファイルのパスを指定します:ags challenge goals create --namespace <YourNamespace> --challenge-code <ChallengeCode> --json @goal.jsonゴールごとに新しいファイルを作成して、この手順を繰り返します。
-
チャレンジの
assignmentRuleがRANDOMIZEDで、randomizedPerRotationがtrueの場合は、ゴールを追加した後にゴールをランダム化します:ags challenge challenges randomize --namespace <YourNamespace> --challenge-code <ChallengeCode>
チャレンジを編集または削除する
- Admin Portal
- AGS CLI
-
Challenge pageで、編集または削除したいチャレンジを見つけてクリックします。チャレンジの詳細ページが表示されます。
-
詳細ページの右上で、次のいずれかを実行します:
- チャレンジを編集するには、Editをクリックします。Edit Challengeフォームが表示されます。チャレンジまたはそのゴールの設定方法については、チャレンジを作成するセクションの手順2とゴールと報酬を作成するを参照してください。
- チャレンジを削除するには、Deleteをクリックし、ポップアップで再度クリックして削除を確認します。チャレンジはネームスペースから削除されます。
チャレンジを編集するには:
-
チャレンジの現在の設定をファイルに保存します:
ags challenge challenges get --namespace <YourNamespace> --challenge-code <ChallengeCode> --format json > challenge.json -
challenge.jsonで変更したい設定を編集します。更新は設定全体を置き換えるため、その他の設定はそのままにしてください。ゴールを変更するには、ゴールと報酬を作成するを参照してください。 -
編集したファイルを送信します:
ags challenge challenges update --namespace <YourNamespace> --challenge-code <ChallengeCode> --json @challenge.json注記チャレンジにアクティブなゴールがある場合、ローテーション、割り当てルール、繰り返し設定、および終了設定を変更することはできません。
チャレンジを削除するには、次のコマンドを実行します:
ags challenge challenges delete --namespace <YourNamespace> --challenge-code <ChallengeCode>