웹앱 연동

Android SDK 2.29.0 이상, JavaScript SDK 11.24.1 이상 버전에서 지원하는 기능입니다.

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

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

브릿지 설정을 하면 웹뷰에서 발생하는 핵클 이벤트는 Android SDK를 통해 수집됩니다.

웹뷰 브릿지는 Hackle JavaScript SDK에서 브릿지로 전달한 데이터만 Hackle Android SDK의 JavascriptInterface로 처리합니다.

Kotlin

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

Java

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

핵클 안드로이드 웹뷰 설정은 안드로이드 Javascript Interface를 통해 핵클 JavaScript SDK와 상호작용하게 됩니다. 반드시 WebView::loadUrl 함수 호출 이전에 해당 설정이 완료될 수 있도록 코드를 위치시켜 주세요.

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

Android SDK 2.62.0 이상, JavaScript SDK 11.51.0 이상 버전에서 지원하는 기능입니다.

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

Kotlin

val webViewConfig = HackleWebViewConfig
	.builder()
	.automaticScreenTracking(true)
	.automaticEngagementTracking(true)
	.build()
Hackle.app.setWebViewBridge(webView, webViewConfig)

Java

설정 옵션

Option	Default	Description
automaticScreenTracking	false	웹사이트에서 발생해는 $page_view 수집 여부
automaticEngagementTracking	false	웹사이트에서 발생하는 engagement 수집 여부
automaticRouteTracking	true	웹사이트에서 발생하는 페이지 정보 자동 수집 여부

웹페이지 이동 시 $page_view와 $engagement 를 자동 수집하려면 automaticScreenTracking, automaticEngagementTracking, automaticRouteTracking 를 모두 true로 설정하세요.

웹페이지 이동 시 $page_view와 $engagement 를 수동 수집하는 경우 automaticScreenTracking, automaticEngagementTracking는 true로 설정하고, automaticRouteTracking 를 false로 설정하세요.