사용자 여정과 전환 | Appbox Android SDK 가이드

Android SDK 연동

사용자 여정과 전환 개요

전제내용
필요 artifactappbox-core (+ trackConversion은 기능 artifact 1개 이상 추가 필요)
콘솔, 서버 전제여정 event key의 수집 대상 등록은 서버에서 관리합니다. 전환 코드는 콘솔에서 캠페인 생성 시 발급됩니다 (전환 이벤트 설정 가이드)
웹 브릿지 대응message.trackConversion

여정 데이터를 서비스 데이터와 연결하려면 기기 사용자 식별자 조회를 함께 사용합니다.

사용자 여정 이벤트 기록

서비스의 주요 사용자 행동을 기록합니다. 화면 진입, 상품 조회 같은 행동 시점에 호출합니다.

사용자 여정 이벤트 기록

AppBox.trackJourneyEvent(eventKey)

Kotlin
1 AppBox.trackJourneyEvent("product_view")
1 AppBox.trackJourneyEvent("product_view");

Request 항목 정의

Request 항목필수여부설명기본값
eventKey필수수집 대상으로 등록된 event key. 앞뒤 공백은 제거됩니다-

오류

반환값도 callback도 없어 결과를 알 수 없습니다. 전송 여부를 코드에서 확인할 수 없습니다.

수집 대상으로 등록되지 않은 key는 오류 없이 버려집니다. "호출했는데 콘솔에 보이지 않는" 경우의 가장 흔한 원인입니다. (등록은 서버에서 관리합니다)

  • app_first_open, session_start, session_end는 SDK가 자동 수집하는 예약 key입니다. 직접 전달하면 무시됩니다.
  • 빈 문자열은 무시되고, AppBox.initialize 전 호출도 무시됩니다.
  • 전송 성공을 확인해야 하는 업무 처리에는 사용하지 않습니다.

전환 기록

구매, 회원가입 등 전환이 완료된 시점을 기록합니다. 캠페인 성과를 측정할 전환 지점에서 호출합니다.

전환 기록

AppBox.trackConversion(conversionCode, value, callback)

Kotlin
1 AppBox.trackConversion("<CONVERSION_CODE>") { success, error ->
2 if (!success) Log.w("AppBox", error?.message ?: "전환 기록 실패")
3 }
4
5 // 금액 등 값을 함께 기록
6 AppBox.trackConversion("<CONVERSION_CODE>", 39000.0) { success, error -> }
1 AppBox.trackConversion("<CONVERSION_CODE>", new AppBoxOperationCallback() {
2 @Override
3 public void onComplete(boolean success, Throwable error) {
4 if (!success) Log.w("AppBox", String.valueOf(error));
5 }
6 });
7
8 // 금액 등 값을 함께 기록
9 AppBox.trackConversion("<CONVERSION_CODE>", 39000.0, new AppBoxOperationCallback() {
10 @Override
11 public void onComplete(boolean success, Throwable error) { }
12 });

Request 항목 정의

Request 항목필수여부설명기본값
conversionCode필수콘솔에서 발급된 전환 코드-
value-금액 등 함께 기록할 숫자 값없음
callback필수AppBoxOperationCallback-


Response 항목 정의

Response 결과값
success전환 전송 요청 성공 여부 (true | false)
오류AppBoxConversionUnavailableException: appbox-core 외 기능 artifact가 하나도 없는 구성
(네트워크 오류): 서버 전송 실패


appbox-core 외에 기능 artifact가 하나 이상 필요합니다. appbox-push, appbox-inapp, appbox-webview, appbox-health, appbox-appsflyer, appbox-auth-* 중 어느 것이든 하나면 충분합니다. In-App 메시지의 전환 동작을 클릭했다고 해서 이 함수가 자동으로 호출되지는 않습니다.

웹 브릿지에서는 전환 이벤트 기록의 message.trackConversion입니다.

www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.