AppsFlyer | Appbox Android SDK 가이드

Android SDK 연동

AppsFlyer 개요

전제내용
필요 artifactappbox-appsflyer + 초기화 설정의 appsFlyer
전제 미충족 시콜백 error로 AppBoxAppsFlyerUnavailableException 또는 AppBoxAppsFlyerNotConfiguredException → 예외 카탈로그
설정 주의devKey가 비어 있으면 AppsFlyer 초기화가 건너뛰기 처리됩니다 (SKIPPED)

딥링크 진입 Activity와 intent-filter는 앱이 구성합니다. SDK는 딥링크 수신용 화면을 제공하지 않으며, 수신한 intent를 SDK에 전달하는 공개 함수도 없습니다. 딥링크를 받아도 AppBox 화면이 자동으로 열리지는 않습니다.

딥링크 listener 설정

AppsFlyer 딥링크 결과를 받을 listener를 등록합니다. 어트리뷰션 딥링크에 따라 앱 내 화면을 라우팅할 때 사용합니다.

딥링크 listener 설정

AppBox.setAppsFlyerDeepLinkListener(listener, callback)

Kotlin
1 AppBox.setAppsFlyerDeepLinkListener({ result ->
2 when (result.status) {
3 AppBoxAppsFlyerDeepLinkResult.Status.FOUND ->
4 routeTo(result.value, result.getSubParam(AppBoxAppsFlyerSubParam.SUB1))
5 AppBoxAppsFlyerDeepLinkResult.Status.NOT_FOUND -> Unit
6 AppBoxAppsFlyerDeepLinkResult.Status.ERROR -> logError(result.errorMessage)
7 }
8 }, AppBoxOperationCallback { success, error -> })
1 AppBox.setAppsFlyerDeepLinkListener(new AppBoxAppsFlyerDeepLinkListener() {
2 @Override
3 public void onDeepLink(AppBoxAppsFlyerDeepLinkResult result) {
4 switch (result.getStatus()) {
5 case FOUND:
6 routeTo(result.getValue(),
7 result.getSubParam(AppBoxAppsFlyerSubParam.SUB1));
8 break;
9 case NOT_FOUND:
10 break;
11 case ERROR:
12 logError(result.getErrorMessage());
13 break;
14 }
15 }
16 }, new AppBoxOperationCallback() {
17 @Override
18 public void onComplete(boolean success, Throwable error) { }
19 });

Request 항목 정의

Request 항목필수여부설명기본값
listener필수AppBoxAppsFlyerDeepLinkListener-
callback필수등록 결과를 받는 AppBoxOperationCallback-


Response 항목 정의

Response 결과값
successlistener 등록 성공 여부 (true | false)
result.statusFOUND, NOT_FOUND, ERROR
result.value딥링크 값
result.subParams하위 파라미터 모음. getSubParam(SUB1)~getSubParam(SUB10)으로 읽습니다
result.rawParams원본 파라미터
result.isDeferred지연 딥링크 여부 (true | false)
오류등록 시 (callback): AppBoxAppsFlyerUnavailableException. appbox-appsflyer 미포함
이벤트 수신 시 (listener): result.errorCode / result.errorMessage. ERROR 상태일 때의 원인. 값은 AppsFlyer SDK가 전달합니다 (pass-through)


등록 전에 도착한 결과는 한 번 다시 전달됩니다. 마지막에 등록한 하나만 유지됩니다. Application.onCreate()에서 등록하며, 해제는 clearAppsFlyerDeepLinkListener를 사용합니다.

딥링크 listener 해제

등록한 AppsFlyer 딥링크 listener를 해제합니다. 딥링크 라우팅을 중단해야 할 때 호출합니다.

딥링크 listener 해제

AppBox.clearAppsFlyerDeepLinkListener(callback)

Kotlin
1 AppBox.clearAppsFlyerDeepLinkListener(AppBoxOperationCallback { success, error -> })
1 AppBox.clearAppsFlyerDeepLinkListener(new AppBoxOperationCallback() {
2 @Override
3 public void onComplete(boolean success, Throwable error) { }
4 });

Request 항목 정의

Request 항목필수여부설명기본값
callback필수AppBoxOperationCallback-


Response 항목 정의

Response 결과값
successlistener 해제 성공 여부 (true | false)


해제 이후 도착한 딥링크 결과는 앱에 전달되지 않습니다.

www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.