iOS Adobe Extension v3 마이그레이션 가이드

Adobe Experience SDK용 Adjust 확장판이 v3로 업데이트되어 Adjust iOS SDK v5를 지원합니다. 이 가이드에 따라 v2에서 v3로 마이그레이션하시기 바랍니다.

Swift Package Manager를 사용하여 Adobe Experience용 Adjust iOS Extension v3를 설치하려면 다음 URL을 입력합니다.

1
https://github.com/adjust/ios_adobe_extension.git

CocoaPods를 사용하는 경우 Podfile 에 다음 라인을 추가합니다.

pod 'AdjustAdobeExtension'

Adobe Experience용 Adjust iOS Extension 설정 통합 가이드는 연동 가이드를 참조하시기 바랍니다.

새 API

v3에서 추가됨

다음 API가 v3에 추가되었습니다.

숏 브랜드 링크 해석

Adobe Experience SDK용 Adjust Extension v3는 숏 브랜드 링크 해석 지원이 추가되었습니다. 단축된 링크를 해석하려면 다음 인수로 Adjust.processAndResolveDeeplink 메서드를 호출합니다.

deeplink: NSURL: 앱을 연 딥링크
withCompletionHandler: ADJResolvedDeeplinkBlock: 해석된 단축 링크를 인수로 수신하는 완료 함수

Swift
Objective-C

1
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
2
    if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
3
        if let incomingUrl = userActivity.webpageUrl {
4
        if let deeplink = ADJDeeplink(deeplink: incomingUrl) {
5
            Adjust.processAndResolveDeeplink(deeplink) { resolveDeeplink in
6
                print("[\(resolveDeeplink)]")
7
            }
8
        }
9
        }
10
    }
11
    return true
12
}

1
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<uiuseractivityrestoring>> * _Nullable))restorationHandler {
2
    if ([[userActivity activityType] isEqualToString:NSUserActivityTypeBrowsingWeb]) {
3
        ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:[userActivity webpageURL]];
4
        [Adjust processAndResolveDeeplink:deeplink
5
                withCompletionHandler:^(NSString * _Nullable resolvedLink) {
6
                    NSLog(@"[%@]", resolvedLink);
7
        }];
8
    }
9
    return YES;
10
}

글로벌 콜백 파라미터

Adobe Experience SDK용 Adjust Extension v3는 iOS SDK v5의 글로벌 콜백 파라미터 API 지원이 추가되었습니다. 세션에 글로벌 콜백을 추가하려면 다음 인수로 Adjust.addGlobalCallbackParameter 메서드를 호출합니다.

key: NSString: 파라미터의 키
value: NSString: 파라미터의 값

Swift
Objective-C

1
Adjust.addGlobalCallbackParameter("value", forKey: "key")
2
Adjust.addGlobalCallbackParameter("855", forKey: "user_id")

1
[Adjust addGlobalCallbackParameter:@"value" forKey:@"key"];
2
[Adjust addGlobalCallbackParameter:@"855" forKey:@"user_id"];

글로벌 콜백 설정 방법을 알아보시기 바랍니다.

글로벌 파트너 파라미터

Adobe Experience SDK용 Adjust Extension v3는 iOS SDK v5의 글로벌 파트너 파라미터 API 지원이 추가되었습니다. 글로벌 파트너 파라미터를 추가하려면 다음 인수로 Adjust.addGlobalPartnerParameter 메서드를 호출합니다.

key: String: 파라미터의 키
value: String: 파라미터의 값

Swift
Objective-C

1
Adjust.addGlobalPartnerParameter("value", forKey: "key")
2
Adjust.addGlobalPartnerParameter("855", forKey: "user_id")

1
[Adjust addGlobalPartnerParameter:@"value" forKey:@"key"];
2
[Adjust addGlobalPartnerParameter:@"855" forKey:@"user_id"];

글로벌 파트너 파라미터 설정 방법을 알아보시기 바랍니다.

외부 기기 ID 전송

Adobe Experience SDK용 Adjust Extension v3는 외부 기기 식별자 설정 지원이 추가되었습니다. 외부 기기 ID를 설정하려면 다음 인수로 AdjustAdobeExtensionConfig 인스턴스의 setExternalDeviceId 메서드를 호출합니다.

externalDeviceId: NSString: 외부 기기 식별자

Swift
Objective-C

1
if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
2
   config.setExternalDeviceId("1a42b171-faa5-46da-b5ae-6f4be6d05167")
3
   AdjustAdobeExtension.setConfiguration(config)
4
}

1
AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
2
[config setExternalDeviceId:@"1a42b171-faa5-46da-b5ae-6f4be6d05167"];
3
[AdjustAdobeExtension setConfiguration:config];

외부 기기 ID 설정 방법을 알아보시기 바랍니다.

사전 설치 앱에 대한 기본 링크 토큰 설정

Adobe Experience SDK용 Adjust Extension v3는 기본 캠페인에 사전 설치 앱의 설치를 기혹하기 위한 기본 링크 토큰 설정 지원이 추가되었습니다. 기본 링크 토큰을 설정하려면 다음 인수로 AdjustAdobeExtensionConfig 인스턴스의 setDefaultTracker 메서드를 호출합니다.

defaultTracker: NSString: 사전 설치 캠페인의 영숫자 링크 토큰

Swift
Objective-C

1
if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
2
   config.setDefaultTracker("abc123")
3
   AdjustAdobeExtension.setConfiguration(config)
4
}

1
AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
2
[config setDefaultTracker:@"abc123"];
3
[AdjustAdobeExtension setConfiguration:config];

사전 설치된 앱 활동 전송 방법을 알아보시기 바랍니다.

변경된 API

v3에서 변경됨

다음 API가 v3에서 변경되었습니다.

다이렉트 딥링크

SDK v2에서는 딥링크 데이터를 인수로 AdjustAdobeExtension.application 메서드를 호출하여 어트리뷰션에 대한 딥링크를 열 수 있습니다.

Swift
Objective-C

1
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
2
    return AdjustAdobeExtension.application(app, open: url, options: options)
3
}

1
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
2
    return [AdjustAdobeExtension application:app openURL:url options:options];
3
}

SDK v3가 Adjust iOS SDK의 processDeeplink 메서드를 사용하도록 업데이트되었습니다. 다이렉트 딥링크를 여는 방법은 다음과 같습니다.

딥링크 URL로 새로운 ADJDeeplink 인스턴스를 생성합니다.
ADJDeeplink 인스턴스를 Adjust.processDeeplink 메서드에 전달합니다.

Swift
Objective-C

1
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
2
   if let deeplink = ADJDeeplink(deeplink: url) {
3
      Adjust.processDeeplink(deeplink)
4
   }
5
   return true
6
}

1
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
2
   [Adjust processDeeplink: [[ADJDeeplink alloc] initWithDeeplink:url]];
3
   return YES;
4
}

다이렉트 딥링크를 사용하여 사용자 리어트리뷰션 방법을 알아보시기 바랍니다.

디퍼드 딥링크 콜백

SDK v2에서는 AdjustAdobeExtensionConfig 인스턴스의 setDeeplinkResponseBlock 메서드에 함수를 전달하여 디퍼드 딥링크가 열릴 때 콜백 함수를 실행하도록 SDK를 구성할 수 있습니다.

Swift
Objective-C

1
if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
2
    config.setDeeplinkResponseBlock { deepLink in
3
        // Deep link response received
4
        // Apply your logic to determine whether the Adjust SDK should try to open the deep link
5
        return true;
6
        // or
7
        // return false;
8
    }
9
    AdjustAdobeExtension.setConfiguration(config)
10
}

1
AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
2
[config setDeeplinkResponseBlock:^BOOL(NSURL * _Nullable deeplink) {
3
    // Deep link response received
4
    // Apply your logic to determine whether the Adjust SDK should try to open the deep link
5
    return YES;
6
    // or
7
    // return NO;
8
}];
9
[AdjustAdobeExtension setConfiguration:config];

SDK v3에서는 setDeeplinkResponseBlock 메서드의 이름이 setDeferredDeeplinkReceivedBlock으로 변경되었습니다.

Swift
Objective-C

1
if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
2
    config.setDeferredDeeplinkReceivedBlock { (deeplink: URL?) -> Bool in
3
        if let deeplinkString = deeplink?.absoluteString.lowercased(),
4
        deeplinkString.contains("no_open") {
5
            return false
6
        }
7
        return true
8
    }
9
    AdjustAdobeExtension.setConfiguration(config)
10
}

1
AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
2
[config setDeferredDeeplinkReceivedBlock:^BOOL(NSURL * _Nullable deeplink) {
3
    if (deeplink && [[deeplink.absoluteString lowercaseString] containsString:@"no_open"]) {
4
        return NO;
5
    }
6
    return YES;
7
}];
8
[AdjustAdobeExtension setConfiguration:config];

디퍼드 딥링크 콜백 처리 방법을 알아보시기 바랍니다.