In-App 동기화 listener 설정 | Native In-App | Appbox Android SDK 가이드
In-App 동기화 listener 설정
In-App 동기화 listener 설정
AppBox.setInAppSyncListener(listener)
Kotlin
1
AppBox.setInAppSyncListener { context, campaignCode, handledBySdk ->
2
Log.d("AppBox", "sync campaign=$campaignCode handled=$handledBySdk")
3
}
4
5
// 해제
6
AppBox.setInAppSyncListener(null)
1
AppBox.setInAppSyncListener(new AppBoxInAppSyncListener() {
2
@Override
3
public void onInAppSyncReceived(Context context, String campaignCode, boolean handledBySdk) {
4
Log.d("AppBox", "sync campaign=" + campaignCode + " handled=" + handledBySdk);
5
}
6
});
7
8
// 해제
9
AppBox.setInAppSyncListener(null);
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| listener | - | AppBoxInAppSyncListener. null이면 등록을 해제합니다 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
context | listener로 전달되는 context |
campaignCode | 동기화 대상 캠페인 식별자. 값이 없으면 빈 문자열 |
handledBySdk | SDK가 이 신호를 처리했는지 여부 |
| 오류 | 이 함수에는 오류 전달이 없습니다. 등록은 appbox-core만으로 되지만 발화는 appbox-push가 담당합니다. appbox-push가 없으면 listener는 등록되지만 호출되지 않습니다. appbox-webview는 필요하지 않습니다. |
| handledBySdk | 의미 |
|---|---|
true | SDK가 신호를 처리함. 표시됐다는 뜻이 아님. 상세는 아래 동작 설명 |
false | 표시 조건 화면 없음, artifact 없음, 미초기화, 처리 중 예외 |
동기화 신호가 아닌 일반 알림 Push는 전달되지 않습니다. listener의 예외는 SDK가 삼켜 Push 처리에 영향을 주지 않습니다. 마지막에 등록한 하나만 유지됩니다. Application.onCreate()에서 등록합니다.
if (!handledBySdk) { 화면 전환 } 패턴을 In-App을 쓰지 않는 앱에 넣지 마세요. 그런 앱에서는 이 값이 항상 false라 Push마다 화면이 전환됩니다.
동작 설명
handledBySdk 판정 상세입니다.
true는 표시 대기열에 정상 진입한 경우 외에도, 조건에 맞는 캠페인이 없어 대기열이 비었거나 In-App 설정이enabled = false이거나 이미 처리한 중복 Push인 경우에도true입니다.false는 표시 조건을 만족하는 화면이 없어 보류됐거나(다시 옵트인 화면에 진입할 때 재평가),appbox-inappartifact가 없거나, In-App이 초기화되지 않았거나, 처리 중 예외가 발생한 경우입니다.- In-App을 실제로 사용하는 앱에서만
handledBySdk조건 분기를 사용하세요.