> ## 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 이벤트와 함께 사용자 지정 태그 사용

사용자 지정 태그는 스튜디오가 모든 API 요청에 선택적으로 포함할 수 있는 키-값 쌍의 컬렉션입니다. 표준 PlayStream 이벤트를 더 많은 스튜디오별 메타데이터(예: 빌드 번호, 외부 추적 식별자 등)로 보강하는 데 유용합니다.

사용자 지정 태그는 PlayStream 이벤트를 사용할 수 있는 방법을 확장합니다. 기본 PlayStream 스키마는 고정되어 있어 확장성이 없지만, 이는 공통 지표와 분석을 구축할 수 있게 해주었습니다. 스키마의 고정된 특성으로 인해 게임 스튜디오는 효율적이고 경제적인 방식으로 데이터를 사용자 지정하는 능력이 제한되었고, 특정 데이터 포인트를 수집하는 능력도 제한되었습니다. 사용자 지정 태그는 스키마를 확장하여 더 큰 유연성과 기능을 제공하는 방법을 제공합니다.

## 사용자 지정 태그로 무엇을 할 수 있나요?

사용자 지정 태그를 사용하여 많은 작업을 수행할 수 있습니다. 다음은 몇 가지 제안이지만, 사용할 때 더 창의적이어도 좋습니다.

### 자동화

PlayStream 메타데이터는 특정 이벤트를 트리거하는 기준 역할을 할 수 있습니다. 작업을 수행해야 할 때 PlayFab 고객은 "\[사용자 지정 태그]가 xyz 요구 사항을 충족하면 작업 A를 실행"이라고 하는 규칙을 설정할 수 있습니다.

CloudScript를 사용자 지정 태그와 통합하여 자동화를 달성할 수 있습니다. CloudScript [Actions and Rules](/services/playfab/data-analytics/acting-data/action-rules-overview)를 사용하면 특정 기준에 따라 이벤트를 자동으로 실행할 수 있습니다.

예를 들어, 게임 스튜디오가 게임에 대해 성과 마케팅에 투자하고 있고 새로운 플레이어를 확보하기 위해 다양한 마케팅 캠페인을 진행 중이라면, 이제 플레이어를 획득한 마케팅 캠페인을 추적하고 그 캠페인 ID를 모든 PlayStream 이벤트에 추가할 수 있습니다. 그런 다음 그 캠페인 ID를 사용해 프로세스를 자동화할 수 있습니다. 예를 들어, 광고에서 "가입 시 무료 금화 1,000개"를 약속했다면, "새 플레이어" 이벤트를 보내고 마케팅 캠페인을 사용하여 어떤 인센티브를 플레이어에게 제공할지 결정합니다. 예: 'marketing campaign = 'FREE\_GOLD\_COINS'이면 플레이어에게 금화 1,000개를 지급'.

### 원격 분석

PlayStream 메타데이터는 데이터 수집 및 분석에 도움을 줄 수 있습니다. 예를 들어, PlayFab이 아닌 서비스에서 PlayStream 이벤트 데이터의 일부로 사용자 지정 태그를 보내고, 그것이 데이터 파이프라인을 통해 흐르는 동안 계속 추적할 수 있습니다.
이미 자체 분석 시스템(예: 특정 식별자 기반)이 있는 경우 그 식별자를 PlayStream 이벤트의 일부로 사용자 지정 태그에 전달하여 새 데이터를 쉽게 통합하고 병합할 수 있습니다.

캠페인 ID 또는 기타 분석 식별자를 포함하여 수익을 분석하고, 어느 캠페인이 가장 많은 신규 플레이어 획득, 수익 흐름 또는 고객 가치를 창출했는지 판단할 수 있습니다.

## 데이터 흐름

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 노드`를 추가한 후의 응답은 노드가 없을 때 받는 응답과 동일합니다.


## Related topics

- [Intelligent Delivery: 사용자 지정 태그 지정자](/ko/build/core-features/common/packaging/intelligentdelivery-custom.md)
- [사용자 지정 CloudScript 작성](/ko/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript.md)
- [Insights](/ko/services/playfab/data-analytics/legacy/insights/overview.md)
- [플레이어 사용자 지정 속성 빠른 시작](/ko/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [게임 스트리밍 사용자 지정 해상도 모범 사례](/ko/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices.md)