언리얼 SDK

SDK 설치

GitHub 릴리즈 타임라인 페이지에서 AmplitudeUnreal.zip의 최신 버전을 다운로드하십시오. 파일을 언리얼 프로젝트의 Plugins 디렉터리 내 폴더에 압축을 푸십시오.

bash

mkdir -p Plugins/AmplitudeUnreal
unzip AmplitudeUnreal.zip -d Plugins/AmplitudeUnreal

편집기에서 SDK 플러그인 활성화

UE4 에디터에서 프로젝트를 엽니다. 설정 > 플러그인 > 프로젝트 > 분석으로 이동하여 AmplitudeUnreal을 활성화하십시오.

Amplitude를 분석 공급자로 활성화

설정 > 프로젝트 설정 > 분석 > Amplitude로 이동하여 필드에 API 키를 입력하십시오.

필수 분석 모듈 포함

계측과 관련된 모든 파일에는 언리얼 엔진 분석 헤더를 포함시켜야 합니다.

cpp

#include "Runtime/Analytics/Analytics/Public/Analytics.h"
#include "Runtime/Analytics/Analytics/Public/Interfaces/IAnalyticsProvider.h"

이벤트 및 사용자 속성 추적

Amplitude 언리얼 API는 언리얼 엔진이 정의한 분석 제공자 인터페이스를 따릅니다.

기본 이벤트 기록

이벤트는 사용자가 앱과 상호작용하는 방식을 나타냅니다. 예를 들어 Game Started 이벤트를 추적할 수 있습니다.

cpp

FAnalytics::Get().GetDefaultConfiguredProvider()->StartSession();
FAnalytics::Get().GetDefaultConfiguredProvider()->RecordEvent(TEXT("Game started"));
FAnalytics::Get().GetDefaultConfiguredProvider()->EndSession();

속성과 함께 이벤트 기록

이벤트에는 속성이 포함될 수 있습니다. 속성은 이벤트에 대한 컨텍스트를 제공합니다.

cpp

TArray<FAnalyticsEventAttribute> AppendedAttributes;
AppendedAttributes.Emplace(TEXT("Test Event Prop key1"), TEXT("Test Event value1"));
AppendedAttributes.Emplace(TEXT("Test Event Prop key2"), TEXT("Test Event value2"));
FAnalytics::Get().GetDefaultConfiguredProvider()->RecordEvent(TEXT("Game Started"), AppendedAttributes);

사용자 속성 설정

사용자 속성은 사용자가 앱에서 작업을 수행할 때의 사용자를 설명합니다.

일반적인 언리얼 엔진 IAnalyticsProvider은 제한된 수의 사용자 속성을 지원합니다.

cpp

FAnalytics::Get().GetDefaultConfiguredProvider()->SetLocation(TEXT("Test location"));
FAnalytics::Get().GetDefaultConfiguredProvider()->SetGender(TEXT("Test gender"));
FAnalytics::Get().GetDefaultConfiguredProvider()->SetAge(TEXT(27));

사용자 지정 사용자 ID 설정

앱에 자체 로그인 시스템이 있는 경우 SetUserId를 사용하여 사용자 지정 사용자 ID를 설정합니다.

cpp

FAnalytics::Get().GetDefaultConfiguredProvider()->SetUserID(TEXT("test123@test.com"));

이 내용이 도움이 되었나요?