地域別価格
アイテムカタログを設定するときに、仮想アイテムとゲームキーパッケージについて、さまざまな国のユーザー向けの価格ポリシー(地域価格)を設定できます。各アイテムまたはゲームキーパッケージの価格は、デフォルトでUSDで設定されています。地域制限と地域価格を同時に設定できます。
どのように動作するか
カタログの価格は、ユーザーの国に基づいています。
ペイステーションでの購入の際、商品の価格はユーザーの国の通貨に換算され、該当する場合は税金も含まれます。
国判別
- アイテムカタログをリクエストする場合、ユーザーの国は仮想アイテム&通貨またはゲームキーメソッドグループからカタログサブセクションのメソッドの
country
パラメータに渡されます。
国が指定されていない場合は、ユーザーのIPアドレスに基づいて決定されます。その後、アイテムカタログの価格がユーザーの国に合わせて選択されます。 - 商品を購入する場合:
- 支払いトークンを取得するクライアントメソッドを使用する場合、それらはクライアント側からのみ使用し、サーバー側では使用しないようにすることが重要です。クライアントメソッド内の国と通貨はユーザーのIPアドレスによって決定されます。サーバー側からこのメソッドを使用すると、誤った通貨の決定が発生し、ペイステーション内で決済方法に影響を与える可能性があります。
- 購入用支払いトークンの作成サーバーメソッドを使用する場合、リクエスト本文に
country
オブジェクトを渡すか、X-User-Ip
ヘッダーにユーザーのIPアドレスを渡す必要があります。
- country.valueパラメータの国と
X-User-Ip
ヘッダーのIPアドレスが渡された場合、country.valueパラメーターの国の値が優先されます。
- country.valueパラメータの国と
アイテムカタログにおける価格表示の原則
カタログ内のすべてのアイテムについて、価格が指定されている同じ通貨リストを使用する必要があります。
これは、カタログ内のすべてのアイテムが同じ通貨で表示されるようにするために必要です。いずれかの国のアイテム価格が指定されていない場合は、その国のカタログ全体の価格がデフォルト通貨で表示されます。
アイテムごとにデフォルト通貨が異なる場合、価格はカタログ内の最初のアイテムのデフォルト通貨で表示されます。その中の1つのアイテムがこの通貨で価格を持っていない場合、応答ではそのアイテムに対してnull
の価格が返されます。これによりアイテム価格の不正確な表示が生じ、カタログ全体の表示に影響が出る可能性があります。
例:
使用に適した方
各国のユーザー向けにストアの価格設定ポリシーを設定することで、購買力の低い国での売り上げを伸ばしたいパートナー。
入手方法
地域の価格は追加、編集、削除できます:
アイテムの作成および編集時にアドミンページ経由での設定
地域価格で仮想アイテムを作成するには:- アドミンページでプロジェクトを開きます。
- サイドメニューのストアをクリックします。
- 仮想アイテムペインで、構成するをクリックします。
- +をクリックし、ドロップダウンリストからアイテムを作成するを選択します。
- 以下を指定します:
- 画像
- SKU
- アイテムが属する1つまたは複数のグループ
- 名前
- 説明
- アイテム属性 — 消耗品、非消耗品、または期間限定アイテム
- 価格設定ブロックで、有料アイテムを選択します。
- 「実際通貨での定価」トグルを「オン」に切り替えて、価格を指定します。地域価格を設定しない場合、商品の価格はすべての国で同じ米ドルになります。
- 価格を設定するには:
- 商品の価格を異なる通貨で設定したい場合は、+をクリックして通貨と価格を指定します。
- 国別の特別価格を設定したい場合は、価格設定を追加するをクリックし、国、通貨、数量を指定します。必要な地域価格の数を設定することができます。
- 仮想通貨で価格を付けたい場合は、仮想通貨での価格設定のトグルをオンに切り替えて価格を指定します。
- 特定のユーザーにアイテムの購入を制限したい場合は、1ユーザーがこのアイテムを購入できる回数を制限するのトグルをオンに切り替えて、回数を指定します。
- ストア内のアイテムを表示する場合は、ストア内でアイテムを表示するトグルをオンに設定します。
- アイテムを作成するをクリックします。
アドミンページのファイルからインポートする
事前に作成されたアイテムのファイルから地域の価格をインポートできます。
機能
- 一度に複数のアイテムの地域価格をアップロードまたは更新します。
- あらゆるタイプのアイテムに対応:
- 仮想アイテム
- 仮想通貨
- 仮想通貨パッケージ
- バンドル
- 特定のプラットフォーム上のゲームキーのパッケージ
アップロードされたデータの検証。ファイルの構造やデータ形式が要件を満たしていない場合、インポート中にエラーのリストが表示されます。
ファイル構造
ファイルはCSV形式であり、次の列が含まれている必要があります:SKU — 地域価格を設定する必要があるアイテムSKU。Country — ISO 3166-1 alpha-2形式の国名コード。CSVファイルをアップロードする前に、エクソーラがサポートしている国/地域リストを確認してください。列のセルへの記入は任意です。国/地域が指定されていない場合、価格表示の例を見ることができます。Currency — 通貨コードはISO 4217形式です。Amount — アイテムの価格。小数点にはピリオドを使用します。IsDefault — デフォルト価格であるかどうか。以下を指定します:1
— デフォルト価格の行の場合。すべての国で表示され、地域別価格はありません。0
— それ以外の行の場合。また、IsDefault列のセルを空白のままにすることもできます。
デフォルトの価格は地域別であってはなりません -
例
正しく記入されたファイル(複数のアイテム、3つの通貨、地域別価格あり)。
不適切に記入されたファイル(複数のアイテム、3つの通貨、地域別価格あり)。
エラー:「virtual-item-1」と「bundle-1」で、「国」列のグループセルが空ではありません。
新しいアイテムを追加するたびに、デフォルトの通貨で価格を設定する必要があります。指定しない場合、ファイルのインポート時にエラーが表示されます。
例
正しく記入されたファイル(複数のアイテム、3つの通貨、地域別価格あり)。
不適切に記入されたファイル(複数のアイテム、3つの通貨、地域別価格あり)。
エラー:「virtual-item-1」グループと「bundle-1」グループにはデフォルトの通貨はありません。
プラットフォーム — プラットフォームSKU。ゲームキーの地域価格を設定するときに使用されますが、他のアイテムには使用されません。
利用可能なプラットフォーム。
プラットフォームSKU プラットフォーム名 steam Steam playstation PlayStation xbox Xbox uplay Uplay origin Origin drmfree DRM Free gog GOG epicgames Epic Games Store nintendo_eshop Nintendo Switch eShop discord_game_store Discord Game Store oculus Oculus viveport Viveport stadia Google Stadia
SKUが同じでプラットフォームが異なるゲームキーは、異なるエンティティと見なされます。各エンティティには、デフォルトの通貨で指定された価格が必要です。
例
正しく記入されたファイル(複数のゲームキー、3つの通貨、地域別価格あり、2つのプラットフォーム)。
不適切に記入されたファイル(複数のゲームキー、3つの通貨、地域別価格あり、2つのプラットフォーム)。
エラー1:「SKU」と「プラットフォーム」によるゲームキーのグループ化が正しくなく、3つではなく9つのエンティティが見つかりました。
エラー2:グループ3、4、5、6のグループ化が正しくないため、デフォルトの価格が設定されていません。
エラー3:グループ9は同じエンティティの価格の完全なセットを持っているため、グループ7のデータを上書きします。その結果、「プレイステーション」プラットフォームの「game-key-2」は、インポート後のMYRでのみ価格になります。
ファイルの完了と発生する可能性のあるエラーの例
インポート用CSVファイルの正しい記入例:ファイルのインポート
ファイルから価格をインポートするには:- アドミンページでプロジェクトを開きます。
- サイドメニューの「ストア」をクリックし、任意のタイプの製品のセクションに移動します。
- 「価格をインポートする」をクリックします。
- インポートウィンドウで、ファイルテンプレートをダウンロードして値を追加できます。
- インポートウィンドウの対応するフィールドにファイルをアップロードします。
- インポート中にエラーが発生した場合、インポートウィンドウにこれらのエラーのリストと修正の推奨事項が表示されます。ファイルに必要な変更を加えて、再度アップロードします。
アップロードが成功した場合、指定されたSKUを持つアイテムの地域価格はファイル内の価格に従って更新されます。以前に指定された価格は削除されます。
例:
アイテムには異なる通貨で複数の価格があり、アドミンページには複数の地域価格があります。インポートされたファイルには1つの価格しかありませんが、ファイルをインポートした後、アドミンページではこのアイテムについて1つの価格がEURで指定されます。
APIメソッドを使用したセットアップ
APIメソッドで地域別の価格を設定するには、以下を経由で国別の価格設定を持つオブジェクトの配列を渡します:配列の例:- http
"prices": [
{
"amount": 100,
"currency": "USD",
"is_enabled": true,
"is_default": true
},
{
"amount": 200,
"currency": "CZK",
"country_iso": "CZ",
"is_enabled": false,
"is_default": false
}
]
誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。