앱 삭제 트래킹 설정하기 - 플러터 SDK (v4)

에어브릿지는 앱 이벤트를 최근 6개월 동안 1번이라도 트래킹한 유저를 대상으로 사일런트 푸시를 매일 KST(한국표준시) 0시~1시 사이에 보내서 앱 삭제 여부를 확인합니다. 앱 삭제 이벤트는 에어브릿지 리포트와 원본 데이터 추출 등으로 확인할 수 있습니다.

인증 정보 입력하기

애플 개발자 센터와 구글 클라우드 콘솔의 인증 정보를 에어브릿지 대시보드에 입력해야 합니다.

애플 개발자 대시보드에서 인증 정보 확인하기

애플 개발자 대시보드에서 아래 인증 정보 4가지를 확인해 주세요.

구글 클라우드 콘솔에서 인증 정보 확인하기

구글 클라우드 콘솔에서 아래 3가지 작업을 통해 인증 정보를 확인해 주세요.

에어브릿지에 인증 정보 입력하기

플랫폼별 인증 정보를 입력해 주세요.

iOS

에어브릿지의 [설정]>[앱 삭제 이벤트 트래킹]>[iOS 앱 삭제 트래킹]에 애플 개발자 센터에서 확인한 인증 정보를 모두 입력합니다.

앱 환경 선택하기

인증 정보를 에어브릿지에 모두 입력한 이후에 푸시 토큰을 수집하는 앱 환경을 선택합니다.

선택하는 앱 환경에 따라 수집하는 푸시 토큰이 다릅니다. 예를 들어 Production 환경에서 수집한 푸시 토큰은 Development 환경에서 사용할 수 없습니다.

안드로이드

아래 순서에 따라 인증 정보를 입력해 주세요.

1. 에어브릿지 대시보드 [설정]>[앱 삭제 이벤트 트래킹]으로 이동합니다.

2. [안드로이드] 탭에 구글 클라우드 콘솔에서 다운로드한 JSON 파일을 업로드합니다.

3. 파일을 드롭하거나 클릭으로 파일을 선택할 수 있습니다.

사일런트 푸시 테스트하기

플랫폼별 사일런트 푸시 테스트에 대한 자세한 내용은 아래와 같습니다.

iOS

사일런트 푸시 테스트는 사일런트 푸시가 정상적으로 전송되는지 확인할 수 있는 테스트입니다. ‘사일런트 푸시 테스트’를 클릭하면 입력한 인증 정보로 사일런트 푸시를 디바이스에 정상적으로 전송하는지 확인할 수 있습니다. 사일런트 푸시 테스트는 앱 삭제 이벤트를 측정하거나 생성하지 않기 때문에 에어브릿지 대시보드에서 앱 삭제를 확인할 수 없습니다.

앱 삭제 트래킹을 위해 필요한 인증 정보 중 하나인 Bundle ID는 사일런트 푸시 테스트로만 유효성을 검증할 수 있습니다. 따라서 사일런트 푸시 테스트 진행을 권장합니다.

사일런트 푸시 테스트를 진행하기 위해서는 APNs 푸시 토큰(디바이스 토큰)이 필요합니다. 앱 환경에 따라 수집하는 푸시 토큰이 다릅니다. 사일런트 푸시 테스트를 진행하기 전에 푸시 토큰과 앱 환경을 확인해야 합니다. APNs 푸시 토큰을 확인하는 방법은 애플 개발자 가이드를 참고해 주세요.

에어브릿지에서 디바이스로 사일런트 푸시를 전송하면 성공 메시지 또는 에러 코드를 확인할 수 있습니다. iOS 환경의 사일런트 푸시 테스트로 확인할 수 있는 주요 에러 코드는 아래와 같습니다. 에러 코드에 관한 자세한 내용은 애플 개발자 가이드를 참고해 주세요.

주의하세요

iOS 시뮬레이터(iOS Simulator)에서는 사일런트 푸시 테스트를 진행할 수 없습니다.

안드로이드

사일런트 푸시 테스트로 사일런트 푸시가 디바이스에 정상적으로 전송되는지 확인할 수 있습니다. 테스트를 진행하기 위해서는 ‘사일런트 푸시 테스트’를 클릭하고 테스트 디바이스의 FCM 등록 토큰을 입력해야 합니다. FCM 등록 토큰을 확인하는 방법은 파이어베이스 가이드를 참고해 주세요.

사일런트 푸시가 디바이스에 정상적으로 전송되면 앱을 설치한 디바이스에 대해 성공 메시지를 확인할 수 있습니다. 또는 앱을 삭제한 디바이스에 대해 404 에러 코드를 확인할 수 있습니다.

안드로이드 환경의 사일런트 푸시 테스트로 확인할 수 있는 주요 에러 코드는 아래와 같습니다. 에러 코드에 관한 자세한 내용은 파이어베이스 가이드를 참고해 주세요.

사일런트 푸시 테스트는 에어브릿지에서 확인할 수 있는 앱 삭제 이벤트 수치에 어떠한 영향도 주지 않습니다. 따라서 사일런트 푸시 테스트로는 에어브릿지 리포트 또는 로우 데이터 추출에서 앱 삭제 이벤트 발생 여부를 확인할 수 없습니다.

에어브릿지 SDK 설정하기

앱 삭제를 트래킹하기 위해서는 에어브릿지 SDK 설정을 완료해야 합니다.

푸시 알람 설정하기

에어브릿지는 사일런트 푸시 알림을 통해 앱 삭제를 트래킹합니다. 따라서 앱이 푸시 알림을 받을 수 있도록 설정해 주세요.

푸시 토큰 전송하기

푸시 토큰이 생성되면 해당 토큰을 registerPushToken 함수로 호출해 SDK에 전달해 주세요.

123
import 'package:airbridge_flutter_sdk/airbridge_flutter_sdk.dart';
...
Airbridge.registerPushToken(token);

주의하세요

iOS에서는 APNS 푸시 토큰을, Android에서는 파이어베이스 푸시 토큰을 전송해야 합니다.

에어브릿지 사일런트 푸시 알람 무시 설정하기

에어브릿지가 앱 삭제 트래킹을 위해 보내는 사일런트 푸시 알람은 유저 앱에 나오지 않아야 하는 알람입니다. 앱은 해당 푸시 알람을 무시해야 합니다. 아래 코드를 참고해 주세요.

1234567
import 'package:airbridge_flutter_sdk/airbridge_flutter_sdk.dart';
...
if (Airbridge.isUninstallTrackingNotification(payload)) {
    // app uninstall tracking push by airbridge.
    // ignore these push notifications.
    return
}

앱 삭제 트래킹 시작하기

에어브릿지 대시보드에 인증 정보를 입력하고 에어브릿지 SDK 설정을 마치면 앱 삭제 트래킹 토글을 활성화할 수 있습니다. 토글을 활성화하면 앱 삭제 트래킹이 시작됩니다.

앱 삭제에 관한 자세한 내용은 에어브릿지 가이드에서 확인해 주세요.

도움이 되었나요?

더 필요한 내용이 있나요?