iOS 연동

이 페이지에서는 iOS SDK의 Push Notification 설치 및 연동 방법을 가이드합니다.

사전 작업

iOS Push Notification을 설정하려면 iOS SDK 연동이 필요합니다. 다음 가이드를 완료 후 진행해주세요.

iOS SDK

1. Xcode 설정

Xcode에서 설정이 필요합니다. 이미 사용중인 설정은 스킵해주세요.

1.1 Push Notifications 추가

Xcode의 Target > Signing & Capabilities 에서 Push Notification 을 추가합니다.

1.2 Notification Service Extension 추가

Xcode의 File > New > Target 에서 Notification Service Extension을 추가합니다.

적절한 이름을 입력, Embed in Application 에서 앱 타겟이 선택되어 있는지 확인해준 후 계속 진행합니다. 이 가이드에서는 DummyNotificationServiceExtension 으로 추가하겠습니다.

Activate 까지 완료해줍니다.

2. SDK 추가하기

CocoaPods와 SPM을 지원합니다.

2.1 CocoaPods

Podfile에 다음과 같이 추가하고 pod insall 해주세요.

use_frameworks!

# 1.2 에서 추가한 NotificationServiceExtension 타겟 이름을 넣어주세요.
target 'DummyNotificationServiceExtension' do
  pod 'MarketapSDKNotificationServiceExtension', '~> 1.0.9'
end

2.2 SPM (Swift Package Manager)

iOS SDK 에서 MarketapSDK 패키지를 추가했다면 MarketapNotificationServiceExtension 가 함께 설치되어 있습니다. 1.2 Notification Service Extension 추가 에서 설정한 NotificationServiceExtension 타겟에 추가해줍니다.

3. 연동 코드 작성하기

3.1 UNUserNotificationCenterDelegate 설정

앱 푸시 설정을 위해 UNUserNotificationCenterDelegate 를 추가하고 SDK 와 연동해줍니다. 이미 사용중인 UNUserNotificationCenterDelegate 가 있다면 동일하게 사용 가능합니다.

예시에서는 AppDelegate에 UNUserNotificationCenterDelegate를 채택하고 사용하겠습니다.

Swift

import MarketapSDK

class AppDelegate: NSObject, UIApplicationDelegate, UNUserNotificationCenterDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {    
        // ...
        Marketap.initialize(projectId: "PROJECT_ID")
        Marketap.application(application, didFinishLaunchingWithOptions: launchOptions)

        // delegate 추가
        UNUserNotificationCenter.current().delegate = self
        // ...
        return true
    }

    func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        // ...
        // 푸시 토큰 등록
        Marketap.setPushToken(token: deviceToken)
    }

    func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
        // ...
        // 마켓탭이 푸시를 처리했으면 리턴 (마켓탭 콘솔에서 전송했을 경우)
        if Marketap.userNotificationCenter(center, willPresent: notification, withCompletionHandler: completionHandler) {
            return
        }
        // 마켓탭이 처리하지 않았으면 이어서 진행
        // ...
    }

    func userNotificationCenter(
        _ center: UNUserNotificationCenter,
        didReceive response: UNNotificationResponse,
        withCompletionHandler completionHandler: @escaping () -> Void
    ) {
        // ...
        // 마켓탭이 푸시 클릭을 처리했으면 리턴 (마켓탭 콘솔에서 전송했을 경우)
        if Marketap.userNotificationCenter(center, didReceive: response, withCompletionHandler: completionHandler) {
            return
        }
        // 마켓탭이 처리하지 않았으면 이어서 진행
        // ...
    }
}

Objective-C

3.2 앱 푸시 수신 설정 (선택)

푸시 알림을 발송하려면 사용자에게 수신 동의를 받아야 합니다. 관련 권한을 앱에서 직접 관리하거나 MarketapSDK 가 지원하는 함수를 사용할 수 있습니다. 다음은 예시 코드입니다.

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // ...
    Marketap.initialize(projectId: "PROJECT_ID")
    Marketap.application(application, didFinishLaunchingWithOptions: launchOptions)

    // 권한 요청 및 등록
    Marketap.requestAuthorizationForPushNotifications()
    // ...
    return true
}

Objective-C

3.3 Notification Service Extension 연동하기

이 섹션의 연동을 진행하지 않을 경우 이미지 누락, 임프레션 집계 오류 등 마켓탭 푸시가 정상 동작하지 않을 수 있습니다. 필수로 연동해주세요.

1.2 Notification Service Extension 추가 에서 추가한 Notification Service Extension의 NotificationService에 다음과 같이 추가해줍니다.

Swift

import UIKit
import MarketapSDKNotificationServiceExtension

class NotificationService: UNNotificationServiceExtension {
    var contentHandler: ((UNNotificationContent) -> Void)?
    var bestAttemptContent: UNMutableNotificationContent?

    override func didReceive(
        _ request: UNNotificationRequest,
        withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
    ) {
        // 마켓탭이 푸시를 처리했으면 리턴 (마켓탭 콘솔에서 전송했을 경우)
        if MarketapNotificationService.didReceive(request, withContentHandler: contentHandler) {
            return
        }
        // 마켓탭이 처리하지 않았으면 이어서 진행
        // ...
    }

    override func serviceExtensionTimeWillExpire() {
        // 마켓탭이 처리했으면 리턴 (마켓탭 콘솔에서 전송했을 경우)
        if MarketapNotificationService.serviceExtensionTimeWillExpire() {
            return
        }
        // 마켓탭이 처리하지 않았으면 이어서 진행
        // ...
    }
}

Objective-C

4. 클릭 액션 커스텀하기 (선택)

푸시 캠페인에 클릭 액션 URL이 설정되어 있는 경우, 마켓탭 SDK는 기본 동작으로 UIApplication.shared.open을 호출하여 해당 URL을 실행합니다.

실행된 URL은 앱의 딥링크 처리 루트(예: application(_:open:options:) 또는 SceneDelegate의 scene(_:openURLContexts:))에서 수신하여 처리할 수 있습니다.

이 기본 동작을 비활성화하고 클릭 시 액션을 직접 제어하려면, 아래 페이지 안내에 따라 clickHandler 기반 커스텀 연동을 진행해주세요.

커스텀 클릭 핸들러

5. 이어서 진행하기

이제 Push Notification 연동이 완료되었습니다. 아래 문서에서 이어서 진행해주세요.

Push Notification 테스트

In-App Campaign 테스트

심화 연동