View in English

App Store Connect 분석 도움말

지원 / App Store Connect 분석 / 개요 / 분석 보고서 API

개요

분석 보고서 API

개요

“분석 보고서 API(Analytics Reports API)”를 사용하면 App Store Connect 분석 데이터를 대량으로 내보내어 오프라인 분석을 수행하고, App Store 실적을 자체 데이터 시스템에 통합할 수 있습니다.

전체 문서 확인하기.

분석 보고서는 개인정보를 보호함과 동시에 App Store Connect에서 세분화된 데이터를 제공합니다. 이러한 보고서를 사용자화 분석, 보고 및 자동화에 사용할 수 있습니다.

  • 데이터 형식. 보고서는 대부분의 데이터 처리 도구로 쉽게 수집할 수 있는 표준 형식인 탭으로 구분된 압축된 텍스트 파일(.txt.gz)로 제공됩니다.

  • 액세스 및 역할. 보고서에 액세스하려면 적절한 역할의 App Store Connect API 키가 필요합니다. 최초로 새로운 “분석 보고서” 유형을 요청하는 경우, “관리” 역할이 필요합니다. 보고서 유형이 요청되면, “판매” 및 “보고서” 또는 “재정 관리” 역할의 API 키를 사용하여 생성된 보고서를 다운로드할 수 있습니다.

  • 초기 설정. 두 가지 유형을 요청할 수 있습니다. ONGOING 요청은 갱신형(일별, 주별, 월별) 보고서를 생성하며, ONE_TIME_SNAPSHOT은 사용할 수 있는 모든 과거 데이터를 포괄적으로 정리하여 제공합니다. ONGOING 보고서를 요청하면 약 24에서 48시간 후에 첫 번째 보고서를 받게 됩니다.

  • 데이터 완전성. 특정 날짜의 데이터는 보고 날짜로부터 2일이 경과하면 완전한 것으로 간주됩니다. 데이터 완전성에 대해 더 알아보기 .

사용할 수 있는 보고서 카테고리

분석 보고서는 여러 카테고리로 그룹화되며, 각 카테고리는 앱 수명 주기의 각기 다른 부분에 중점을 둡니다.

App Store 참여도

이 보고서는 사람들이 App Store에서 앱을 발견하고 상호작용을 하는 방식을 보여줍니다.

  • App Store 추천 및 참여도 보고서

    제품 페이지, 스토어 시트 및 앱 내 이벤트에 관련된 노출 수, 페이지 조회 수 및 탭 수에 관한 상세 데이터입니다. 여기에는 이벤트 유형, 페이지 유형, 소스 유형과 집계된 수 등의 관점이 포함됩니다.

  • App Store 웹 미리보기 보고서

    사용자가 웹에서 앱의 제품 페이지 및 “앱 내 이벤트”에 참여한 방식에 대한 인사이트를 제공합니다.

App Store 상거래

해당 보고서는 다운로드, 사전 주문 및 구입에 중점을 둡니다.

  • App Store 다운로드 보고서

    App Store에서 앱이 다운로드되는 빈도를 측정합니다.

  • App Store 사전 주문 보고서

    앱의 사전 주문 및 취소에 관련된 세부 사항 관련 내용을 다룹니다.

  • App Store 구입 보고서

    구매 유형, 콘텐츠 이름, 매출, 수익금 및 유료 사용자를 포함하는 수익 및 구매 데이터와 다운로드 소스를 포함합니다.

  • 구독 이벤트

    프로모션 시작, 프로모션 갱신, 유료로 전환, 유료 갱신, 자발적 또는 비자발적 취소 등 구독 주기 변경에 대한 세부 사항 관련 내용을 다룹니다. 구독 이벤트를 다운로드 소스에 다시 할당할 수 있는 기능이 포함됩니다.

  • 구독 상태

    총 유료 구독 수, 무료 체험, 유료 프로모션, 청구 문제가 있는 구독 등 App Store에서 활성화되거나 이탈된 구독에 대한 세부 사항 관련 내용을 다룹니다. 구독 상태를 다운로드 소스에 다시 할당할 수 있는 기능이 포함됩니다.

참고. 이 보고서는 기존의 “판매 및 추세” 구독 보고서를 대체하여, 개인정보를 보호하는 상태에서 손쉽게 다운로드와 구독의 연관성을 확인할 수 있게 되었습니다.

앱 사용

이 보고서는 사용자가 앱을 다운로드한 후 상호작용을 하는 방식을 이해하는 데 도움이 됩니다. 사용 데이터는 진단 및 사용 정보 공유에 동의한 사용자의 데이터만 수집합니다.

개인정보 및 데이터 사용 가능 여부

분석 ”보고서”는 사용자의 개인정보를 보호할 수 있도록 설계되었습니다. 데이터는 개인 식별을 방지하기 위해 개인 정보 보호 향상 기술을 사용하여 집계 및 처리됩니다. 표준 보고서에는 개별 사용자를 쉽게 식별할 수 있는 필드가 생략되어 있습니다. 추가 필드가 포함된 상세 보고서는 추가적인 보호 장치가 적용됩니다. 예를 들어 임곗값을 사용하여 5명 미만의 사용자 또는 5명의 고유 기기의 데이터가 있는 행은 생략합니다. 일부 사용 보고서는 최소한 임곗값에 도달하지 않는 경우 생성되지 않습니다. 즉, 활동량이 적거나 새로운 기능이 포함된 경우 데이터가 표시되지 않을 수 있습니다. 또한, 지표에 소량의 통계적 노이즈를 추가하여, 개별 사용자 활동의 리버스 엔지니어링을 방지함과 동시에 규모의 정확성을 유지합니다.