地域別価格

アイテムカタログを設定するときに、仮想アイテムとゲームキーパッケージについて、さまざまな国のユーザー向けの価格ポリシー（地域価格）を設定できます。各アイテムまたはゲームキーパッケージの価格は、デフォルトでUSDで設定されています。地域制限と地域価格を同時に設定できます。

どのように動作するか

カタログの価格は、ユーザーの国に基づいています。

ペイステーションでの購入の際、商品の価格はユーザーの国の通貨に換算され、該当する場合は税金も含まれます。

国判別

• アイテムカタログをリクエストする場合、ユーザーの国は仮想アイテム&通貨またはゲームキーメソッドグループからカタログサブセクションのメソッドのcountryパラメータに渡されます。
  国が指定されていない場合は、ユーザーのIPアドレスに基づいて決定されます。その後、アイテムカタログの価格がユーザーの国に合わせて選択されます。
• 商品を購入する場合：
  • 支払いトークンを取得するクライアントメソッドを使用する場合、それらはクライアント側からのみ使用し、サーバー側では使用しないようにすることが重要です。クライアントメソッド内の国と通貨はユーザーのIPアドレスによって決定されます。サーバー側からこのメソッドを使用すると、誤った通貨の決定が発生し、ペイステーション内で決済方法に影響を与える可能性があります。
  • 購入用支払いトークンの作成サーバーメソッドを使用する場合、リクエスト本文にcountryオブジェクトを渡すか、X-User-IpヘッダーにユーザーのIPアドレスを渡す必要があります。

1. 1. country.valueパラメータの国とX-User-IpヘッダーのIPアドレスが渡された場合、country.valueパラメーターの国の値が優先されます。

アイテムカタログにおける価格表示の原則

カタログ内のすべてのアイテムについて、価格が指定されている同じ通貨リストを使用する必要があります。

これは、カタログ内のすべてのアイテムが同じ通貨で表示されるようにするために必要です。いずれかの国のアイテム価格が指定されていない場合は、その国のカタログ全体の価格がデフォルト通貨で表示されます。

アイテムごとにデフォルト通貨が異なる場合、価格はカタログ内の最初のアイテムのデフォルト通貨で表示されます。その中の1つのアイテムがこの通貨で価格を持っていない場合、応答ではそのアイテムに対してnullの価格が返されます。これによりアイテム価格の不正確な表示が生じ、カタログ全体の表示に影響が出る可能性があります。

例：

• 1アイテム、1通貨、地域価格なし
• 1つのアイテム、2つの通貨、地域価格なし
• 1つのアイテム、地域価格あり
• 複数のアイテム、地域別価格あり、1つのデフォルト通貨
• 複数のアイテム、地域別価格あり、異なるデフォルト通貨

アイテムのデフォルト通貨はUSDで、価格は5米ドルです。国の設定はありません。この場合、すべての国のユーザーにこの価格が表示されます。

アイテムにはUSDとEURの2つの価格オプションが設定されていますが、国別の特別価格は設定されていません。この場合、EURが使用されている国のユーザーには7EURの価格が表示されます。その他の国のユーザーには、デフォルト通貨である5USDの価格が表示されます。

プロジェクトには次の通貨で価格が設定されています：

• デフォルト価格 — 7USD
• ユーロでの価格 — 6EUR
• 地域価格：
  • ドイツ — 8EUR
  • イタリア — 5EUR
  • マレーシア — 20MYR
  • 南アフリカ — 90ZAR

ユーザーの国によって、カタログの価格表示は以下のようになります：

ユーザーの国	カタログ価格	コメント
アメリカ合衆国	7 USD	アメリカ合衆国（米国）はUSDを使用する国です。アメリカ合衆国向けの特別価格は設定されていません。
日本	7 USD	日本の通貨が指定されていないため、価格はデフォルトの通貨で表示されます。
フランス	6 EUR	フランスはEUR使用国です。フランス向けの特別価格は設定されていません。
ドイツ	8 EUR	ドイツでは地域価格が設定されています。
イタリア	5 EUR	イタリアでは地域価格が設定されています。
マレーシア	20 MYR	マレーシアでは地域価格が設定されています。
南アフリカ	90 ZAR	南アフリカでは地域価格が設定されています。

プロジェクトの価格は次の通貨で表示されます：

• すべてのアイテムのデフォルト価格は米ドル（USD）
• マレーシアでは、すべてのアイテムの価格はマレーシアリンギット（MYR）
• 南アフリカでは、1つを除くすべての商品の価格は南アフリカランド（ZAR）

この場合、カタログはマレーシアのユーザーにはMYRで表示され、南アフリカのユーザーにはUSDで表示されます。南アフリカからのユーザーに対しては、アイテムの1つにZARでの価格が設定されていないため、USDで表示されます。

プロジェクトには次の通貨で価格が設定されています：

• 1_test_itemのデフォルト価格は米ドル（USD）
• 2_test_itemのデフォルト価格はユーロ（EUR）
• 南アフリカでは、1_test_itemの価格は南アフリカランド（ZAR）、2_test_itemの価格は指定されていません

この場合、南アフリカからのユーザーのために、価格はカタログの最初のアイテムである1_test_itemのデフォルト通貨で表示されるべきです。

1_test_itemのデフォルト通貨はUSDです。これは2_test_itemのデフォルト通貨であるEURと一致しません。また、2_test_itemの価格リストにはUSDの価格がありません。

したがって、2_test_itemの返される価格値はnullになります。

使用に適した方

各国のユーザー向けにストアの価格設定ポリシーを設定することで、購買力の低い国での売り上げを伸ばしたいパートナー。

入手方法

地域の価格は追加、編集、削除できます：

• アイテムの作成/編集時にアドミンページ経由
• ファイル経由で価格をインポートする場合、アドミンページ経由
• APIメソッドの使用

アイテムの作成および編集時にアドミンページ経由での設定

1. アドミンページでプロジェクトを開きます。
2. サイドメニューのストアをクリックします。
3. 仮想アイテムペインで、構成するをクリックします。
4. +をクリックし、ドロップダウンリストからアイテムを作成するを選択します。

5. 以下を指定します：
   • 画像
   • SKU
   • アイテムが属する1つまたは複数のグループ
   • 名前
   • 説明
   • アイテム属性 — 消耗品、非消耗品、または期間限定アイテム
6. 価格設定ブロックで、有料アイテムを選択します。
7. 「実際通貨での定価」トグルを「オン」に切り替えて、価格を指定します。地域価格を設定しない場合、商品の価格はすべての国で同じ米ドルになります。

8. 価格を設定するには：
   • 商品の価格を異なる通貨で設定したい場合は、+をクリックして通貨と価格を指定します。
   • 国別の特別価格を設定したい場合は、価格設定を追加するをクリックし、国、通貨、数量を指定します。必要な地域価格の数を設定することができます。
9. 仮想通貨で価格を付けたい場合は、仮想通貨での価格設定のトグルをオンに切り替えて価格を指定します。
10. 特定のユーザーにアイテムの購入を制限したい場合は、1ユーザーがこのアイテムを購入できる回数を制限するのトグルをオンに切り替えて、回数を指定します。
11. ストア内のアイテムを表示する場合は、ストア内でアイテムを表示するトグルをオンに設定します。
12. アイテムを作成するをクリックします。

アドミンページのファイルからインポートする

事前に作成されたアイテムのファイルから地域の価格をインポートできます。

機能：

• 一度に複数のアイテムの地域価格をアップロードまたは更新します。
• あらゆるタイプのアイテム対応：
  • 仮想アイテム
  • 仮想通貨
  • 仮想通貨パッケージ
  • バンドル
  • 特定のプラットフォーム上のゲームキーのパッケージ

• アップロードされたデータの検証。ファイル構造またはデータ形式が要件を満たしていない場合は、インポート中にエラーのリストが表示されます。

• SKU — 地域価格を設定する必要があるアイテムSKU。
• Country — ISO 3166-1 alpha-2形式の国名コード。CSVファイルをアップロードする前に、エクソーラがサポートしている国/地域リストを確認してください。列のセルへの記入は任意です。国/地域が指定されていない場合、価格表示の例を見ることができます。
• Currency — ISO 4217形式の国名コード。
• Amount — アイテムの価格。小数点としてピリオドを使用します。

• IsDefault — それがデフォルト価格であるかどうか。以下を指定します：

  • 1 — デフォルト価格の行に挿入します。すべての国で表示され、地域別価格はありません。
  • 0 — 他のすべての行に挿入します。また、IsDefault列のセルを空白のままにすることもできます。

1. デフォルト価格は地域に依存しないように、Country列のセルは空白のままにしてください。
   ファイルに複数のアイテムSKUがある場合、各SKUに対してデフォルト通貨で価格を設定する必要があります。指定されていない場合、ファイルのインポート時にエラーが表示されます。

価格ファイルの例：

1. アドミンページでプロジェクトを開きます。
2. サイドメニューの「ストア」をクリックし、任意のタイプの製品のセクションに移動します。
3. 「価格をインポートする」をクリックします。

4. インポートウィンドウで、ファイルテンプレートをダウンロードして値を追加できます。
5. インポートウィンドウの対応するフィールドにファイルをアップロードします。
6. インポート中にエラーが発生した場合、インポートウィンドウにこれらのエラーのリストと修正の推奨事項が表示されます。ファイルに必要な変更を加えて、再度アップロードします。

アップロードが成功した場合、指定されたSKUを持つアイテムの地域価格はファイル内の価格に従って更新されます。以前に指定された価格は削除されます。

例：

アイテムには異なる通貨で複数の価格があり、アドミンページには複数の地域価格があります。インポートされたファイルには1つの価格しかありませんが、ファイルをインポートした後、アドミンページではこのアイテムについて1つの価格がEURで指定されます。

APIメソッドを使用したセットアップ

• 仮想アイテムの作成と更新のメソッド
• 仮想通貨の作成と更新のメソッド
• 仮想通貨パッケージの作成と更新のメソッド
• バンドルの作成と更新のメソッド

• ゲームキーパッケージの作成と更新のメソッド

"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]