App Store Connect API 4.6: INSTALLS 보고서 중단, 어떻게 해야 하나요? 2026

판단: 새 INSTALLS 보고서를 기다리며 CI 작업을 반복 재실행하지 마세요. 2026년 11월 4일 공개된 App Store Connect API 4.6 변경에 따라 새 보고서 생성이 중단된 상태라면, 기존 보고서를 보존하고 다운로드 작업과 대시보드의 ‘자료 없음’ 처리를 조정해야 합니다. 과거 보고서의 다운로드 가능 범위와 다른 지표의 의미는 Apple 문서에서 각각 확인하세요.

이 글은 App Store Connect API 보고서 수집 작업을 관리하며 보고서 상태와 인증·네트워크·스크립트 문제를 구분해야 하는 개발자를 위한 내용입니다.
macOS CI 정기 작업의 성공·실패 조건을 고치려는 엔지니어도 참고할 수 있습니다.
출시 데이터 대시보드에서 누락을 0으로 오해하지 않게 해야 하는 담당자에게도 해당합니다.

마지막 업데이트: 2026년 11월 7일. 확인 기준은 Apple의 API 4.6 공개 안내와 App Store Connect API 변경 기록입니다. Apple이 보고서 생성 상태나 과거 자료 이용 조건을 변경하면 다시 확인해야 합니다.

새 보고서가 없을 때 먼저 구분할 항목

Apple의 API 4.6 공개 안내와 변경 기록을 기준으로 보면, 새 INSTALLS 보고서가 만들어지지 않는 상황을 곧바로 CI 장애라고 판단해서는 안 됩니다. 보고서 생성 상태의 변경과 요청 자체의 오류는 서로 다른 문제입니다. API 릴리스 변경에 따른 결과인지, 인증·권한·연결·요청 처리에서 생긴 문제인지 로그와 공식 문서로 나눠 확인하세요.

Apple은 판매 및 추세 보고서 인터페이스 문서에서 보고서 요청 방법을 설명하고, 별도의 보고서 이용 가능성 안내에서 보고서의 제공 범위를 안내합니다. 이 문서들을 기준으로 요청 대상과 이용 가능한 보고서 유형을 대조하세요. 요청이 정상 처리됐다는 사실만으로 새로운 INSTALLS 파일이 생성될 것이라고 기대하지는 마세요.

확인할 항목은 다음과 같습니다.

• 실행 로그에 인증 실패나 권한 부족을 나타내는 내용이 있는지 확인합니다.
• 요청에 사용한 보고서 유형과 기간, 계정 조건이 의도한 값인지 검토합니다.
• 네트워크 오류와 응답을 읽거나 저장하는 스크립트 오류를 보고서 부재와 따로 기록합니다.
• Apple의 최신 변경 기록에서 INSTALLS 생성 상태에 관한 안내가 있는지 확인합니다.

대시보드는 누락을 0으로 바꾸지 않아야 합니다

보고서 파일이 없다는 사실은 설치 횟수가 0이라는 뜻이 아닙니다. 수집 파이프라인이 누락을 숫자 0으로 변환하면 실제 데이터와 미수집 상태가 섞입니다. 이때 대시보드는 거짓 하락 추세를 그리고, 알림은 실제 사업 변화처럼 보이는 경고를 보낼 수 있습니다.

저장 단계에서 숫자 값과 자료 상태를 분리하세요. 예를 들어 값이 없는 날은 설치 횟수 필드에 0을 넣는 대신, 상태를 ‘보고서 없음’ 또는 ‘확인 필요’로 기록합니다. 이미 적재된 과거 자료는 그대로 유지하고, 새 자료가 없는 구간을 시각화에서 구별해야 합니다.

주의: 하위 집계나 내보내기 과정에서 빈 값이 자동으로 0으로 바뀌지 않는지 확인하세요. 대시보드에서만 표시를 고쳐도 데이터 웨어하우스나 알림 계산이 0을 계속 사용하면 잘못된 결과가 남습니다.

과거 INSTALLS 보고서는 별도로 확보하세요

새 보고서 생성 중단과 이전에 생성된 파일의 다운로드 가능성은 같은 조건이 아닙니다. 과거 자료가 API로 제공되는 기간과 계정별 범위는 Apple의 판매 및 추세 보고서 이용 가능성 안내에서 확인해야 합니다. 필요한 기간의 파일을 받을 수 있다면 팀이 관리하는 저장소에도 원본을 보관하세요. API에서 계속 받을 수 있을 것이라고 가정하고 아카이빙을 미루면, 이후 접근 조건이 달라졌을 때 복구가 어려워질 수 있습니다.

보관 파일에는 원본 데이터만 두지 말고 요청 기간, 보고서 유형, 수집 시각, 처리 결과도 함께 기록하세요. 이 메타데이터가 있어야 대시보드 값이 어디에서 왔는지 추적하고, 수집 시점 이후에 생긴 공백과 원래 보고서에 값이 없던 경우를 구분할 수 있습니다.

다른 지표를 INSTALLS의 대체값으로 취급하지 마세요

대체 데이터를 검토하기 전에 필요한 것이 설치 횟수인지, 사용자 획득인지, 앱 사용이나 삭제 같은 행동 정보인지 업무 정의부터 분명히 하세요. 이름이 비슷하거나 대시보드에서 같은 축에 놓을 수 있다는 이유만으로 지표가 서로 같다고 볼 수 없습니다.

Apple의 분석 지표 정의와 앱 설치 보고서 설명을 읽고 각 지표의 집계 기준과 포함 범위를 대조하세요. Platform App Installs 문서 역시 별도의 정의를 확인하는 자료이지, INSTALLS와 동등한 대체 보고서라고 단정할 근거는 아닙니다. Apple이 공식 대체 지표를 명시하지 않았다면 대시보드에서 서로 다른 지표를 분리하고 이름과 정의를 함께 표시하세요.

macOS CI 정기 작업을 새 상태에 맞게 조정하기

macOS CI 정기 작업에서 보고서가 없을 때 무한 재시도를 하지 않도록 결과 분류를 바꾸세요. 새 보고서 부재를 예상 가능한 결과로 기록하되, 인증·연결·파일 처리 실패는 별도의 오류로 남겨야 합니다. 그러면 운영자는 정책상 보고서가 없는 상태와 복구가 필요한 장애를 로그에서 구별할 수 있습니다.

작업을 수정할 때는 아래 순서로 확인하세요.

• [ ] Apple의 API 4.6 변경 기록과 보고서 이용 가능성 문서를 다시 확인합니다.
• [ ] 요청 대상, 실행 계정 권한, 인증 정보, 기간 조건을 로그에 남깁니다.
• [ ] 기존 보고서 요청으로 다운로드와 압축 해제, 저장 경로까지 검증합니다.
• [ ] 새 보고서가 없는 결과와 인증·네트워크·스크립트 오류에 서로 다른 상태를 부여합니다.
• [ ] 대시보드, 알림, 후속 계산에서 누락된 자료가 0으로 바뀌지 않는지 확인합니다.
• [ ] 실제 정기 작업 한 차례를 실행해 로그 보존과 오류 분류가 의도대로 작동하는지 확인합니다.

기존 자료 요청을 통한 검증은 읽기와 보관 경로가 동작하는지 확인하는 방법입니다. 실제 정기 작업 결과는 스케줄러와 오류 처리를 점검하는 데 도움이 됩니다. 어느 쪽도 새 INSTALLS 보고서가 앞으로 생성된다는 보장은 아니므로, 테스트 성공을 보고서 생성 재개로 해석하지 마세요. 원격 Mac을 정기적인 macOS 작업에 쓸지 검토한다면 UDPMac의 환경 안내에서 운영 방식과 접속 조건을 먼저 살펴볼 수 있습니다. API 작업 자체가 반드시 Mac에서 실행돼야 하는 것은 아닙니다.

작업 상태와 지표 선택을 비교하는 기준

첫 번째 표는 수집 작업 결과를 분류할 때 사용할 기준입니다. ‘적합’은 해당 처리 방법을 권장한다는 뜻이며, 보고서가 실제로 제공된다는 보장은 아닙니다.

두 번째 표는 INSTALLS 보고서를 다른 정보로 바꿔 보여줄지 결정할 때 참고하세요. 지표 정의가 다르면 동일한 계열로 이어 붙이지 말고, 별도 이름으로 제시해야 합니다.

FAQ

App Store Connect API 4.6 이후 새 INSTALLS 보고서가 생성되나요?

Apple의 API 4.6 변경 안내에 따라 새 INSTALLS 보고서가 더 이상 생성되지 않는 상태라면, 반복 재시도만으로 새 파일을 얻을 수 있다고 기대하지 마세요. 먼저 공식 변경 안내를 확인한 뒤 작업 결과를 ‘새 보고서 없음’으로 분류하세요. 인증이나 네트워크 문제가 함께 있는지는 별도 로그로 점검해야 합니다.

기존 INSTALLS 보고서는 API로 다시 내려받을 수 있나요?

기존에 생성된 보고서는 새 보고서 생성 여부와 별개의 문제입니다. Apple의 판매 및 추세 보고서 인터페이스와 보고서 이용 가능성 안내를 확인해 계정과 보고서 유형에 적용되는 다운로드 범위를 살펴보세요. API에서 아직 받을 수 있는 자료도 이용 조건이 바뀔 수 있으므로, 필요한 파일은 직접 받아 팀 저장소에 보관하는 편이 안전합니다.

새 INSTALLS 파일을 못 받은 것이 macOS CI 스크립트 오류라는 뜻인가요?

그렇다고 단정할 수 없습니다. 인증 정보, 권한 설정, 네트워크 연결, 요청 매개변수, 응답 처리 코드도 각각 확인해야 합니다. 최근 정상 실행 로그와 현재 실행을 비교하고, 과거 보고서 요청과 새 보고서 요청의 결과를 따로 기록하세요. 새 보고서가 없는 정상 결과를 실패로 취급해 재시도하는 정책은 공식 상태를 확인한 뒤 조정해야 합니다.

INSTALLS 보고서가 멈춘 뒤 대시보드의 과거 추세는 어떻게 보존하나요?

누락된 날짜를 설치 수 0으로 채우지 말고 ‘자료 없음’ 또는 ‘보고서 생성 중단 이후’로 표시하세요. 원본 보고서 파일과 수집 시각, 요청 조건을 함께 보관하면 이후 지표 정의를 검토할 때 유용합니다. 다른 분석 지표를 연결하더라도 설치 횟수와 같은 의미라고 단정하지 말고, 정의와 집계 기준을 확인해 별도 계열로 보여주세요.

실행 환경도 작업 방식에 맞춰 선택하세요

보고서 생성이 멈춘 문제는 Mac을 추가한다고 해결되지 않습니다. 현재 Linux나 다른 CI 환경에서 API 요청이 충분히 운영된다면 그 환경을 유지하고, 필요한 변경은 보고서 상태 분류와 자료 보관에서 처리하세요. 반대로 macOS 전용 도구가 포함된 정기 작업을 위해 Mac을 직접 구매하면 초기 장비 비용과 유지 관리 부담이 생기고, 자체 호스팅 장비는 보안·연결·가동 상태를 직접 관리해야 합니다. 일반 클라우드 환경은 macOS 전용 작업을 그대로 실행할 수 없는 경우도 있습니다.

macOS 환경이 필요한 기간이 한정돼 있다면 UDPMac 원격 Mac 대여와 직접 장비 운영을 비교해 볼 수 있습니다. 원격 환경은 장비 구매 없이 필요한 기간에 접근하는 선택지지만, 장기간 계속 실행되는 무거운 작업이나 물리 장치 연결이 필요한 경우에는 직접 보유한 Mac이 더 알맞을 수 있습니다. API 작업이 실제로 Mac을 요구하는지, 운영자가 유지 관리를 감당할 수 있는지부터 따져 UDPMac의 원격 Mac 이용 안내를 확인하세요.

자주 묻는 질문