소스 - App Store Connect API

Prev Next

개요

App Store에서 보고서 데이터를 전송하는 설정 도움말 페이지입니다.

획득 가능한 데이터

App Store Connect API를 이용하여 데이터를 수집하고 있습니다.

'재무보고', '매출 및 트렌드'를 확인할 수 있습니다.
각각 App Store Connect의 '결제 및 재무 보고', '매출 및 트렌드'에서 다운로드할 수 있는 보고서와 동일한 보고서와 연동이 가능합니다.

매출 및 트렌드 도움말 페이지입니다.
재무보고 도움말 페이지입니다.

설정 항목

STEP1 기본 설정

품목명 필수 기본값 내용
App Store Connect API 연결 정보 - 미리 등록되어 있는 접속 정보 중 이번 전송 설정에 필요한 권한을 가진 접속 정보를 선택합니다.
API Endpoint - API의 접속 URL을 지정합니다.
입력 파일 형식 CSV/TSV 입력 파일의 형식을 지정해 주세요.
자세한 내용은 입력 파일 형식 설정을 참고하세요.
쿼리 파라미터 No - API 요청에 포함할 쿼리 파라미터를 지정할 수 있습니다.
파라미터의 종류는 아래의 쿼리 파라미터 종류를 참고하세요.
또한, 파라미터 값은 커스텀 변수를 이용하여 TROCCO의 데이터 적재 시 동적으로 설정값을 결정할 수도 있다.

쿼리 매개변수 종류

조회하는 보고서의 종류(API Endpoint의 URL)에 따라 지정할 수 있는 파라미터가 달라집니다.
자세한 내용은 공식 문서를 참고하세요.

재무 보고서(Finance Reports)

파라미터 이름 내용
filter[regionCode] 통화 단위를 지정할 수 있습니다. 코드에 대한 자세한 내용은 공식 문서를 참고하세요.
filter[reportDate] Apple Fiscal Calendar를 기반으로 가져오는 보고서의 날짜를 지정할 수 있습니다. YYYY-MM 형식으로 지정해 주세요.
filter[reportType] 보고서 유형으로 FINANCIAL 또는 FINANCE_DETAIL을 지정할 수 있습니다.
filter[vendorNumber] 벤더 번호를 지정할 수 있습니다. 자세한 내용은 공식 문서를 참고하세요.

매출 및 트렌드 보고서(Sales and Trends Reports)

파라미터 이름 내용
filter[frequency] 보고서의 수집 간격을 지정할 수 있습니다.
DAILY, WEEKLY, MONTHLY, YEARLY를 지정할 수 있습니다.
filter[reportDate] 조회할 보고서의 날짜를 지정할 수 있습니다.
YYYY-MM-DD 형식으로 지정해 주세요.
자세한 내용은 공식 문서를 참고하세요.
filter[reportSubType] 보고서의 하위 유형으로 SUMMARY, DETAILED, OPT_IN을 지정할 수 있습니다.
filter[reportType] 보고서 유형으로 SALES, PRE_ORDER, NEWSSTAND, SUBSCRIPTION, SUBSCRIPTION_EVENT, SUBSCRIBER를 지정할 수 있다.
filter[vendorNumber] 벤더 번호를 지정할 수 있습니다.
자세한 내용은 공식 문서를 참고하세요.
filter[version] 보고서 버전을 지정할 수 있습니다.
자세한 내용은 공식 문서를 참고하세요.