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

# PlayStream および Telemetry を使用したリーダーボード

> PlayFab リーダーボードの version-ended およびエンティティ ランクのイベントを PlayStream または Telemetry に発行して、CloudScript や Azure Functions をトリガーしたり、トップ プレイヤーに報酬を付与したりします。

リーダーボードと [PlayStream](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/ingest-data/playstream-overview.md) の統合により、リアルタイムのイベント取り込み・処理パイプラインを簡単に活用でき、リーダーボードのバージョンが変わったときにトリガーされるカスタム プレイヤー体験を構築できます。[PlayStream のアクションとルール](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/acting-data/action-rules-quickstart.md)を使用すると、カスタム [CloudScript](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript.md) や [Azure Functions](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript-af.md) をトリガーして、トップ プレイヤーに[報酬を付与する](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/inventory.md)、プレイヤーに個別化された通知を送信する、または不正行為をチェックするためのスコア検証を行うなど、エンゲージメントとリテンションのための機能を促進できます。PlayStream イベントは、データ分析とウェアハウジングのため、Data Explorer にもアーカイブされます。

リアルタイムのイベント アクションではなくデータ分析とウェアハウジングだけを行いたい場合、リーダーボードは分析機能のみを提供する [Telemetry イベント](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/ingest-data/telemetry-overview.md)との統合を備えています。

リーダーボードは、次の 2 つのオプションのイベントを提供します:

* [`playfab.leaderboard.leaderboard_version_ended`](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended)
* [`playfab.leaderboard.entity_rank_on_leaderboard_version_ended`](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/Leaderboards/entity-rank-on-leaderboard-version-ended)

これら 2 つのイベントを使用すると、リーダーボードのバージョンが終了したことをすばやく知ることができ、必要なタイミングで以前のデータをクエリできます。entity rank on leaderboard version ended イベントを使うと、リーダーボードのバージョンが終了したときに、そのリーダーボードのトップ エンティティのランクとスコアを取得できます。

## PlayStream または Telemetry イベントを有効化する

新しいリーダーボードを作成するとき、または既存のリーダーボード定義を編集するときに、イベントを有効化できます。PlayStream と Telemetry イベントの構成セクションで、None、PlayStream、または Telemetry を選択します。

![リセット頻度、リーダーボード イベント、エンティティ ランクの上限などのイベント パラメーターを設定する構成画面を表示している画像。](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/create-leaderboard-with-events.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=c45d0ef67226e657e6e7c272ea3c0279)

> **注:** 既存のリーダーボードでは、leaderboard version ended と entity rank on leaderboard version ended の両方のイベントが既定で無効になっています。これらを有効にしたい場合、あるいはいずれか一方だけを有効にしたい場合は、変更したいリーダーボードにアクセスしてその設定を有効にしてください。

送信後、リーダーボードのバージョンが変更されるたびにイベントが発行されます。

## イベントの利用

これらのイベントを活用して、Azure Function への接続などのさまざまなアクションを実行する方法の詳細については、次のリソースを参照してください:

* [PlayStream で CloudScript アクションを使用する](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream.md)
* [クイックスタート: Azure Functions を使用した PlayFab CloudScript の記述](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart.md)
* [CloudScript クイックスタート](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart.md)

## 制限事項と注意事項

* `playfab.leaderboard.entity_rank_on_leaderboard_version_ended` イベントは、上位 1000 位までのランクのみを返します。

* `playfab.leaderboard.entity_rank_on_leaderboard_version_ended` イベントは、リーダーボード内のすべてのエントリに対してイベントを送信します。

* `playfab.leaderboard.entity_rank_on_leaderboard_version_ended` イベントは、エンティティ タイプが `master_player_account` または `external` のリーダーボードでは機能しません。

## 関連項目

* [`playfab.leaderboard.leaderboard_version_ended`](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/Leaderboards/leaderboard-version-ended)
* [`playfab.leaderboard.entity_rank_on_leaderboard_version_ended`](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/Leaderboards/entity-rank-on-leaderboard-version-ended)
* [PlayStream の概要](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/ingest-data/playstream-overview.md)
* [PlayStream および Telemetry を使用した統計](https://docs.xbox.com/ja-jp/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry.md)
* [Telemetry の概要](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/ingest-data/telemetry-overview.md)
* [料金メーター](https://docs.xbox.com/ja-jp/services/playfab/pricing/meters/meters.md)
* [PlayStream イベントの機能](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/ingest-data/playstream-event-capabilities.md)
* [PlayStream で CloudScript アクションを使用する](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream.md)
* [クイックスタート: Azure Functions を使用した PlayFab CloudScript の記述](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart.md)
* [CloudScript クイックスタート](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart.md)
* [リーダーボードの制限](https://docs.xbox.com/ja-jp/services/playfab/community/leaderboards/limits-leaderboards.md)
* [リーダーボードと Cloudscript](https://docs.xbox.com/ja-jp/services/playfab/community/leaderboards/leaderboards-cloudscript.md)


## Related topics

- [Azure Functions を使用したリーダーボード](https://docs.xbox.com/ja-jp/services/playfab/community/leaderboards/leaderboards-cloudscript.md)
- [PlayFab Leaderboards の概要](https://docs.xbox.com/ja-jp/services/playfab/community/leaderboards/index.md)
- [PlayStream とテレメトリを使用した統計情報](https://docs.xbox.com/ja-jp/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry.md)
- [グループ リーダーボード](https://docs.xbox.com/ja-jp/services/playfab/community/leaderboards/group-leaderboards.md)
- [手動ティア リーダーボード](https://docs.xbox.com/ja-jp/services/playfab/community/leaderboards/manual-tiers.md)
