Android 앱 구독 설정

Adjust가 Google과 통신하려면 일련의 서비스 인증 정보가 필요합니다. 다음은 Google Cloud 프로젝트를 플레이 콘솔에 연결하고, 서비스 계정을 사용하여 Adjust의 액세스를 승인하는 방법입니다.

  1. Google Play 계정에서 Android에 대한 실시간 개발자 알림을 설정합니다. 서버 알림을 설정하면 Google Play Store는 Adjust에 앱의 구독 업데이트를 알립니다. 이를 통해 Adjust는 구독 이벤트를 적시에 트리거할 수 있습니다.
  2. Google 서비스 계정에 대한 JSON 공개 키를 생성합니다. Google 서비스 계정을 Adjust에 연결하려면 JSON 키가 필요합니다.
  3. 서비스 계정에 파이낸셜 액세스를 부여합니다.
  4. Adjust에서 Google 서비스 계정을 연결합니다.

시작에 앞서

딥링크 생성 전에 알아야 할 사항은 다음과 같습니다.

성장 솔루션:

구독 기능은 Adjust 성장 솔루션의 일부로 이용하실 수 있습니다. 본 기능을 패키지에 추가하시려면 Adjust 담당자나 sales@adjust.com으로 문의하시기 바랍니다.

요구 사항

  • Google Play Console에서의 Account owner 권한
  • Google Cloud Console에서 주제, 구독 및 역할 할당을 생성할 수 있는 권한
  • Google 서비스 계정 인증 정보를 연결하기 위한 Adjust에서의 관리자, 편집자 또는 사용자 지정 편집자 권한

실시간 개발자 알림 설정

푸시 구독 생성

  1. Google Cloud 콘솔에서 Topic을 엽니다.

  2. 프로젝트를 선택합니다.

  3. 토픽 생성을 선택합니다.

  4. 토픽 ID를 입력하고 생성 을 선택합니다.

  5. 이제 왼쪽 탐색 창의 Pub/Sub에서 구독 을 선택합니다.

  6. 구독 생성 을 선택합니다.

  7. 구독 ID 를 입력합니다.

  8. Cloud Pub/Sub 토픽 선택 목록에서 4단계에서 생성한 주제를 선택합니다.

  9. 전송 유형 에서 푸시 를 선택합니다.

  10. 엔드포인트 URL 필드에 https://subscription.adjust.com/v3/playstore를 입력합니다.

  11. Retry policy 에서 Retry after exponential backoff delay 를 선택하고 다음을 입력합니다.

    • 최소 백오프 시간 - 10
    • 최대 백오프 시간 - 600

  12. 생성 을 선택합니다.

구독에 주체(principal) 추가

  1. 생성한 구독을 선택하고 주체 추가 를 선택합니다.
  2. 새 주체 필드에 google-play-developer-notifications@system.gserviceaccount.com 를 입력합니다.
  3. 역할 할당 목록에서 Pub/Sub 퍼블리셔를 선택합니다.
  4. 저장 을 선택합니다.

토픽 이름 값 복사

  1. Google Cloud 콘솔에서 Topic을 엽니다.
  2. 푸시 구독을 생성할 때 추가한 토픽을 선택하고, 토픽 이름의 값을 복사합니다.
    • 전체 토픽 이름을 보기 위해 (아래 화살표 아이콘)을 선택해야 할 수도 있습니다. 이후 (복사 아이콘)을 선택하여 토픽 이름의 값을 복사합니다.

이 값은 다음 단계에서 필요합니다.

앱에 대한 실시간 개발자 알림 활성화

  1. 구글 플레이 콘솔을 실행합니다.
  2. 앱을 선택합니다.
  3. 수익화 에서 수익화 설정 을 선택합니다.
  4. Google Play 결제 섹션 으로 스크롤 다운합니다.
  5. 알림 관리에서 실시간 알림 활성화 를 선택합니다.
  6. 토픽 이름 필드에 이전 단계에서 복사한 토픽 이름을 붙여넣기 합니다.
  7. 변경 내용 저장 을 선택합니다.

구독을 설정하려는 모든 앱에 대해 2~7단계를 반복합니다.

JSON 공개 키 생성

Google Play Android 개발자 API 활성화하기

  1. 구글 플레이 콘솔을 실행합니다.
  2. 기존 프로젝트를 선택하거나 새 프로젝트를 생성합니다.
  3. API & Services > Enabled APIs and services 를 선택합니다.
  4. + API 및 서비스 활성화 를 선택합니다.
  5. Google Play Android Developer API 를 검색하여 선택한 뒤, 활성화 를 선택합니다.
  6. 인증 정보 생성 을 선택합니다.
  7. 어느 API를 사용하고 계신가요? 를 선택하고 Google Play Android Developer API 를 선택합니다.
  8. 어떤 데이터에 액세스할 예정인가요? 을 선택하고, Application data 를 선택한 후 Next 를 선택합니다.
중요:

인증 정보가 Google Play Developer API에서 올바르게 작동하려면 최대 36시간이 소요될 수 있습니다.

서비스 계정 생성

서비스 계정을 생성하기 전에 Play Console에 제품을 추가하셨나요?

중요

서비스 계정을 생성하려면 다음의 단계를 수행하시기 바랍니다.

  1. 구글 플레이 콘솔을 실행합니다.

  2. 이전 단계에서 선택한 것과 동일한 프로젝트를 선택합니다.

  3. IAM & Admin > Service Accounts 를 엽니다.

  4. 서비스 계정 생성 을 선택합니다.

  5. Service account details 에 서비스 계정 이름을 입력합니다.

    • 서비스 계정 ID 필드 가 자동으로 입력됩니다. 본 이메일은 서비스 계정의 이메일 주소입니다.

  6. 생성 및 계속 을 선택합니다.

  7. 이 서비스 계정에 프로젝트에 액세스 권한 부여 (선택 사항) 에서 다음의 역할을 선택하고 계속 을 선택합니다.

    • 서비스 계정 키 관리자 - 서비스 계정 키를 생성하고 관리할 수 있습니다.
    • Pub/Sub 관리자 - 플랫폼 서버 알림을 활성화합니다.
    • 모니터링 뷰어 - 알림 대기열 모니터링을 허용합니다.

  8. 완료 를 선택하여 서비스 계정 페이지로 돌아갑니다.

Google API Console에서 Create Service Account를 선택합니다.

1/2

공개 키 인증 정보 생성

공개 키 인증 정보를 생성하려면 다음의 단계를 수행하시기 바랍니다.

  1. 구글 플레이 콘솔을 실행합니다.
  2. 이전 단계에서 선택한 것과 동일한 프로젝트를 선택합니다.
  3. IAM & Admin > Service Accounts 를 엽니다.
  4. 생성한 서비스 계정의 액션 에서 키 관리 를 선택합니다.
  5. 키 추가 > 새 키 생성 을 선택합니다.
  6. 키 유형 을 JSON 으로 선택한 후 생성 을 선택합니다.

서비스 계정에서 키 관리를 선택합니다.

1/3

파이낸셜 액세스 부여

서비스 계정에 파이낸셜 액세스를 부여하려면 다음의 단계를 수행하시기 바랍니다.

Google Cloud Console

  1. Google Cloud Console에서 이전 단계에서 선택한 것과 동일한 프로젝트를 선택합니다.
  2. IAM & Admin > Service Accounts 를 엽니다.
  3. 생성한 서비스 계정에서 이메일 값을 복사합니다.
    • 이 이메일은 다음 단계에서 필요합니다.

Google Play Console에서

  1. 구글 플레이 콘솔을 실행합니다.

  2. 사용자 및 권한 > 새 사용자 초대 를 선택합니다.

  3. 이전 단계에서 검색한 서비스 계정의 이메일 주소를 입력합니다.

  4. 앱 권한 아래에 앱을 추가합니다.

  5. 계정 권한에서 다음 권한을 선택합니다.

    • 앱 정보 보기(읽기 전용)
    • 파이낸셜 데이터 보기
    • 주문 및 구독 관리

  6. 사용자 초대 뒤 초대 전송 을 선택합니다.

Google Play Console의 API 액세스에서 액세스 부여를 선택합니다.

1/3

적절한 계정 권한이 없는 경우 본 옵션을 사용할 수 없습니다. 계정 소유자 또는 관리자에게 문의하시기 바랍니다.

Adjust에서 Google 서비스 계정 연결

Adjust에 Google 서비스 계정 인증 정보를 추가하려면 다음의 단계를 수행하시기 바랍니다.

  1. DataWorks 에서 Connections 을 선택합니다.
  2. + 새 연결 을 선택합니다.
  3. 파트너 에서 Google 서비스 계정을 선택합니다.
  4. 서비스 에서 구독 을 선택합니다.
  5. 인증 정보 파일 필드에 공개 키 인증 정보 생성 단계에서 다운로드한 JSON 파일을 업로드합니다.
  6. 연결 을 선택합니다.

➡️ 다음 단계: Adjust에서 앱에 대한 구독을 활성화합니다.