> ## 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.

# イベントの概要

> XBOX Live のゲーム イベントが、イベントベースのプレイヤー データ タイトルの統計、リーダーボード、マッチメイキングを更新するためにユーザー統計サービスにどのようにフィードされるかについて説明します。

**注:** この記事は、タイトル管理のユーザー統計ではなく、イベントベースのユーザー統計を使用している場合にのみ適用されます。

**注** Application Insights は非推奨になりました。イベントの監視には [fiddler](https://learn.microsoft.com/windows/uwp/xbox-live/using-xbox-live/troubleshooting/how-to-set-up-fiddler-for-debugging) を使用してください。

## XBOX services ユーザー統計サービスへのゲーム イベントの書き込み

ゲームで最もエキサイティングな瞬間は、対戦相手を倒す、倒される、場所へ移動する、武器を発射する、花を摘むなど、重要な出来事が起こったときです。XBOX services を使用することで、タイトルはプレイヤーのゲームにおける重要なイベントに関する情報を共有できます。詳細を XBOX services に送信でき、ユーザーに関する統計が記録されます。これらの統計は、ユーザー統計、リーダーボード、およびマッチメイキングで使用するために取得できます。

イベントと、イベントの一部として送信される任意のデータがサービスに届くと、XBOX services はタイトルのサービス構成で定義されたルールを処理し、ユーザー統計、リーダーボードなどを作成または更新します。

### Partner Center での構成

まず、Partner Center の Player Stats | Stat rules ページでイベントを定義します。Partner Center でイベントと統計を定義したら、次の手順を実行してイベントを送信できます。

### イベントの書き込み

Microsoft Game Development Kit (GDK) タイトルの場合、イベントを送信する API は XBOX One Software Development Kit タイトルの API とは異なり、マニフェスト ファイルの使用は必要ありません。

[XblEventsWriteInGameEvent](/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent) 関数は次のように宣言されています。

```cpp theme={null}
STDAPI XblEventsWriteInGameEvent(
    _In_ XblContextHandle xboxLiveContext,
    _In_z_ const char* eventName,
    _In_opt_z_ const char* dimensionsJson,
    _In_opt_z_ const char* measurementsJson
) XBL_NOEXCEPT;
```

`xboxLiveContext` は、XBOX services のコンテキスト ハンドルです。

`eventName` は、Partner Center で定義されたイベント名です。

`dimensions` は、有限の値のセットを取るイベント プロパティに対応するプロパティ バッグです。例: レベル、武器、キャラクター。

`measurements` は、値のセットが不確定であるイベント プロパティに対応するプロパティ バッグです。例: 走行距離、倒した敵の数、プレイ時間 (分)。

Dimensions と Measurements については、後で詳しく説明します。

#### Measurements と Dimensions

XBOX services のイベントを目的として [XblEventsWriteInGameEvent](/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent) を呼び出す場合、イベント プロパティを dimension として渡すか measurement として渡すかに違いはありません。これらの違いは、テレメトリのために Application Insights でイベントを分析する場合にのみ関係します。ゲームプレイ体験には影響しません。詳細については、[カスタム イベントとメトリックの Application Insights API](https://azure.microsoft.com/documentation/articles/app-insights-api-custom-events-metrics/) を参照してください。

Dimensions は、イベントをフィルターまたはピボットするために使用できます。例: レベル 6 をクリアしたユーザーを表示する、または使用された武器が "Minigun" であるすべての "Enemies Killed" イベントを表示する。

Measurements はグラフィカルに表示することも、リーダーボードで使用することもできます。例: 時間、連続勝利ラウンド数などを追跡する。

ただし、XBOX services での使用を目的とする場合、イベント プロパティを measurement として渡すか dimension として渡すかに違いはありません。実績のロック解除やその他の XBOX services 関連機能の目的では、これらは同じように処理されます。

### XBOX services イベントのデバッグ

タイトルからのイベントが XBOX services に正常に到達しない場合、hero stats とリーダーボードは更新されません。イベントが XBOX services で正常に受信されていない疑いがある場合は、次の手順を試してください。

* サンドボックスが正しいことを確認します。

* デバイスに Fiddler をセットアップします。Fiddler では、次のようにイベントが表示されるはずです。

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/fiddler1.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=303d2cc63ba1e38513d100d0ba5ebfcf" alt="Fiddler の未デコード イベント" width="1313" height="899" data-path="images/gdk/services/fiddler1.png" />

`v10.vortex-win.data.microsoft.com` への呼び出しを探します。表示されているようにリクエスト本文をデコードする必要があり、JSON を確認すると、次のような内容が表示されます。

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/fiddler2.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=77448c0f355fcf3636ead1bf44ea5e88" alt="Fiddler のデコード済みイベント" width="1307" height="997" data-path="images/gdk/services/fiddler2.png" />

イベント名が期待どおりのものであることを確認できます。タイトル ID が名前の先頭に付加されます。また、200 のリターン コードが返されていることも確認してください。

## 関連項目

[イベントベース vs. タイトル管理の統計](/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm#update-frequency)。


## Related topics

- [イベント](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/events/live-events-nav.md)
- [イベント ベースのステータスの初めての一瞥](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [サービス生成イベントを有効化または無効化する](/ja-jp/services/playfab/data-analytics/ingest-data/opt-in-events.md)
- [Insights](/ja-jp/services/playfab/data-analytics/legacy/insights/overview.md)
- [XBOX Achievements Manager API の概要](/ja-jp/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
