[NEW] Unity SDK: SKAdNetwork 지원 추가

Singular Unity SDK
다운로드 Singular Unity SDK 2.1.2 버전
호환성 Unity 4.7.2+
샘플 앱 Singular SDK를 전체적으로 연동한 샘플 앱을 확인해주세요. 베스트 프랙티스에 기반하여 여러 연동 부분이 어떻게 결합될 수 있는지 확인하세요.
연동 가이드

소개: SKAdNetwork와 SKAN

SKAdNetwork는 유저의 개인 정보를 침해하지 않고 모바일 인스톨 어트리뷰션을 판정하기 위한 Apple의 신규 프레임워크입니다. SKAdNetwork를 사용하면 사용자의 개인 식별 정보를 공유하지 않는 방식으로 앱 마케팅 캠페인 성과를 측정할 수 있습니다.

Singular의 새로운 iOS SDK 버전을 통해 최소한의 개발 리소스로도 SKAdNetwork를 원할히 구현할 수 있습니다.

본 SKAdNetwork 구현은 Singular가 SKAdNetwork를 매끄럽게 구현할 수 있도록 고안한 SKAN 표준안을 따릅니다. SKAN 대한 더 자세한 내용은 SKAN 2020년 7월에 발표된 SKAN 사양을 참조하세요.

Unity SDK에서 SKAdNetwork 트래킹 활성화

SingularSDKObject 설정

SingularSDKObject 내에 다음 옵션을 설정할 수 있습니다. 각 옵션에 대한 자세한 내용은 iOS SDK SKAdNetwork 구현 가이드를 참조하세요.

옵션 기본값 정의
SKANEnabled False SKAdNetwork 지원을 활성화하려면 True로 설정.
manualSKANConversionManagement False 전환값을 수동으로 관리(매뉴얼 모드)하려면 True로 설정.
waitForTrackingAuthorizationWithTimeoutInterval *  0 (비활성화) 초 단위의 값을 설정하면 Singular SDK가 유저의 AppTrackingTransparency 동의 획득 혹은 거부 행동을 기다리면서 그동안 로깅된 이벤트를 Singular 서버로 보내지 않도록 지연하는 최대 시간을 지정.

* 주의: 2020년 9월 3일, Apple은 발표를 통해 iOS 14의 특정 개인 정보 기능 도입의 지연을 안내했습니다. 특히 IDFA 사용을 위해 AppTrackingTransparency를 사용해야만 하는 요구 사항을 내년 초까지 지연하기로 했습니다. 이 변화 사항으로 iOS 14에서 IDFA가 사용 가능하므로 AppTrackingTransprency 팝업창을 구현하지 않기를 권장합니다. 더 많은 내용은 iOS 14 베타 7과 IDFA 사용 가능 포스팅에서 확인하세요.

위 항목에서 안내된 waitForTrackingAuthorizationWithTimeoutInterval은 해당 지연 기간이 끝나고 iOS 14의 아직 발표되지 않은 추후의 버전, 즉 IDFA 획득을 위해 AppTrackingTransparency가 필요하도록 요구되도록 변경되는 향후 시점에 적용되는 내용입니다.

메서드

SingularSDK.SkanRegisterAppForAdNetworkAttribution 메서드
정의 SKAdNetwork 트래킹 등록 (SingularSDK 객체에 SKANEnabled=true를 설정하지 않은 경우). 본 메서드를 호출하면 설정된 값을 오버라이딩함
메서드 public void SkanRegisterAppForAdNetworkAttribution()
사용예
SingularSDK.SkanRegisterAppForAdNetworkAttribution();
SingularSDK.SkanUpdateConversionValue 메서드
정의

SKAdNetwork 전환값을 수동으로 업데이트.

주의: SKAdNetwork 전환값을 수동으로 설정하기를 원하는 경우에만 본 메서드 사용. 이 메서드는 manualSKANConversionManagement가 True로 설정된 경우에만 동작함.

메서드 public void SkanUpdateConversionValue(int value)
사용예
// sign-up 이벤트 발생
Singular.Event("SignUp");

// 전환값을 7로 업데이트
SingularSDK.SkanUpdateConversionValue(7);
SingularSDK.SkanGetConversionValue 메서드
정의 Singular SDK에서 트래킹된 현재 전환값 획득
메서드 public int? SkanGetConversionValue()
사용예
int? value = SingularSDK.SkanGetConversionValue();
SingularSDK.SetConversionValueUpdatedHandler 메서드
정의 전환값이 업데이트되는 시점에 알림을 받는 핸들러를 설정합니다.
메서드 public void SetConversionValueUpdatedHandler(SingularConversionValueUpdatedHandler handler)
사용예
public class Main : MonoBehaviour, SingularConversionValueUpdatedHandler {
  void Awake() {
    SingularSDK.SetConversionValueUpdatedHandler(this);
  }

  void OnConversionValueUpdated(int value) {
    // 전환값 사용
  }
}
도움이 되었습니까?