Setup Guide

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

15 分で読めます

概要

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

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

はじめに

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

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

手順 1:Epic Online Services デベロッパー契約に署名する

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

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

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

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

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

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

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

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

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

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

製品の Epic Games ストア アチーブメントを作成する

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

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

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

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

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

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

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

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

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

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

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

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

  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 ストア アチーブメントの zip テンプレートをダウンロード)] を選択してファイルをダウンロードします。ファイルをダウンロードしたらフォームを閉じます。
    • 注記:Epic Games ストア アチーブメントのオプションを使用できない場合は、セットアップ プロセス が完了していることを確認してください。

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

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

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

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

  1. コンピュータでダウンロードした zip ファイルを解凍します。
  2. achievementDefinitions.csv」というラベルが付いたファイルを開きます。
  3. CSV ファイルで、最後の列に user_epic_achievements_xp というラベルが付いていることを確認します。この列がない場合はファイルに追加します。
  4. CSV ファイルにアチーブメントの適切な値を入力します。
  5. user_epic_achievements_xp 列で、アチーブメントごとに希望する経験値 (XP) を追加します。
    • 注記:XP 値を定義するときは、必ず適切な XP の要件 に従うようにしてください。
CSV ファイルにおけるアチーブメントの定義の例

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

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

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

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

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

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

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

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

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

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

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

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

Epic Games ストア アチーブメントを作成する前に、そのアチーブメントを関連付ける、対応する 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 (新しいアチーブメントを作成)] フォームに必要な情報を入力します。
    • Achievement ID (アチーブメント ID):アチーブメントを識別する一意の値。
    • Select Locale (ロケールを選択):指定したアチーブメントの名前と説明のロケール。必要に応じて、Epic Games ストアがサポートしている言語ごとに一連の一意の Epic Games ストア アチーブメントを作成できます。
    • Visibility (可視性):ロックを解除する前に、アチーブメントを製品ユーザーに表示するかどうかを決定します。
    • Unlocked Icon (ロック解除アイコン):アチーブメントのロックを解除した後に Epic Games ソーシャル オーバーレイか製品がユーザーに表示する画像。
    • Locked Icon (ロック アイコン):アチーブメントのロックを解除する前にユーザーに表示されるアイコン。Epic Games ストア アチーブメントではこのアイコンは使用 されず、Epic Games ストア ユーザーには半透明のロック解除アイコンが表示されるということに注意してください。
    • Locked Display Name (ロック時の表示名):アチーブメントのロックを解除する前にユーザーに表示される名前。
    • Locked Description (ロック時の説明):アチーブメントのロックを解除する前にユーザーに表示される説明。
    • Unlocked Display Name (ロック解除後の表示名):アチーブメントのロックを解除した後にユーザーに表示される名前。
    • Unlocked Description (ロック解除後の説明):アチーブメントのロックを解除した後にユーザーに表示される説明。
    • Flavor Text Optional (任意のフレーバー テキスト):製品で自由に使用できる任意のテキスト。
  7. フォームが完成したら、[Create (作成)] をクリックして新しいアチーブメントを保存します。

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

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

  1. デベロッパー ポータルで、[Your Product] > [Game Services] > [Progression] > [Achievements] の順に移動します。次に [Epic Online Services Achievements] を選択します。
  2. [Deployment] ドロップダウンで、開発サンドボックスに関連付けられているデプロイメントを選択します。
  3. アチーブメントのリストで、新しい Epic Games ストア アチーブメントにリンクする Epic Online Services アチーブメントを見つけます。
  4. アチーブメントの列の右側にある メニュー アイコン (...) をクリックし、[Link Achievements (アチーブメントをリンク)] を選択します。
  5. アチーブメントの XP 値を入力します。
  6. [Create Link (リンクを作成)] を選択し、新しい Epic Games ストア アチーブメントを完成させて保存します。

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

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

Epic Games ストア アチーブメントで付与された 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 ストア アチーブメントを削除する

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

Epic Games ストア アチーブメントがライブにプッシュされている場合は、デベロッパー ポータルでアチーブメントのリンクを解除することはできません。このような状況で Epic Games ストア アチーブメントを削除する場合は、サポートに問い合わせてください

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

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

ライブの Epic Games ストア アチーブメントをプレビューする

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

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

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

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

公開、審査、および承認プロセスについて理解する

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

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

注記

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

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

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

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

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

審査を受けるためにアチーブメントをサブミットする

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

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

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

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

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

注記:

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

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

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

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

注記:Epic Games ストア アチーブメントがライブになると、デベロッパー ポータルでその XP 値を調整したり、アチーブメントを削除したりできなくなります。公開されたアチーブメントを削除する場合は、サポートに問い合わせてください。アチーブメントに関連付けられているテキストや画像を更新する場合は、通常の公開フローに従います。

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

Epic Games ストア アチーブメントの 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 ストア アチーブメントは、ブロンズ、シルバー、ゴールド ティアに分類されます。
    • ブロンズ:5 ~ 45 XP
    • シルバー:50 ~ 95 XP
    • ゴールド:100 ~ 200 XP
    • 1 つの製品で合計 1,000 XP を獲得したユーザーは、さらにプラチナ ティア アチーブメントを獲得できます。

*アチーブメントに DLC を追加する予定にしている場合、またはアチーブメント全体で 1,000 を超える合計 XP が必要な場合は、テクニカル アカウント マネージャーか サポートに問い合わせてください