PlayStream 이벤트와 함께 사용자 지정 태그 사용
사용자 지정 태그는 스튜디오가 모든 API 요청에 선택적으로 포함할 수 있는 키-값 쌍의 컬렉션입니다. 표준 PlayStream 이벤트를 더 많은 스튜디오별 메타데이터(예: 빌드 번호, 외부 추적 식별자 등)로 보강하는 데 유용합니다. 사용자 지정 태그는 PlayStream 이벤트를 사용할 수 있는 방법을 확장합니다. 기본 PlayStream 스키마는 고정되어 있어 확장성이 없지만, 이는 공통 지표와 분석을 구축할 수 있게 해주었습니다. 스키마의 고정된 특성으로 인해 게임 스튜디오는 효율적이고 경제적인 방식으로 데이터를 사용자 지정하는 능력이 제한되었고, 특정 데이터 포인트를 수집하는 능력도 제한되었습니다. 사용자 지정 태그는 스키마를 확장하여 더 큰 유연성과 기능을 제공하는 방법을 제공합니다.사용자 지정 태그로 무엇을 할 수 있나요?
사용자 지정 태그를 사용하여 많은 작업을 수행할 수 있습니다. 다음은 몇 가지 제안이지만, 사용할 때 더 창의적이어도 좋습니다.자동화
PlayStream 메타데이터는 특정 이벤트를 트리거하는 기준 역할을 할 수 있습니다. 작업을 수행해야 할 때 PlayFab 고객은 “[사용자 지정 태그]가 xyz 요구 사항을 충족하면 작업 A를 실행”이라고 하는 규칙을 설정할 수 있습니다. CloudScript를 사용자 지정 태그와 통합하여 자동화를 달성할 수 있습니다. CloudScript Actions and Rules를 사용하면 특정 기준에 따라 이벤트를 자동으로 실행할 수 있습니다. 예를 들어, 게임 스튜디오가 게임에 대해 성과 마케팅에 투자하고 있고 새로운 플레이어를 확보하기 위해 다양한 마케팅 캠페인을 진행 중이라면, 이제 플레이어를 획득한 마케팅 캠페인을 추적하고 그 캠페인 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 이벤트를 따라 데이터 파이프라인을 통해 흐르며, 나중에 실행 가능한 목적과 분석 목적을 위해 이 데이터에 액세스할 수 있습니다.
샘플 요청
샘플 응답
사용자 지정 태그를 추가해도 엔드포인트 호출에서 받는 응답은 변경되지 않습니다.CustomTag 노드를 추가한 후의 응답은 노드가 없을 때 받는 응답과 동일합니다.