본문으로 건너뛰기

Android 앱 연동

Android 앱을 Monetai와 연동하여 Google Play Store에서 발생하는 수익을 실시간으로 추적할 수 있습니다.

연동 방법​

Android 앱 연동은 다음 두 가지 방법으로 설정할 수 있습니다:

방법 1: 대시보드 온보딩 섹션​

방법 2: 설정 메뉴​

연동 과정​

Android 앱 연동은 3단계로 구성되어 있으며, 각 단계별로 세부 과정을 진행합니다.

1단계: 앱 패키지 연동​

1-1. 패키지 이름 입력​

Google Play Console에서 앱의 패키지 이름을 가져와서 입력합니다.

설정 방법:

  1. Google Play Console에 로그인
  2. Monetai를 연결할 앱 선택
  3. 앱의 패키지 이름 복사 (예: com.example.app)
  4. Monetai 대시보드에 입력

Android 패키지 이름 입력

2단계: Google Service Account 생성 및 키 발급​

Google Play Store API 접근을 위한 서비스 계정을 생성하고 권한을 설정합니다.

2-1. Google Developer API 활성화​

설정 방법:

  1. Google Play Console에서 프로젝트 선택 또는 신규 프로젝트 생성
  2. Google Play Android Developer API 검색
  3. [사용 설정] 버튼 클릭

Google Developer API 활성화

2-2. 서비스 계정 생성​

설정 방법:

  1. Google Cloud Console에서 [IAM & 관리자] > [서비스 계정] 이동
  2. [서비스 계정 만들기] 클릭 서비스 계정 생성
  3. 서비스 계정 이름 입력 후 [만들고 계속] 클릭 4. [이 서비스 계정에 프로젝트에 대한 액세스 권한 부여] 단계에서 [Pub/Sub Admin] 역할 추가 서비스 계정 권한 확인

2-3. 서비스 계정 키 다운로드​

설정 방법:

  1. 생성한 서비스 계정의 작업 버튼(⋮) 클릭
  2. [키 관리] 선택 서비스 계정 키 다운로드
  3. [키 추가] > [새 키 만들기] 선택
  4. 키 타입을 JSON으로 선택 후 생성 및 다운로드

2-4. Google Play Console 권한 부여​

설정 방법:

  1. Google Play Console에서 [사용자 및 권한] 메뉴로 이동
  2. 생성한 서비스 계정 이메일 주소 입력
  3. [권한] 아래 [계정 권한] 에서 다음 3가지 권한 설정:
    • 앱 정보 보기 및 일괄 보고서 다운로드 (읽기 전용)
    • 재무 데이터, 주문, 구독 취소 설문 응답 보기
    • 주문 및 구독 관리
  4. [사용자 초대] 클릭 Google Play Console 권한 부여

2-5. 서비스 계정 JSON 등록​

설정 방법:

  1. 2-3단계에서 다운로드한 Service Account JSON 파일의 내용을 복사
  2. Monetai 대시보드에 붙여넣기
  3. [권한 확인] 버튼 클릭하여 모든 권한이 올바르게 설정되었는지 확인

3단계: Real-time Developer Notifications 설정​

Google의 Real-Time Developer Notifications(RTDN)를 설정하여 실시간 구매 정보를 수신합니다.

3-1. Pub/Sub API 활성화​

설정 방법:

  1. Google Cloud Console로 이동
  2. 상단의 프로젝트 선택 메뉴에서 서비스 계정을 생성했던 동일한 프로젝트가 선택되어 있는지 확인
  3. Pub/Sub API가 비활성화 상태라면 [사용 설정] 버튼 클릭 Pub/Sub API 활성화

3-2. Pub/Sub Topic 선택 및 연결​

설정 방법:

  1. Monetai 대시보드로 이동
  2. 기존에 Google 실시간 개발자 알림을 받고 있는 토픽이 있다면 해당 토픽 선택
  3. 없을 경우 [새 토픽 생성] 클릭하여 새 토픽 생성
  4. 토픽 선택 후 [연결] 버튼 클릭

💡 타사 서비스 사용 시 (Adapty 등)

Adapty와 같은 타사 서비스를 사용하고 있어서 기존 Pub/Sub 토픽을 찾을 수 없는 경우, Pub/Sub 토픽 대신 URL로 연동할 수 있습니다.

Adapty 사용자의 경우:

  1. Adapty 대시보드로 이동
  2. 앱 설정 > Google Play RTDN topic name 메뉴로 이동
  3. "URL for forwarding raw Google events" 필드 찾기
  4. Monetai에서 제공하는 웹훅 URL을 해당 필드에 입력

자세한 내용은 Adapty RTDN 문서를 참조하세요.

3-3. Google Play Console에 토픽 등록​

💡 URL 연동 사용자 참고사항

3-2단계에서 설명한 URL을 통해 연동하는 경우, 이 3-3단계는 건너뛸 수 있습니다.

설정 방법:

  1. Google Play Console에서 Monetai를 연결할 앱의 대시보드로 이동
  2. 사이드바의 [수익화] > [수익화 설정] 선택
  3. [실시간 개발자 알림] 의 [Topic name] 필드에 Monetai에서 제공하는 Topic ID 복사하여 붙여넣기
  4. [Notification content] 를 "Subscriptions, voided purchases, and all one-time products" 로 선택 후 저장

Google Play Console 토픽 등록

3-4. 테스트 알림 확인​

설정 방법:

  1. [Topic name] 필드 아래의 [테스트 알림 보내기] 버튼 클릭
  2. Monetai 대시보드에서 [새로고침] 버튼 클릭하여 알림 수신 확인
  3. "수신 완료" 메시지가 표시되면 연동 완료

테스트 알림 전송

지원하는 알림 유형​

Monetai는 Real-Time Developer Notifications를 통해 다음 이벤트들을 실시간으로 추적합니다:

구독 관련​

  • 구독 무료 체험 시작
  • 유료 구독 시작
  • 유료 구독 갱신
  • 환불

연동 확인​

연동이 완료되면 다음과 같은 방법으로 확인할 수 있습니다:

  • 테스트 알림: Google Play Console에서 테스트 알림 전송 후 수신 확인

문제 해결​

자주 발생하는 문제​

Q: 패키지 이름을 찾을 수 없습니다 A: Google Play Console에서 앱을 선택한 후, 앱 정보에서 패키지 이름을 확인할 수 있습니다.

Q: 서비스 계정 권한 확인에 실패합니다 A: 다음 사항들을 확인해 주세요:

  • Google Play Android Developer API가 활성화되었는지
  • 서비스 계정에 Pub/Sub Admin 역할이 부여되었는지
  • Google Play Console에서 서비스 계정에 올바른 권한이 부여되었는지

Q: 테스트 알림이 수신되지 않습니다 A: 다음 사항들을 확인해 주세요:

  • Pub/Sub API가 활성화되었는지
  • 토픽이 올바르게 연결되었는지
  • Google Play Console에 토픽이 등록되었는지

지원​

연동 과정에서 문제가 발생하면 support@monetai.io에 문의해 주세요.

다음 단계​

Android 앱 연동이 완료되면 다음 단계로 진행하세요: