アチーブメント セットアップ ガイド

Epic Games Store に公開されている製品の場合、Epic Games Store アチーブメントで製品のユーザー エクスペリエンスを向上させることができます。これらのアチーブメントは、Epic Online Services アチーブメント の機能を強化するものであり、お客様の製品を使用したユーザーに経験値 (XP) を付与するために使用できます。

製品の Epic Games Store アチーブメントを実装するプロセスの概要を以下に示します。Epic Games Store アチーブメントの一般的な情報については、「アチーブメントの概要」を参照してください。

まず、以下の手順に従って Epic Games Store アチーブメント用の製品を準備します。

1. Epic Online Services デベロッパー契約に署名する。
   • 注記：この手順は、お客様の組織で 1 回だけ実行する必要があります。
2. 開発サンドボックスとステージ サンドボックス、およびデプロイメントを生成する。
3. Epic Games Store アチーブメントで使用する各サンドボックスでデプロイメントを選択する。

組織のオーナーは最新のデベロッパー契約を読んで署名する必要があります。この契約に同意するまで Epic Games Store アチーブメントを使用することはできません。

この契約を読んで署名するには、組織のオーナーは以下の手順に従います。このプロセスを完了できるのは組織のオーナーのみです。:

1. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。次に [Epic Games Store Achievements (Epic Games Store アチーブメント)] を選択します。
2. [Developer Agreement (デベロッパー契約)] セクションで、[See Agreement (契約を見る)] をクリックします。
3. Epic Online Services デベロッパー契約を確認し、[Accept (同意)] をクリックします。

契約に署名したら、以下の手順 2 および 3 に進みます。

Epic Games Store アチーブメントのセットアップの次の手順では、製品で開発およびステージ サンドボックスとデプロイメントを生成します。サンドボックスとデプロイメントが生成されたら、Epic Games Store アチーブメントで使用するプライマリ デプロイメントとして、各 サンドボックス で デプロイメント を 1 つ選択します。Epic Online Services では、アチーブメント データを含め、製品のすべてのユーザー データを特定のデプロイメントに関連付けます。

注記：サンドボックスとデプロイメントの詳細については、「製品管理」を参照してください。

サンドボックスとデプロイメントを生成して選択するには、以下の手順に従います。

1. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。次に [Epic Games Store Achievements (Epic Games Store アチーブメント)] を選択します。
2. [Generate Sandboxes and Deployments (サンドボックスとデプロイメントを生成)] セクションで、[Generate (生成)] をクリックして新しい開発およびステージ サンドボックスとそれらに関連するデプロイメントを作成します。
   • 注記：製品に 1 つ以上のデプロイメントを含む開発およびステージ サンドボックスがすでにある場合は、この手順をスキップして手順 3 に進んでください。
3. [Select a Primary Deployment per Sandbox (サンドボックスごとにプライマリ デプロイメントを選択)] セクションで、Epic Games Store アチーブメントを含める各サンドボックスのプライマリ デプロイメントを選択します。
   • ヒント：開発とステージに関しては、プリプロダクション QA に使用しているデプロイメントを選択します。ライブに関しては、ライブ製品と関連付けられているデプロイメントを選択します。
4. プライマリ デプロイメント セクションを確認したら、[Submit (提出)] をクリックしてこのプロセスを完了します。

セットアップ プロセスが完了したら、Epic Games Store アチーブメントを作成できます。

次のように、製品の Epic Games Store アチーブメントの作成方法は 2 つあります。

• 一括インポートで複数の Epic Games Store アチーブメントを一度に定義する。
  • ヒント：すでに Epic Online Services アチーブメントを製品に追加している場合は、この方法をお勧めします。
• デベロッパー ポータルのインターフェースを使用して、Epic Games Store アチーブメントを一度に 1 つずつ定義する。

以下のセクションで、これらの方法のそれぞれについて詳しく説明します。

製品に複数の Epic Games Store アチーブメントを一度に追加するには、一括インポート プロセスを使用します。このプロセスでは、ダウンロードしたファイルでアチーブメントを定義してから、その情報をデベロッパー ポータルにアップロードします。

注記：一括インポート プロセスは、開発サンドボックスで Epic Games Store アチーブメントにリンクしたデプロイメントで完了する必要があります。

このプロセスを開始するには、次の方法のいずれかを選択して開始ファイルを取得します。

• 方法 1：ライブ デプロイメントから zip ファイルに現在の Epic Online Services アチーブメントをエクスポートします。すでに製品に対してアチーブメントを定義している場合は、このオプションをお勧めします。
• 方法 2：Epic Games Store アチーブメント テンプレートをダウンロードして新しいアチーブメントを作成します。

ファイルを作成したら、アチーブメントを定義してアップロード できます。

1. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。次に [Epic Online Services Achievements] を選択します。
2. [Deployment (デプロイメント)] ドロップダウンでライブ サンドボックスを選択します。
3. 右上にある [Bulk Import / Export (一括インポート/エクスポート)] をクリックします。
4. [Bulk Export (一括エクスポート)] フォームで、[Export Current EOS Achievements (現在の EOS アチーブメントをエクスポート)] を選択してファイルをダウンロードします。ファイルをダウンロードしたらフォームを閉じます。

zip ファイルをダウンロードしたら、以下の「アチーブメントを定義してアップロードする」セクションを確認して次の手順に進みます。

1. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。次に [Epic Online Services Achievements] を選択します。
2. [Deployment] ドロップダウンで開発サンドボックスを選択します。
3. 右上にある [Bulk Import / Export] をクリックしてフォームを開きます。次に [Next (次へ)] をクリックします。
4. [Download Epic Games Store Achievements Zip Template (Epic Games Store アチーブメントの zip テンプレートをダウンロード)] を選択してファイルをダウンロードします。ファイルをダウンロードしたらフォームを閉じます。
   • 注記：Epic Games Store アチーブメントのオプションを使用できない場合は、セットアップ プロセス が完了していることを確認してください。

zip ファイルをダウンロードしたら、以下の「アチーブメントを定義してアップロードする」セクションを確認して次の手順に進みます。

選択した開始方法にかかわらず、次の手順ではダウンロードしたファイルで Epic Games Store アチーブメントを定義します。更新したファイルは、Epic Games Store アチーブメントを作成するためにデベロッパー ポータルにアップロードされます。

Epic Games Store アチーブメントを定義してアップロードするには、以下のプロセスに従います。

1. コンピュータでダウンロードした zip ファイルを解凍します。
2. 「achievementDefinitions.csv」というラベルが付いたファイルを開きます。
3. CSV ファイルで、最後の列に user_epic_achievements_xp というラベルが付いていることを確認します。この列がない場合はファイルに追加します。
4. CSV ファイルにアチーブメントの適切な値を入力します。
   • ファイルにライブの Epic Online Services アチーブメントが含まれていることを確認します。ライブ サンドボックスからアチーブメントをエクスポートした 場合は、これらのアチーブメントがすでに含まれているはずです。
   • アチーブメントの使用上の制限事項の詳細については、こちらを参照してください。
5. user_epic_achievements_xp 列で、アチーブメントごとに希望する経験値 (XP) を追加します。
   • 注記：XP 値を定義するときは、必ず適切な XP の要件 に従うようにしてください。

CSV ファイルにおけるアチーブメントの定義の例。

6. (任意) 「achievementLocalizations.csv」ファイルを編集することにより、ローカライズされたテキストを追加して画像をアチーブメントに関連付けます。
   • 「achievementLocalizations.csv」の詳細については、こちらを参照してください。
7. 修正した「achievementDefinitions.csv」ファイルを含むファイルを新しい zip アーカイブにコンパイルします。zip アーカイブのルート レベルにすべてのファイルを配置します。
8. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。次に [Epic Online Services Achievements] を選択します。
9. [Deployment] ドロップダウンで開発サンドボックスを選択します。
10. 右上にある [Bulk Import / Export] をクリックしてフォームを開きます。次に [Next] をクリックして [Bulk Import (一括インポート)] ページに進みます。
11. ページの下部にある [Upload Achievement (アチーブメントをアップロード)] セクションを探し、警告メッセージを確認して承認します。
12. [Choose File to Upload (アップロードするファイルを選択)] をクリックし、zip アーカイブを選択します。次に [Next] をクリックしてファイルをアップロードします。

アチーブメントをインポートしたら、それらのアチーブメントが「アチーブメントの XP (期待値) の要件」で指定された基準を満たしていることを確認します。

アチーブメントのインポートを確認するには、以下の手順に従います。

1. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。次に [Epic Games Store Achievements (Epic Games Store アチーブメント)] を選択します。
2. ページ上部にある [Push to Stage (ステージにプッシュ)] ボタンを探します。
   • ボタンが有効になっている場合、アチーブメントは検証に合格し、XP の要件を満たしています。
   • ボタンが無効になっている場合、アチーブメントは XP の要件を満たしていません。その場合はメッセージを展開し、失敗した検証の詳細を確認します。一般的なエラーとしては、XP 値がないか正しくない、合計 XP が 1,000 に等しくない、アイコンのファイルのサイズが正しくない、文字数の制限を超えているといったものが挙げられます。
3. アチーブメントに 1 つ以上のエラーがある場合は、CSV ファイルでそれらの問題を解決します。その後、zip アーカイブを更新してから、一括インポート プロセスに従ってもう一度アーカイブをアップロードします。

Epic Games Store アチーブメントは、製品で検証してからステージにプッシュできます。そのためには、SDK の初期化 時に、アチーブメントに関連付けられている開発サンドボックスとデプロイメントを使用する製品のビルドを作成します。

アチーブメントをライブにプッシュする場合、[Product Details (製品詳細)] ページと [Achievement Details (アチーブメント詳細)] ページでプレビューすることができます。そのためにはまず、審査と承認 のためにアチーブメントをステージにプッシュします。

Epic Games Store アチーブメントを作成するときは、Epic Online Services アチーブメントにリンクして経験値 (XP) の値を割り当てます。対応する Epic Online Service アチーブメントがない場合は、デベロッパー ポータルで作成できます。

注記： このセクションでは、Epic Games Store アチーブメントを 1 つ作成してリンクする方法について説明します。すでに製品に Epic Online Services アチーブメントが複数ある場合、または複数のアチーブメントを作成したい場合は、Epic Games Store アチーブメントの一括アップロード のプロセスに従うことを強くお勧めします。

Epic Games Store アチーブメントを作成する前に、そのアチーブメントを関連付ける、対応する Epic Online Services アチーブメントを用意しておく必要があります。次の 2 つの方法で Epic Online Services アチーブメントを定義できます。

• 製品に対応するコードを書き込んでから起動します。詳細については、「Epic Online Services アチーブメント」を参照してください。
• 各 Epic Online Services アチーブメントのベースを 統計 に設定します。たとえば、ユーザーがゲーム内で一定の距離を移動することに対して報酬を与えるアチーブメントを作成するには、最初にプレイヤーの移動距離を追跡する統計を作成してから、アチーブメントとその統計を関連付けます。

Epic Online Services アチーブメントを作成するには、以下の手順に従います。

1. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。次に [Epic Online Services Achievements] を選択します。
2. [Deployment] ドロップダウンで、開発サンドボックスに関連付けられているデプロイメントを選択します。
3. 右上のオプションの [Create New (新規作成)] をクリックします。
4. このアチーブメントのベースを統計にするには、ドロップダウンから目的のオプションを選択してから、アチーブメントのロックを解除する統計値を入力します。
5. [Next] をクリックします。
6. 次のとおり [Create New Achievement (新しいアチーブメントを作成)] フォームに必要な情報を入力します。
   • アチーブメント ID：アチーブメントを識別する一意の値。
   • ロケールを選択：指定したアチーブメントの名前と説明のロケール。必要に応じて、Epic Games Store がサポートしている言語ごとに一連の一意の Epic Games Store アチーブメントを作成できます。
   • 可視性：ロックを解除する前に、アチーブメントを製品ユーザーに表示するかどうかを決定します。
   • アンロックされたアイコン：アチーブメントのロックを解除した後にソーシャル オーバーレイか製品がユーザーに表示する画像。
   • ロックされたアイコン：アチーブメントのロックを解除する前にユーザーに表示されるアイコン。Epic Games Store アチーブメントではこのアイコンは使用 されず、Epic Games Store ユーザーには半透明のロック解除アイコンが表示されるということに注意してください。
   • ロックされた表示名：アチーブメントのロックを解除する前にユーザーに表示される名前。
   • ロックされた説明文：アチーブメントのロックを解除する前にユーザーに表示される説明。
   • ロック解除された表示名：アチーブメントのロックを解除した後にユーザーに表示される名前。
   • ロック解除された説明：アチーブメントのロックを解除した後にユーザーに表示される説明。
   • 任意のフレーバーテキスト：製品で自由に使用できる任意のテキスト。
7. フォームが完成したら、[Create (作成)] をクリックして新しいアチーブメントを保存します。

Epic Online Services アチーブメントを用意したら、Epic Games Store アチーブメントを作成し、2 つのアチーブメントをまとめてリンクできます。これを実行するには、以下の手順に従います。

1. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。次に [Epic Online Services Achievements] を選択します。
2. [Deployment] ドロップダウンで、開発サンドボックスに関連付けられているデプロイメントを選択します。
3. アチーブメントのリストで、新しい Epic Games Store アチーブメントにリンクする Epic Online Services アチーブメントを見つけます。
4. アチーブメントの列の右側にある メニュー アイコン (...) をクリックし、[Link Achievements (実績をリンク)] を選択します。
5. アチーブメントの XP 値を入力します。
   • ヒント：ガイドラインについては、「アチーブメントの XP (経験値) の要件」を参照してください。
6. [Create Link (リンクを作成)] を選択し、新しい Epic Games Store アチーブメントを完成させて保存します。

Epic Games Store アチーブメントがライブにプッシュされる前に XP 値を編集できます。アチーブメントがライブになると、この値を変更することはできません。

Epic Games Store アチーブメントで付与された XP を変更する方法は、次のとおりです。

1. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。
2. Epic Online Services アチーブメントの上にあるドロップダウンで、開発サンドボックスに関連付けられているデプロイメントを選択します。
3. [Epic Games Store Achievements] をクリックし、更新するアチーブメントを見つけます。
4. アチーブメントの列の右側にある メニュー アイコン (...) をクリックし、[Edit XP (XP を編集)] を選択します。
5. 希望するアチーブメントの XP 値を入力します。
6. [Save (保存)] をクリックして変更を確定します。

Epic Games Store アチーブメントを削除するには、関連付けられている Epic Online Services アチーブメントからアチーブメントのリンクを解除します。このアクションにより、製品から Epic Games Store アチーブメントが削除されます。Epic Online Services アチーブメントは削除 されません。

Epic Games Store アチーブメントのリンクを解除してアチーブメントを削除するには、以下の手順に従います。

1. デベロッパー ポータルで、[Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Progression (進行状況)] > [Achievements (アチーブメント)] の順に移動します。
2. Epic Online Services アチーブメントの上にあるドロップダウンで、開発サンドボックスに関連付けられているデプロイメントを選択します。
3. [Epic Games Store Achievements] をクリックし、削除するアチーブメントを見つけます。
4. アチーブメントの列の右側にある メニュー アイコン (...) をクリックし、[Unlink (リンクを解除)] を選択します。
5. [Remove Link (リンクを削除)] を選択し、Epic Games Store アチーブメントのリンクを解除してアチーブメントを削除します。

Epic Games Store では、[Product Details] ページと製品の専用の [Achievements] ページの両方にアチーブメントの情報が表示されます。この情報をプレビューするには、まず以下の状態になっていることを確認します。

• 製品がライブにプッシュされている。
• 製品にカタログ アイテムがある。
• 製品に オファー がある。

次に、ライブにプッシュする前に以下の URL を使用して製品のアチーブメントをプレビューします。次の <product-name> の部分を製品の名前で置き換えます。/store/en-US/achievements/<product-name>

アチーブメントの詳細ページの例。

ユーザーが Epic Games Store アチーブメントを獲得できるようにするには、次のワークフローに従う必要があります。

1. 開発サンドボックスで アチーブメントを作成します。
2. Epic Games Store チームによる審査を受けるために、アチーブメントをステージ サンドボックスにプッシュしてサブミットします。
3. 承認されたら、アチーブメントをライブ サンドボックスにプッシュします。

注記：

• Epic Games Store アチーブメントをサンドボックス間でプッシュする場合、宛先サンドボックスにリンクされたデプロイメントのアチーブメントを置き換えます。
• Epic Games Store アチーブメントがライブになると、デベロッパー ポータルでその XP 値を調整したり、アチーブメントを削除したりできなくなります。公開された実績を削除する場合は、非公開ディスカッションを作成 してサポートに問い合わせてください。
• アチーブメントに関連付けられているテキストや画像を更新する場合は、このセクションで説明しているように、通常の公開フローに従います。

アチーブメントをステージにプッシュするには、以下の手順に従います。

1. デベロッパー ポータルで、[Your Product] > [Game Services] > [Progression] > [Achievements] の順に移動し、[Epic Games Store Achievements] を選択します。
2. 右上のオプションの [Push to Stage] をクリックします。

[Push to Stage] ボタンが無効でクリックできない場合は、アチーブメントに 1 つ以上のエラーが含まれています。ページのアラート ボックスにエラーが表示され、これらの問題を解決しなれば先に進むことができません。

アチーブメントがステージにプッシュされると、Epic Games Store チームが、アチーブメントに成人向けコンテンツ、冒とく的表現、アセット フリップなどの不適切なコンテンツが含まれていないかどうかを審査します。 Epic Games はリンクされていないアチーブメント (つまり、Epic Online Services アチーブメント) をモデレートせず、Epic Games Store アチーブメントのみが審査されるということに注意してください。Epic Games Store アチーブメントは、Epic Games Store の コンテンツ ガイドライン に準拠していなければなりません。

Epic Games Store チームがアチーブメントを承認すると、アチーブメントをライブにプッシュするためのボタンとともに、画面上部にメッセージが表示されます。

Epic Games Store チームが審査プロセスで Epic Games Store アチーブメントのいずれかを却下した場合、ステージ サンドボックスに以下の例のような却下に関するメッセージが表示されます。

却下の詳細を確認するには、[See Details (詳細を見る)] をクリックします。

特定された問題を修正するには、開発サンドボックスに切り替えて必要な更新を完了してから、承認のためにアチーブメントをステージにもう一度サブミットします。

注記：

• 更新をステージにプッシュした後も、製品の承認前であればいつでも変更を加えることができます。変更を加えるには、ステージへのプッシュをキャンセルし、開発サンドボックスで目的の更新を完了します。準備が整ったら、更新した製品をもう一度ステージにプッシュします。
• アチーブメントに変更を加えた場合、アチーブメント全体をステージにもう一度サブミットして審査を受ける必要があります。

Epic Games Store アチーブメントの審査と承認が完了したら、ユーザーが獲得できるようにそのアチーブメントをライブにプッシュすることが可能です。これを実行するには、以下の手順に従います。

1. デベロッパー ポータルで、[Your Product] > [Game Services] > [Progression] > [Achievements] の順に移動し、[Epic Games Store Achievements] を選択します。
2. [Deployment] ドロップダウンでステージ サンドボックスを選択します。
3. 右上のオプションの [Push to Live (ライブにプッシュ)] をクリックします。

注記：Epic Games Store アチーブメントがライブになると、デベロッパー ポータルでその XP 値を調整したり、アチーブメントを削除したりできなくなります。

• 公開された実績を削除する場合は、非公開ディスカッションを作成 してサポートに問い合わせてください。
• アチーブメントに関連付けられているテキストや画像を更新する場合は、通常の公開フローに従います。

Epic Games Store アチーブメントの XP (経験値) の値を設定するときには、次のガイドラインに従う必要があります。

• 各製品は、定義したアチーブメント数に関係なく、合計 XP* を 1,000 ちょうどにする必要があります。現在製品で使用されている合計 XP は、デベロッパー ポータルの [Your Product] > [Games Services] > [Progression] > [Achievements] > [Epic Games Store Achievements] に表示されます。
  • 特定の製品に 1,000 XP ちょうどではない値を追加しようとすると、エラー メッセージが表示されます。
  • 製品の合計 XP が 1,000 に完全に等しくない (つまり、合計 XP を 1,000 ちょうどにできない) 場合、アチーブメントを開発からステージにプッシュできません。
• 各アチーブメントの XP 値は、5 の倍数 (5、10、15、100、110、200 など) にする必要があります。
• 1 つのアチーブメントの最小値は 5、最大値は 200 です。
• 次のように、Epic Games Store アチーブメントは、ブロンズ、シルバー、ゴールド ティアに分類されます。
  • ブロンズ：5-45 XP
  • シルバー：50-95 XP
  • ゴールド：100-200 XP
  • 1 つの製品で合計 1,000 XP を獲得したユーザーは、さらにプラチナ ティア アチーブメントを獲得できます。