In-App 동기화 listener 설정 | Native In-App | Appbox Android SDK 가이드

In-App 동기화 listener 설정

사일런트 Push로 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 결과값
contextlistener로 전달되는 context
campaignCode동기화 대상 캠페인 식별자. 값이 없으면 빈 문자열
handledBySdkSDK가 이 신호를 처리했는지 여부
오류이 함수에는 오류 전달이 없습니다. 등록은 appbox-core만으로 되지만 발화는 appbox-push가 담당합니다. appbox-push가 없으면 listener는 등록되지만 호출되지 않습니다. appbox-webview는 필요하지 않습니다.
handledBySdk의미
trueSDK가 신호를 처리함. 표시됐다는 뜻이 아님. 상세는 아래 동작 설명
false표시 조건 화면 없음, artifact 없음, 미초기화, 처리 중 예외

동기화 신호가 아닌 일반 알림 Push는 전달되지 않습니다. listener의 예외는 SDK가 삼켜 Push 처리에 영향을 주지 않습니다. 마지막에 등록한 하나만 유지됩니다. Application.onCreate()에서 등록합니다.

if (!handledBySdk) { 화면 전환 } 패턴을 In-App을 쓰지 않는 앱에 넣지 마세요. 그런 앱에서는 이 값이 항상 false라 Push마다 화면이 전환됩니다.

동작 설명

handledBySdk 판정 상세입니다.

  • true는 표시 대기열에 정상 진입한 경우 외에도, 조건에 맞는 캠페인이 없어 대기열이 비었거나 In-App 설정이 enabled = false이거나 이미 처리한 중복 Push인 경우에도 true입니다.
  • false는 표시 조건을 만족하는 화면이 없어 보류됐거나(다시 옵트인 화면에 진입할 때 재평가), appbox-inapp artifact가 없거나, In-App이 초기화되지 않았거나, 처리 중 예외가 발생한 경우입니다.
  • In-App을 실제로 사용하는 앱에서만 handledBySdk 조건 분기를 사용하세요.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.