現地価格
購買力の低い国で売上を増やしたいパートナーには、地域の価格設定ポリシーを設定するオプションがあります。これにより、異なる国のユーザーのために商品のコストを調整することが可能になります。
アイテムカタログを設定する際に、仮想アイテムとゲームキーパッケージの地域価格を設定できます。各アイテムまたはゲームキーパッケージの価格は、デフォルトで米ドルで設定されています。地域制限と地域価格を同時に設定することができます。
地域の価格は追加、編集、削除できます：
どのように動作するか
カタログの価格は、ユーザーの国に基づいています。
ペイステーションでの購入の際、商品の価格はユーザーの国の通貨に換算され、該当する場合は税金も含まれます。
国判別
- アイテムカタログをリクエストする場合、ユーザーの国は仮想アイテム&通貨またはゲームキーメソッドグループからカタログサブセクションのメソッドの
countryパラメータに渡されます。
国が指定されていない場合は、ユーザーのIPアドレスに基づいて決定されます。その後、アイテムカタログの価格がユーザーの国に合わせて選択されます。 - 商品を購入する場合：
- 支払いトークンを取得するクライアントメソッドを使用する場合、それらはクライアント側からのみ使用し、サーバー側では使用しないようにすることが重要です。クライアントメソッド内の国と通貨はユーザーのIPアドレスによって決定されます。サーバー側からこのメソッドを使用すると、誤った通貨の決定が発生し、ペイステーション内で決済方法に影響を与える可能性があります。
- 購入用支払いトークンの作成サーバーメソッドを使用する場合、リクエスト本文に
countryオブジェクトを渡すか、X-User-IpヘッダーにユーザーのIPアドレスを渡す必要があります。
- country.valueパラメータの国と
X-User-IpヘッダーのIPアドレスが渡された場合、country.valueパラメーターの国の値が優先されます。
- country.valueパラメータの国と
アイテムカタログにおける価格表示の原則
カタログ内のすべてのアイテムについて、価格が指定されている通貨の同じリストを使用する必要があります。 これは、カタログ内のすべてのアイテムが同じ通貨で表示されるようにするために必要です。いずれかの国のアイテム価格が指定されていない場合は、その国のカタログ全体の価格がデフォルト通貨で表示されます。
アイテムのデフォルト通貨が異なる場合、価格はカタログの最初のアイテムのデフォルト通貨で表示されます。いずれかのアイテムにこの通貨の価格がない場合、カタログリクエストレスポンスではnullの価格値が返されます。この場合、アイテム価格が正しく表示されず、カタログ全体の表示に影響を与える可能性があります。
例：
アイテムのデフォルト通貨はUSDで、価格は5米ドルです。国の設定はありません。この場合、すべての国のユーザーにこの価格が表示されます。
アイテムの作成および編集時にパブリッシャーアカウント経由でをセットアップする
- パブリッシャーアカウントでプロジェクトを開き、ストア > 仮想アイテムに移動し、「構成する」をクリックします。
- 「+」をクリックし、ドロップダウンリストから「アイテムを作成する」を選択します。
- 以下を追加します：
- 画像
- SKU
- アイテムが属する1つまたは複数のグループ
- 名前
- 説明
- アイテム属性 — 消耗品、非消耗品、または期間限定アイテム
- 価格設定ブロックで、有料アイテムを選択します。
- 「実際通貨での定価」トグルを「オン」に切り替えて、「価格をセットアップする」を指定します。
- 開いたウィンドウで、通貨とデフォルト価格を指定します。USDを別のデフォルト通貨に置き換えることができます。
- 現地価格を設定します。 これは、手動または自動の2つの方法で行うことができます：
- 手動で価格を設定するには：
- 「+ 現地価格を追加」をクリックしてラインごとに価格を追加します。
- 「適用」をクリックします。
- 価格を自動的に設定するには：
- 「デフォルト価格を使用して計算」をクリックします。国のリストはアルファベット順に生成され、地域通貨での価格は為替レートと税金に基づいて国ごとに計算されます。
- 地域別価格が不要な国を削除するには、価格の右側にある「X」をクリックしてください。
- 自動的に計算された価格を変更するには、対応する行の値を変更します。
- 「変更を適用する」をクリックします。
- 仮想通貨で価格を追加する場合は、「仮想通貨での価格設定」トグルを「オン」に設定し、価格を指定します。
- 特定のユーザーにアイテムの購入を制限したい場合は、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ファイルの正しい記入例：
- csv
SKU,Currency,Amount,Country,IsDefault
virtual-item-1,EUR,9.09,,0
virtual-item-1,USD,10.1,,1
virtual-item-1,MYR,47,,0
virtual-currency-1-pack-100,EUR,2.09,,0
virtual-currency-1-pack-100,USD,2.3,,1
virtual-currency-1-pack-100,MYR,24,,0
bundle-1,EUR,15,,0
bundle-1,USD,17,,1
bundle-1,MYR,82,,0
エラー：グループ「game-key-1 + steam」と「game-key-2 + steam」にはデフォルト価格がありません。
ファイルのインポート
ファイルから価格をインポートするには：- アドミンページでプロジェクトを開きます。
- サイドメニューの「ストア」をクリックし、任意のタイプの製品のセクションに移動します。
- 「価格をインポートする」をクリックします。
- インポートウィンドウで、ファイルテンプレートをダウンロードして値を追加できます。
- インポートウィンドウの対応するフィールドにファイルをアップロードします。
- インポート中にエラーが発生した場合、インポートウィンドウにこれらのエラーのリストと修正の推奨事項が表示されます。ファイルに必要な変更を加えて、再度アップロードします。
アップロードが成功した場合、指定された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を押します。
