Webshop カタログスキーリファレンス
Web ショップでの製品の表示をコントロールできるカタログフィールドがあります。
読み終わるまでの所要時間 2 分最終更新 1ヶ月前
Webshop は、プロジェクトのアプリ内課金 (IAP) カタログにプロダクトをレンダリングします。各プロダクトは標準の IAP カタログ項目で、カテゴリ、解像度像度画像、プロモーション処置、ディスプレイ順序、プロダクトごとのバッジなど、ウェブショップ固有のフィールドで拡張でき、ショップでプロダクトがどのように表示されるかをコントロールします。
このリファレンスでは、Webshop が各製品に対して読み取るフィールドを示します。各 IAP 製品が持つ基本カタログフィールドと、Webshop の拡張子フィールドです。Webshop 拡張子フィールドは、Webshop カタログに含める製品だけに適用されます。カタログの入手先と製品ディスプレイの仕組みについては、カタログと Webshop での支払い を参照してください。製品を作成する方法については、エディターでのカタログの作成 を参照してください。
プロダクトフィールド
これらはすべてのカタログ製品の基本フィールドです。
フィールド | Type (タイプ) | 必須 | 説明 |
|---|---|---|---|
| string | はい | 製品の一意の識別子 (SKU)。 |
| string | はい | 製品タイプ。 |
| string | いいえ | プロダクトカードに表示されるプロダクト画像の URL。 |
| array | はい | ローカライズされたディスプレイ詳細。言語ごとに 1 エントリー。ローカライズ版製品詳細 を参照してください。 |
| array | はい | 通貨ごとの価格。価格設定 を参照してください。 |
| array | いいえ | 別のストア固有のプロダクト ID。各エントリーには、 |
ローカライズされた製品の詳細
productDetailsフィールド | Type (タイプ) | 必須 | 説明 |
|---|---|---|---|
| string | はい | このエントリーが適用される言語。 |
| string | はい | プロダクトのディスプレイ名 |
| string | はい | プレイヤー向けの製品説明。 |
| string | いいえ | タイトルとともに表示される任意のセカンダリ行。 |
| object | いいえ | プロダクトカードに表示されるチップ。 |
価格設定
pricingUSDフィールド | Type (タイプ) | 必須 | 説明 |
|---|---|---|---|
| string | はい | ISO 4217 通貨コード。例えば |
| integer | はい | プロダクトに課金される金額。 |
| integer | いいえ | ウェブショップで表示される価格。ウェブ固有の価格を設定する。 |
金額はマイクロ単位の整数です。1,000,000 は通貨の 1 単位です。例えば、 は 9.99 です。手動での価格設定ではなく、カタログツールでの価格設定 — エディターでカタログを作成する を参照してください。
9990000Webshop 拡張子フィールド
これらのフィールドは、ウェブショップ固有のディスプレイオプションで基本カタログプロダクトを拡張します。Webshop カタログの製品に対してのみ効果を発揮します。
フィールド | Type (タイプ) | 必須 | 説明 |
|---|---|---|---|
| 文字列の配列 | いいえ | 製品が属するカテゴリ ID（最大 16、一意の ID）。それぞれが、Webshop 用に定義したカテゴリと一致する必要があります。 |
| array | いいえ | 製品詳細ダイアログ用の高解像度画像 (最大 8 個)。各エントリーには、 |
| object | いいえ | カードの昇格処理。 |
| integer | いいえ | ショップ全体のプロダクトのディスプレイ順値が小さいほど最初に表示されます。 |
例
以下の製品には、 基本カタログフィールドと Webshop 拡張子フィールドの両方が含まれています 。
{ "uSKU": "com.example.gems.medium", "type":"Consumable", "imageUrl": "https://cdn.example.com/gems-medium.png", "productDetails": [ { "language": "en", "title":"ミディアムジェムパック", "description": "ゲームで使う宝石の便利な隠し場所", "subtitle":"500 gems", "badge": { "text":"Best value", "imageUrl": "https://cdn.example.com/gem-icon.png" } } ], "pricing": [ { "currencyCode":"USD", "amount":9990000, "webshopPrice":"25270591" ], "categories": ["gems"], "hdImages": [ { "url": "https://cdn.example.com/gems-medium-hd.png", "altText":"宝石の山" } ], "promotion": { "type":"Sale", "endsAt":"2026-07-01T00:00:00Z" }, "sortIndex":10}