인앱 이벤트 설정

유저는 앱을 사용하면서 다양한 행동을 하게 되는데 이런 행동들을 인앱 이벤트라고 부릅니다. 이렇게 유저에 의해 발생한 인앱 이벤트를 측정하기 위해서 인앱 이벤트 API를 앱에 적용할 필요가 있습니다. 다음 사항을 참고하여 API를 적용해 주시기 바랍니다.

인앱 이벤트 명칭

• 인앱 이벤트의 명칭을 수집하기 위해 event 라는 key를 사용합니다.

• 이 key의 value에 세팅되는 문자열이 해당 이벤트의 명칭이 됩니다.

• 아래 나오는 예시에서 w_로 시작하는 value는 변경하지 말고 그대로 사용해 주시기 바랍니다. w_는 와이즈트래커 시스템 기본값을 의미하는 prefix입니다.

인앱 이벤트 속성

• 속성이란 인앱 이벤트의 명칭을 제외하고 해당 이벤트와 연관된 다양한 정보들을 말합니다.

• 예를 들어 '구매' 이벤트가 발생했다면, 구매한 상품명, 수량, 가격 등의 정보가 속성이 됩니다.

• 속성 데이터의 측정은 필수가 아닙니다. 따라서 필요한 정보에 대해서만 선택적으로 측정하면 됩니다.

• 각 이벤트마다 권장하는 속성을 선택 속성 표에 정리해 놓았습니다. 표를 참고하여 필요한 속성을 추가해 주시기 바랍니다.

Hybrid App에 API를 적용해야 한다면

Hybrid App은 WebView로 불러온 HTML 페이지 안에 인앱 이벤트 API를 추가해야 하는 경우가 많습니다. HTML에서 호출한 API가 정상적인 기능을 수행하기 위해서는 아래 두가지 경우를 고려하여 API를 적용해야 합니다.

API를 웹 페이지 자체에 적용해야 하는 경우

API 코드 블록을 감싸는 script의 type과 id를 아래와 같이 지정해야 합니다. 이렇게 되면 API에 설정된 값은 웹 페이지가 로딩되는 시점에 SDK가 수집하여 실행합니다.

<script type="wisetracker/text" id="wiseTracker2">
    // API 코드 블록
</script>

회원가입, 상품 조회, 구매 등과 같이 '완료화면'이 존재하는 인앱 이벤트에 이 방법을 사용합니다.

function에 적용해야 하는 경우

버튼 클릭, 장바구니에 상품 추가 등의 이벤트는 일반적으로 해당 이벤트에 대한 '완료화면'이 존재하지 않으며 유저에 의해 불특정한 시점에 발생합니다. 이런 경우는 바로 위의 방법(화면 로딩 시점에 API를 적용)을 사용하지 않고, 클릭 또는 장바구니 등의 function내에 Hybrid용 API를 그대로 적용해줍니다.