이벤트 및 수익 추적

팔로우
Avatar
Eyal Rabinovich
Updated
문서

언리얼 엔진 SDK 연동 가이드

다음 대상 가이드 개발자 변경 로그
전제 조건
호환성 언리얼 엔진 4.23 이상
연동 가이드
  1. 기본 연동
  2. 이벤트 및 구매 추적
  3. 딥링크 구현하기
  4. SKAdNetwork 지원 추가
  5. 고급 옵션

이벤트 추적 (비 구매)

Singular는 캠페인 성과를 분석하고 KPI를 측정하기 위해 인앱 이벤트에 대한 데이터를 수집할 수 있습니다.

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

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

참고: 타사 파트너 및 분석 솔루션과의 호환성을 보장하기 위해 이벤트 이름과 속성을 영문으로 전달할 것을 적극 권장합니다.

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

사용 예시

 
// Send an event without any parameters, just a name

  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);

구매 추적

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

참고: 다른 통화로 보고된 모든 구매은 Singular 계정에 설정된 대로 조직의 기본 통화로 자동 변환됩니다.

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

SingularSDK SendRevenue 메서드
설명 Singular에 구매 이벤트를 보냅니다.
서명 
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").
사용 예시 
// Send a revenue event with product details

  TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendRevenueWithArgs("Purchase Completed",
  "USD", 9.99, args);

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

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

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

중요:

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

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

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

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

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

요구 사항:

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

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

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

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

언리얼 엔진 SDK 연동 가이드

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