> ## 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 服務使用者統計資料服務
遊戲中最令人興奮的時刻，就是發生重大事件的時候：擊敗對手、被擊敗、移動到某個位置、射擊武器、摘一朵花。透過 XBOX 服務，遊戲可以分享玩家遊戲中重要事件的相關資訊。詳細資料可以傳送至 XBOX 服務，由其記錄使用者的統計資料。這些統計資料可以擷取並用於使用者統計資料、排行榜與配對。
事件以及隨事件傳送的任何資料到達服務後，XBOX 服務就會處理您在遊戲服務設定中定義的規則，以建立或更新使用者統計資料、排行榜等。
### 在 Partner Center 上設定
首先，在 Partner Center 的 Player Stats | Stat rules 頁面上定義您的事件。在 Partner Center 中定義事件與統計資料後，您就可以執行下列步驟來傳送事件。
### 寫入事件
對於 Microsoft Game Development Kit (GDK) 遊戲，傳送事件的 API 與 XBOX One 軟體開發套件遊戲不同，而且不需要使用資訊清單檔案。
[XblEventsWriteInGameEvent](/zh-TW/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 服務內容控制代碼。
`eventName` 是在 Partner Center 上定義的事件名稱。
`dimensions` 是屬性包，對應於值為有限集合的事件屬性。例如：關卡、武器或角色。
`measurements` 是屬性包，對應於值為不確定集合的事件屬性。例如：行駛英里數、擊殺敵人數或遊戲分鐘數。
維度與測量值將在下文進一步討論。
#### 測量值與維度
針對 XBOX 服務事件呼叫 [XblEventsWriteInGameEvent](/zh-TW/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent) 時，將事件屬性作為維度或測量值傳遞並沒有差異。只有在您於 Application Insights 上分析事件以取得遙測時，這些差異才有關係；這對遊戲體驗沒有任何影響。如需詳細資訊，請參閱[適用於自訂事件和計量的 Application Insights API](https://azure.microsoft.com/documentation/articles/app-insights-api-custom-events-metrics/)。
維度可用來篩選或樞紐分析您的事件。例如：顯示完成第 6 關的使用者，或顯示所使用武器為 "Minigun" 的所有 "Enemies Killed" 事件。
測量值可以用圖形方式顯示，或適合用於排行榜。例如：追蹤時間、連勝回合數等。
但就搭配 XBOX 服務使用而言，將事件屬性作為測量值或維度傳遞並無差別，在解除鎖定成就及其他 XBOX 服務相關功能方面，兩者的處理方式完全相同。
### 偵錯 XBOX 服務事件
如果遊戲的事件無法成功到達 XBOX 服務，主打統計資料與排行榜就不會更新。如果您懷疑 XBOX 服務未成功接收事件，請嘗試下列步驟：
* 確認您的沙箱正確無誤。
* 在裝置上設定 Fiddler。在 Fiddler 中，您應該會看到如下的事件：
尋找對 `v10.vortex-win.data.microsoft.com` 的呼叫。您需要依圖示解碼要求本文，接著查看 JSON 時，就會看到類似下列的內容：
您可以確認事件名稱是否符合預期。您的遊戲 ID 會加在名稱前面。您也應該確認收到的傳回碼為 200。
## 另請參閱
[事件型與遊戲管理型統計資料](/zh-TW/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm#update-frequency)。
## Related topics
- [事件](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/events/live-events-nav.md)
- [事件型統計資料初探](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [啟用或停用服務產生的事件](/zh-TW/services/playfab/data-analytics/ingest-data/opt-in-events.md)
- [Insights](/zh-TW/services/playfab/data-analytics/legacy/insights/overview.md)
- [事件的入口網站設定](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal.md)