iOS SDK 설치 가이드

use_frameworks!

target 'YourApp' do
  pod 'IMQACore'
end

pod install

https://github.com/idlerecord/imqa-ios-sdk-spm

@objc(IMQAOptions) public final class Options: NSObject {

    /// 앱 키 (IMQA 콘솔에서 발급)
    public let serviceKey: String

    /// 데이터를 전송할 Collector 주소
    public let endpoints: IMQA.Endpoints?

    /// 데이터 수집 비율 (0.0 ~ 1.0)
    /// 0.0: 수집 안 함 / 1.0: 100% 수집 (기본값: 1.0)
    public var sampleRate: Double

    /// 기기 ID(UUID)를 Collector로 전송할지 여부
    /// 기기 ID는 UUID를 생성하여 Keychain에 저장한 값입니다.
    public var isDeviceIdEnable: Bool

    /// 서비스 공간 식별자 (콘솔에서 확인)
    public var namespace: String?

    /// API 응답값으로 SDK 수집 여부를 제어합니다.
    public var sdkCollectControl: IMQA.SDKCollectControl?

    /// 사용자 터치(클릭) 자동 수집 여부
    public var tapOption: IMQA.TapOption?

    /// HTTP 요청의 Header 및 Body 수집 여부
    /// 설정하지 않으면 XHR은 수집하되 Header와 Body는 수집하지 않습니다.
    public var xhrOption: IMQA.XHROption?

    /// WebView 세션 데이터 출처 설정
    /// true: Native가 전송한 데이터 사용 (기본값)
    /// false: WebView 자체에서 생성한 데이터 사용
    /// ※ Native 앱에서는 별도 설정이 필요 없습니다.
    public var webviewOption: IMQA.WebviewOption?

    /// 배포 환경 구분
    /// 운영 환경과 테스트 환경이 동일 서버를 사용하는 경우에만 설정합니다.
    public var deployEnvironment: IMQADeployEnvironment
}

let tapOption = IMQA.TapOption(
    isAutoCapture:             Bool,
    isAutoCaputrueButtonTitle: Bool,
    isAutoCaputrueButtonId:    Bool
)

button.imqa_ignore = true

// 자동 수집 활성화, Title 수집 비활성화, ID 수집 활성화
let tapOption = IMQA.TapOption(
    isAutoCapture:             true,
    isAutoCaputrueButtonTitle: true,
    isAutoCaputrueButtonId:    true
)

let xhrOption = IMQA.XHROption(
    isCaptureHttpRequestHeader: Bool,
    isCaptureHttpRequestBody:   Bool
)

// Header, Body 모두 수집
let xhrOption = IMQA.XHROption(
    isCaptureHttpRequestHeader: true,
    isCaptureHttpRequestBody:   true
)

// Header만 수집
let xhrOption = IMQA.XHROption(
    isCaptureHttpRequestHeader: true,
    isCaptureHttpRequestBody:   false
)

let webOption = IMQA.WebviewOption(
    isSharedSession: Bool,
    isNeedWebAgent:  Bool
)

// 하이브리드 앱 — 세션 통합, WebAgent 자동 주입
let webOption = IMQA.WebviewOption(
    isSharedSession: true,
    isNeedWebAgent:  true
)

// WebAgent를 별도로 로드하는 경우 — 중복 주입 방지
let webOption = IMQA.WebviewOption(
    isSharedSession: true,
    isNeedWebAgent:  false
)

extension IMQA {

    /// SDK 초기화
    @discardableResult
    @objc public static func setup(options: IMQA.Options,
                                   isDebug: Bool = false) -> IMQA?

    /// SDK 시작
    @objc public func start()

    /// 사용자 ID 설정
    @objc public static func setUserId(id: String?)

    /// 현재 설정된 사용자 ID 반환
    @objc public static func getUserId() -> String?

    /// 커스텀 로그 전송
    @objc public static func customLog(level: IMQA.LogLevel, message: String)

    /// Span에 커스텀 속성 추가
    /// SDK start() 이전에 설정하면 이후 생성되는 모든 Span에 자동 포함됩니다.
    @objc public static func setAttribute(key: String, value: String?)

    /// Keychain에 저장된 기기 UUID 반환
    @objc public static func getDeviceId() -> String

    /// xib 방식으로 WebView를 초기화한 경우, 스크립트를 수동으로 주입합니다.
    @objc public static func setWebviewConfiguration(
        userContentController: WKUserContentController)
}

import UIKit
import IMQACore

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        setupIMQASDK()
        return true
    }

    func setupIMQASDK() {
        let endpoint   = IMQA.Endpoints(collectorURL: "Collector 주소")
        let serviceKey = "서비스 키"

        // SDK 수집 여부를 API 응답으로 제어
        let sdkControl = IMQA.SDKCollectControl(remoteCollectionControlEnable: true)

        // HTTP 요청 Header, Body 수집
        let xhrOption  = IMQA.XHROption(
            isCaptureHttpRequestHeader: true,
            isCaptureHttpRequestBody:   true)

        // Native 세션 공유 (기본값: true)
        let webOption  = IMQA.WebviewOption(isSharedSession: true)

        // 터치 자동 수집, Title 비활성화, ID 활성화
        let tapOption  = IMQA.TapOption(
            isAutoCapture:             true,
            isAutoCaputrueButtonTitle: ture,
            isAutoCaputrueButtonId:    true)

        let option = IMQA.Options(
            namespace:         "namespace",
            serviceKey:        serviceKey,
            endpoints:         endpoint,
            deployEnvironment: .production,
            sampleRate:        1.0,
            isDeviceIdEnable:  true,
            sdkCollectControl: sdkControl,
            tapOption:         tapOption,
            xhrOption:         xhrOption,
            webviewOption:     webOption)

        // isDebug: true → 콘솔 로그 출력 활성화
        IMQA.setup(options: option, isDebug: true)?.start()
    }
}

func setupIMQASDK() {
    // Collector URL: 사용자가 선택한 IP를 우선 사용하고, 없으면 기본값으로 폴백
    let endpoint = IMQA.Endpoints(
        collectorURL: "collector 주소"
    )

    // API 응답으로 SDK 수집 여부 원격 제어
    let sdkControl = IMQA.SDKCollectControl(
        remoteCollectionControlEnable: true
    )

    // HTTP 요청의 Header 및 Body 수집 활성화
    let xhrOption = IMQA.XHROption(
        isCaptureHttpRequestHeader: true,
        isCaptureHttpRequestBody:   true
    )

    // Native 세션 공유, WebAgent 스크립트 중복 주입 방지
    let webOption = IMQA.WebviewOption(
        isSharedSession: true,
        isNeedWebAgent:  false
    )

    // 탭 이벤트 자동 수집 (Title 수집 비활성화, ID 수집 활성화)
    let tapOption = IMQA.TapOption(
        isAutoCapture:             true,
        isAutoCaputrueButtonTitle: true,
        isAutoCaputrueButtonId:    true
    )

    let option = IMQA.Options(
        namespace:         "namespace",
        serviceKey:        serviceKey,
        endpoints:         endpoint,
        deployEnvironment: .development,
        sampleRate:        1,
        isDeviceIdEnable:  true,
        sdkCollectControl: sdkControl,
        tapOption:         tapOption,
        xhrOption:         xhrOption,
        webviewOption:     webOption
    )

    // isDebug: true → 콘솔 로그 출력 활성화
    IMQA.setup(options: option, isDebug: true)?.start()
}

#import "AppDelegate.h"
#import <IMQACore/IMQACore-Swift.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [self setupIMQASDK];
    return YES;
}

- (void)setupIMQASDK {
    IMQAEndpoints *endpoint =
        [[IMQAEndpoints alloc] initWithCollectorURL:@"Collector 주소"];
    NSString *serviceKey = @"서비스 키";

    IMQASDKCollectControl *sdkControl =
        [[IMQASDKCollectControl alloc] initWithRemoteCollectionControlEnable:YES];

    IMQAXHROption *xhrOption =
        [[IMQAXHROption alloc] initWithIsCaptureHttpRequestHeader:YES
                               isCaptureHttpRequestBody:YES];

    IMQAWebviewOption *webOption =
        [[IMQAWebviewOption alloc] initWithIsSharedSession:YES];

    IMQATapOption *tapOption =
        [[IMQATapOption alloc] initWithIsAutoCapture:YES];

    IMQAOptions *option = [[IMQAOptions alloc]
        initWithNamespace:         @"namespace"
        serviceKey:                serviceKey
        endpoints:                 endpoint
        deployEnvironment:         IMQADeployEnvironmentProduction
        sampleRate:                1.0
        isDeviceIdEnable:          YES
        sdkCollectControl:         sdkControl
        tapOption:                 tapOption
        xhrOption:                 xhrOption
        webviewOption:             webOption];

    [[IMQA setupWithOptions:option isDebug:YES] start];
}

@end

IMQA.setSharedSession(session: Bool)

let config = WKWebViewConfiguration()
let view   = WKWebView(frame: .zero, configuration: config)

let request = URLRequest(url: URL(string: "https://example.com/")!)

IMQA.setWebviewConfiguration(
    userContentController: wkWebView.configuration.userContentController
)
wkWebView.load(request)

// WebViewVC에서 Bridge 초기화 시 WebView 인스턴스를 전달합니다.
self.bridge = IMQASDKBridge(webView: wkWebView)

// WebViewVC가 pop 또는 disappear될 때 반드시 연결을 해제합니다.
IMQASDKBridge.removeScriptMessageHandler()

import Foundation
@objc class SwiftRuntimeLoader: NSObject {}

import IMQACore

func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
    if let windowScene = scene as? UIWindowScene {
        let window = UIWindow(windowScene: windowScene)
        window.rootViewController = UIHostingController(
            rootView: LandmarkList()
                .imqaTrackLifecycle(viewName: nil)
                .environmentObject(UserData()))
        self.window = window
        window.makeKeyAndVisible()
    }
}