> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy 価格メーター

> PlayFab Economy Catalog の課金対象メーター、それらが測定するアクション、およびカタログ使用量が PlayFab の請求にどのように反映されるかを理解します。

# Catalog 価格メーター

PlayFab Economy V2 Catalog API には、消費量ベースのメーターが 2 つのカテゴリー(Requests と Storage)あります。このページでは、それらのメーターの定義と、測定と計算の方法について説明します。PlayFab の価格モデルの詳細については、[PlayFab 価格の概要](/services/playfab/pricing/pricing-overview) を参照してください。

<Note>
  PlayFab Economy V2 の一般的な使用は、PlayStream Events などの他の PlayFab メーターに寄与する場合があります。
</Note>

## Requests

リクエストメーターは、UGC API 呼び出しまたは CDN リクエストのレスポンスサイズによって決定されます。3 つの PlayFab プランのそれぞれについて、サイズに応じて 5 つの異なるレートがあります:

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/services/playfab/pricing/pricingV2-media/ugc-pricing-requests.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e8e7d1f9cf171d3af9da7177dc1df98e" alt="UGC Requests 価格" width="955" height="576" data-path="images/services/playfab/pricing/pricingV2-media/ugc-pricing-requests.png" />

<Note>
  100 MB を超えるコンテンツを保存する予定がある場合は、お問い合わせください。
</Note>

## Storage

ストレージメーターは、すべてのコンテンツ(ファイルと画像の両方)の合計サイズによって決定されます。5 GB がすべての価格プランに含まれています。追加ストレージについては、プランに応じてこのメーターに 3 つの異なるレートがあります。

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/services/playfab/pricing/pricingV2-media/ugc-pricing-storage.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=c3bc65ca518e4e1c5387dd068da37caa" alt="UGC Storage 価格" width="912" height="205" data-path="images/services/playfab/pricing/pricingV2-media/ugc-pricing-storage.png" />

このメーターには、公開されていないアイテムに関連付けられたコンテンツと、公開カタログを通じて表示されないアイテムが含まれます。アイテムを公開カタログから非表示にする方法の詳細については、[Catalog Item Status](/services/playfab/economy-monetization/economy-v2/catalog/item-status) を参照してください。

## 含まれるメーター

選択したプランに関係なく、すべての PlayFab のお客様に対して、含まれるメーターのセットがあります:

| メーター                |   含まれる量   |
| ------------------- | :-------: |
| Up to 1 MB Requests | 15 万リクエスト |
| Storage             |    5 GB   |

<Note>
  開発モードのスタジオは、UGC を有効にする前に支払い情報を入力する必要があり、超過分は上記のレートに基づいて課金されます。
</Note>

## 請求例

顧客の Catalog 使用例と月次請求を確認してみましょう。この例のタイトルは *Pay-as-you-go* プランを使用しています。まずは 1 人のユーザーから始めましょう。このユーザーはコンテンツ検索ページに移動し、「恐竜」を検索します。ユーザーには 10 件の結果が表示され、それぞれにタイトルとサムネイル画像があります。ユーザーは 1 つのコンテンツを選択し、説明、評価、およびさらに 4 つの画像を含む完全なメタデータが表示されます。ユーザーはコンテンツが十分に興味深く見えると判断し、ダウンロードボタンを選択します。

さて、このシナリオがどのようなメーター消費を引き起こしたか見てみましょう:

* このユーザーはコンテンツ検索ページに移動し、「恐竜」を検索します。ユーザーには 10 件の結果が表示され、それぞれにタイトルとサムネイル画像があります。
  * `SearchItems` 呼び出しは基本メタデータ付きで 10 個のアイテムを返し、単一の「**Up to 1 MB Request**」を発生させます。
  * 10 個のサムネイルはそれぞれ CDN からリクエストされます。5 個が 1 MB をわずかに下回り、5 個が 1 MB をわずかに上回るとしましょう。このシナリオは、5 個の「**Up to 1 MB Requests**」と 4 個の「**Up to 5 MBs Requests**」を発生させます。
* ユーザーは 1 つのコンテンツを選択し、説明、評価、およびさらに 4 つの画像を含む完全なメタデータが表示されます。
  * `GetItem` 呼び出しは完全なメタデータ付きで単一のアイテムを返し、単一の **Up to 1 MB Request** を発生させます。
  * `GetRatings` 呼び出しは単一のアイテムの評価を返し、単一の **Up to 1 MB Request** を発生させます。
  * 4 つの画像はそれぞれ CDN からリクエストされます。高品質の画像として、2 つの画像は 5 MB *未満* で、2 つの画像は 5 MB *を超え* ます。このシナリオは、2 個の「**Up to 5 MBs Requests**」と 2 個の「**Up to 25 MBs Requests**」を発生させます。
* ユーザーはコンテンツが十分に興味深く見えると判断し、ダウンロードボタンを選択します。
  * コンテンツは CDN からリクエストされます。20 MB の大きなコンテンツとして。このシナリオは、単一の **Up to 25 MBs Requests** を発生させます。

| メーター          | リクエスト数 |
| ------------- | ------ |
| Up to 1 MB    | 8      |
| Up to 5 MBs   | 7      |
| Up to 25 MBs  | 3      |
| Up to 50 MBs  | 0      |
| Up to 100 MBs | 0      |

次に、このタイトルには、30 日間の月に 1 日 1 回このシナリオを実行する 10,000 人のユーザーがいます(300,000 回)。これはおおよそ、1 人のユーザーが平均して 9 秒に 1 回実行することと同じです。このシナリオは以下のメーター消費をもたらします:

| メーター          | リクエスト数 |
| ------------- | ------ |
| Up to 1 MB    | 240 万  |
| Up to 5 MBs   | 210 万  |
| Up to 25 MBs  | 90 万   |
| Up to 50 MBs  | 0      |
| Up to 100 MBs | 0      |

タイトルがスタジオ内で UGC を使用している唯一のタイトルであり、月末にタイトルに 4 GB の UGC が保存されている場合(これは 5 GB の含まれる量で完全にカバーされるため、**Storage** メーターでは課金されません)、最終的な UGC 請求は以下のようになります:

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/services/playfab/pricing/pricingV2-media/ugc-sample-monthly-bill.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=fddbf962aa0ba9404fd9ed9e7474a10b" alt="サンプル請求" width="1200" height="401" data-path="images/services/playfab/pricing/pricingV2-media/ugc-sample-monthly-bill.png" />

## リソース

* メーターごとの最新の価格については、[PlayFab 価格](https://playfab.com/pricing/) を参照してください
* ゲームのメーター使用量とコストを最低レートに維持する方法については、[消費量のベストプラクティス](/services/playfab/pricing/consumption-best-practices) を参照してください

## 関連 API

以下の API により Economy Catalog メーターが増加します:

* [CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/create-draft-item)
* [CreateUploadUrls](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/create-upload-urls)
* [DeleteEntityItemReviews](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/delete-entity-item-reviews)
* [DeleteItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/delete-item)
* [GetCatalogConfig](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-catalog-config)
* [GetDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-draft-item)
* [GetEntityDraftItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-entity-draft-items)
* [GetEntityItemReview](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-entity-item-review)
* [GetItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item)
* [GetItemModerationState](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-moderation-state)
* [GetItemPublishStatus](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-publish-status)
* [GetItemReviews](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-reviews)
* [GetItemReviewSummary](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-review-summary)
* [GetItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-items)
* [PublishDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/publish-draft-item)
* [ReportItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/report-item)
* [ReportItemReview](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/report-item-review)
* [ReviewItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/review-item)
* [SearchItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/search-items)
* [SetItemModerationState](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/set-item-moderation-state)
* [SubmitItemReviewVote](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/submit-item-review-vote)
* [TakedownItemReviews](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/takedown-item-reviews)
* [UpdateCatalogConfig](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/update-catalog-config)
* [UpdateDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/update-draft-item)

<Note>
  CDN への任意の呼び出しも Economy Catalog メーターを増加させます
</Note>


## Related topics

- [PlayFab 消費量のベストプラクティス](/ja-jp/services/playfab/pricing/consumption-best-practices.md)
- [Inventory 読み取りメーター API の説明](/ja-jp/services/playfab/pricing/meters/economy-reads.md)
- [Economy v2 のストア](/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/stores.md)
- [ストア (Economy Legacy) クイックスタート](/ja-jp/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [アイテム (レガシー Economy) のクイックスタート](/ja-jp/services/playfab/economy-monetization/economy/items/quickstart.md)
