웹앱 연동

📘

웹앱에 대해서는 문서를 참고해주세요.

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

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

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

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

🚧

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

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

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

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

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

웹뷰에서 발생하는 자동 수집 이벤트 연동

웹뷰 내 웹사이트에서 발생하는 $page_view와 $engagement는 비활성화 상태입니다.
웹뷰 브릿지를 설정할 때 HackleWebViewConfig를 설정하여 자동 수집 이벤트를 각각 활성화할 수 있습니다.

let webViewConfig = HackleWebViewConfigBuilder()
	.automaticScreenTracking(true)
	.automaticEngagementTracking(true)
	.build()

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

설정 옵션