Unreal Engine SDK : Skadnetwork 지원 추가

팔로우
Avatar
Eyal Rabinovich
Updated
싱글 언리얼 엔진 SDK
다운로드
 싱글 언리얼 엔진 SDK 버전 2.4.0
호환성

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

 

소개 SKAdNetwork 및 SKAN

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

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

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

USingularSDKBPLibrary::Initialize 메서드 설정

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

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

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

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

SKAdNetwork 메서드

싱글 SDK SkanRegisterAppForAdNetwork 어트리뷰션 메서드
설명

SKAdNetwork 트래킹을 위해 등록합니다.

참고:

  • 이는 USingularSDKBPLibrary::Initialize 메서드에서 skAdNetworkEnabled를True로 설정하는 것과 동일합니다.
  • 이 메서드를 호출하면 USingularSDKBPLibrary::Initialize 에 설정된 값이 오버라이드됩니다.
  • 언리얼 엔진 SDK 버전 2.0.11부터 SKAdNetwork가 기본적으로 활성화됩니다.
시그니처 public void SkanRegisterAppForAdNetworkAttribution()
사용 예제 
USingularSDKBPLibrary::SkanRegisterAppForAdNetworkAttribution();
싱글 SDK SkanUpdateConversionValue 메서드
설명

SKAdNetwork 전환 값을 업데이트합니다.

참고: SKAdNetwork 전환값을 수동으로 업데이트하도록 선택한 경우 이 메서드를 사용합니다. 이 메서드는 manualSKANConversionManagement 이 True 으로 설정된 경우에만 작동합니다.
서명 public void SkanUpdateConversionValue(int conversionValue)
사용 예시 
  // 회원가입 이벤트가 발생했습니다
  USingularSDKBPLibrary::SendEvent("SignUp");
  
  // 전환 가치를 7로 업데이트하세요.
  USingularSDKBPLibrary::SkanUpdateConversionValue(7);
싱글 SDK 스칸겟컨버젼값 메서드
설명 싱귤러 SDK가 추적하는 현재 전환 값을 가져옵니다.
Signature public int SkanGetConversionValue()
사용 예시 
int value = USingularSDKBPLibrary::SkanGetConversionValue();

SKAN에 등록 전환 값 업데이트

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

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

      // 업데이트된 전환 가치를 호출하는 등록 대리자
  UPROPERTY(BlueprintAssignable, Category = "Singular-SDK")
  FOnConversionValueUpdated OnConversionValueUpdated;
  
  // 대리인을 등록하는 데 사용할 방법
  UFUNCTION()
  void NewConversionValue(int32 conversionValue);

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

    OnConversionValueUpdated.AddDynamic(this,&YOURCLASS::NewConversionValue);
단일 언리얼 엔진 SDK
통합 가이드
  1. 기본 통합
  2. 이벤트 및 수익 추적
  3. 딥링크 구현하기
  4. SKAdNetwork 지원 추가
  5. 고급 옵션