본문으로 건너뛰기

iOS 앱 연동

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

연동 방법​

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

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

방법 2: 설정 메뉴​

연동 과정​

iOS 앱 연동은 총 3단계로 구성되어 있으며, 약 5분 이내에 완료할 수 있습니다.

1단계: 앱 정보 입력​

App Store Connect에서 앱의 기본 정보를 가져와서 입력합니다.

필요한 정보​

  • 번들 ID (Bundle ID): 앱의 고유 식별자
  • Apple ID: App Store Connect에서의 앱 ID

설정 방법​

  1. App Store Connect에 로그인
  2. [앱] 으로 이동하여 Monetai를 연결할 앱 선택
  3. 왼쪽 메뉴에서 [일반 정보] > [앱 정보] 선택
  4. [번들 ID] 와 [Apple ID] 복사하여 Monetai 대시보드에 입력

iOS 앱 정보 입력

2단계: 앱 공유 암호 설정​

App Store Server Notifications를 위한 인증 정보를 설정합니다.

설정 방법​

  1. [앱 정보] 의 [앱 공유 암호] 섹션에서 [관리] 선택
  2. [공유 암호] 복사
  3. Monetai 대시보드에 입력

중요: 앱 공유 암호는 App Store Server Notifications의 인증에 사용되므로 안전하게 보관해야 합니다.

iOS 앱 공유 암호 설정

3단계: 서버 알림 URL 등록​

App Store에서 실시간 구매 정보를 받기 위한 서버 알림을 설정합니다.

설정 방법​

  1. Monetai 대시보드에서 제공하는 Apple Server Notification URL 복사
  2. App Store Connect의 [앱 정보] > [App Store 서버 알림] 으로 이동
  3. 복사한 URL을 다음 두 필드에 모두 입력:
    • Production Server URL
    • Sandbox Server URL
  4. Notification 버전을 Version 2 notifications로 설정

iOS 서버 알림 URL 등록

지원하는 알림 유형​

Monetai는 App Store Server Notifications V2를 통해 다음 이벤트들을 실시간으로 추적합니다:

구독 관련​

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

연동 확인​

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

  • 알림 수신 확인: 실시간으로 구매 정보가 수신되는지 확인

문제 해결​

자주 발생하는 문제​

Q: 번들 ID를 찾을 수 없습니다 A: App Store Connect에서 앱을 선택한 후, 왼쪽 메뉴의 [일반 정보] > [앱 정보] 에서 확인할 수 있습니다.

Q: 앱 공유 암호가 표시되지 않습니다 A: App Store Connect에서 해당 앱에 대한 관리자 권한이 필요합니다. 권한을 확인해 주세요.

Q: 서버 알림이 수신되지 않습니다 A: URL이 정확히 입력되었는지, 그리고 Production과 Sandbox URL 모두 설정되었는지 확인해 주세요.

지원​

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

다음 단계​

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