function 액션으로 앱 고유 동작을 연결할 때 사용합니다.액션 listener 설정 | Native In-App | Appbox Android SDK 가이드
액션 listener 설정
액션 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 결과값 | |
|---|---|
success | listener 등록 성공 여부 (true | false) |
event.campaignCode | listener로 전달되는 캠페인 식별자 |
event.action | 실행된 동작 종류. 항상 소문자 |
event.actionValue | 동작에 설정된 값 |
| 오류 | 등록 시 (callback): AppBoxInAppUnavailableException. appbox-inapp 미포함이벤트 수신 시 (listener): 오류 전달 없음 |
listener는 알림용입니다. link와 external의 URL 열기는 SDK가 계속 담당합니다. listener에서 같은 URL을 다시 열면 화면이 두 번 열립니다.
action값은 서버 설정과 무관하게 소문자로 전달됩니다.- 메시지 노출 자체는 listener로 전달되지 않습니다.
- 마지막에 등록한 하나만 유지됩니다.
Application.onCreate()에서 등록을 권장합니다.