사용자 여정과 전환 | Appbox Android SDK 가이드
Android SDK 연동
사용자 여정과 전환 개요
| 전제 | 내용 |
|---|---|
| 필요 artifact | appbox-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입니다.