- 개발자 가이드
- SDK Integration
- Android SDK
앱 삭제 트래킹 설정하기 - 안드로이드 SDK
에어브릿지는 앱 이벤트를 최근 6개월 동안 1번이라도 트래킹한 유저를 대상으로 사일런트 푸시를 매일 KST(한국표준시간) 0시~1시 사이에 보내서 앱 삭제 여부를 확인합니다. 앱 삭제 이벤트는 에어브릿지 리포트와 로우 데이터 등으로 확인할 수 있습니다.
파이어베이스 클라우드 메시징(FCM)을 사용해 안드로이드 환경에서 발생한 앱 삭제를 트래킹합니다.
알립니다
Airbridge Android SDK가 v2.6.0 이상이어야 합니다.
파이어베이스 인증 정보를 에어브릿지 대시보드에 입력하면 안드로이드 환경에서 발생한 앱 삭제를 트래킹할 수 있습니다.
알립니다
구글이 파이어베이스 클라우드 메시징(FCM) 레거시 API의 지원을 중단합니다. 안드로이드 환경에서 앱 삭제 이벤트를 계속해서 트래킹하기 위해서는 2024년 5월 31일까지 파이어베이스 인증 정보를 에어브릿지에 업데이트해야 합니다. 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
에어브릿지는 인증 정보를 업데이트한 다음날부터 새로운 API를 사용합니다. 새로운 API를 사용해도 안드로이드 환경에서 발생한 앱 삭제 이벤트의 수치 또는 수집 방식은 달라지지 않습니다.
파이어베이스 콘솔에서 인증 정보를 포함하고 있는 비공개 키를 생성해 주세요.
1. 파이어베이스 콘솔에서 비공개 키를 생성하는 프로젝트를 선택하거나 ‘프로젝트 추가’를 클릭해서 신규 프로젝트를 생성합니다. 파이어베이스 가이드를 참고해 등록한 앱의 기본 설정을 완료합니다.
2. 선택한 프로젝트에서 [프로젝트 개요]>[프로젝트 설정]으로 이동합니다. [클라우드 메시징] 탭에서 Firebase Cloud Messaging API(V1)가 사용 여부를 확인합니다. ‘사용 설정됨’으로 되어 있다면 다음 단계를 진행합니다.
‘사용 중지됨’이면 오른쪽 더보기 버튼을 클릭한 후에 ‘Google Cloud 콘솔에서 API 관리’를 선택합니다. 구글 클라우드 콘솔의 API 관리 페이지에서 ‘사용’을 클릭합니다. 그리고 파이어베이스 콘솔의 [클라우드 메시징] 탭에서 ‘사용 설정됨’으로 변경되었는지 확인합니다.
3. [프로젝트 개요]>[프로젝트 설정]>[서비스 계정] 탭으로 이동합니다. ‘새 비공개 키 생성’을 클릭합니다.
4. ‘키 생성’을 클릭하면 비공개 키가 있는 JSON 파일이 다운로드됩니다. JSON 파일을 안전한 위치에 저장합니다.
아래 순서에 따라 인증 정보를 입력해 주세요.
1. 에어브릿지 대시보드 [Settings]>[Uninstall Tracking]로 이동합니다.
2. [안드로이드] 탭에 파이어베이스 콘솔에서 다운로드한 JSON 파일을 업로드합니다.
3. 파일을 드롭하거나 클릭으로 파일을 선택할 수 있습니다.
사일런트 푸시 테스트로 사일런트 푸시가 디바이스에 정상적으로 전송되는지 확인할 수 있습니다. 테스트를 진행하기 위해서는 ‘사일런트 푸시 테스트’를 클릭하고 테스트 디바이스의 FCM 등록 토큰을 입력해야 합니다. FCM 등록 토큰을 확인하는 방법은 파이어베이스 가이드를 참고해 주세요.
사일런트 푸시가 디바이스에 정상적으로 전송되면 앱을 설치한 디바이스에 대해 성공 메시지를 확인할 수 있습니다. 또는 앱을 삭제한 디바이스에 대해 404 에러 코드를 확인할 수 있습니다.
안드로이드 환경의 사일런트 푸시 테스트로 확인할 수 있는 주요 에러 코드는 아래와 같습니다. 에러 코드에 관한 자세한 내용은 파이어베이스 가이드를 참고해 주세요.
에러 코드 | HTTP 오류 코드 | 설명 |
|---|---|---|
INVALID_ARGUMENT | 400 | 요청 매개변수가 잘못되었습니다. 패키지 이름 등이 정상적으로 입력되었는지 확인하세요. |
THIRD_PARTY_AUTH_ERROR | 401 | APN 인증서 또는 웹 푸시 인증 키가 유효하지 않거나 누락되었습니다. 인증 정보를 다시 확인하세요. |
SENDER_ID_MISMATCH | 403 | 인증된 발신자 ID가 등록 토큰의 발신자 ID와 다릅니다. 발신자 ID를 다시 확인하세요. |
UNREGISTERED | 404 | 등록 토큰이 잘못되었습니다. 에어브릿지 기준 앱이 삭제되었다는 뜻입니다. 앱 삭제 이벤트가 에어브릿지에 정상적으로 수집될 수 있습니다. |
QUOTA_EXCEEDED | 429 | 메시지 대상에 대한 전송 한도가 초과되었습니다. |
INTERNAL | 500 | 파이어베이스 서버에서 오류가 발생했습니다. 잠시 기다린 후에 테스트를 다시 진행하세요. 오류가 지속되면 파이어베이스에 문의하세요. |
UNAVAILABLE | 503 | 파이어베이스 서버가 과부하되어 요청이 제때 처리되지 않았습니다. 잠시 기다린 후에 테스트를 다시 진행하세요. |
사일런트 푸시 테스트는 에어브릿지에서 확인할 수 있는 앱 삭제 이벤트 수치에 어떠한 영향도 주지 않습니다. 따라서 사일런트 푸시 테스트로는 에어브릿지 리포트 또는 로우 데이터 추출에서 앱 삭제 이벤트 발생 여부를 확인할 수 없습니다.
앱 삭제를 트래킹하기 위해서는 에어브릿지 SDK 설정을 완료해야 합니다. AndroidManifest.xml 에 아래처럼 추가해 주세요
<service
android:name="${packageName}.MyFirebaseMessagingService"
android:exported="false">
<intent-filter>
<action android:name="com.google.firebase.MESSAGING_EVENT" />
</intent-filter>
</service>파이어베이스 클라우드 메시징(Firebase Cloud Messaging, FCM)에서 생성된 푸시 토큰(push token)을 에어브릿지 SDK를 통해 전달합니다.
public class MyFirebaseMessagingService extends FirebaseMessagingService {
@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
super.onMessageReceived(remoteMessage);
}
@Override
public void onNewToken(String token) {
super.onNewToken(token);
Airbridge.registerPushToken(token);
}
}class MyFirebaseMessagingService : FirebaseMessagingService() {
override fun onMessageReceived(remoteMessage: RemoteMessage) {
super.onMessageReceived(remoteMessage)
}
override fun onNewToken(token: String) {
super.onNewToken(token)
Airbridge.registerPushToken(token)
}
}이미 파이어베이스 클라우드 메시징에서 푸시 토큰이 발급됐을 수 있습니다. 아래 설청을 추가해 기존 푸시 토큰도 함께 전달해 주세요.
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
FirebaseMessaging.getInstance()
.getToken()
.addOnSuccessListener(new OnSuccessListener<String>() {
@Override
public void onSuccess(String token) {
Airbridge.registerPushToken(token);
}
});
}
}class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
...
FirebaseMessaging.getInstance()
.token
.addOnSuccessListener {
Airbridge.registerPushToken(it)
}
...
}
}주의하세요
반드시 해당 함수가 Airbridge SDK의 초기화 작업 이후에 호출 될 수 있도록 작성해 주세요.
사일런트 푸시로 별도 데이터 없이 사일런트 알림이 전송됩니다. 하지만 파이어베이스 클라우드 메시징의 onMessageReceived 구현에 따라 사일런트 푸시의 알림이 유저에게 노출될 수 있습니다. 아래 예외 처리를 추가하면 사일런트 푸시가 유저에게 노출되지 않습니다.
public class MyFirebaseMessagingService extends FirebaseMessagingService {
@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
super.onMessageReceived(remoteMessage);
if (remoteMessage.getData().containsKey("airbridge-uninstall-tracking")) {
return;
} else {
// handleNotification(remoteMessage);
}
}
@Override
public void onNewToken(String token) {
super.onNewToken(token);
Airbridge.registerPushToken(token);
}
}class MyFirebaseMessagingService : FirebaseMessagingService() {
override fun onMessageReceived(remoteMessage: RemoteMessage) {
super.onMessageReceived(remoteMessage)
if (remoteMessage.data.containsKey("airbridge-uninstall-tracking")) {
return
} else {
// handleNotification(remoteMessage)
}
}
override fun onNewToken(token: String) {
super.onNewToken(token)
Airbridge.registerPushToken(token)
}
}에어브릿지 대시보드에 인증 정보를 입력하고 에어브릿지 SDK 설정을 마치면 앱 삭제 트래킹 토글을 활성화할 수 있습니다. 토글을 활성화하면 앱 삭제 트래킹이 시작됩니다.
앱 삭제에 관한 자세한 내용은 에어브릿지 가이드에서 확인해 주세요.
도움이 되었나요?