Setup Guide

Epic Games Store アチーブメントを製品に実装する

15 分で読めます

製品 を Epic Games ストアで公開すると、Epic Games Store アチーブメントによって製品のユーザー エクスペリエンスを強化できます。Epic Games Store アチーブメントでは Epic Online Services アチーブメント の機能が拡張されています。この機能を使用して、Epic Profile の経験値 (XP) や他のメリットを報酬としてユーザーに与えることができます。

組織が Epic Games ストアに公開できることを確認する

Epic Games Store アチーブメントは、組織が Epic Games ストアに公開できる場合のみに製品に追加できます。組織が Epic Games ストアに公開するように設定されていない場合、アクセスをリクエスト してください。

Epic Games Store アチーブメント用に製品を準備する

Epic Games Store アチーブメントを製品に追加する前に、Epic Games Store アチーブメントを使用するように製品を設定する必要があります。3 つのステップのオンボーディング プロセスに従ってください。

  1. 最新のデベロッパー契約にサインする
    • 組織に対してこれを行うのは 1 回だけです。
  2. 開発サンドボックスとステージ サンドボックス、およびデプロイメントを生成する
  3. Epic Games Store アチーブメントで使用される各サンドボックスでデプロイメントを選択する

ステップ 1:最新のデベロッパー契約にサインする

組織の所有者が最新のデベロッパー契約を一読して署名する必要があります。組織の所有者がこの契約に同意するまで Epic Games Store アチーブメントを使用することはできません。この手順を実行できるのは、組織の所有者だけです。

契約を読んでサインする方法

  1. 組織の所有者として、Dev Portal にサインインします。
    • 組織の所有者でない場合、この手順を実行するように所有者に依頼してください。
  2. [Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Achievements (アチーブメント)] > [Epic Games Store achievements (Epic Games Store アチーブメント)] に移動します。
  3. [Developer agreement (デベロッパー契約)] を選択します。
  4. 最新のデベロッパー契約を読んでサインします。

ステップ 2 と 3:サンドボックスとデプロイメントを生成して選択する

Epic Games Store アチーブメントを設定するには、最初に製品で開発およびステージ サンドボックスとデプロイメント を生成する必要があります。Epic Games Store アチーブメントで使用されるデプロイメントにするように各サンドボックスでデプロイメントを 1 つ選択する必要もあります。Epic Online Services では、アチーブメント データを含め、製品のすべてのユーザー データを特定の デプロイメント に関連付けます。

サンドボックスとデプロイメントを生成して選択する方法

  1. [Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Achievements (アチーブメント)] > [Epic Games Store achievements (Epic Games Store アチーブメント)] に移動します。
  2. まだ ステップ1:最新のデベロッパー契約にサインする を完了していない場合、続行する前にこのステップを実行する必要があります。
  3. [Generate (生成)] を選択して、新しい 開発とステージ サンドボックス および関連するデプロイメントを生成します。
    • すでに製品に開発サンドボックスとステージ サンドボックスが設定されていて、それぞれに 1 つ以上のデプロイメントがある場合、このステップをスキップできます。
  4. サンドボックスごとにプライマリ デプロイメントを選択します。デプロイメントには、Epic Games Store アチーブメントが含まれます。
  5. [Submit (送信)] を選択します。

開発サンドボックスで Epic Games Store アチーブメントを構成します。

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

Epic Games Store アチーブメントを一括でアップロードする

一括インポート機能を使用して、複数の Epic Games Store アチーブメントを同時に追加します。開発サンドボックスの Epic Games Store アチーブメントにリンクされているデプロイメントでこれを行う必要があります。

このプロセスの開始時に、次のいずれかを行う必要があります。

  • 方法 1:ライブ デプロイメントから zip ファイルに現在の Epic Online Services アチーブメントをエクスポートします。すでにアチーブメントを製品に対して定義している場合、この方法をお勧めします。
  • 方法 2:2 番目の画面に表示される Epic Games Store アチーブメント テンプレートの CSV をダウンロードします。

次に、ダウンロードしたファイルにアチーブメントを定義して、Dev Portal にファイルをインポートします

方法 1:現在の Epic Online Services アチーブメントをエクスポートする

  1. [Game Services] > [Achievements] > [Epic Games Store Achievements] に移動します。
  2. [Deployment (デプロイメント)] ドロップダウンで、ライブ サンドボックスに切り替えます。
  3. [BULK IMPORT/EXPORT (一括インポート / 一括エクスポート)] を選択します。
  4. [EXPORT CURRENT ACHIEVEMENTS (現在のアチーブメントをエクスポートする)] を選択します。
  5. 一括エクスポータを閉じます。

これで、アチーブメントを定義してアップロードできるようになりました

方法 2:Epic Games Store アチーブメント テンプレートをダウンロードする

  1. [Game Services] > [Achievements] > [Epic Games Store Achievements] に移動します。
  2. [Deployment] ドロップダウンで開発サンドボックスに切り替えます。
  3. [BULK IMPORT/EXPORT (一括インポート / 一括エクスポート)] を選択します。
  4. [NEXT (次へ)] を選択します。
  5. [DOWNLOAD Epic Games Store achievementS ZIP TEMPLATE] を選択します。
  6. 一括エクスポータを閉じます。

これで、アチーブメントを定義してアップロードできるようになりました

アチーブメントを定義してアップロードする

上記のいずれの方法でも、アチーブメントを csv ファイルに追加して、このファイルをアップロードする必要があります。

  1. コンピュータで、ダウンロードした zip ファイルを解凍します。
  2. achievementDefinitions.csv を開きます。
  3. 最後の列が user_epic_achievements_xp でない場合、この列を追加します。
  4. アチーブメントに適切な値をファイルに入力します。
  5. (オプション) achievementLocalizations.csv を編集します。このファイルで、ローカライズされたテキストを追加して画像をアチーブメントに関連付けることができます。
  6. 修正した achievementDefinitions.csv' ファイルを含む各ファイルを新しい zip アーカイブに追加します。zip アーカイブのルート レベルにすべてのファイルを配置します。
  7. Dev Portal で、[Game Services] > [Achievements] > [Epic Games Store Achievements] に移動します。
  8. [Deployment] ドロップダウンで開発サンドボックスに切り替えます。
  9. [BULK IMPORT/EXPORT (一括インポート / 一括エクスポート)] を選択します。
  10. [NEXT (次へ)] を選択します。
  11. スクロールして警告メッセージを確認し、同意します。
  12. [CHOOSE FILE TO UPLOAD (アップロードするファイルを選択)] を選択して、zip アーカイブを選択します。
Image: Example achievement definition in the CSV file

画像:画像:CSV ファイルのアチーブメント定義の例

アチーブメントのインポートを確認する

アチーブメントをインポートした後、アチーブメントの XP (経験値) の要件 を満たしていることを確認できます。

アチーブメントのインポートを確認する方法

  1. [Your Product (あなたの製品)] > [Game Services (ゲーム サービス)] > [Achievements (アチーブメント)] > [Epic Games Store achievements (Epic Games Store アチーブメント)] に移動します。
  2. 画面上部の [PUSH TO STAGE (ステージにプッシュ)] ボタンを確認します。
    • ボタンが有効な場合は、アチーブメントが検証に合格したことを意味します。つまり、アチーブメントの XP (経験値) の要件 を満たしているということです。この手順のステップ 4 に進みます。
    • ボタンが無効の場合、アチーブメントは要件の検証に合格していません。メッセージを展開して、検証に失敗したアチーブメントの詳細を表示します。一般的なエラーには、XP 値がないか正しくない、合計 XP が 1000 に等しくない、アイコン ファイル サイズが正しくない、文字数の制限を超えている、などがあります。XP の要件の詳細については、こちら を参照してください
  3. ファイル内のエラーを解決し、zip アーカイブを更新してから、一括インポート プロセスでもう一度 zip アーカイブをアップロードします。

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

アチーブメントをライブにプッシュする場合、[Product Details (製品詳細)] ページとアチーブメント詳細ページでプレビューすることができます。このためには、最初に アチーブメントをステージにプッシュして、モデレーション、レビュー、承認を行う 必要があります。

Epic Games Store アチーブメントを 1 つ作成してリンクする

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

Epic Games Store アチーブメントを作成すると、これを Epic Online Services アチーブメントにリンクして、XP 値を割り当てます。適切な Epic Online Services アチーブメントがない場合は、Dev Portal ですばやくこれを作成することができます。

Epic Games Store アチーブメントに対応する Epic Online Services アチーブメントを作成する

注記: すでに Epic Games Store アチーブメントに対応する Epic Online Services アチーブメントがある場合は、Epic Games Store アチーブメントを作成 することができます。

次の 2 つの方法で、Epic Online Services アチーブメントを定義できます。

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

Epic Online Services アチーブメントを作成する方法

  1. [Game Services] > [Achievements] > [Epic Games Store Achievements] に移動します。
  2. [Deployment] ドロップダウンで開発サンドボックスに関連付けられているデプロイメントを選択します。
  3. [CREATE NEW (新規作成)] を選択します。
  4. このアチーブメントのベースを統計に設定する場合は、統計を選択します。
    • 例えば、製品ユーザーが特定数のアイテムを収集したときに、アチーブメントのロックを解除する場合は、収集したアイテム数に関する統計を選択します。
  5. ステップ 4 で統計を選択した場合、アチーブメントのロックを解除する統計値を入力します。
    • 例えば、製品ユーザーが 5 つのお守りを収集したときに、アチーブメントのロックを解除する場合は、5 を入力します。
  6. [NEXT] をクリックします。
  7. 次のように、アチーブメントの設定を入力します。
    • Achievement ID (アチーブメント ID):アチーブメントを識別する一意の値。
    • Select Locale (ロケールを選択):名前と説明に適用するロケール。Epic Games ストアがサポートしている言語ごとに、一連の異なる Epic Games Store アチーブメントを定義することができます。
    • VISIBILITY (可視性):ロックを解除する前に、アチーブメントを製品ユーザーに表示するかどうかを決定します。
    • UNLOCKED ICON (ロック解除したアイコン):製品ユーザーがアチーブメントのロックを解除した後で、Epic Games ソーシャル オーバーレイまたは製品が表示するアイコンをアップロードします。
    • LOCKED ICON (ロックされたアイコン):アチーブメントのロックを解除する前に製品ユーザーに表示されるアイコン。 注記: このアイコンは、関連する Epic Games Store アチーブメントの製品ユーザーには表示されません。代わりに、ユーザーには半透明のロックを解除したアイコンが表示されます。
    • Locked Display Name (ロックされた表示名):アチーブメントのロックを解除する前に製品ユーザーに表示される名前。
    • Locked Description (ロックされた説明):アチーブメントのロックを解除する前に製品ユーザーに表示される説明。
    • Unlocked Display Name (ロック解除された表示名):アチーブメントのロックを解除した後に製品ユーザーに表示される名前。
    • Unlocked Description (ロック解除された説明):アチーブメントのロックを解除した後に製品ユーザーに表示される説明。
    • Flavor Text Optional (オプションのフレーバー テキスト):製品で自由に使用できるオプションの追加テキスト。
  8. [CREATE (作成)] を選択します。

Epic Games Store アチーブメントを作成してリンクする

注記:各 Epic Games Store アチーブメントを Epic Online Services アチーブメントにリンクする必要があります。Epic Online Services アチーブメントがない場合、すばやく Dev Portal でこれを作成 することができます。

新規 Epic Games Store アチーブメントを作成する方法

  1. [Game Services] > [Achievements] > [Epic Games Store Achievements] に移動します。
  2. [Deployment] ドロップダウンで、開発サンドボックスに関連付けられているデプロイメントを選択します。
  3. アチーブメントのリストで、新規 Epic Games Store アチーブメントにリンクする Epic Online Services アチーブメントを見つけます。
  4. […] > [Link achievement (アチーブメントをリンク)] を選択します。
  5. アチーブメントの XP 値を入力します。
  6. [CREATE LINK (リンクを作成)] を選択します。

Epic Games Store アチーブメントの XP 値を編集する

Epic Games Store アチーブメントで付与された XP を編集することができます。

注記: アチーブメントをライブにプッシュした後に、Epic Games Store アチーブメントの XP 値を変更することはできません。

Epic Games Store アチーブメントで付与された XP を編集することができます。

  1. [Game Services] > [Achievements] > [Epic Games Store Achievements] に移動します。
  2. Epic Online Services アチーブメントの上にあるドロップダウンで、開発サンドボックスに関連付けられたデプロイメントを選択します。
  3. Epic Games Store アチーブメント を選択します。
  4. XP を変更するアチーブメントを見つけます。
  5. [...] > [Edit XP (XP を編集)] を選択します。
  6. 新しい XP 値を入力します。
  7. [SAVE (保存)] を選択します。

Epic Games Store アチーブメントのリンクを解除して削除する

関連する Epic Online Services アチーブメントから Epic Games Store アチーブメントのリンクを解除することができます。これによって次のようになります。

  • Epic Games Store アチーブメントが削除される。
  • 関連する Epic Online Services アチーブメントは削除されない。

注記:Epic Games Store アチーブメントがライブにプッシュされる場合は、Dev Portal でアチーブメントのリンクを解除することはできません。この状況でアチーブメントを削除する場合は、Epic Games のサポートに問い合わせてください

Epic Games Store アチーブメントのリンクを解除して削除する手順です。

  1. [Game Services] > [Achievements] > [Epic Games Store Achievements] に移動します。
  2. Epic Online Services アチーブメントの上にあるドロップダウンで、開発サンドボックスに関連付けられたデプロイメントを選択します。
  3. Epic Games Store アチーブメント を選択します。
  4. リンクを解除して削除するアチーブメントを見つけます。
  5. [...] > [Unlink (リンクを解除)] を選択します。
  6. [REMOVE LINK (リンクを削除)] を選択します。

ライブの Epic Games Store アチーブメントを表示する

製品の詳細ページと、製品のアチーブメントの新しい詳細ページを表示するには、最初に次のことを確認します。

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

Achievement Details Page (アチーブメントの詳細ページ) を表示するには、次の URL を使用します。<product-name> を製品の名前で置き換えます。 /store/en-US/achievements/<product-name>

画像:アチーブメントの詳細ページの例

アチーブメントをステージ サンドボックスにプッシュすることができます。詳細については、「公開、モデレーション、承認」を参照してください。

公開、モデレーション、承認

注記: アチーブメントをライブにした後は、これを削除したり、その XP 値を調整したりすることはできません。テキストや画像を変更する場合は、このセクションで説明しているように、通常の公開フローに従います。アチーブメントを削除する必要がある場合は、Epic Games のサポート に問い合わせてください。

公開のワークフロー

アチーブメントをユーザーに表示できるようにライブにするには、公開のワークフローに従います。

  1. 開発 サンドボックス で、アチーブメント を作成します。
  2. アチーブメントをステージ サンドボックスにプッシュします。Epic Games では、モデレーション プロセスの一環としてアチーブメントをレビューします。
  3. アチーブメントをライブ サンドボックスにプッシュします

注記: Epic Games Store アチーブメントをサンドボックス間でプッシュする場合、宛先サンドボックスにリンクされたデプロイメントのアチーブメントを置き換えます。

アチーブメントをステージにプッシュする

アチーブメントをステージにプッシュするには、アチーブメント リストの上にある [PUSH TO STAGE (ステージにプッシュ)] を選択します。ボタンがアクティブでない場合は、先に解決しなければならないエラーがあることを意味します。ページのアラート ボックスにこれらのエラーが表示されます。

アチーブメントのモデレーション

Epic Games では、モデレーション プロセス時に、成人向けコンテンツ、冒とく的表現やアセットの反転など、不適切なコンテンツを探します。

Epic Games では、リンクされていないアチーブメント (つまり、Epic Online Services アチーブメント) をモデレートしません。Epic Games では、Epic Games Store アチーブメントのみをモデレートします。

Epic Games Store アチーブメントがモデレーションに失敗した場合

Epic Games で Epic Games Store アチーブメントが拒否された場合は、ステージ サンドボックスに次のメッセージが表示されます。

詳細を表示するには、[SEE DETAILS (詳細を表示)] を選択します。

問題を解決するには、開発サンドボックスに切り替えて必要な変更を加え、承認のためにアチーブメントをステージに再送信します。

注記

  • ステージにプッシュした際は、製品の承認であればいつでも追加の変更を加えることができます。このためには、ステージへのプッシュをキャンセルし、開発サンドボックスで変更を加えてから製品をステージに再度プッシュします。
  • アチーブメントに変更を加えると、アチーブメント全体をステージに再送信してモデレーションを行う必要があります。

アチーブメントがモデレーションに合格した場合

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

アチーブメントをライブにプッシュする

アチーブメントをライブにすると、次の制限事項が適用されます。

  • ライブ アチーブメントの XP を調整できない。
  • ライブ アチーブメントを削除する場合は、Epic Games のサポートに問い合わせる 必要がある。
  • ライブ アチーブメントのテキストや画像を変更する場合は、通常の公開フローに従う。

アチーブメントをライブにする方法

  1. ステージ サンドボックスに切り替えます。
  2. アチーブメント リストの上にある [PUSH TO LIVE (ライブにプッシュ)] を選択します。

Epic Games Store アチーブメントの XP の要件

Epic Games Store アチーブメントの XP (経験値) は次の要件に従う必要があります。

  • 各製品は、定義したアチーブメント数に関係なく、合計 XP を 1000 ちょうどにする必要がある。
  • ゲームに 1000 XP ぴったりではない値を追加すると、エラー メッセージが表示される。
  • 製品の XP が 1000 よりも多い場合も少ない場合も、開発からステージにアチーブメントをプッシュすることはできない。
  • [Game Services] > [Achievements] > [Epic Games Store achievements] のアチーブメント表に製品の合計 XP を表示することができる。
  • 各アチーブメントの XP 値は 5 の倍数にする必要がある (例:5、10、15… 100、110、200 など)。
  • 1 つのアチーブメントに対する最小は 5、最大は 200 です。
  • 注記 :アチーブメントに DLC を追加する予定がある場合、またはアチーブメント全体で合計 1,000 を超える XP が必要な場合は、引き続き Epic Online Services アチーブメントを使用する必要があります。1,000 を超える XP が必要な場合のサポートは今後のリリースで行われる予定です。
  • 注記 :Epic Games Store アチーブメントは、次のようにブロンズ、シルバーまたはゴールドと分類されます。
    • 5-45 XP: ブロンズ
    • 50-95 XP: シルバー
    • 100-200 XP: ゴールド
    • 追加の「プラチナ」階層アチーブメントもあります。製品で合計 1000 XP を獲得した場合、製品ユーザーはこのアチーブメントのロックを解除します。