AppsFlyer | Appbox Android SDK 가이드
Android SDK 연동
AppsFlyer 개요
| 전제 | 내용 |
|---|---|
| 필요 artifact | appbox-appsflyer + 초기화 설정의 appsFlyer |
| 전제 미충족 시 | 콜백 error로 AppBoxAppsFlyerUnavailableException 또는 AppBoxAppsFlyerNotConfiguredException → 예외 카탈로그 |
| 설정 주의 | devKey가 비어 있으면 AppsFlyer 초기화가 건너뛰기 처리됩니다 (SKIPPED) |
딥링크 진입 Activity와 intent-filter는 앱이 구성합니다. SDK는 딥링크 수신용 화면을 제공하지 않으며, 수신한 intent를 SDK에 전달하는 공개 함수도 없습니다. 딥링크를 받아도 AppBox 화면이 자동으로 열리지는 않습니다.
딥링크 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 결과값 | |
|---|---|
success | listener 등록 성공 여부 (true | false) |
result.status | FOUND, 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 해제
딥링크 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 결과값 | |
|---|---|
success | listener 해제 성공 여부 (true | false) |
해제 이후 도착한 딥링크 결과는 앱에 전달되지 않습니다.