> ## 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 업적 서비스가 Data Platform 원격 분석 및 사용자 통계를 사용하여 직접적인 API 호출 없이 업적을 잠금 해제하는 방법입니다.

이 항목에서는 이벤트 기반 업적 서비스가 Data Platform 원격 분석을 사용하여 플레이어 업적을 추적하는 방법을 설명합니다.

<Note>타이틀에서 이벤트 기반 업적(이전에는 Achievements 2013이라고 함)을 사용 중이고, 앞으로 여러 플랫폼을 지원하려면 계속 이벤트 기반 업적을 사용해야 합니다. 사용자가 모든 플랫폼에서 자신의 업적을 유지할 수 있도록 하기 위해 이것이 필요합니다.</Note>

개발자 및 게시자가 타이틀을 서비스로서 관리할 수 있도록 지원하기 위해 업적 서비스는 XBOX services 이벤트 기반 Data Platform 위에 구축되었습니다.

이벤트 기반 Data Platform은 타이틀 개발자가 사용량 원격 분석을 수집하고 이 데이터를 기반으로 사용자 경험을 구축하는 데 사용할 수 있는 단일 이벤트 기반 데이터 모델 및 파이프라인으로 구성됩니다. Data Platform의 주요 혁신 중 하나는 게시자가 플레이어의 행동에 대한 심층 통찰력을 얻기 위해 사용할 수 있는 공유 의미 체계를 지원하는 공통 사용자 통계 분류 체계입니다.

모든 업적은 타이틀의 직접적인 API 호출을 요구하는 것이 아니라 사용자 통계에서 파생됩니다. 이는 두 가지 이유로 수행되었습니다.

1. 개발자는 추가 코드 변경이나 타이틀 업데이트 없이 타이틀 출시 후 업적을 추가할 수 있습니다. 타이틀이 출시 시점에 잘 계측된 경우, 개발자는 클라우드에서 타이틀의 서비스 구성을 업데이트하여 새 업적을 추가할 수 있습니다.

2. 타이틀은 동일한 타이틀 내 사용자 행동에 대해 더 적은 서비스 호출을 할 수 있습니다. 예를 들어 타이틀은 사용자 통계가 여러 영역에 적용되는 단일 이벤트를 기록할 수 있습니다. 이벤트는 궁극적으로 업적, 리더보드 및 비즈니스 인텔리전스(BI) 보고서에 기여할 수 있습니다.

### 데이터 파이프라인

업적 서비스 사용의 주요 단계에 대한 개괄적인 보기는 다음 단계로 제공됩니다.

1. 구성
   XBOX services가 처리하거나 저장해야 하는 관련 데이터를 지정하는 타이틀 구성을 설계하고 게시합니다.

2. 계측
   데이터가 제대로 인코딩되고 전송되도록 타이틀 내 이벤트 로깅을 구현합니다.

3. 수집
   타이틀은 클라이언트 로깅 라이브러리를 사용하여 이벤트를 Data Platform에 공급합니다. 이 서비스는 타이틀 구성에 따라 이벤트를 처리하여 통계를 집계, 상관 관계, 라우팅 및 저장합니다.

4. 업적 처리
   서비스는 들어오는 통계 변경 사항을 처리하여 업적 목표가 충족되었는지 감지합니다. 타이틀 구성에 따라 서비스는 업적을 잠금 해제하고, 적절한 보상 시스템에 알리며, 업적 레코드를 저장합니다.

5. 알림
   업적 서비스는 추가 경험 및 기능을 구동하기 위해 잠금 해제 활동을 사용자에게(시스템 토스트 알림을 통해), 타이틀, XBOX 클라이언트 및 기타 XBOX services에 전달합니다.

6. 분석
   게시자가 플레이어가 자신의 타이틀을 어떻게 사용하고 있는지 이해하는 데 사용하는 온라인 보고 및 BI 플랫폼입니다.

### 업적 서비스의 주요 기능

XBOX services는 업적 서비스를 크게 확장했으며, 이를 통해 타이틀 개발자는 업적을 사용하여 사용자 참여를 유도하는 방법에 대한 더 많은 옵션과 제어권을 갖게 됩니다.
이벤트 기반 업적 서비스는 다음 기능을 도입했습니다:

* 클라우드 트리거 잠금 해제
* 챌린지
* 업적에서 딥 링크 사용
* 업적 진행

#### 클라우드 트리거 잠금 해제

이벤트 기반 업적의 경우 타이틀은 업적을 잠금 해제하기 위해 XBOX services에 업적별 호출을 수행하지 않습니다. 대신 개발자와 게시자는 이제 클라우드의 서비스 구성에서 업적의 잠금 해제 규칙을 온라인으로 구성합니다. XBOX services는 클라우드에서 실시간으로 이러한 규칙 처리를 처리합니다. 이를 통해 개발자와 게시자는 타이틀을 업데이트하지 않고도 타이틀 출시 후 새로운 업적과 챌린지를 추가할 수 있습니다.

#### 챌린지(시간 제한 업적)

챌린지는 더 최신 타이틀 관리 업적 서비스에서 더 이상 사용할 수 없으며 챌린지 사용은 더 이상 권장되지 않습니다. 자세한 내용은 [이벤트 기반 vs 타이틀 관리 업적](/services/xbox-services/player-data/achievements/live-achievements-eb-vs-tm)을 참조하세요.

챌린지는 지정된 기간 동안만 사용자가 잠금 해제할 수 있는 시간 제한 업적입니다. 아이콘, 잠금 해제 규칙 및 숨기기 옵션 등 업적처럼 구성되지만, 유효한 기간을 정의해야 한다는 점이 다릅니다.

사용자가 챌린지를 완료하면 사용자의 업적 기록에 잠금 해제된 업적으로 저장됩니다. 사용자가 챌린지에 참여했지만 유효 기간 동안 챌린지가 잠금 해제되지 않으면 해당 기록은 사용자의 업적 기록에 저장되지 않습니다.

#### 업적에서 딥 링크 사용

타이틀은 업적 스키마를 사용하여 업적 세부 정보에 표시되는 딥 링크를 지정할 수 있습니다. 딥 링크는 업적을 획득할 수 있는 게임 내 위치에 연결됩니다. 링크는 프로토콜 활성화 중에 게임에 전달되는 문자열로 형식화됩니다. 타이틀은 문자열을 구문 분석하여 게임 내 어디로 이동할지 결정해야 합니다. 예를 들어, 게임의 레벨 완료와 관련된 업적은 게임에 문자열을 전달하는 딥 링크를 업적 세부 정보에 포함할 수 있습니다. 이는 게임에 해당 레벨로 이동하도록 지시합니다.

#### 업적 진행

XBOX 업적 서비스는 업적 진행 상황을 측정하고 타이틀이 해당 진행 상황을 플레이어에게 표시하는 데 사용할 수 있는 데이터를 제공합니다.

업적 서비스는 업적 규칙별 진행 세부 정보를 제공합니다. 업적을 잠금 해제하기 위해 충족해야 하는 여러 요구 사항이 있는 경우 서비스 응답에는 각 요구 사항에 대한 진행 세부 정보가 포함됩니다. 업적에 여러 통계를 기반으로 하는 하나의 요구 사항이 있는 경우 서비스는 기본 통계를 결합하는 단일 진행 값을 반환합니다.

### 진행 객체

사용자 업적 목록을 쿼리하면 진행 객체가 반환됩니다. 여기에는 업적 규칙(요구 사항) 및 해당 요구 사항 충족을 향한 사용자의 현재 진행 상태에 대한 세부 데이터가 포함됩니다. 자세한 내용은 [XblAchievementProgression](/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression) 참조를 참조하세요.


## Related topics

- [이벤트 기반 업적](/ko/services/xbox-services/player-data/achievements/event-based/live-achievements-eb-nav.md)
- [이벤트 기반](/ko/services/xbox-services/player-data/achievements/event-based/index.md)
- [이벤트 기반 업적의 포털 구성](/ko/services/xbox-services/player-data/achievements/event-based/config/live-achievements-eb-portal.md)
- [이벤트 기반 플레이어 데이터 개요](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/live-how-data-platform-works.md)
- [이벤트 기반 업적 개념](/ko/services/xbox-services/player-data/achievements/event-based/concepts/live-achievements-eb-concepts-nav.md)