문서

언리얼 엔진 SDK 연동 가이드

다음 대상 가이드	개발자 변경 로그
전제 조건	Singular 계정 액세스 다운로드하세요: Singular 언리얼 엔진 SDK 버전 2.5.0
호환성	언리얼 엔진 4.23 이상
연동 가이드	기본 연동 이벤트 및 구매 추적 딥 링크 구현하기 SKAdNetwork 지원 추가 고급 옵션

소개 SKAdNetwork 및 SKAN

SKAdNetwork는 최종 사용자의 개인 정보를 침해하지 않고 모바일 인스톨을 어트리뷰션하기 위한 Apple의 새로운 프레임워크입니다. Singular의 새로운 버전의 iOS SDK는 최소한의 엔지니어링 작업으로 SKAdNetwork를 원활하게 구현할 수 있도록 도와줍니다. 이 SKAdNetwork 구현은 SK광고네트워크의 원활한 구현을 위해 Singular가 개발한 표준인 SKAN을 기반으로 합니다.

Singular의 SKAdNetwork 구현에 대한 전체 가이드는 iOS SDK SKAdNetwork 구현 가이드를 참조하세요.

언리얼 엔진 SDK에서 SKAdNetwork 구현하기

USingularSDKBPLibrary::Initialize 메서드 설정하기

USingularSDKBPLibrary::Initialize 메 서드에서 다음 옵션을 구성할 수 있습니다. 각 옵션에 대한 자세한 내용은 iOS SDK SKAdNetwork 구현 가이드를 참조하세요.

옵션	기본값	설명
skAdNetworkEnabled	True	SKAdNetwork 지원을 활성화하려면 true로 설정합니다.
수동 SKAN전환관리	False	전환 값을 수동으로 관리하려면 true로 설정합니다.

참고: 언리얼 엔진 SDK 버전 2.0.11부터 SKAdNetwork가 기본적으로 활성화됩니다.

이전 버전의 SDK를 사용하는 경우 skAdNetworkEnabled 을 True 으로 설정하여 SKAdNetwork 를 활성화해야 합니다.

SKAdNetwork 메소드

Singular SDK SkanRegisterAppForAdNetwork 어트리뷰션 메서드
설명	SKAdNetwork 트래킹을 등록합니다. 참고: 이는 USingularSDKBPLibrary::Initialize 메서드에서 skAdNetworkEnabled를 True로 설정하는 것과 동일합니다. 이 메서드를 호출하면 USingularSDKBPLibrary::Initialize 에서 설정된 값이 재정의됩니다. 언리얼 엔진 SDK 버전 2.0.11부터 SKAdNetwork는 기본적으로 활성화됩니다.
서명	public void SkanRegisterAppForAdNetworkAttribution()
사용 예제	`USingularSDKBPLibrary::SkanRegisterAppForAdNetworkAttribution();`
Singular SDK SkanUpdateConversionValue 메서드
설명	SKAdNetwork 전환 값을 업데이트합니다. 참고: SKAdNetwork 전환 값을 수동으로 업데이트하도록 선택한 경우 이 메서드를 사용합니다. 이 메서드는 manualSKANConversionManagement 가 True 로 설정된 경우에만 작동합니다.
서명	public void SkanUpdateConversionValue(int conversionValue)
사용 예시	`// A sign-up event happened USingularSDKBPLibrary::SendEvent("SignUp"); // Update the conversion value to 7 USingularSDKBPLibrary::SkanUpdateConversionValue(7);`
SingularSDK SkanGetConversionValue 메서드
설명	Singular SDK가 추적한 현재 전환 값을 가져옵니다.
서명	public int SkanGetConversionValue()
사용 예시	`int value = USingularSDKBPLibrary::SkanGetConversionValue();`

SKAN 전환 값 업데이트에 등록

델리게이트를 등록하려는 클래스의 헤더 파일 상단에 #include "SingularDelegates.h" 을 추가합니다.

클래스에 다음을 추가합니다:

// A delegate to register that invokes the Conversion Value updated

  UPROPERTY(BlueprintAssignable, Category = "Singular-SDK")
  FOnConversionValueUpdated OnConversionValueUpdated;
  
  // The method we will use to register the delegate

  UFUNCTION()
  void NewConversionValue(int32 conversionValue);

클래스 cpp 파일에서 이벤트에 등록합니다:

OnConversionValueUpdated.AddDynamic(this,&YOURCLASS::NewConversionValue);

언리얼 엔진 SDK 연동 가이드

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