# ウェブショップでのカタログと支払い

> Webshopがプロジェクトのアプリ内課金カタログを再利用し、購入を既存の支払いプロバイダーにフォワードする方法を説明します。

Webshopは、Unity Cloudプロジェクトから[アプリ内課金(IAP)](/iap.md)カタログを読み取り、ゲーム内で使用するのと同じ[IAP支払いプロバイダー](/iap/payment-providers.md)に各購入を送信します。プレイヤーには、モバイル アプリケーション用に維持しているのと同じカタログがウェブに表示されます。

## カタログソース##catalog-source

プレイヤーがショップを訪れると、Web ショップはプロジェクトの製品カタログを IAP に要求し、ショップのテーマ別レイアウトで表示します。

[カタログ](/iap/create-catalog-in-editor.md)に加えた変更は、プレイヤーが新しいセッションをロードしたときに自動的に Webshop に反映されます。

ウェブショップでは、IAP が返す順序とグループでプロダクトがディスプレイされます。製品の順序またはグループを変更するには、IAPでカタログを更新します。

## プロダクトディスプレイフィールド##product-display-fields

Webshop には、各製品の以下のプレイヤー用フィールドが表示されます。

| フィールド   | 説明                                                                                                                                                                                   |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| タイトルと説明 | プロダクトカードのタイトルとボディとしてレンダリングされる、プロダクトのディスプレイ名とプレイヤー向けの説明。                                                                                                                              |
| 価格      | プレイヤーの通貨でのプロダクトの価格。カード上の主要価格としてレンダリングされます。                                                                                                                                           |
| セール価格   | 商品がセールになると、ウェブショップではセール価格がプライマリー価格として表示され、その横に元の価格が取り消し線で表示されます。                                                                                                                     |
| バッジ     | カードの任意のチップ。**Best value**や\*\*+20%ボーナス\*\*など。バッジのテキストとアイコンは IAP カタログに設定され、Webshop によって自動的に表示されます。販売中かどうかにかかわらず、すべての製品にバッジを付けることができます。詳細については、[セールスとバッジ](#sales-and-badges)を参照してください。 |
| 製品画像    | 製品の任意の画像。画像のないカードは、テーマのデフォルトプレースホルダーを使用します。                                                                                                                                          |

Webshop では、色、タイポグラフィ、レイアウトなどのプロダクトフィールドをテーマごとにフレーム表示します。また、ヒーローバナーやサムネイルなど、プロダクトフィールドをブランディングでフレーム化します。テーマとブランドの詳細については、「 [Web ショップのテーマと](./theming-and-branding.md)ブランド 」を参照してください。Webshop が各製品から読み取るフィールドの完全なリストについては、[Webshop カタログスキーマリファレンス](./catalog-schema.md) を参照してください。

公開する前に、IAP カタログに少なくとも 1 つのウェブ販売可能な製品があることを確認してください。IAP カタログが空の場合、ショップはプロダクトカードなしでレンダリングします。

### セールスとバッジ##sales-and-badges

Webショップでは、IAPカタログからセール価格とバッジを読み取ります。Webshop ダッシュボードでは設定しません。

* セールス:製品のウェブ価格を設定し、カタログで製品をセールとしてマークします。ウェブショップでは、自動的にプロダクトの通常価格が取り消し線で表示されます。必要なのは、カタログでセール価格を設定し、セールとマークすることだけです。
* バッジカタログの各リスティングにバッジ テキストと任意のアイコン(**Best value**や\*\*+20% bonus\*\*など)を追加します。リスティングでセールが行われると、バッジは Webshop 価格と項目の標準価格の% 割引に自動的に設定されますが、これは手動で上書きできます。 バッジはセールスとは別のものであるため、どの製品にもバッジを付けることができます。
* ボーナス:項目に**ボーナス**昇格マークを付けると、リストの **Subtitle** フィールドが取り消し線で表示されます。アイテムのタイトル`120 Gems`と取り消し線付きの副題 `100 Gems` をディスプレイし、このリストに宝石のボーナスが含まれていることを示します。

IAP で製品を定義するセールスとバッジを設定します。

## Web ショップにおける製品の可視性##product-visibility-in-webshops

Web ショップは、ウェブ販売用に作成した製品のみを IAP カタログにディスプレイします。Webshopに製品を含める/除外するには、カタログでの可視性を更新します。変更は、ウェブショップが次回カタログを取得したときに表示されます。

詳細については、[カタログとカタログリスト](/iap/catalogs-and-catalog-listings.md)を参照してください。

## プレイヤー固有のカタログ設定##player-specific-catalog-settings

IAP 設定では、通貨、ロケール、およびプレイヤー固有の製品選択を設定します。Webshop がプロダクトをリクエストすると、プレイヤーがディープリンクで送信する`locale`や`currency`パラメーターなど、プレイヤーのセッションコンテキストを IAP に渡します。ウェブショップはカタログが返すものをレンダリングします。特定のプレイヤーに表示される内容を変更するには、IAP で設定を変更します。

## 支払いフロー##payment-flow

ウェブショップは直接支払いを処理しません。代わりに、各購入は、プロジェクトにすでに設定されている[IAP支払いプロバイダー](/iap/payment-providers.md)にルートされます。これは、モバイルアプリケーションで購入を処理するのと同じプロバイダーです。

支払いが承認されると、ウェブショップのフローは完了です。レシート検証、エンタイトルメント付与、払い戻しは、ゲーム内課金と同じIAPフローを使用します。個別のウェブショップ台帳を照合する必要はありません。

購入後のプレイヤー向けの返品フローについては、[ゲームからWebshopを開く](./deep-links.md#post-purchase-return-to-the-game) を参照してください。

## ドラフトでの購入のテスト##test-purchases-in-a-draft

**開発プレビュー URL** が**編集**ビューの**一般**セクションに表示されます。ブラウザーで環境のドラフト設定が開きます。

> **Warning:**
>
> Dev プレビュー URL は、ライブ チェックアウト フローを開きます。プロジェクトに実際のカタログと支払いプロバイダーが設定されている場合は、購入を完了すると実際の請求が作成され、実際の利用資格が付与されます。

実際のコストをかけずに購入フロー全体をテストするには、支払いプロバイダーのドキュメントにあるサンドボックス アカウントまたはテスト カードを使用します。ウェブショップには個別のテストモードはありません。IAP 支払いプロバイダーがテストモードを管理します。

実際のカタログやテストトランザクションなしでテーマをプレビューするには、**編集**ビューの **Catalog & payment provider** (カタログと支払いプロバイダー) セクションで \*\*Mock catalog (\*\*模擬カタログ) を有効にします。**プレビュー** ペインには、固定のサンプル製品セットが表示されます。モックプロダクトはダッシュボードボードのプレビューにのみ存在します。プレイヤーはそれらを購入できず、公開されたショップには一切表示されません。