이 기능은 iOS 14 이상 버전의 기기에서만 사용할 수 있습니다.
SKAdNetwork(StoreKit Ad Network)는 앱 설치와 재설치를 어트리뷰션하는 Apple의 자체 어트리뷰션 프레임워크입니다. SKAdNetwork 워크플로우는 다음과 같습니다.
- Apple은 어트리뷰션 정보를 수집하고, 관련 광고 네트워크에게 이를 알립니다.
- 네트워크는 Adjust에 해당 정보와 함께 포스트백을 전송합니다.
- Adjust는 Datascape 에 SKAdNetwork 데이터를 표시합니다.
SKAdNetwork 커뮤니케이션 비활성화
- (void)disableSkanAttribution;Adjust SDK는 기본값에 따라 SKAdNetwork와 정보를 주고 받습니다. SDK는 초기화 시 SKAdNetwork의 어트리뷰션을 기록합니다.
인수 없이 disableSkanAttribution 메서드를 호출하여 SKAdNetwork 커뮤니케이션을 비활성화할 수 있습니다.
disableSkanAttribution 메서드는 Adjust SDK를 초기화하기 이전 에 호출해야 합니다.
let yourAppToken = "{YourAppToken}"let environment = ADJEnvironmentSandboxlet adjustConfig = ADJConfig( appToken: yourAppToken, andEnvironment: environment)//...adjustConfig.disableSkanAttribution()//...Adjust.initSdk(adjustConfig)ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:@"{YourAppToken}" andEnvironment:ADJEnvironmentSandbox];[adjustConfig disableSkanAttribution];/// ...[Adjust initSdk:adjustConfig];전환값 업데이트
+ (void)updateConversionValue:(NSInteger)conversionValue;전환값은 SKAdNetwork에서 사용자 행동 측정에 사용되는 메커니즘입니다. 64가지 조건을 0에서 63 사이의 값에 매핑하여 사용자 설치에 대해 이 정수 값을 SKAdNetwork로 전송할 수 있습니다. 이를 통해 처음 며칠간 사용자의 앱 이용에 관한 인사이트를 얻을 수 있습니다.
Adjust에서 전환값을 관리하는 경우 서버는 SDK에서 이 값을 업데이트합니다. updateSkanConversionValue 메서드를 사용하여 이 값을 업데이트할 수도 있습니다. 이 메서드는 Apple의 updateConversionValue 메서드를 래핑하고 다음 인수를 허용합니다.
| 인수 (Arguments) | 데이터 유형 | 설명 |
|---|---|---|
fineValue | Integer | 전환값. 0 및 63 사이의 값이어야 함. |
coarseValue | SKAdNetwork.CoarseConversionValue | coarse-grained 전환값. 앱의 설치 수가 Privacy Threshold를 충족하지 못하는 경우에 사용됩니다.
|
lockWindow | Boolean | 전환값 윈도우가 종료되기 전에 포스트백을 전송할지 여부.전환값 윈도우가 종료될 때까지 기다리지 않고 시스템이 포스트백을 전송하도록 하려면 true 값을 사용하시기 바랍니다. 기본: false. |
completion | Function | 선택 사항. 전환값을 업데이트할 때 해당 메서드에 발생하는 모든 오류를 포착 및 핸들링하기 위해 제공하는 Completion Handler.핸들러를 제공하지 않는 경우 값을 nil로 설정하시기 바랍니다. |
Adjust.updateSkanConversionValue( 1, coarseValue: SKAdNetwork.CoarseConversionValue.low, lockWindow: false) { error in if let error { print(String(format: "An error occurred during completion: %@", error)) }}[Adjust updateSkanConversionValue:1 coarseValue:SKAdNetworkCoarseConversionValueLow lockWindow:NO withCompletionHandler:^(NSError *_Nullable error) { NSLog(@"An error occurred during completion: %@", error);}];SKAdNetwork 콜백
SKAdNetwork 4.0 포스트백은 광고주들에게 사용자 관련 인사이트를 더 많이 제공하기 위해 추가적인 정보를 포함하고 있습니다. Adjust 서버가 전환값을 업데이트하면 이 추가 정보가 유형이 지정되지 않은 딕셔너리에 전송됩니다. 이 정보에 액세스하려면 completion handler를 [adjustSkanUpdatedWithConversionData] 메서드에 전달합니다. completion handler에서 콜백 정보에 액세스할 수 있습니다.
conversion_value: 업데이트된 전환값coarse_value: 업데이트된 coarse 전환값lock_window: 전환값 윈도우가 종료되기 전에 포스트백을 전송할지 여부error: 업데이트로 반환된 모든 오류 메시지
예시
본 예시에서 Adjust는 fine-grained 전환값, coarse-grained 전환값, SKAdNetwork 포스트백이 전환값 종료 전에 전송되도록 설정되었는지 여부를 로그합니다.
func adjustSkanUpdated(withConversionData data: [String: String]) { print("Conversion value updated callback called!") print(String(format: "Conversion value dictionary: \n%@", data.description))}- (void)adjustSkanUpdatedWithConversionData:(NSDictionary<NSString *, NSString *> *)data { NSLog(@"Conversion value updated callback called!"); NSLog(@"Conversion value dictionary: \n%@", data.description);}다이렉트 설치 포스트백(direct install postback) 설정하기
다이렉트 설치 포스트백은 SKAdNetwork 정보만 포함합니다. 캠페인 데이터와 같은 정보는 다이렉트 설치 포스트백에 포함되지 않습니다.
Adjust에 SKAdNetwork 콜백의 사본을 전송하도록 앱을 구성하면, 고객님의 애널리틱스에서 SKAdNetwork 정보를 사용하실 수 있습니다.
다이렉트 설치 포스트백 설정을 위해, 귀하의 Info.plist 파일에 Adjust 콜백 URL을 추가해야 합니다.
- Xcode의 프로젝트 네비게이터(Project navigator)에서 Info.plist 를 선택하세요.
- 속성 리스트 에디터의 키 옆에 있는 추가 버튼(+)을 선택한 후,
Return을 누르세요. NSAdvertisingAttributionReportEndpoint를 키 이름으로 입력하세요.- 팝업 메뉴의 Type 을 String 으로 설정하세요.
https://adjust-skadnetwork.com주소를 입력하세요.
자세한 정보는 Apple의 Configuring an Advertised App 설명서를 참조하시기 바랍니다.
이 기능은 iOS 14 이상 버전의 기기에서만 사용할 수 있습니다.
SKAdNetwork(StoreKit Ad Network)는 앱 설치와 재설치를 어트리뷰션하는 Apple의 자체 어트리뷰션 프레임워크입니다. SKAdNetwork 워크플로우는 다음과 같습니다.
- Apple은 어트리뷰션 정보를 수집하고, 관련 광고 네트워크에게 이를 알립니다.
- 네트워크는 Adjust에 해당 정보와 함께 포스트백을 전송합니다.
- Adjust는 Datascape 에 SKAdNetwork 데이터를 표시합니다.
SKAdNetwork 커뮤니케이션 비활성화
- (void)deactivateSKAdNetworkHandling;Adjust SDK v4.23.0 및 이상 버전에서는 기본값에 따라 SKAdNetwork와 정보를 주고 받습니다.SDK는 초기화 시 SKAdNetwork의 어트리뷰션을 기록합니다.
config 객체에는 해당 동작을 제어하는 boolean isSKAdNetworkHandlingActive 속성이 포함되어 있습니다. 인수 없이 deactivateSKAdNetworkHandling 메서드를 호출하여 SKAdNetwork 커뮤니케이션을 비활성화할 수 있습니다.
deactivateSKAdNetworkHandling 메서드는 Adjust SDK를 초기화하기 이전 에 호출해야 합니다.
let yourAppToken = "{YourAppToken}"let environment = ADJEnvironmentSandbox as? Stringlet adjustConfig = ADJConfig( appToken: yourAppToken, environment: environment)//...adjustConfig.deactivateSKAdNetworkHandling()//...Adjust.appDidLaunch(adjustConfig)*adjustConfig = [ADJConfig configWithAppToken:@"{YourAppToken}" environment:ADJEnvironmentSandbox];[adjustConfig.deactivateSKAdNetworkHandling];/// ...[Adjust appDidLaunch:adjustConfig];전환값 업데이트
+ (void)updateConversionValue:(NSInteger)conversionValue;전환값은 SKAdNetwork에서 사용자 행동 측정에 사용되는 메커니즘입니다. 64가지 조건을 0에서 63 사이의 값에 매핑하여 사용자 설치에 대해 이 정수 값을 SKAdNetwork로 전송할 수 있습니다. 이를 통해 처음 며칠간 사용자의 앱 이용에 관한 인사이트를 얻을 수 있습니다.
Adjust에서 전환값을 관리하는 경우 서버는 SDK에서 이 값을 업데이트합니다. updateConversionValue 메서드를 사용하여 이 값을 업데이트할 수도 있습니다. 이 메서드는 Apple의 updateConversionValue 메서드를 래핑하고 업데이트된 전환값을 나타내는 정수로된 인수를 받아들입니다.
Adjust.updateConversionValue(value)[Adjust updateConversionValue:value];예시
이 예시에서는 사용자가 이벤트를 트리거함에 따라 전환값을 10으로 업데이트하는 방법을 보여줍니다.
func onButtonClick() { Adjust.updateConversionValue(10)}- (void)onButtonClick { [Adjust updateConversionValue:10];}Completion Handler 설정
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로 설정하시기 바랍니다. |
예시
if #available(iOS 16.1, *) { Adjust.updatePostbackConversionValue( 1, coarseValue: SKAdNetwork.CoarseConversionValue.low.rawValue, lockWindow: false) { error in if let error { print(String(format: "An error occurred during completion: %a", error)) } }}if (@available(iOS 16.1, *)) { [Adjust updatePostbackConversionValue:1 coarseValue:SKAdNetworkCoarseConversionValueLow lockWindow:NO completionHandler:^(NSError *_Nullable error) { NSLog(@"An error occurred during completion: %a", error); }];}전환값 변경 사항 수신
전환값 관리에 Adjust 솔루션을 사용하는 경우, Adjust 서버는 전환값 업데이트를 SDK에 전송합니다. adjustConversionValueUpdated 메서드를 사용하면 델리게이트 함수를 설정하여 이러한 업데이트를 수신할 수 있습니다.
예시
이 예시에서는 전환값이 업데이트될 때 다음 항목을 로깅하는 방법을 보여줍니다.
- 전환값 업데이트 확인 메세지
- 새로운 전환값
func adjustConversionValueUpdated(_ conversionValue: NSNumber?) { print("Conversion value: \(conversionValue ?? 0)")}- (void)adjustConversionValueUpdated:(NSNumber *)conversionValue { NSLog(@"Conversion value: %@", conversionValue);}SKAdNetwork 4.0 콜백
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로 기본 설정되어 있습니다. |
예시
본 예시에서 Adjust는 fine-grained 전환값, coarse-grained 전환값, SKAdNetwork 포스트백이 전환값 종료 전에 전송되도록 설정되었는지 여부를 로그합니다.
func adjustConversionValueUpdated(_ fineValue: NSNumber?, coarseValue: String?, lockWindow: NSNumber?) { print("Fine conversion value: \(fineValue ?? 0)") print("Coarse conversion value: \(coarseValue ?? "")") print("Will send before conversion value window ends: \(lockWindow?.boolValue ?? nil)")}- (void)adjustConversionValueUpdated:(NSNumber *)fineValue coarseValue:(NSString *)coarseValue lockWindow:(NSNumber *)lockWindow { NSLog(@"Fine conversion value: %@", fineValue); NSLog(@"Coarse conversion value: %@", coarseValue); NSLog(@"Will send before conversion value window ends: %u", [lockWindow boolValue]);}다이렉트 설치 포스트백(direct install postback) 설정하기
다이렉트 설치 포스트백은 SKAdNetwork 정보만 포함합니다. 캠페인 데이터와 같은 정보는 다이렉트 설치 포스트백에 포함되지 않습니다.
Adjust에 SKAdNetwork 콜백의 사본을 전송하도록 앱을 구성하면, 고객님의 애널리틱스에서 SKAdNetwork 정보를 사용하실 수 있습니다.
다이렉트 설치 포스트백 설정을 위해, 귀하의 Info.plist 파일에 Adjust 콜백 URL을 추가해야 합니다.
- Xcode의 프로젝트 네비게이터(Project navigator)에서 Info.plist 를 선택하세요.
- 속성 리스트 에디터의 키 옆에 있는 추가 버튼(+)을 선택한 후,
Return을 누르세요. NSAdvertisingAttributionReportEndpoint를 키 이름으로 입력하세요.- 팝업 메뉴의 Type 을 String 으로 설정하세요.
https://adjust-skadnetwork.com주소를 입력하세요.
자세한 정보는 Apple의 Configuring an Advertised App 설명서를 참조하시기 바랍니다.