SDK 마이그레이션 가이드 - iOS SDK

import Airbridge
...
let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_SDK_TOKEN")
    .setLogLevel(.warning)
    .setSessionTimeout(second: 300)
    .build()
Airbridge.initializeSDK(option: option)

#import <Airbridge/Airbridge.h>
...
AirbridgeOptionBuilder* optionBuilder = [[AirbridgeOptionBuilder alloc] initWithName:@"YOUR_APP_NAME"
                                                                               token:@"YOUR_APP_SDK_TOKEN"];
[optionBuilder setLogLevel:AirbridgeLogLevelWarning];
[optionBuilder setSessionTimeoutWithSecond:300];
AirbridgeOption* option = [optionBuilder build];
[Airbridge initializeSDKWithOption:option];

import UIKit
import Airbridge

class SceneDelegate: UIResponder, UIWindowSceneDelegate {
    var window: UIWindow?

    // when terminated app is opened with scheme deeplink or universal links
    func scene(
        _ scene: UIScene,
        willConnectTo session: UISceneSession,
        options connectionOptions: UIScene.ConnectionOptions
    ) {
        // when app is opened with scheme deeplink
        if let url = connectionOptions.urlContexts.first?.url {
            // track deeplink
            Airbridge.trackDeeplink(url: url)

            // handle airbridge deeplink
            var isHandled = Airbridge.handleDeeplink(url: url) { url in
                DeeplinkHandler.handleSchemeDeeplink(url: url)
            }
            if isHandled { return }

            // handle scheme deeplink
            isHandled = DeeplinkHandler.handleSchemeDeeplink(url: url)
            if isHandled { return }

            // handle other deeplink
            isHandled = DeeplinkHandler.handleOtherDeeplink(url: url)
        }
        // when app is opened with universal links
        else if let userActivity = connectionOptions.userActivities.first {
            // track deeplink
            Airbridge.trackDeeplink(userActivity: userActivity)

            // handle airbridge deeplink
            var isHandled = Airbridge.handleDeeplink(userActivity: userActivity) { url in
                DeeplinkHandler.handleSchemeDeeplink(url: url)
            }
            if isHandled { return }

            // handle other deeplink
            if let url = userActivity.webpageURL {
                isHandled = DeeplinkHandler.handleOtherDeeplink(url: url)
            }
        }
    }

    // when backgrounded app is opened with scheme deeplink
    func scene(
        _ scene: UIScene,
        openURLContexts URLContexts: Set<UIOpenURLContext>
    ) {
        guard let url = URLContexts.first?.url else { return }

        // track deeplink
        Airbridge.trackDeeplink(url: url)

        // handle airbridge deeplink
        var isHandled = Airbridge.handleDeeplink(url: url) { url in
            DeeplinkHandler.handleSchemeDeeplink(url: url)
        }
        if isHandled { return }

        // handle scheme deeplink
        isHandled = DeeplinkHandler.handleSchemeDeeplink(url: url)
        if isHandled { return }

        // handle other deeplink
        isHandled = DeeplinkHandler.handleOtherDeeplink(url: url)
    }

    // when backgrounded app is opened with universal links
    func scene(
        _ scene: UIScene,
        continue userActivity: NSUserActivity
    ) {
        // track deeplink
        Airbridge.trackDeeplink(userActivity: userActivity)

        // handle airbridge deeplink
        var isHandled = Airbridge.handleDeeplink(userActivity: userActivity) { url in
            DeeplinkHandler.handleSchemeDeeplink(url: url)
        }
        if isHandled { return }

        // handle other deeplink
        if let url = userActivity.webpageURL {
            isHandled = DeeplinkHandler.handleOtherDeeplink(url: url)
        }
    }
}

import UIKit
import Airbridge

@main
class AppDelegate: UIResponder, UIApplicationDelegate {   
    var window: UIWindow?

    // when app is opened with scheme deeplink
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        // track deeplink
        Airbridge.trackDeeplink(url: url)

        // handle airbridge deeplink
        var isHandled = Airbridge.handleDeeplink(url: url) { url in
            DeeplinkHandler.handleSchemeDeeplink(url: url)
        }
        if isHandled { return isHandled }

        // handle scheme deeplink
        isHandled = DeeplinkHandler.handleSchemeDeeplink(url: url)
        if isHandled { return isHandled }

        // handle other deeplink
        isHandled = DeeplinkHandler.handleOtherDeeplink(url: url)

        return isHandled
    }

    // when app is opened with universal links
    func application(
        _ application: UIApplication,
        continue userActivity: NSUserActivity,
        restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
    ) -> Bool {
        // track deeplink
        Airbridge.trackDeeplink(userActivity: userActivity)

        // handle airbridge deeplink
        var isHandled = Airbridge.handleDeeplink(userActivity: userActivity) { url in
            DeeplinkHandler.handleSchemeDeeplink(url: url)
        }
        if isHandled { return isHandled }

        // handle other deeplink
        if let url = userActivity.webpageURL {
            isHandled = DeeplinkHandler.handleOtherDeeplink(url: url)
        }

        return isHandled
    }
}

import SwiftUI
import Airbridge

@main
struct ActualApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                // when app is opened with scheme deeplink or universal links
                .onOpenURL { url in
                    // track deeplink
                    Airbridge.trackDeeplink(url: url)

                    // handle airbridge deeplink
                    var isHandled = Airbridge.handleDeeplink(url: url) { url in
                        DeeplinkHandler.handleSchemeDeeplink(url: url)
                    }
                    if isHandled { return }

                    // handle scheme deeplink
                    isHandled = DeeplinkHandler.handleSchemeDeeplink(url: url)
                    if isHandled { return }

                    // handle other deeplink
                    isHandled = DeeplinkHandler.handleOtherDeeplink(url: url)
                }
        }
    }
}

#import "SceneDelegate.h"
#import "ABDeeplinkHandler.h"
#import <Airbridge/Airbridge.h>

@interface SceneDelegate ()

@end

@implementation SceneDelegate

// when terminated app is opened with scheme deeplink or universal links
- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {
    // when app is opened with scheme deeplink
    NSURL* url = connectionOptions.URLContexts.allObjects.firstObject.URL;
    NSUserActivity* userActivity = connectionOptions.userActivities.allObjects.firstObject;
    if (url != nil) {
        // track deeplink
        [Airbridge trackDeeplinkWithUrl:url];

        // handle airbridge deeplink
        BOOL isHandled = [Airbridge handleDeeplinkWithUrl:url onSuccess:^(NSURL* url) {
            [ABDeeplinkHandler handleSchemeDeeplink:url];
        }];
        if (isHandled) { return; }

        // handle scheme deeplink
        isHandled = [ABDeeplinkHandler handleSchemeDeeplink:url];
        if (isHandled) { return; }

        // handle other deeplink
        isHandled = [ABDeeplinkHandler handleSchemeDeeplink:url];
    }
    else if (userActivity != nil) {
        // track deeplink
        [Airbridge trackDeeplinkWithUserActivity:userActivity];

        // handle airbridge deeplink
        BOOL isHandled = [Airbridge handleDeeplinkWithUserActivity:userActivity onSuccess:^(NSURL* url) {
            [ABDeeplinkHandler handleSchemeDeeplink:url];
        }];
        if (isHandled) { return; }

        // handle other deeplink
        NSURL* url = userActivity.webpageURL;
        if (url != nil) {
            isHandled = [ABDeeplinkHandler handleOtherDeeplink:url];
        }
    }
}

// when backgrounded app is opened with scheme deeplink
- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
    NSURL* url = URLContexts.allObjects.firstObject.URL;
    if (url == nil) { return; }

    // track deeplink
    [Airbridge trackDeeplinkWithUrl:url];

    // handle airbridge deeplink
    BOOL isHandled = [Airbridge handleDeeplinkWithUrl:url onSuccess:^(NSURL* url) {
        [ABDeeplinkHandler handleSchemeDeeplink:url];
    }];
    if (isHandled) { return; }

    // handle scheme deeplink
    isHandled = [ABDeeplinkHandler handleSchemeDeeplink:url];
    if (isHandled) { return; }

    // handle other deeplink
    isHandled = [ABDeeplinkHandler handleSchemeDeeplink:url];
}

// when backgrounded app is opened with universal links
- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity {
    // track deeplink
    [Airbridge trackDeeplinkWithUserActivity:userActivity];

    // handle airbridge deeplink
    BOOL isHandled = [Airbridge handleDeeplinkWithUserActivity:userActivity onSuccess:^(NSURL* url) {
        [ABDeeplinkHandler handleSchemeDeeplink:url];
    }];
    if (isHandled) { return; }

    // handle other deeplink
    NSURL* url = userActivity.webpageURL;
    if (url != nil) {
        isHandled = [ABDeeplinkHandler handleOtherDeeplink:url];
    }
}

@end

#import "AppDelegate.h"
#import "ABDeeplinkHandler.h"
#import <Airbridge/Airbridge.h>

@interface AppDelegate ()

@end

@implementation AppDelegate

// when app is opened with scheme deeplink
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    // track deeplink
    [Airbridge trackDeeplinkWithUrl:url];

    // handle airbridge deeplink
    BOOL isHandled = [Airbridge handleDeeplinkWithUrl:url onSuccess:^(NSURL* url) {
        [ABDeeplinkHandler handleSchemeDeeplink:url];
    }];
    if (isHandled) { return isHandled; }
    
    // handle scheme deeplink
    isHandled = [ABDeeplinkHandler handleSchemeDeeplink:url];
    if (isHandled) { return isHandled; }
    
    // handle other deeplink
    isHandled = [ABDeeplinkHandler handleOtherDeeplink:url];
    
    return isHandled;
}

// when app is opened with universal links
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
    // track deeplink
    [Airbridge trackDeeplinkWithUserActivity:userActivity];

    // handle airbridge deeplink
    BOOL isHandled = [Airbridge handleDeeplinkWithUserActivity:userActivity onSuccess:^(NSURL* url) {
        [ABDeeplinkHandler handleSchemeDeeplink:url];
    }];
    if (isHandled) { return isHandled; }
    
    // handle other deeplink
    NSURL* url = userActivity.webpageURL;
    if (url != nil) {
        isHandled = [ABDeeplinkHandler handleOtherDeeplink:url];
    }
    
    return isHandled;
}

@end

import Airbridge
...
let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_SDK_TOKEN")
    .build()
Airbridge.initializeSDK(option: option)
...
let isHandled = Airbridge.handleDeferredDeeplink() { url in
    if let url {
        DeeplinkHandler.handleSchemeDeeplink(url)
    }
}

#import <Airbridge/Airbridge.h>
...
AirbridgeOptionBuilder* optionBuilder = [[AirbridgeOptionBuilder alloc] initWithName:@"YOUR_APP_NAME"
                                                                               token:@"YOUR_APP_SDK_TOKEN"];
AirbridgeOption* option = [optionBuilder build];
[Airbridge initializeSDKWithOption:option];
...
[Airbridge handleDeferredDeeplinkOnSuccess:^(NSURL* url) {
    if (url != nil) {
        [ABDeeplinkHandler handleSchemeDeeplink:url];
    }
}];

import Airbridge
...
// setCategory
Airbridge.trackEvent(
    category: AirbridgeCategory.ORDER_COMPLETED,
    semanticAttributes: [
        // setAction
        AirbridgeAttribute.ACTION: "Tool",
        // setLabel
        AirbridgeAttribute.LABEL: "Hammer",
        // setValue
        AirbridgeAttribute.VALUE: 10,
        // setSemantics (using ABSemanticsKey)
        AirbridgeAttribute.CURRENCY: "USD",
        AirbridgeAttribute.PRODUCTS: [
            [
                // setSemantics value (using ABProductKey)
                AirbridgeAttribute.PRODUCT_ID: "12345",
                // setSemantics value (using String)
                "name": "PlasticHammer",
            ],
        ],
        // setSemantics (using String)
        "totalQuantity": 1,
    ],
    customAttributes: [
        // setCustoms
        "promotion": "FirstPurchasePromotion",
    ]
)

#import <Airbridge/Airbridge.h>
...
[Airbridge trackEventWithCategory:@"event" semanticAttributes:@{
    // action
    AirbridgeAttribute.ACTION: @"Tool",
    // label
    AirbridgeAttribute.LABEL: @"Hammer",
    // value
    AirbridgeAttribute.VALUE: @(10),
    // semantic attribute (provided by sdk)
    AirbridgeAttribute.CURRENCY: @"USD",
    AirbridgeAttribute.PRODUCTS: @[
        @{
            // semantic attribute value (provided by sdk)
            AirbridgeAttribute.PRODUCT_ID: @"12345",
            // semantic attribute value (not provided by sdk)
            @"name": @"PlasticHammer",
        },
    ],
    // semantic attribute (not provided by sdk)
    @"totalQuantity": @(1),
}, customAttributes:@{
    // custom attribute
    @"promotion": @"FirstPurchasePromotion",
}];