문서

Android 제거 추적은 Firebase 클라우드 메시징 서비스를 활용합니다. Firebase는 2024년 7월 22일에 레거시 HTTP API를 더 이상 지원하지 않습니다. 아직 레거시 HTTP API를 사용 중인 경우 Singular 앱 구성 페이지를 통해 HTTP V1 API를 사용하도록 업데이트하세요. 자세히 알아보세요.

Singular는 마케팅 캠페인을 통해 발생하는 트래픽의 품질을 측정하는 또 다른 방법으로 앱 삭제 추적 옵션을 제공합니다. 이 기능은 Singular 안드로이드 SDK 버전 7.x 이상에서 사용할 수 있으며, 이 기능을 사용하려면 앱을 업데이트해야 합니다.

참고:

Singular의 앱 삭제 추적은 구글 서비스를 활용하지만 구글과는 다른 방법론을 사용합니다. Google은 디바이스의 운영 체제에서 직접 제거를 보고합니다. 따라서 Google에서 보고하는 수치는 Singular에서 보고하는 수치와 다를 수 있습니다.
제거는 Singular에서 이벤트로 추적되므로 원래 설치 또는 리인게이지먼트 소스에서 어트리뷰션 링크가 제거되지 않습니다. 사용자가 평생 동안 앱을 여러 번 제거할 수 있기 때문에 제거율이 100%보다 높을 수 있습니다.

Google 조직에 도메인 제한 공유가 활성화된 경우, 허용된 값에 Singular 조직 ID를 적용합니다:

도메인 제한 공유 정책 수정

조직 정책 액세스
Google Cloud 콘솔에서 조직 정책 페이지로 이동합니다.
정책을 설정하려는 조직 리소스를 선택합니다.
목록에서 도메인 공유 제한 제약 조건을 찾아 선택합니다.
정책 관리를 클릭합니다.

허용된 값에 조직 ID 추가

정책 값에서 사용자 지정을 선택합니다.

조직 리소스 ID를 형식에 맞게 입력합니다:

is:principalSet://iam.googleapis.com/organizations/626787461583

설정 지침

HTTP V1 API

Android SDK 7.x 이상 연동: 삭제 추적은 Android SDK 버전 7.x 이상에서 사용할 수 있습니다. SDK 업그레이드에 대한 지침은 Android SDK 연동 가이드를 참조하세요.
AndroidManifest.xml을 수정합니다: Android SDK 제거 추적 가이드 세부 정보를 참조하세요.
Singular 앱 페이지 > 앱 > 고급 설정 > 추적 제거에서 프로젝트 ID를 입력합니다.

프로젝트 ID를 생성하고 구성하려면 다음과 같이 하세요.
1. Firebase 클라우드 메신저 콘솔로이동합니다.
2. 새 프로젝트를 선택하거나 생성합니다.
3. 프로젝트 개요 > 프로젝트 설정으로 이동하여 프로젝트 ID를 복사합니다. 이 프로젝트 ID는 이후 단계에서 프로젝트에 적절한 역할과 권한이 부여된 후 Singular 앱 페이지에 입력해야 하는 프로젝트 ID입니다.
4. 클라우드 메시 징으로 이동하여 프로젝트에 대해 FCM 클라우드 메시징을 활성화하고 Firebase 클라우드 메시징 API(V1)를 활성화합니다.
5. 서비스 계정 > 서비스 계정 권한 관리로이동합니다.
6. 올바른 프로젝트 역할 및 권한 할당
  1. 왼쪽 탐색 메뉴에서 역할을 선택합니다 .
  2. 역할 만들기를 클릭하고 다음 정보를 입력합니다.
    제목: Singular 제거 추적
    ID: singular_uninstalls
    역할 시작 단계: 일반 사용 가능
  3. 권한 추가를 클릭하고 cloudmessaging.messages.create를 추가합니다 . Firebase Cloud 메시징 API 관리자에서 필터링을 통해 빠르게 찾을 수 있습니다.
  4. 만들기를 클릭하여 역할 만들기를 완료합니다.
7. 역할에 Singular 할당하기
  1. 왼쪽 탐색 메뉴에서 IAM을 선택합니다.
  2. 권한 탭에서 액세스 권한 부여
    
    를 클릭합니다.
  3. 담당자 추가 > 새 담당자 아래에
    
    singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.com
    
    을 입력합니다.
  4. 역할 할당 아래에서 이전 단계에서 만든"Singular 제거 추적"을 선택합니다.
    
    최종 구성이 일치해야 합니다:
  5. 저장을클릭합니다

(레거시) HTTP API

Android에서 제거 추적을 설정하려면 다음과 같이 하세요:

Android SDK 7.x+를 연동합니다: 제거 추적은 Android SDK 버전 7.x 이상에서 사용할 수 있습니다. SDK 업그레이드에 대한 지침은 Android SDK 연동 가이드를 참조하세요.
AndroidManifest.xml을 수정합니다: Android SDK 제거 추적 가이드 세부 정보를 참조하세요.
발신자 ID와 서버 키를 추가합니다: Singular에서는 제거 추적을 활성화하기 위해 Google 프로젝트 번호와 서버 키가 필요합니다. 이 값을 검색하려면 다음과 같이 하세요:
- Firebase에서 콘솔로 이동을 선택하고 프로젝트를 선택합니다.
- 톱니바퀴 아이콘을 선택하고 프로젝트 설정 > 클라우드 메시징으로 이동합니다.
- Singular 계정에서 설정 > 앱으로 이동하여 제거 추적을 추적하려는 앱을 찾은 다음 편집을 선택합니다.
- 제거 추적 아래에서 프로젝트 번호(Firebase의 발신자 ID) 와 서버 키를 추가합니다 .
다음과 같이 앱에서 FCM을 구성합니다:
1. Firebase 콘솔에서 Firebase 프로젝트를 생성합니다.
2. 프로젝트 대시보드에서 Android 앱에 Firebase 추가를 선택합니다.
3. Android 앱의 패키지 ID를 입력합니다.
4. 구성 파일(google-services.json)을 다운로드하여 Android 프로젝트의 앱 모듈에 복사합니다.
5. 프로젝트 수준의 build.gradle 파일(><프로젝트>/build.gradle>)에 다음을 추가합니다:
```
buildscript {
   dependencies {
     // Add this line or latest version 
     classpath 'com.google.gms:google-services:3.1.0'
   }
 }
```
6. 앱 수준 build.gradle 파일(><프로젝트>/<앱 모듈>/build.gradle>)에 다음을 추가합니다:
```
// Add to the bottom of the file
apply plugin: 'com.google.gms.google-services'
```
7. 프로젝트를동기화합니다.
8. Android 코드에서 다음 서비스를 생성합니다:
```
public class FCMService extends FirebaseInstanceIdService {
    @Override
    public void onTokenRefresh() {
        super.onTokenRefresh();
        //now we will have the token                   
        String token = FirebaseInstanceId.getInstance().getToken();
    }
}
```
  onTokenRefresh 메서드는 알림을 전송하는 데 필요한 FCM 토큰을 가져옵니다.
9. Android 매니페스트 파일에 서비스를 추가합니다:
```
<service android:name=".FCMService">
 <intent-filter>
 <action android:name="com.google.firebase.INSTANCE_ID_EVENT"/
 </intent-filter>
</service>
```

이제 Singular는 업데이트된 버전의 애플리케이션을 보유한 사용자의 제거를 추적합니다.

알림 테스트하기

FCM 토큰을 제공하여 콘솔을 사용하여 알림을 테스트할 수 있습니다:

Screen_Shot_2017-12-27_at_4.56.12_PM.png

Android 제거 추적 설정

설정 지침

프로젝트 ID를 생성하고 구성하려면 다음과 같이 하세요.

알림 테스트하기