Unreal Engine SDK: 이벤트 및 주문 트래킹

싱글 언리얼 엔진 SDK
다운로드
싱글 언리얼 엔진 SDK 버전 2.4.0
호환성

언리얼 엔진 4.23 이상

통합 가이드
  1. 기본 통합
  2. 이벤트 및 수익 추적
  3. 딥링크 구현하기
  4. SKAdNetwork 지원 추가
  5. 고급 옵션

 

이벤트 추적(비수익)

싱귤러는 인앱 이벤트에 대한 데이터를 수집하여 캠페인의 성과를 분석하고 KPI를 측정할 수 있습니다.

예를 들어, 게임 앱에서 사용자 로그인, 등록, 튜토리얼 완료 또는 레벨 업에 대한 데이터를 수집하고자 할 수 있습니다.

SendEventSendEventWithArgs 방법을 사용하여 앱에서 Singular로 이벤트를 보낼 수 있습니다.

참고: 타사 파트너 및 분석 솔루션을 사용하려는 경우 타사 파트너 및 분석 솔루션과의 호환성을 보장하기 위해 이벤트 이름과 속성을 영문으로 전달하는 것이 좋습니다.

SingularSDK SendEvent 메서드
설명 사용자 지정 이벤트 이름과 함께 추적할 사용자 이벤트를 Singular에 보냅니다.
서명
public static void SendEvent(FString eventName)

사용 예시

// 매개변수 없이 이름만 사용하여 이벤트 보내기
  USingularSDKBPLibrary::SendEvent("Login");
SingularSDK SendEventWithArgs 메서드
설명 사용자 지정 이벤트 이름과 추가 사용자 지정 매개변수와 함께 사용자 이벤트를 추적할 수 있도록 Singular로 보냅니다.
Signature
public static void SendEventWithArgs(FString eventName, 
TMap<FString, FString> args)

사용 예시

TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendEventWithArgs("Login", args);

수익 추적

싱귤러는 앱을 통해 얻은 수익에 대한 데이터를 수집하여 캠페인의 성과와 ROI를 분석하는 데 도움을 줄 수 있습니다. 싱귤러는 보고서, 로그 내보내기 및 포스트백에서 데이터를 사용할 수 있도록 합니다.

참고: 다른 통화로 보고된 모든 수익은 싱귤러 계정에 설정된 대로 조직의 기본 통화로 자동 변환됩니다.

사용자 지정 이벤트 이름, 거래 통화, 거래 금액 등 구매에 대한 정보를 Singular에 전달하려면 SendRevenue를 사용하세요. SendRevenueWithArgs는 매우 유사하지만 사용자 지정 매개변수를 추가할 수 있습니다.

SingularSDK SendRevenue 메서드
설명 싱귤러에 수익 이벤트를 보냅니다.
서명
public static void SendRevenue(FString eventName,
FString currency, float amount)
참고: 통화를 세 글자로 된 ISO 4217 통화 코드(예: "USD", "EUR", "INR")로 전달하세요.
사용 예시
USingularSDKBPLibrary::SendRevenue("Purchase Completed", "USD", 9.99);
SingularSDK SendRevenueWithArgs 메서드
설명 추가 사용자 지정 매개변수와 함께 수익 이벤트를 Singular로 전송합니다.
서명
public static void SendRevenueWithArgs(FString eventName, 
FString currency, float amount, TMap<FString, FString> args)
참고: 통화를 세 글자로 된 ISO 4217 통화 코드(예: "USD", "EUR", "INR")로 전달하세요.
사용 예시
// 제품 세부정보와 함께 수익 이벤트 보내기
  TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendRevenueWithArgs("Purchase Completed",
"USD", 9.99, args);

하이브리드 이벤트 추적(고급)

싱귤러는 앱에 연동된 싱귤러 SDK를 통해 모든 이벤트와 구매을 전송할 것을 권장합니다. 그러나 Singular는 다른 소스에서 이벤트와 구매을 수집할 수 있습니다.

싱귤러 SDK에서 전송되지 않은 모든 이벤트는 싱귤러의 서버 간 이벤트 문서 요구사항을준수해야 하며, 이벤트의 정확한 어트리뷰션을 위해 일치하는 기기 식별자를 제공해야 합니다.

중요:

서버 간 이벤트 요청에 사용된 디바이스 식별자가 Singular에서 일치하는 디바이스 식별자가 없는 경우 불일치가 발생할 수 있습니다. 다음과 같은 가능성에 유의하세요:

  • 이벤트 요청이 앱 세션에서 싱귤러 SDK가 디바이스 식별자를 기록하기 '전에 ' 수신된 경우, 이벤트 요청은 알 수 없는 디바이스에 대한 '첫 번째 세션'으로 간주되며, 싱귤러는 해당 디바이스를 오가닉 어트리뷰션으로 어트리뷰션합니다.
  • 싱귤러 SDK가 디바이스 식별자를 기록했지만, 싱귤러 SDK 식별자가 서버 간 이벤트 요청에 지정된 디바이스 식별자와 다른 경우, 이벤트는 잘못 어트리뷰션됩니다.

하이브리드 이벤트 추적 가이드

내부 서버에서 이벤트 보내기

싱귤러는 서버에서 수익에 대한 데이터를 수집하여 캠페인의 성과와 ROI를 분석하는 데 도움을 줄 수 있습니다.

요구사항:

  • 인앱 등록 또는 로그인 이벤트에서 디바이스 식별자를 캡처하여 전달하고 이 데이터를 서버의 사용자 ID와 함께 저장하세요. 디바이스 식별자는 사용자에 따라 변경될 수 있으므로 사용자가 앱 세션을 생성할 때 식별자를 업데이트해야 합니다. 이렇게 하면 서버 측 이벤트가 올바른 디바이스에 어트리뷰션되도록 보장할 수 있습니다.
  • 서버 측 이벤트는 플랫폼별로 다르므로 디바이스 플랫폼과 일치하는 디바이스 식별자(예: iOS 디바이스의 경우 IDFA 또는 IDFV)로만 전송해야 합니다.
  • 싱귤러 내부 BI 포스트백 메커니즘을 사용하여 이벤트를 내부 엔드포인트로 실시간으로 푸시하여 서버 측의 데이터 집합을 업데이트할 수 있습니다. 내부 BI 포스트백 FAQ를 참조하세요.
  • 자세한 내용은 서버 간 통합 가이드의 "수익 추적 " 섹션을 검토하세요.
수익 제공업체에서 이벤트 보내기
RevenueCat 또는 adapty와 같은 타사 제공업체는 구매 및 구독 수익을 Singular에 제공할 수 있습니다.

이러한 파트너를 활성화하는 방법에 대한 자세한 내용은 아래 링크를 참조하세요.

세그먼트에서 이벤트 보내기

세그먼트에서 싱귤러 SDK와 병행하여 싱귤러에 이벤트를 보내려면 세그먼트에 "클라우드 모드" 대상을 추가해야 합니다. 여기에서 가이드를 따르세요.