AppsFlyer와 딥링크 | Appbox iOS SDK 가이드
AppsFlyer와 딥링크
AppsFlyer 설정
AppsFlyer 설정
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
config | 필수 | AppsFlyer 설정 | - |
config.devKey | 필수 | AppsFlyer dev key | - |
config.appleAppID | 필수 | Apple App ID: App Store Connect의 숫자 ID | - |
config.attTimeout | 선택 | ATT 응답 대기 시간 | 60초 |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
AppBoxInitConfig.appsFlyer를 전달하면 같은 설정이 초기화 중 자동 적용됩니다. 초기화 config로 설정했다면 이 함수를 다시 호출하지 않습니다. 설정만으로 AppsFlyer가 시작되지는 않습니다. listener 또는 bridge를 준비한 뒤 startAppsFlyer()를 호출합니다.
AppsFlyer 시작
AppsFlyer 시작
Request 항목 정의
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
AppsFlyer 설정 또는 AppBoxInitResult.appsFlyer.status == .INITIALIZED 확인 뒤 호출합니다.
- Native 결과가 필요하면 listener를 먼저 등록합니다.
- WebView 결과가 필요하면 JavaScript bridge를 먼저 설정합니다.
- 앱 lifecycle에서 한 번만 시작합니다.
딥링크 listener 설정
딥링크 listener 설정
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
listener | 선택 | 딥링크 결과를 받을 closure/block. nil이면 listener 없음 | nil |
Response 항목 정의
| Response 결과값 | |
|---|---|
result.status | .found, .notFound, .error |
result.value | 발견된 딥링크 값 |
result.subParams | sub1부터 sub10까지의 하위 파라미터 |
result.rawParams | AppsFlyer 원본 파라미터 |
result.isDeferred | deferred deep link 여부 |
result.errorCode, result.errorMessage | 실패 코드와 설명 |
listener 등록 → AppsFlyer 설정, 초기화 → startAppsFlyer() 순서를 사용합니다. 해제 의도를 명확히 하려면 clearAppsFlyerDeepLinkListener()를 사용합니다. rawParams에 포함될 수 있는 식별 정보나 token을 로그에 남기지 않습니다.
딥링크 listener 해제
딥링크 listener 해제
Request 항목 정의
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
해제 후에는 Native listener로 새 딥링크 결과를 받지 않습니다. 화면 단위 listener라면 화면 종료 시점에 해제합니다.
AppsFlyer JavaScript bridge 설정
AppsFlyer JavaScript bridge 설정
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
config | 필수 | AppsFlyer JavaScript bridge 설정 | - |
config.deliverNotFoundAndError | 선택 | not-found와 error 결과도 웹에 전달할지 여부 | false |
config.pendingLimit | 선택 | 웹 준비 전 보관할 최대 결과 수 | 10 |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
WebView와 AppsFlyer 초기화가 완료된 뒤, startAppsFlyer() 전에 설정합니다. pendingLimit이 음수이면 0으로 보정됩니다. WebView에서 AppsFlyer 결과가 필요할 때만 사용합니다.
AppsFlyer JavaScript bridge 해제
AppsFlyer JavaScript bridge 해제
Request 항목 정의
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
해제 후에는 새 AppsFlyer 결과가 JavaScript로 전달되지 않습니다. Native listener 설정에는 영향을 주지 않습니다.
URL Scheme 전달
URL Scheme 전달
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
url | 필수 | 앱 lifecycle callback이 전달한 URL | - |
options | 필수 | 동일 callback이 전달한 URL open options | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
Bool | Auth 또는 AppsFlyer 경로에서 URL을 처리했는지 여부 |
options를 버리지 말고 lifecycle callback이 전달한 값을 함께 전달합니다. AppDelegate와 SceneDelegate에서 같은 URL을 중복 전달하지 않습니다. 앱의 다른 URL router가 있다면 반환값을 기준으로 후속 처리를 결정합니다.
AppDelegate 연결 예제는 AppBoxSampleiOS에서 확인할 수 있습니다.
Universal Link 전달
NSUserActivity를 AppsFlyer 처리 경로에 전달합니다.
Universal Link 전달
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
userActivity | 필수 | 앱 lifecycle callback이 전달한 NSUserActivity | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
Bool | AppsFlyer 경로에서 user activity를 처리했는지 여부 |
Associated Domains와 Universal Link 설정을 먼저 완료합니다. AppDelegate와 SceneDelegate에서 같은 activity를 중복 전달하지 않습니다. 앱의 다른 Universal Link router가 있다면 반환값을 기준으로 후속 처리를 결정합니다.
AppDelegate 연결 예제는 AppBoxSampleiOS에서 확인할 수 있습니다.