리액트 네이티브 SDK - SKAdNetwork 지원

팔로우
Avatar
Jared Ornstead
Updated
문서

소개 SKAdNetwork와 SKAN

Singular의 iOS SDK는 다중 포스트백, 계층적 소스 ID, 세분화된 전환 값과 같은 SKAN 4.0 기능을 지원하여 SKAdNetwork 연동을 간소화합니다. Singular의 오픈 소스 SKAN 표준을 기반으로 하여 간편한 설정과 애드 네트워크와의 호환성을 보장합니다. 설정에 대한 자세한 내용은 Singular의 SKAdNetwork 가이드를 참조하세요.

SKAdNetwork 트래킹 지원

팁: Singular SDK를 사용할 때 SKAdNetwork 추적은 기본적으로 활성화되어 있습니다.

SKAdNetwork 지원을 비활성화하거나 해제하려면 다음과 같이 하세요:

  • Singular 컨피그 오브젝트를 빌드할 때 설정 메서드를 FALSE 로 설정합니다.

앱 트래킹 투명성(ATT) 처리하기

iOS 14.5 이상(iOS 18 포함)의 경우, ATTrackingManager 을 사용하여 추적을 위해 IDFA에 액세스하기 전에 사용자 동의를 요청하세요. Singular의 iOS SDK(v12.x)는 ATT를 지원하여 동의 전 초기화를 허용하고 동의를 받거나 타임아웃이 발생할 때까지 이벤트를 지연시킵니다. 이를 통해 Apple의 개인정보 보호 규정을 준수하고 SKAdNetwork(SKAN) 4.0과의 호환성을 보장합니다.

구현

  1. ATT 프레임워크 추가:

    • Xcode 프로젝트에 AppTrackingTransparency 을 포함합니다.
    • Info.plist 을 NSUserTrackingUsageDescription 으로 업데이트합니다(예: "이 앱은 추적을 사용하여 광고를 개인화합니다.").

  2. ATT 동의를 요청합니다:

    • 앱이 실행될 때 또는 온보딩 후에 UX 전략에 따라 동의를 요청하는 메시지를 표시합니다.
    • 사전 동의 초기화를 처리하려면 Singular의 SDK를 사용합니다.

  3. Singular SDK를 구성합니다:

모범 사례

  • 프롬프트 타이밍: 앱 실행 시 ATT 동의를 요청하여 IDFA 가용성을 극대화하거나, 온보딩 이후까지 지연하여 사용자 컨텍스트를 개선하세요. 동의율과 UX의 균형을 맞추기 위해 두 가지를 모두 테스트하세요.
  • 시간 초과: waitForTrackingAuthorizationWithTimeoutInterval 을 30-300초로 설정합니다. 시간 초과 후 Singular는 SKAN 4.0 어트리뷰션을 진행합니다(IDFA 없음).
  • SKAN 4.0 연동: 전환 값 업데이트가 ATT 동의와 일치하는지 확인하여 SKAN 포스트백을 최적화합니다(예: 이벤트를 0-63 값에 매핑하기 위해 Singular의 대시보드 사용).
  • 오류 처리: ATTrackingManager.trackingAuthorizationStatus 에서 restricted (예: 자녀 보호) 또는 notDetermined 상태 및 분석용 로그를 확인하세요.

수동 전환 값 처리

관리 모드

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

따라서 클라이언트 측 코드를 수정하지 않고도 Singular 플랫폼을 통해 전환 값을 설정하고 변경할 수 있어 유연성을 극대화할 수 있습니다.

이 서버 측 관리 모드는 SKAdNetwork 타이머를 처리하는 데도 도움이 됩니다. SKAdNetwork에 등록한 시점부터 24시간 이내에 전환 값을 업데이트할 수 있습니다. 전환 값을 업데이트하기 위해 호출하면 타이머가 24시간 더 연장됩니다. 따라서 전환 이벤트를 선택할 때 해당 업데이트 기간 내에 이벤트가 발생하는지 확인해야 합니다. 관리 모드에서는 앱의 새 버전을 릴리스하지 않고도 언제든지 전환 이벤트 구성을 변경할 수 있습니다.

수동 모드

전환 값을 직접 업데이트하려는 경우:

  • 싱귤래러콘을 빌드할 때 withManualSkanConversionManagement 구성 메서드를 설정합니다.
  • 그런 다음 전환 값을 업데이트하려면 앱에서 필요한 곳에 skanUpdateConversionValue 메서드를 사용하여 앱의 라이프사이클에서 필요할 때마다 업데이트합니다.
  • 또는, SKAdNetwork 4.0 전환 값을 수동으로 업데이트하려면, 앱 라이프사이클에서 필요할 때마다 skanUpdateConversionValues 메서드를 사용합니다.

참고: 초기화 시 SDK를 수동으로 업데이트하도록 설정하지 않은 경우 skanUpdateConversionValue 메서드가 작동하지 않습니다.

전환 값 검색하기

현재 전환 값을 가져오려면 skanGetConversionValue 메서드를 사용합니다. 이 메서드는 관리 모드와 수동 모드 모두에서 작동합니다.