블루프린트 분석 플러그인

분석 서비스와의 통신을 위해 제공되는 블루프린트 노드 집합입니다.

Windows
MacOS
Linux

엔진의 분석(analytics) API 는 UObject 종속성이 없도록 디자인되었습니다. 그때문에 블루프린트에서 C++ 코드로의 번역 레이어가 필요합니다. 아 번역 레이어는 블루프린트 라이브러리 플러그인으로 제공합니다. 이 플러그인을 켜면 블루프린트에서 API 호출을 할 수 있게 됩니다. 플러그인이 호출을 번역한 다음 프로젝트에 등록한 기본 번역 제공사에 전송합니다. 기본 제공사가 등록되지 않은 경우, 프로젝트의 로그 파일에서 경고를 확인할 수 있을 것입니다.

analytics_blueprint_plugin.png

Start Session

현재 플레이어에 대한 분석 세션을 새로 시작합니다. 각 플레이 세션은 고유한 세션으로 취급하여, 분석 데이터가 사용자의 게임 플레이 빈도 및 기간을 캡처할 수 있도록 합니다. 기존 세션이 진행중인 경우, 대부분의 제공사들은 기존 세션을 자동으로 닫은 다음 새로 시작합니다.

Start Session
Return Value

출력

설명

Return Value

반환값 - 기본 분석 제공사가 새 세션을 만들 수 있었는지 아닌지 입니다.

End Session

주어진 세션에 대한 이벤트 녹화를 중지합니다. 일부 제공사는 자체 수집기에 데이터를 비워넣습니다.

End Session

Record Event

관련된 특성이 없는 이벤트를 녹화하려면, Record Event 노드를 사용하세요. 이러한 유형의 이벤트는 종종 사용자가 특정 옵션을 몇 번이나 했는지 셀 때 사용합니다.

Record Event
Event Name
WeaponStore.Opened

입력

설명

Event Name

이벤트 이름 - 증가시킬 이벤트 이름입니다.

Record Event With Attribute

특성이 하나 있는 이벤트를 이름으로 기록하여, 고유 특성에 대한 이벤트 빈도를 비교할 수 있습니다. 예를 들어 아래 Item.Equipped 이벤트는 사용자가 게임에서 무기를 얼마나 자주 장착했는지 기록하여, 게임에서 플레이어에게 가장 인기있는 아이템을 보여줍니다.

Record Event with Attribute
Event Name
Item.Equipped
Attribute Name
ItemID
Attribute Value
Sword23

입력

설명

Event Name

이벤트 이름 - 증가시킬 이벤트 이름입니다.

Attribute Name

특성 이름 - 이 이벤트를 특화시킬 특성 이름입니다.

Attribute Value

특성 값 - 이벤트 특화시 고유 부분으로 사용되는 값입니다.

Record Event With Attributes

이벤트에 대해 더욱 자세한 사항을 제공해 주려면 Record Event with Attributes 를 사용하면 됩니다. 이벤트에 대한 컨텍스트로 여러 특성을 제공해 주고자 할 때 사용됩니다. 아래 예제에서, 여러가지 특성을 통해 만들어진 아이템, 사용된 머티리얼, 플레이어의 선호 대미지 모디파이어를 설명합니다. 이 예제를 통해 플레이어의 아이템 제작 선호도와 잠재된 밸런싱 문제를 발견할 수도 있습니다.

Record_event_with_attributes.png

입력

설명

Event Name

이벤트 이름 - 증가시킬 이벤트 이름입니다.

Attributes

특성 - 사용자의 동작에 대한 컨텍스트를 더해줄 특성 목록입니다.

Make AnalyticsEventAttr

쉽게 두 개의 스트링을 받아 분석 API 가 필요로 하는 구조체로 변환해 줍니다.

make_analyticseventattr.png

입력

설명

Attribute Name

특성 이름 - 생성하려는 특성 이름입니다.

Attribute Value

특성 값 - 생성하려는 특성 값입니다.

Flush Events

일부 제공사는 한계점에 도달하거나 세션이 종료될 때까지 수집된 분석 데이터를 로컬 캐시에 저장해 둡니다. 이 호출로 제공사는 로컬 캐시된 데이터를 전송합니다.

Flush Events

Record Item Purchase

게임내 화폐를 사용한 게임내 아이템 구매를 기록합니다. 실제 금전 거래 내역용이 아닙니다. 그 대신 게임내 화폐를 사용한 아이템 구매 내역을 기록합니다. 이 게임내 화폐는 게임내에서 획득하거나 실제 금전을 사용하여 직접 구매할 수도 있습니다. 실제 금전으로 게임내 화폐 구매 내역을 추적하려면, Record Currency Purchase 노드를 사용하세요.

Record Item Purchase
Item Id
Sword23
Currency
Gems
Per Item Cost
1
Item Quantity
1

입력

설명

Item Id

아이템 ID - 구매의 특성 대상이 될 고유 아이템 식별자입니다. 특정 아이템의 인기도를 알아볼 때 이 ID 가 사용됩니다.

Currency

화폐 - 아이템 구매에 사용된 게임내 화폐를 설정하는 스트링입니다 (골드, 칩, 젬 등)

Per Item Cost

아이템당 가격 - 아이템 구매시 게임내 화폐 가격을 나타냅니다.

Item Quantity

아이템 양 - 플레이어가 구매한 아이템 갯수입니다.

Record Currency Given

게임이 플레이어에게 일정량의 게임내 화폐를 부여하는 것을 기록합니다. 퀘스트 완수라든가, 아이템 판매라든가, 상자를 열 때 등입니다. 게임내 경제가 전체적으로 잘 돌아가는지 이해하는 데 있어 중요한 데이터입니다.

Record Currency Given
Game Currency Type
Gems
Game Currency Amount
10

입력

설명

Game Currency Type

게임 화폐 유형 - 플레이어에게 보상으로 주어진 게임내 화폐를 설명하는 스트링입니다 (골드, 칩, 젬 등)

Game Currency Amount

게임 화폐 양 - 플레이어에게 주어진 화폐의 양입니다.

Record Currency Purchase

실제 금전으로 게임내 화폐를 구매한 것을 기록하며, in-app purchase (App 내 구입) 이라고도 합니다. Apsalar 등 일부 제공사에서는 이 정보를 자동으로 캡처합니다. 보통 이 행위는 정보를 수동으로 캡처할지 말지에 따라 설정을 통해 켜고/끌 수 있습니다.

Record Currency Purchase
Game Currency Type
Gems
Game Currency Amount
100
Real Currency Type
USD
Real Money Cost
19.00
Payment Provider
Paypal

입력

설명

Game Currency Type

게임 화폐 유형 - 플레이어가 구매한 게임내 화폐를 설명하는 스트링입니다 (골드, 칩, 젬 등).

Game Currency Amount

게임 화폐량 - 플레이어에게 부여된 화폐의 양입니다.

Real Currency Type

실제 금전 유형 - 게임내 화폐 구매에 사용된 실제 금전에 대한 ISO 4217 3 자 약자입니다. 자세한 정보는 ISO guides 를 참고하세요.

Real Money Cost

실제 금전 비용 - 게임내 화폐를 구매하는 데 사용된 실제 금전 액수입니다.

Payment Provider

지불 제공사 - 구매를 완수한 제공사 이름입니다 (Apple, Google, PayPal, Steam, 등)

새로운 언리얼 엔진 4 문서 사이트에 오신 것을 환영합니다!

문서 사이트에 대한 의견을 모을 수 있는 피드백 시스템을 포함해서 여러가지 새로운 기능을 준비하고 있습니다. 아래 Documentation Feedback 포럼(영문) 또는 언리얼 엔진 네이버 공식 카페(한글) 중 편하신 곳에 의견이나 문제점을 알려 주세요.

새 시스템이 준비되면 알려 드리겠습니다.

네이버 카페
공식 포럼