SKAdNetwork(StoreKit Ad Network)는 앱 설치와 재설치를 어트리뷰션하는 Apple의 자체 어트리뷰션 프레임워크입니다. SKAdNetwork 워크플로우는 다음과 같습니다.
- Apple은 어트리뷰션 정보를 수집하고, 관련 광고 네트워크에게 이를 알립니다.
- 네트워크는 Adjust에 해당 정보와 함께 포스트백을 전송합니다.
- Adjust는 Datascape 에 SKAdNetwork 데이터를 표시합니다.
Disable SKAdNetwork communication
Adjust SDK v4.23.0 및 이상 버전에서는 기본값에 따라 SKAdNetwork와 정보를 주고 받습니다.SDK는 초기화 시 SKAdNetwork의 어트리뷰션을 기록합니다.
config 객체에는 해당 동작을 제어하는 boolean isSKAdNetworkHandlingActive
속성이 포함되어 있습니다. 인수 없이 deactivateSKAdNetworkHandling
메서드를 호출하여 SKAdNetwork 커뮤니케이션을 비활성화할 수 있습니다.
Update conversion values
전환값은 SKAdNetwork에서 사용자 행동 측정에 사용되는 메커니즘입니다. 64가지 조건을 0
에서 63
사이의 값에 매핑하여 사용자 설치에 대해 이 정수 값을 SKAdNetwork로 전송할 수 있습니다. 이를 통해 처음 며칠간 사용자의 앱 이용에 관한 인사이트를 얻을 수 있습니다.
Adjust에서 전환값을 관리하는 경우 서버는 SDK에서 이 값을 업데이트합니다. updateConversionValue
메서드를 사용하여 이 값을 업데이트할 수도 있습니다. 이 메서드는 Apple의 updateConversionValue
메서드를 래핑하고 업데이트된 전환값을 나타내는 정수로된 인수를 받아들입니다.
Example
이 예시에서는 사용자가 이벤트를 트리거함에 따라 전환값을 10
으로 업데이트하는 방법을 보여줍니다.
Set up completion handlers
Adjust SDK는 Apple의 updatePostbackConversionValue
메서드에 대한 래퍼를 포함합니다. 이러한 메서드는 장애 처리 옵션 등 추가적인 SKAdNetwork 포스트백 핸들링 옵션을 포함하고 있습니다.
다음은 지원되는 메서드입니다.
updatePostbackConversionValue(_:completionHandler:)
: 전환값을 업데이트하고 실패를 처리.updatePostbackConversionValue(_:completionHandler:coarseValue:)
: fine 및 coarse 전환값을 전부 업데이트하고 실패를 처리.updatePostbackConversionValue(_:coarseValue:lockWindow:completionHandler:)
: fine & coarse grained 전환값을 모두 업데이트하고, 전환값 윈도우 종료 전에 포스트백을 전송할지 결정. 오류 핸들링.
인수 (Arguments) | 데이터 유형 | 설명 |
---|---|---|
fineValue | Integer | 전환값. 0 및 63 사이의 값이어야 함. |
coarseValue | SKAdNetwork.CoarseConversionValue | coarse-grained 전환값. 앱의 설치 수가 Privacy Threshold를 충족하지 못하는 경우에 사용됩니다.
|
lockWindow | Boolean | 전환값 윈도우가 종료되기 전에 포스트백을 전송할지 여부.전환값 윈도우가 종료될 때까지 기다리지 않고 시스템이 포스트백을 전송하도록 하려면 true 값을 사용하시기 바랍니다. 기본: false . |
completion | Function | 선택 사항. 전환값을 업데이트할 때 해당 메서드에 발생하는 모든 오류를 포착 및 핸들링하기 위해 제공하는 Completion Handler.핸들러를 제공하지 않는 경우 값을 nil 로 설정하시기 바랍니다. |
Example
Listen for changes to conversion values
전환값 관리에 Adjust 솔루션을 사용하는 경우, Adjust 서버는 전환값 업데이트를 SDK에 전송합니다. adjustConversionValueUpdated
메서드를 사용하면 델리게이트 함수를 설정하여 이러한 업데이트를 수신할 수 있습니다.
Example
이 예시에서는 전환값이 업데이트될 때 다음 항목을 로깅하는 방법을 보여줍니다.
- 전환값 업데이트 확인 메세지
- 새로운 전환값
SKAdNetwork 4.0 callbacks
SKAdNetwork 4.0 포스트백은 광고주들에게 사용자 관련 인사이트를 더 많이 제공하기 위해 추가적인 정보를 포함하고 있습니다. Adjust 서버가 전환값을 업데이트할 때 이 추가 정보가 페이로드에 전송됩니다. adjustConversionValueUpdated
콜백 메서드로 이 정보에 액세스하실 수 있습니다.
인수 (Arguments) | 데이터 유형 | 설명 |
---|---|---|
fineValue | NSNumber | Adjust의 서버가 전송하는 전환값 |
coarseValue | NSString | coarse-grained 전환값. 앱의 설치 수가 Privacy Threshold를 충족하지 못하는 경우에 사용됩니다.
Apple은 low, medium, high로 설정된 조건 중 어느 것도 충족되지 않는 경우 아무 것도 전송하지 않습니다. |
lockWindow | NSNumber | 전환값 윈도우가 종료되기 전에 포스트백을 전송할지 여부. 1 은 전환값 윈도우 종료 전에 포스트백이 전송됨을 의미합니다.SKAdNetwork 4.0 포스트백에서는 0 , 그 이전 SKAdNetwork 버전에서는 nil 로 기본 설정되어 있습니다. |
Example
본 예시에서 Adjust는 fine-grained 전환값, coarse-grained 전환값, SKAdNetwork 포스트백이 전환값 종료 전에 전송되도록 설정되었는지 여부를 로그합니다.
Set up direct install postbacks
Adjust에 SKAdNetwork 콜백의 사본을 전송하도록 앱을 구성하면, 고객님의 애널리틱스에서 SKAdNetwork 정보를 사용하실 수 있습니다.
다이렉트 설치 포스트백 설정을 위해, 귀하의 Info.plist
파일에 Adjust 콜백 URL을 추가해야 합니다.
- Xcode의 프로젝트 네비게이터(Project navigator)에서 Info.plist 를 선택하세요.
- 속성 리스트 에디터의 키 옆에 있는 추가 버튼(+)을 선택한 후,
Return
을 누르세요. NSAdvertisingAttributionReportEndpoint
를 키 이름으로 입력하세요.- 팝업 메뉴의 Type 을 String 으로 설정하세요.
https://adjust-skadnetwork.com
주소를 입력하세요.