엔진의 분석(analytics) API 는 UObject 종속성이 없도록 디자인되었습니다. 그때문에 블루프린트에서 C++ 코드로의 번역 레이어가 필요합니다. 아 번역 레이어는 블루프린트 라이브러리 플러그인으로 제공합니다. 이 플러그인을 켜면 블루프린트에서 API 호출을 할 수 있게 됩니다. 플러그인이 호출을 번역한 다음 프로젝트에 등록한 기본 번역 제공사에 전송합니다. 기본 제공사가 등록되지 않은 경우, 프로젝트의 로그 파일에서 경고를 확인할 수 있을 것입니다.
Start Session
현재 플레이어에 대한 분석 세션을 새로 시작합니다. 각 플레이 세션은 고유한 세션으로 취급하여, 분석 데이터가 사용자의 게임 플레이 빈도 및 기간을 캡처할 수 있도록 합니다. 기존 세션이 진행중인 경우, 대부분의 제공사들은 기존 세션을 자동으로 닫은 다음 새로 시작합니다.
| 출력 | 설명 |
|---|---|
| Return Value | 반환값 - 기본 분석 제공사가 새 세션을 만들 수 있었는지 아닌지 입니다. |
End Session
주어진 세션에 대한 이벤트 녹화를 중지합니다. 일부 제공사는 자체 수집기에 데이터를 비워넣습니다.
Record Event
관련된 특성이 없는 이벤트를 녹화하려면, Record Event 노드를 사용하세요. 이러한 유형의 이벤트는 종종 사용자가 특정 옵션을 몇 번이나 했는지 셀 때 사용합니다.
| 입력 | 설명 |
|---|---|
| Event Name | 이벤트 이름 - 증가시킬 이벤트 이름입니다. |
Record Event With Attribute
특성이 하나 있는 이벤트를 이름으로 기록하여, 고유 특성에 대한 이벤트 빈도를 비교할 수 있습니다. 예를 들어 아래 Item.Equipped 이벤트는 사용자가 게임에서 무기를 얼마나 자주 장착했는지 기록하여, 게임에서 플레이어에게 가장 인기있는 아이템을 보여줍니다.
| 입력 | 설명 |
|---|---|
| Event Name | 이벤트 이름 - 증가시킬 이벤트 이름입니다. |
| Attribute Name | 특성 이름 - 이 이벤트를 특화시킬 특성 이름입니다. |
| Attribute Value | 특성 값 - 이벤트 특화시 고유 부분으로 사용되는 값입니다. |
Record Event With Attributes
이벤트에 대해 더욱 자세한 사항을 제공해 주려면 Record Event with Attributes 를 사용하면 됩니다. 이벤트에 대한 컨텍스트로 여러 특성을 제공해 주고자 할 때 사용됩니다. 아래 예제에서, 여러가지 특성을 통해 만들어진 아이템, 사용된 머티리얼, 플레이어의 선호 대미지 모디파이어를 설명합니다. 이 예제를 통해 플레이어의 아이템 제작 선호도와 잠재된 밸런싱 문제를 발견할 수도 있습니다.
| 입력 | 설명 |
|---|---|
| Event Name | 이벤트 이름 - 증가시킬 이벤트 이름입니다. |
| Attributes | 특성 - 사용자의 동작에 대한 컨텍스트를 더해줄 특성 목록입니다. |
Make AnalyticsEventAttr
쉽게 두 개의 스트링을 받아 분석 API 가 필요로 하는 구조체로 변환해 줍니다.
| 입력 | 설명 |
|---|---|
| Attribute Name | 특성 이름 - 생성하려는 특성 이름입니다. |
| Attribute Value | 특성 값 - 생성하려는 특성 값입니다. |
Flush Events
일부 제공사는 한계점에 도달하거나 세션이 종료될 때까지 수집된 분석 데이터를 로컬 캐시에 저장해 둡니다. 이 호출로 제공사는 로컬 캐시된 데이터를 전송합니다.
Record Item Purchase
게임내 화폐를 사용한 게임내 아이템 구매를 기록합니다. 실제 금전 거래 내역용이 아닙니다. 그 대신 게임내 화폐를 사용한 아이템 구매 내역을 기록합니다. 이 게임내 화폐는 게임내에서 획득하거나 실제 금전을 사용하여 직접 구매할 수도 있습니다. 실제 금전으로 게임내 화폐 구매 내역을 추적하려면, Record Currency Purchase 노드를 사용하세요.
| 입력 | 설명 |
|---|---|
| Item Id | 아이템 ID - 구매의 특성 대상이 될 고유 아이템 식별자입니다. 특정 아이템의 인기도를 알아볼 때 이 ID 가 사용됩니다. |
| Currency | 화폐 - 아이템 구매에 사용된 게임내 화폐를 설정하는 스트링입니다 (골드, 칩, 젬 등) |
| Per Item Cost | 아이템당 가격 - 아이템 구매시 게임내 화폐 가격을 나타냅니다. |
| Item Quantity | 아이템 양 - 플레이어가 구매한 아이템 갯수입니다. |
Record Currency Given
게임이 플레이어에게 일정량의 게임내 화폐를 부여하는 것을 기록합니다. 퀘스트 완수라든가, 아이템 판매라든가, 상자를 열 때 등입니다. 게임내 경제가 전체적으로 잘 돌아가는지 이해하는 데 있어 중요한 데이터입니다.
| 입력 | 설명 |
|---|---|
| Game Currency Type | 게임 화폐 유형 - 플레이어에게 보상으로 주어진 게임내 화폐를 설명하는 스트링입니다 (골드, 칩, 젬 등) |
| Game Currency Amount | 게임 화폐 양 - 플레이어에게 주어진 화폐의 양입니다. |
Record Currency Purchase
실제 금전으로 게임내 화폐를 구매한 것을 기록하며, in-app purchase (App 내 구입) 이라고도 합니다. Apsalar 등 일부 제공사에서는 이 정보를 자동으로 캡처합니다. 보통 이 행위는 정보를 수동으로 캡처할지 말지에 따라 설정을 통해 켜고/끌 수 있습니다.
| 입력 | 설명 |
|---|---|
| Game Currency Type | 게임 화폐 유형 - 플레이어가 구매한 게임내 화폐를 설명하는 스트링입니다 (골드, 칩, 젬 등). |
| Game Currency Amount | 게임 화폐량 - 플레이어에게 부여된 화폐의 양입니다. |
| Real Currency Type | 실제 금전 유형 - 게임내 화폐 구매에 사용된 실제 금전에 대한 ISO 4217 3 자 약자입니다. 자세한 정보는 ISO guides 를 참고하세요. |
| Real Money Cost | 실제 금전 비용 - 게임내 화폐를 구매하는 데 사용된 실제 금전 액수입니다. |
| Payment Provider | 지불 제공사 - 구매를 완수한 제공사 이름입니다 (Apple, Google, PayPal, Steam, 등) |