SKAdNetwork 4.0 가이드: 3가지 포스트백 윈도우의 동작 방식

SKAdNetwork 4.0 멀티 윈도우 어트리뷰션은 어떻게 작동하나요? SKAdNetwork 4.0은 앱 최초 실행 후 0~2일, 3~7일, 8~35일에 걸쳐 전환 측정 기간을 세 개의 순차적인 윈도우로 나눕니다. Apple은 각 앱 다운로드에 포스트백 데이터 계층을 할당하며, 이를 통해 해당 포스트백이 세밀한(fine-grained), 개략적인(coarse-grained) 또는 축소된 어트리뷰션 데이터를 노출할지 여부가 결정됩니다.

SKAdNetwork 4.0은 iOS에서 개인정보를 보호하며 캠페인 성과를 측정할 수 있도록 지원하는 Apple의 개인정보 보호 중심 모바일 마케팅 어트리뷰션 프레임워크입니다. 지속적인 기기 식별자를 수집하지 않고도 퍼널 중반부의 사용자 생애 가치를 평가하기 위해 최초 실행 후 최대 35일까지 지속되는 세 개의 순차적 전환 윈도우, 계층형 소스 식별자, 개략적 전환 값, 윈도우 잠금 메커니즘을 도입했습니다.

한눈에 보기: 주요 포스트백 일정 및 공개 규칙

• 윈도우 1 (최초 실행 후 0~2일): 세밀한 값(0~63) 또는 개략적인 값(low, medium, high)을 공개할 수 있으며, 추가로 무작위화된 24~48시간의 지연 후에 발송됩니다.
• 윈도우 2 (최초 실행 후 3~7일): 포스트백 데이터 계층에 의해 제공 및 허용된 경우 coarse-conversion-value를 공개할 수 있으며, 그렇지 않은 경우 해당 필드는 생략됩니다. 추가로 무작위화된 24~144시간의 지연 후에 발송됩니다.
• 윈도우 3 (최초 실행 후 8~35일): 포스트백 데이터 계층에 의해 제공 및 허용된 경우 coarse-conversion-value를 공개할 수 있으며, 그렇지 않은 경우 해당 필드는 생략됩니다. 추가로 무작위화된 24~144시간의 지연 후에 발송됩니다.
• 계층 0 데이터 제약: 계층 0에 해당하는 다운로드에는 2자리 소스 ID가 포함되고 전환 값이 없는 단일 포스트백만 수신되며, 두 번째 및 세 번째 포스트백은 생략됩니다.
• 다중 포스트백 요건: 여러 개의 성공적인 포스트백 대상이 되려면 광고가 SKAdNetwork 4 이상을 사용하여 서명되어야 하며, 광고된 앱이 해당 전환 윈도우 동안 전환 값을 업데이트해야 합니다.

SKAdNetwork 4.0이란 무엇이며 멀티 윈도우 어트리뷰션은 어떻게 작동하는가

단일 타이머 제약에서 멀티 윈도우 라이프사이클 추적으로의 구조적 진화

초기 버전의 Apple StoreKit Ad Network(SKAdNetwork 2.0 및 3.0)는 단일 24시간 롤링 타이머를 기반으로 작동했습니다. SKAdNetwork 3 및 이전 버전에서는 유효한 증가형 전환 값 업데이트가 24시간 타이머를 재시작하여 롤링 전환 기간을 연장할 수 있었습니다. 업데이트 없이 24시간이 경과하면 윈도우가 닫히고 Apple은 무작위 지연 후 단일 포스트백을 발송했습니다.

이러한 단일 타이머 아키텍처는 운영상의 마찰을 야기했습니다.

• 제한된 관측 범위: 광고주는 설치 후 초기 일주일 동안 발생하는 조기 참여만 측정할 수 있었습니다.
• 보고 지연: 반복되는 유효한 전환 업데이트는 유효 측정 기간을 연장하고 최종 포스트백을 지연시켜 자동화된 광고 입찰 알고리즘의 속도를 늦췄습니다.
• 제한된 롱테일 가시성: SKAdNetwork 3에는 체계적인 7일 차부터 30일 차까지의 측정을 위한 전용 후속 전환 윈도우가 없었습니다.

SKAdNetwork 4.0은 사용자의 최초 앱 실행을 기준으로 고정된 세 개의 순차적 측정 윈도우를 설정하여 이 모델을 재구조화합니다.

어트리뷰션 타이머와 활성 사용자 세션의 분리

SKAdNetwork 4.0에서 전환 윈도우는 지속적인 사용자 활동이 아닌 고정된 캘린더 기간에 따라 진행됩니다. 어트리뷰션된 광고 노출 후 앱이 처음 열리면 운영 체제는 윈도우 1을 시작합니다.

첫 48시간 동안 사용자가 앱을 한 번 열든 쉰 번 열든, 윈도우 1은 48시간 시점에 종료됩니다(윈도우 잠금을 통해 조기 완료되지 않는 한). 그 후 시스템은 자동으로 윈도우 2(3일 차부터 7일 차까지)로 진행하고, 이어 윈도우 3(8일 차부터 35일 차까지)으로 진행합니다. 이러한 분리는 하위 데이터 파이프라인을 위한 구조화된 포스트백 발송 간격을 보장합니다.

이중 암호화 서명 체인

SKAdNetwork는 두 가지 서로 다른 단계에서 공개키 암호화를 사용하여 데이터 무결성을 유지합니다.

• 광고 노출 단계 (광고 네트워크에서 Apple로): 광고 네트워크가 노출을 제공할 때 개인키를 사용하여 광고 페이로드에 서명합니다. 앱이 설치되고 실행되면 운영 체제는 이 서명을 Apple에 등록된 광고 네트워크의 공개키와 대조하여 어트리뷰션 자격을 검증합니다.
• 설치 검증 단계 (Apple에서 광고 네트워크/개발자로): 전환 윈도우가 종료되면 Apple은 설치 검증 포스트백 페이로드에 서명합니다. 수신하는 광고 네트워크와 개발자 엔드포인트는 Apple의 공개키를 사용하여 이 서명을 확인하고 포스트백의 진위성과 무결성을 검증합니다.

참조 항목: SKAdNetwork ──> 모바일 어트리뷰션 모델

3가지 포스트백 윈도우의 메커니즘과 측정 일정

윈도우 1: 초기 참여 및 고정밀 전환 신호 포착

• 측정 간격: 0일 차부터 2일 차까지 (최초 실행 후 첫 48시간).
• 사용 가능한 데이터 공개: 할당된 포스트백 데이터 계층에 따라 결정되는 세밀한 전환 값(0에서 63 사이의 6비트 정수) 또는 개략적 값(low, medium, high).
• 무작위 포스트백 지연: 윈도우 종료 또는 잠금 후 24~48시간.
• 분석 목적: 즉각적인 온보딩 완료, 튜토리얼 마일스톤, 초기 구매 전환, 초기 이탈 위험 측정.

윈도우 2: 초기 사용자 리텐션 및 퍼널 중반부 마일스톤 평가

• 측정 간격: 최초 실행 후 3일 차부터 7일 차까지 (48시간부터 168시간까지).
• 사용 가능한 데이터 공개: 포스트백 데이터 계층에 의해 제공 및 허용된 경우 coarse-conversion-value(low, medium, high)를 공개할 수 있으며, 그렇지 않은 경우 해당 필드는 생략됩니다. 윈도우 2에서는 세밀한 값(0~63)이 지원되지 않습니다.
• 무작위 포스트백 지연: 윈도우 종료 또는 잠금 후 24~144시간 (1~6일).
• 분석 목적: 3일 차부터 7일 차까지의 리텐션, 멀티 데이 참여 루프, 초기 구독 체험, 반복 구매 행동 평가.

윈도우 3: 롱테일 리텐션 및 누적 생애 가치 측정

• 측정 간격: 최초 실행 후 8일 차부터 35일 차까지 (168시간부터 840시간까지).
• 사용 가능한 데이터 공개: 포스트백 데이터 계층에 의해 제공 및 허용된 경우 coarse-conversion-value(low, medium, high)를 공개할 수 있으며, 그렇지 않은 경우 해당 필드는 생략됩니다.
• 무작위 포스트백 지연: 윈도우 종료 또는 잠금 후 24~144시간 (1~6일).
• 분석 목적: 1개월 차 리텐션 벤치마크, 무료 체험판의 유료 구독 전환, 롱테일 수익화 마일스톤 포착.

광고 노출
      │
      ▼
앱 설치
      │
      ▼
앱 최초 실행  ← 전환 측정 t = 0
      │
      ├── 윈도우 1: 최초 실행 후 0~2일
      │      세밀한 공개 또는 개략적 공개
      │      종료/잠금 후 24~48시간 무작위 지연
      │
      ├── 윈도우 2: 최초 실행 후 3~7일
      │      개략적 공개만 가능 (또는 생략)
      │      종료/잠금 후 24~144시간 무작위 지연
      │
      └── 윈도우 3: 최초 실행 후 8~35일
             개략적 공개만 가능 (또는 생략)
             종료/잠금 후 24~144시간 무작위 지연

무작위 지연 메커니즘: 윈도우 1 대 윈도우 2 및 3

관찰자가 인앱 트랜잭션의 정확한 밀리초와 어트리뷰션 포스트백 수신을 연관시키는 타이밍 공격 휴리스틱을 방지하기 위해 Apple은 무작위화된 발송 지연을 적용합니다.

• 윈도우 1 타이머: 조기 잠금 없이 윈도우 1이 자연스럽게 종료되면, 추가로 무작위화된 24~48시간의 지연 후에 첫 번째 포스트백이 전송됩니다.
• 윈도우 2 및 3 타이머: 측정 기간이 연장됨에 따라 Apple은 무작위 지연 윈도우를 24~144시간(최대 6일)으로 확대합니다.

포스트백 데이터 계층이 공개를 제어하는 방식

공식 포스트백 데이터 계층 매트릭스

Apple은 소스 앱 또는 도메인과 연관된 크라우드, 광고된 앱, 설치 국가, 계층형 소스 식별자를 기반으로 앱 다운로드에 포스트백 데이터 계층(계층 0부터 계층 3까지)을 할당합니다. Apple은 계층 0부터 계층 3까지에 대한 보편적인 설치 수 임계값을 공개하지 않습니다.

계층형 소스 식별자의 작동 방식

소스 식별자의 구조와 세밀도

SKAdNetwork 4.0은 레거시 2자리 캠페인 ID를 소스 식별자(Source Identifier)라는 4자리 계층형 정수로 대체합니다.

광고 네트워크와 개발자는 내부 보고 요구사항에 따라 계층형 소스 식별자의 의미를 정의합니다.

• 하위 두 자리 ($d_2 d_1$): 공개될 수 있는 계층형 소스 식별자의 최소 두 자리 부분을 형성합니다. 광고 네트워크는 광범위한 캠페인 그룹화를 위해 이 부분을 사용할 수 있지만, Apple이 고정된 비즈니스 의미를 지정하지는 않습니다.
• 상위 자릿수 ($d_4 d_3$): 광고 지면, 크리에이티브 ID, 지역 타겟팅과 같은 내부 차원을 인코딩할 수 있습니다. Apple은 개별 자릿수에 고정된 비즈니스 의미를 할당하지 않습니다.

원본 소스 식별자: [ d4 ] [ d3 ] [ d2 ] [ d1 ]

첫 번째 성공 포스트백에서 공개 가능한 형태:
2자리 공개:          [ d2 ] [ d1 ]
3자리 공개:    [ d3 ][ d2 ] [ d1 ]
4자리 공개: [ d4 ][ d3 ][ d2 ] [ d1 ]

공개되는 정확한 자릿수는 Apple의 포스트백 데이터 계층에 따라 다릅니다.

캠페인 통합은 특정 소스 식별자와 연관된 크라우드를 증가시킬 수 있지만, Apple은 보편적인 설치 임계값을 공개하지 않으며 통합이 특정 포스트백 데이터 계층을 보장하지는 않습니다.

세밀한 전환 값 대 개략적 전환 값

세밀한 전환 값 (Fine-Grained Conversion Values)

세밀한 전환 값은 0부터 63까지의 정수를 나타내는 6비트 이진수로 작동합니다($2^6 = 64$개의 개별 값). 계층 2 또는 계층 3 포스트백 데이터 계층 하의 윈도우 1에서만 독점적으로 제공되는 세밀한 값을 통해 개발자는 세밀한 수익 범위, 퍼널 단계 또는 비트 단위 이벤트 조합을 인코딩할 수 있습니다.

개략적 전환 값 (Coarse-Grained Conversion Values)

개략적 전환 값은 적용 가능한 포스트백 데이터 계층이 세밀한 공개를 허용하지 않을 때 더 낮은 세밀도의 대안을 제공하며, 두 번째 및 세 번째 포스트백의 전환 값 형식으로 역할을 합니다. Apple은 low, medium, high에 미리 정의된 비즈니스 의미를 할당하지 않으며, 아래 예시는 애플리케이션 정의 매핑의 예시입니다:

• low: 기본 참여(예: 초기 앱 실행 또는 가입)에 대한 예시 매핑.
• medium: 중간 참여(예: 완료된 튜토리얼 또는 멀티 데이 활성 세션)에 대한 예시 매핑.
• high: 고가치 전환 마일스톤(예: 인앱 구매 또는 체험판 활성화)에 대한 예시 매핑.

구현별 전환 스키마 설계에 대해서는 SKAN 전환 매핑 문서를 참조하세요.

포스트백 시퀀스 색인 매핑

SKAdNetwork 4 포스트백에서 postback-sequence-index 필드는 해당 전환 윈도우를 식별합니다:

Apple은 설치 검증 포스트백이 conversion-value(세밀한 값) 또는 coarse-conversion-value(개략적 값) 중 하나를 포함할 수 있으며, 두 가지를 동시에 포함할 수는 없다고 명시하고 있습니다.

아래 페이로드는 SKAdNetwork 4의 예시입니다. 실제 포스트백 필드는 포스트백 시퀀스, 포스트백 데이터 계층, 광고 유형, 개인정보 공개 조건에 따라 다릅니다. 샘플 attribution-signature 값은 자리표시자이며 암호화 유효성이 검증되지 않았습니다.

아래 예시 1은 윈도우 1 세밀한 포스트백 페이로드를 보여주고, 예시 2는 윈도우 2 개략적 포스트백 페이로드를 보여줍니다:

{
  "version": "4.0",
  "ad-network-id": "example123.skadnetwork",
  "source-identifier": "4821",
  "app-id": 1234567890,
  "transaction-id": "6a8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "postback-sequence-index": 0,
  "conversion-value": 47,
  "fidelity-type": 1,
  "did-win": true,
  "attribution-signature": "MEQCIFz8...SAMPLE_CRYPTOGRAPHIC_SIGNATURE...=="
}

{
  "version": "4.0",
  "ad-network-id": "example123.skadnetwork",
  "source-identifier": "48",
  "app-id": 1234567890,
  "transaction-id": "6a8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "postback-sequence-index": 1,
  "coarse-conversion-value": "high",
  "fidelity-type": 1,
  "did-win": true,
  "attribution-signature": "MEQCIFz8...SAMPLE_CRYPTOGRAPHIC_SIGNATURE...=="
}

전환 윈도우 조기 잠금의 트레이드오프

lockWindow 매개변수를 통한 측정 가속화

기본적으로 각 측정 윈도우는 전체 캘린더 기간 동안 열려 있습니다(윈도우 1은 48시간, 윈도우 2는 5일, 윈도우 3은 28일). lockWindow가 true인 경우, 해당 업데이트는 활성 윈도우의 최종 전환 값 업데이트가 됩니다. 시스템은 포스트백을 준비하고 해당 윈도우의 남은 기간 동안 추가적인 전환 값 업데이트를 무시합니다.

기본 윈도우 1 (잠금 없음):
[최초 실행] ─────────────── 48시간 열림 ───────────────► [종료] ──► 지연 (24~48시간) ──► 포스트백 1

잠긴 윈도우 1 (6시간 차에 구매 발생):
[최초 실행] ── 6시간 (Lock: true) ──► [전환 값 잠김 / 포스트백 준비됨] ──► 지연 (24~48시간) ──► 포스트백 1이 더 빠르게 전송됨

윈도우 잠금 호출 시 운영 고려사항

• 포스트백 발송 가속화: 전환이 조기에 완료되면, 전체 캘린더 윈도우가 경과하기를 기다리는 대신 잠긴 전환이 완료되는 즉시 포스트백 지연이 시작됩니다.
• 윈도우 독립성: 현재 윈도우를 잠그더라도 다음 윈도우의 시작 시점이 앞당겨지지 않습니다. 다음 전환 윈도우는 윈도우 1이 잠긴 시점과 관계없이 미리 정의된 시간 경계에 따라 시작됩니다(예: 윈도우 2는 윈도우 1의 잠금 여부와 무관하게 3일 차에 시작됨).
• 후속 이벤트 잠금 (Lockout): lockWindow: true가 실행되면 운영 체제는 해당 특정 윈도우의 남은 기간 동안 발생하는 모든 후속 전환 값 업데이트 호출을 무시합니다.

아래의 Swift 코드는 StoreKit을 사용하여 세밀한 전환 값과 개략적 전환 값을 업데이트하고 윈도우 잠금을 호출하는 방법을 보여줍니다:

import Foundation
import StoreKit

enum SKANError: Error {
    case invalidFineValue
    case unsupportedOSVersion
}

final class SKAN4Manager {

    static let shared = SKAN4Manager()
    private init() {}

    /// 전환 값을 업데이트하고 선택적으로 활성 SKAN 4.0 윈도우를 잠급니다.
    /// - Parameters:
    ///   - fineValue: 윈도우 1용 6비트 정수 (0~63). 참고: 윈도우 2와 3에서 SKAdNetwork는 fineValue 매개변수를 무시합니다.
    ///   - coarseValue: 모든 윈도우용 개략적 값 문자열 ("low", "medium", "high")
    ///   - shouldLock: 활성 윈도우를 즉시 완료하기 위한 부울 플래그
    func updateConversionState(
        fineValue: Int,
        coarseValue: SKAdNetwork.CoarseConversionValue,
        shouldLock: Bool,
        completion: ((Error?) -> Void)? = nil
    ) {
        guard #available(iOS 16.1, *) else {
            completion?(SKANError.unsupportedOSVersion)
            return
        }

        // 세밀한 값 범위 검증 (0~63)
        guard (0...63).contains(fineValue) else {
            completion?(SKANError.invalidFineValue)
            return
        }

        // 비동기 SKAN 4.0 전환 업데이트 실행
        SKAdNetwork.updatePostbackConversionValue(
            fineValue,
            coarseValue: coarseValue,
            lockWindow: shouldLock
        ) { error in
            if let error = error {
                print("SKAN 4.0 업데이트 실패: \(error.localizedDescription)")
            } else {
                print("SKAN 4.0 업데이트 성공 - Fine: \(fineValue), Coarse: \(coarseValue.rawValue), Locked: \(shouldLock)")
            }
            completion?(error)
        }
    }

    /// 예시 수익 매핑 워크플로 (특정 임계값을 프로덕션에 직접 복사하지 마십시오)
    /// 참고: 프로덕션에서는 활성 전환 윈도우를 결정하고 윈도우별 개략적 값 로직을 정의하십시오.
    func handleInAppPurchase(amountUSD: Double) {
        let fineVal: Int
        let coarseVal: SKAdNetwork.CoarseConversionValue
        let lock: Bool

        switch amountUSD {
        case 0.0..<5.0:
            fineVal = 10
            coarseVal = .low
            lock = false
        case 5.0..<25.0:
            fineVal = 25
            coarseVal = .medium
            lock = false
        case 25.0...:
            fineVal = 60
            coarseVal = .high
            // 고가치 전환에 대한 포스트백 준비를 신속하게 처리하기 위해 윈도우를 즉시 잠급니다.
            lock = true
        default:
            fineVal = 0
            coarseVal = .low
            lock = false
        }

        updateConversionState(fineValue: fineVal, coarseValue: coarseVal, shouldLock: lock)
    }
}

SKAdNetwork 4.0 및 AdAttributionKit 상호운용성

SKAdNetwork와 Apple AdAttributionKit의 관계

Apple은 iOS 17.4 이상을 위한 확장된 어트리뷰션 프레임워크로 AdAttributionKit을 도입했습니다. AdAttributionKit과 SKAdNetwork는 공존할 수 있지만, 각각 별개의 어트리뷰션 API로 유지됩니다:

• 프레임워크별 API 호출: 앱은 광고 네트워크가 사용하는 프레임워크에 해당하는 전환 업데이트 API를 호출해야 합니다. 광고 네트워크가 AdAttributionKit을 통해 광고를 제공하는 경우 앱은 AdAttributionKit 전환 메서드를 호출하고, SKAdNetwork를 사용하는 경우 StoreKit API를 호출합니다.
• 크로스 프레임워크 위너 선택: 두 프레임워크가 단일 설치에 대해 적격 노출을 모두 기록하는 경우, 운영 체제는 이를 함께 평가하여 어트리뷰션을 위한 단일 승인 노출을 선택합니다.
• 브리징 동작: Apple은 측정 레이어 간의 호환성을 보장하기 위해 특정 SKAdNetwork 업데이트 호출에 대해 전환 값 브리징 동작을 제공합니다.

기존 App Store 어트리뷰션 통합을 운영하는 데는 SKAdNetwork 4가 계속해서 중요하며, Apple은 새로운 앱 광고 구현을 AdAttributionKit으로 유도하고 두 프레임워크 간의 상호운용성을 문서화하고 있습니다.

비교 매트릭스: 레거시 SKAN 3.0 대 SKAN 4.0 멀티 윈도우 모델

요약 및 의사결정 프레임워크

SKAdNetwork 4.0은 최초 앱 실행일로부터 35일까지 어트리뷰션 가시성을 확장하고, 세밀한 공개가 불가능할 때 더 낮은 세밀도의 측정을 제공하기 위해 개략적 전환 값을 도입했으며, 개발자가 전환 윈도우가 조기에 완료되었을 때 포스트백 지연을 줄이기 위해 측정 윈도우를 잠글 수 있도록 허용합니다. 성공적인 구현을 위해서는 세 가지 윈도우 모두에 대한 신중한 전환 스키마 매핑과 클라이언트 측 업데이트 호출을 실제 비즈니스 마일스톤과 정렬하는 작업이 필요합니다.

애플리케이션 레벨의 딥링크 라우팅은 별도의 측정 및 온보딩 레이어로서 Apple의 개인정보 보호 중심 어트리뷰션 프레임워크와 함께 작동할 수 있습니다. 구현별 딥링크 라우팅 및 어트리뷰션 워크플로에 대해서는 OpoInstall 문서를 참조하세요.

관련 자료

• 개념: 멀티 윈도우 어트리뷰션, 포스트백 데이터 계층, 계층형 소스 식별자, 윈도우 잠금, 개략적 값

• 기술: Apple SKAdNetwork, Apple AdAttributionKit, StoreKit 프레임워크, OpoInstall 모바일 SDK

• 표준: IETF RFC 8259 JSON 사양

• API: StoreKit updatePostbackConversionValue API, SKAdNetwork 설치 검증 포스트백

공식 문서

• SKAdNetwork에 대한 Apple 개발자 문서

• AdAttributionKit에 대한 Apple 개발자 문서

• 여러 전환 윈도우에서 포스트백 수신에 대한 Apple 개발자 문서

• 설치 검증 포스트백의 매개변수 식별에 대한 Apple 개발자 문서

• 포스트백 전환 값 업데이트에 대한 Apple 개발자 문서

• AdAttributionKit과 SKAdNetwork 상호운용성 이해하기