React Native SDK: SKAdNetwork 지원 추가

 

소개: SKAdNetwork와 SKAN

SKAdNetwork는 유저의 개인 정보를 침해하지 않고 모바일 인스톨 어트리뷰션을 측정하기 위한 Apple의 신규 프레임워크입니다. Singular는 새로운 iOS SDK 버전을 통해 최소한의 개발 리소스로 SKAdNetwork를 구현할 수 있도록 지원합니다. 본 SKAdNewtork 기능구현은 Singular에서 SKAdNetwork 적용이 용이하도록 개발한 SKAN 표준에 따릅니다.

싱귤러의 SKAdNetwork 구현에 대한 전체 가이드 내용은 iOS SKAdNetwork 커스텀 옵션을 참조하세요.

 

SKAdNetwork 트래킹 활성화

Singular 초기화 이전에 skAdNetworkEnabled 설정 옵션을 켜면 앱 내 SKAdNetwork 트래킹을 활성화할 수 있습니다.

const config = new SingularConfig('<API_KEY>', '<SECRET>');

// Enable SKAdNetwork
config.withSkAdNetworkEnabled(true);

// Register to a callback for when the conversion value is updated
config.conversionValueUpdatedHandler(value => {
	console.log(`Updated conversion value: ${value}`);
  });

Singular.init(config);

 

전환값(Conversion Value) 업데이트 처리

관리 모드(Managed Mode)

기본적으로 SKAdNetwork 구현은 Singular 서버 측에서 전환값을 직접 관리합니다.

이를 통해 클라이언트측 코드를 직접 변경하는 대신 Singular 플랫폼에서 전환값을 설정하거나 변경할 수 있어 보다 편리하고 유연하게 사용할 수 있습니다.

싱귤러에서 제공하는 서버측 관리 모드는 SKAdNetwork 타이머 관리하도록 지원합니다. SKAdNetwork의 전환값은 SKAdNetwork 등록 이후 24시간 이내에만 업데이트할 수 있습니다. 전환값 업데이트를 호출할 때마다 해당 타이머는 24시간 연장됩니다. 따라서 전환값을 선택할 때 해당 이벤트가 업데이트 윈도우 내에 일어나도록 관리해야 합니다. 관리 모드에서는 새로운 앱 버전을 업데이트하지 않고도 언제든 전환 이벤트 설정을 바꿀 수 있습니다.

매뉴얼 모드(Manual Mode)

앱 코드 내에서 직접 전환값을 수동 업데이트하고자 한다면 SDK 초기화시 withManualSkanConversionManagement를 호출하세요.

const config = new SingularConfig('<API_KEY>', '<SECRET>');
// Enable SKAdNetwork
config.withSkAdNetworkEnabled(true);

// Enable manual conversion value updates
config.withManualSkanConversionManagement();

Singular.init(config);

이후 앱의 생명주기에 맞춰 skanUpdateConversionValue 메서드를 사용해서 전환값을 업데이트할 수 있습니다.

skanUpdateConversionValue 메서드 (JavaScript)
정의 SKAdNetwork 전환값을 수동으로 업데이트
메서드 Singular.skanUpdateConversionValue(conversionValue)
사용예
// signup 이벤트 발생
Singular.event("SignUp");

// 전환값을 7로 업데이트
Singular.skanUpdateConversionValue(7);

주의: 매뉴얼 업데이트 옵션을 설정하지 않으면 skanUpdateConversionValue 메서드가 동작하지 않습니다.

전환값 획득

현재의 전환값을 확인하려면 skanGetConversionValue 메서드를 사용하세요. 이 메서드는 관리 모드(Managed Mode)와 매뉴얼 모드(Manual Mode)에서 모두 사용할 수 있습니다.

skanGetConversionValue 메서드 (JavaScript)
정의 Singular SDK에서 트래킹된 현재 전환값 획득
메서드 Singular.skanGetConversionValue()
사용예
const conversionValue = Singular.skanGetConversionValue();

 

기타 iOS 14 업데이트

앱 추적 투명성 동의(ATT Consent) 처리 문서를 참고하시기 바랍니다.