웹앱 연동

📘
지원 SDK 버전
iOS SDK 2.27.0 이상 버전에서 지원하는 기능입니다.
JavaScript SDK 11.24.1 이상 버전에서 지원하는 기능입니다.

WKWebView 를 통해 자사 웹사이트를 랜더링하는 경우, 다음 같은 설정을 통해 웹사이트에 포함된 핵클 JavaScirpt SDK를 웹사이트 코드 변경없이 핵클 iOS SDK 기능과 동일하게 사용할 수 있습니다.

이 경우 모든 핵클 이벤트는 iOS SDK를 통해 수집됩니다

...
self.webView = ...
HackleApp *hackleApp = [Hackle app];
[hackleApp setWebViewBridge:self.webView :NULL];
...

...
Hackle.app().setWebViewBridge(webView)
...

🚧
핵클 iOS 웹뷰 설정은 iOS UI Delegate 및 WKUserScript 등을 이용하여 핵클 JavaScript SDK와 상호작용하게 됩니다. 반드시 WKWebView::load 함수 호출 이전에 해당 설정이 완료될 수 있도록 코드를 위치시켜 주세요.

🚧
해당 기능을 사용하기 위해서는 JavaScript 웹페이지에서 동일한 App SDK 키를 사용해야 합니다.

이미 사용하고 있는 UI Delegate가 있는 경우 다음과 같이 사용하고 있는 UI Delegate와 함께 해당 함수로 전달해 주세요.

...
self.webView = ...
self.myUIDelegate = ...
HackleApp *hackleApp = [Hackle app];
[hackleApp setWebViewBridge:self.webView :self.myUIDelegate];
...

...
Hackle.app().setWebViewBridge(webView, myUiDelegate)
...

(Optional) Webview Wrapper App 연동

만약 핵클 이벤트를 iOS SDK가 아닌 JavaScript SDK를 통해 수집하고 싶다면 핵클 SDK를 초기화 할 때 HackleAppMode를 web_view_wrapper로 설정하면 됩니다

let config = HackleConfigBuilder()
  .mode(.web_view_wrapper)
  .build()

Hackle.initialize(sdkKey: YOUR_APP_SDK_KEY, config: config) {
    // SDK ready to use.
}

HackleConfigBuilder *builder = [[HackleConfigBuilder alloc] init];
[builder mode:HackleAppMode.web_view_wrapper];
HackleConfig *config = [builder build];

[Hackle initializeWithSdkKey:@"YOUR_APP_SDK_KEY" config:config completion:^{
    // SDK ready to use.
}];

Updated about 2 months ago

📘지원 SDK 버전

🚧

🚧

(Optional) Webview Wrapper App 연동

📘
지원 SDK 버전