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

# 使用自訂標記自訂您的事件

> 了解如何使用自訂標記來自訂您的事件。自訂標記是工作室可選擇隨 API 要求一併包含的機碼值組集合。

# 搭配 PlayStream 事件使用自訂標記

自訂標記 (Custom Tags) 是工作室可選擇隨每個 API 要求一併包含的機碼值組集合。它們可用於以更多工作室特定的中繼資料 (例如組建編號、外部追蹤識別碼等) 來充實標準 PlayStream 事件。

自訂標記擴充了您使用 PlayStream 事件的方式。基本的 PlayStream 結構描述是固定的，缺乏擴充性，但讓我們得以建置通用的計量和分析。結構描述的固定性質限制了遊戲工作室以有效率且經濟的方式自訂其資料的能力，也限制了它們收集特定資料點的能力。自訂標記提供了一種擴充結構描述的方式，以提供更大的彈性和功能。

## 您可以使用自訂標記做什麼？

您可以使用自訂標記完成許多事情。以下是一些建議，但您也可以更有創意地使用它們。

### 自動化

PlayStream 中繼資料可作為觸發特定事件的準則。當需要完成某項工作時，PlayFab 客戶可以設定規則，表示「如果 \[Custom Tags] 符合 xyz 需求，則觸發動作 A」。

您可以將 CloudScript 與自訂標記整合以實現自動化。CloudScript [動作和規則](/zh-TW/services/playfab/data-analytics/acting-data/action-rules-overview)可讓您根據特定準則自動觸發事件。

例如，如果您的遊戲工作室正在為遊戲投資成效行銷，並執行各種不同的行銷活動來吸引新玩家，您現在可以追蹤吸引到玩家的行銷活動，並將該活動識別碼新增至所有 PlayStream 事件。然後，您可以使用該活動識別碼來自動化流程。例如，如果您的廣告承諾「註冊即送 1,000 枚免費金幣」，則傳送「新玩家」事件，並使用行銷活動來決定要給予玩家什麼獎勵。例如，「如果行銷活動 = 'FREE\_GOLD\_COINS'，則給予玩家 1,000 枚金幣」。

### 遙測

PlayStream 中繼資料可協助資料收集和分析。例如，您可以從非 PlayFab 服務傳送自訂標記作為 PlayStream 事件資料的一部分，並在其流經資料管線時持續追蹤。
如果您已經有自己的分析系統 (例如以某個識別碼為基礎)，您可以在 PlayStream 事件中透過自訂標記傳遞該識別碼，輕鬆整合並合併新資料。

您可以包含活動識別碼或其他分析識別碼來分析營收，判斷哪個活動帶來最多的新玩家、營收來源或客戶價值。

## 資料流程

從 API 要求收到自訂標記之後，資料就會成為 PlayStream 事件的一部分，接著流經 PlayStream 管線，並儲存在 PlayFab 的後端資料倉儲 Kusto 中。

## 限制

* 自訂標記有下列限制：
  * 不得超過 10 個機碼值組
  * 每個機碼字串不得超過 64 個 utf8 字元
  * 每個值字串不得超過 128 個 utf8 字元
  * 僅支援 API 呼叫 (亦即 Game Manager UI 不支援)

## 開始使用

下列範例要求示範如何將自訂標記新增至您的 JSON 要求。
`CustomTags` 會在相關 PlayStream 事件流經資料管線時跟隨它們，您之後可以存取這些資料，以用於可採取行動及分析的用途。

### 範例要求

```json theme={null}
POST https://titleId.playfabapi.com/Server/WritePlayerEvent
{
  "PlayFabId": "{{PlayFabId}}",
  "EventName": "player_defeated_enemy",
  "Timestamp": "2016-03-07T00:00:00Z",
  "Body": {
    "Enemy": "guardian",
    "Damage": 5,
    "Coordinates": {
      "X": 123.4,
      "Y": 543.2
    }
  },
  "CustomTags": {
    "correlation_id": "123abc",
    "build_number": "1.0.0.0",
    "platform": "iOS"
  }
}
```

### 範例回應

新增自訂標記不會改變您從端點呼叫收到的回應。新增 `CustomTag node` 之後的回應，與該節點不存在時收到的回應完全相同。


## Related topics

- [Intelligent Delivery：自訂標記指定元](/zh-TW/build/core-features/common/packaging/intelligentdelivery-custom.md)
- [PlayStream 事件功能](/zh-TW/services/playfab/data-analytics/ingest-data/playstream-event-capabilities.md)
- [使用自訂解析度進行測試](/zh-TW/build/core-features/common/game-streaming/game-streaming-testing-custom-resolution.md)
- [使用自訂 ID 登入](/zh-TW/services/playfab/api-references/rest/server/authentication/login-with-custom-id.md)
- [偵錯自訂 HTTP 堆疊](/zh-TW/build/console-features/networking/web-requests/debugging-custom-http-stacks.md)