액션 listener 설정 | Native In-App | Appbox Android SDK 가이드

액션 listener 설정

사용자가 In-App 메시지의 버튼이나 이미지를 눌렀을 때 호출할 listener를 등록합니다. function 액션으로 앱 고유 동작을 연결할 때 사용합니다.

액션 listener 설정

AppBox.setInAppActionListener(listener, callback)

Kotlin
1 AppBox.setInAppActionListener({ event ->
2 when (event.action) {
3 "link", "external" -> Unit // SDK가 처리합니다
4 "function" -> handleCustomAction(event.actionValue)
5 "event", "conversion" -> Unit
6 }
7 }, AppBoxOperationCallback { success, error -> })
8
9 // 해제
10 AppBox.setInAppActionListener(null, AppBoxOperationCallback { success, error -> })
1 AppBox.setInAppActionListener(new AppBoxInAppActionListener() {
2 @Override
3 public void onAction(AppBoxInAppActionEvent event) {
4 if ("function".equals(event.getAction())) {
5 handleCustomAction(event.getActionValue());
6 }
7 // "link", "external"은 SDK가 처리합니다
8 }
9 }, new AppBoxOperationCallback() {
10 @Override
11 public void onComplete(boolean success, Throwable error) { }
12 });
13
14 // 해제
15 AppBox.setInAppActionListener(null, new AppBoxOperationCallback() {
16 @Override
17 public void onComplete(boolean success, Throwable error) { }
18 });

Request 항목 정의

Request 항목필수여부설명기본값
listener-AppBoxInAppActionListener. null이면 등록을 해제합니다-
callback필수등록 결과를 받는 AppBoxOperationCallback-


Response 항목 정의

Response 결과값
successlistener 등록 성공 여부 (true | false)
event.campaignCodelistener로 전달되는 캠페인 식별자
event.action실행된 동작 종류. 항상 소문자
event.actionValue동작에 설정된 값
오류등록 시 (callback): AppBoxInAppUnavailableException. appbox-inapp 미포함
이벤트 수신 시 (listener): 오류 전달 없음


listener는 알림용입니다. link와 external의 URL 열기는 SDK가 계속 담당합니다. listener에서 같은 URL을 다시 열면 화면이 두 번 열립니다.

  • action 값은 서버 설정과 무관하게 소문자로 전달됩니다.
  • 메시지 노출 자체는 listener로 전달되지 않습니다.
  • 마지막에 등록한 하나만 유지됩니다. Application.onCreate()에서 등록을 권장합니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.