Apple App Store 연결
올바른 역할의 App Store Connect API 키를 만들고, 추가하고, 앱을 고르세요.
Apple은 리포팅에 로그인 팝업을 사용하지 않습니다. App Store Connect에서 API 키를 만들어 한 번 다운로드하고, 그 정보를 Revenue Sensor에 붙여넣습니다. 콘솔에서 이 소스의 이름은 Apple IAP입니다.
시작하기 전에
- 키를 만들 수 있도록 App Store Connect의 Account Holder 또는 Admin 권한.
- Vendor Number. App Store Connect → Reports → Payments and Financial Reports에서 확인합니다. 왼쪽 위, 계정 이름 아래에 표시됩니다.
API 키 만들기
- 1
Integrations 키 페이지 열기
App Store Connect → Users and Access → Integrations → App Store Connect API.
- 2
키 생성
Active 옆의 +를 누르고 “Revenue Sensor”처럼 알아볼 수 있는 이름을 키에 붙이세요.
- 3
리포팅 역할 부여
Access에서 Sales, Finance 또는 Admin을 고르세요. 모두 Revenue Sensor가 가져오는 Sales and Trends 리포트를 읽을 수 있습니다. 정확한 App Store Connect 숫자까지 제공하는 것은 Admin뿐입니다(아래 참조). Developer나 App Manager 권한만 있는 키는 수익을 읽을 수 없습니다.
- 4
.p8 파일 다운로드
Apple은 비공개 키를 딱 한 번만 다운로드하게 합니다. 페이지를 떠나기 전에 안전한 곳에 저장하세요. 잃어버렸다면 새 키를 생성하고 새 Key ID와 .p8 파일을 사용하세요.
단연 가장 흔한 실패
수익이 비어 있거나 계정에 “Your API key needs the Sales role”이 표시된다면, 원인은 거의 항상 키의 역할입니다. App Store Connect에서 키에 Sales 또는 Finance 역할을 준 뒤 다시 연결하세요. Vendor Number가 키와 같은 App Store Connect 계정에 속하는지도 확인하세요.
자격 증명 추가
- Issuer ID: App Store Connect API 키 페이지 맨 위에 표시됩니다. 모든 키에 동일합니다.
- Key ID: 만든 키의 행에 표시됩니다.
- 비공개 키: 다운로드한 .p8 파일입니다. 업로드하거나 끌어다 놓으세요. 암호화되어 저장되며 다시 표시되지 않습니다.
- Vendor Number: Payments and Financial Reports에서 확인합니다.
앱 선택
Revenue Sensor는 키가 볼 수 있는 게시된 앱을 나열합니다. 추적할 앱을 선택하세요. 선택한 앱만 동기화됩니다.
가져오는 데이터
수익은 Apple의 일별 Sales summary 리포트의 판매 수량에 Developer Proceeds를 곱한 값입니다. Proceeds는 Apple이 수수료와 징수한 세금을 뺀 뒤 지급하는 금액이므로, 이 소스의 수익 기준은 Payout뿐입니다. 환불은 수량이 음수인 행으로 들어오므로 Apple이 처리한 날에 차감됩니다. 다운로드와 환불도 같은 리포트에서 가져옵니다.
리포팅 지연
Apple은 하루가 끝난 뒤 그날의 판매 리포트를 발행하므로 오늘 데이터는 아직 보이지 않습니다. Apple이 다시 집계하면서 최근 며칠은 조금 바뀔 수 있으며, 동기화할 때마다 최근 14일을 다시 읽습니다.