다차원 보고서의 CSV 다운로드
광고 성과 파일은 네이버 광고주센터의 다차원 보고서에서 CSV로 내려받거나, 대용량 다운로드 보고서에서 생성이 완료된 파일을 받을 수 있습니다. 다차원 보고서는 조회한 분석 결과를 다운로드하는 방식이며, 대용량 보고서는 유형과 기간을 선택해 생성을 신청하는 방식입니다.
다차원 보고서의 경로는 ‘광고주센터 → 검색광고 → 보고서 → 다차원 보고서’입니다. 보고서를 열어 결과 표를 표시한 다음 화면 상단의 ‘다운로드’를 클릭합니다. 공식 안내는 조회된 데이터가 있을 때만 이 버튼이 활성화된다고 설명합니다. 보고서 화면을 열었다는 것만으로 다운로드 조건을 갖춘 것은 아닙니다.
| 다운로드 구분 | 파일을 받는 위치 | 제공 형식 |
|---|---|---|
| 다차원 보고서 조회 결과 | 다차원 보고서 화면 상단 | CSV |
| 완료된 대용량 보고서 | 대용량 보고서 다운로드 탭의 신청 내역 | TSV |
CSV에는 현재 보고서에 표시된 차원과 지표가 그대로 포함됩니다. 화면에 표시한 항목과 무관하게 모든 분석 항목이 추가되는 파일이라고 해석하지 않습니다. 열 설정과 필터를 이용한 성과 분석은 파일을 받는 절차와 구별합니다.
큰 데이터는 다운로드가 비동기로 처리될 수 있습니다. 비동기는 다운로드 요청에 대한 처리가 별도로 진행된다는 뜻입니다. 이 경우 안내된 확인 위치는 ‘대용량 다운로드 보고서’ 화면입니다. 그 화면에서 처리 상태를 확인하고 파일을 내려받습니다. 도움말은 비동기 처리로 전환되는 데이터 건수나 파일 크기를 숫자로 정하지 않습니다.
대용량 보고서의 유형과 기간 선택
‘광고주센터 → 검색광고 → 보고서 → 대용량 다운로드 보고서’에는 ‘광고 정보 일괄 다운로드’와 ‘대용량 보고서 다운로드’ 탭이 있습니다. 통계 지표가 포함된 보고서를 신청하는 곳은 후자입니다. 같은 메뉴 아래에 있다는 이유로 광고 정보 일괄 다운로드를 성과 파일 신청 위치로 선택하지 않습니다.
대용량 보고서 다운로드 탭 상단에는 보고서 유형·분석 단위·기간을 선택하고 ‘생성요청’을 클릭하는 영역이 있습니다. 데이터 변경 관련 안내도 상단에 표시됩니다. 신청 내역 목록은 그 아래에 있어, 새 파일을 요청하는 영역과 요청한 파일의 진행 상태를 읽는 영역을 구별할 수 있습니다.
- 대용량 다운로드 보고서 메뉴에서 ‘대용량 보고서 다운로드’ 탭을 선택합니다.
- 다운로드 항목에서 필요한 보고서 유형을 선택합니다.
- 조회할 기간을 선택하고 ‘생성요청’을 클릭합니다.
신청 도움말의 유형 목록에는 쇼핑검색 관련 보고서와 타게팅 관련 보고서가 함께 나옵니다. 쇼핑검색 쇼핑브랜드형 상품별 성과·전환 보고서가 목록에 있다는 사실을 병원 플레이스광고의 보고서 이름으로 옮기지 않습니다. 실제로 받으려는 광고 성과에 해당하는 유형인지를 다운로드 항목에서 확인합니다.
기간을 선택하지 않으면 전일 데이터로 자동 생성됩니다. 직접 선택할 수 있는 기간은 전일부터 최대 1년까지이며, 도움말이 밝힌 최대 제공 기간도 최근 1년입니다. 기간을 비워 두고 요청한 파일을 장기간의 성과 합계로 읽으면 기본값과 어긋납니다. 전일 자료가 목적이라면 기본값을, 여러 날짜의 자료가 목적이라면 선택한 시작·종료 일자를 기준으로 신청합니다.
신청이 끝나면 목록에 보고서가 추가됩니다. 요청 ID는 신청한 보고서의 식별 번호이고, 보고서종류는 선택한 유형입니다. 시작 일자와 종료 일자는 조회 기간을 나타내며, 생성자는 신청한 사용자입니다. 생성 시점은 파일이 생성된 시점이므로 조회 기간의 종료 일자와 같은 뜻으로 읽지 않습니다.
완료 상태와 TSV 열 순서
신청 내역의 상태는 다음과 같이 구분됩니다. 보고서가 목록에 추가됐다는 사실과 다운로드할 수 있다는 조건은 다릅니다. ‘완료’ 상태인 행에 다운로드가 표시된다는 안내에 따라 진행합니다.
| 상태 표시 | 공식 안내의 의미 |
|---|---|
| 생성중 | 보고서 생성 진행 |
| 완료 | 생성 완료 및 다운로드 가능 |
| 데이터 변경됨 | 생성 후 지표 변경으로 다운로드 불가 |
| 실패 | 보고서 생성 실패 |
완료된 행의 ‘다운로드’를 클릭하면 보고서 정보를 확인하는 순서로 이어집니다. 요청 ID·종류·기간·생성 시점·용량을 확인한 다음 다시 ‘다운로드’를 클릭해 파일을 저장합니다.
받은 데이터는 탭으로 열을 구분하는 텍스트 파일인 TSV입니다. 행 구분자는 CRLF이고, 문자열 인코딩은 UTF-8입니다. 파일을 다른 프로그램으로 읽을 때도 이 사양을 기준으로 설정합니다. 다차원 보고서의 CSV 다운로드 안내와 대용량 보고서의 TSV 제공 안내를 하나의 파일 형식으로 합치지 않습니다.
대용량 파일에는 열의 명칭이 표시되지 않습니다. 숫자만 보고 어느 열이 광고비나 전환 지표인지 추정하지 않고, 사양서에 제시된 열 순서에 맞춰 각 열의 정보를 확인합니다. 보고서 유형을 확인한 뒤 그 유형의 사양을 읽는 이유도 여기에 있습니다. 열 이름이 없는 제공 형식을 곧바로 파일 손상으로 판단하지 않습니다.
생성 후 48시간 이내에 지표가 변경되면 ‘데이터 변경됨’ 상태로 표시되고 다운로드할 수 없습니다. 해당 안내를 확인한 다음 보고서를 다시 신청합니다. 보고서 지표는 생성 시점으로부터 48시간 경과 후 최종 확정되므로, 확정 데이터가 필요하면 그 뒤 재신청하도록 완료된 보고서 도움말이 권장합니다.
파일의 열을 읽는 방법과 그 열에 전환이 집계되는 조건은 구별합니다. 전환 항목의 측정 조건까지 필요하다면 병원 검색광고 전환 추적을 참고할 수 있습니다.
보고서 다운로드 자주 묻는 질문
대용량 보고서의 하루 신청 한도를 넘으면 언제 다시 신청할 수 있나요?
신청 도움말은 하루 한도 초과 안내가 표시되면 다음 날 다시 신청할 수 있다고 밝힙니다. 안내 문구는 ‘하루 신청 한도를 초과했습니다’입니다. 이 문서는 한도가 몇 회인지 숫자를 제시하지 않으므로 임의로 신청 가능 횟수를 정하지 않습니다.
대용량 보고서의 Cost에는 부가가치세가 포함되나요?
신청 안내에 따르면 대용량 보고서의 모든 보고서에서 Cost, 즉 광고비 항목은 부가가치세를 포함합니다. 다만 2026년 3월 30일 이전 값은 부가가치세 미포함이라고 명시합니다. 해당 날짜 이전 자료까지 읽는다면 이 예외를 함께 적용하며, 과거 값에도 현재의 포함 기준이 동일했다고 해석하지 않습니다.
대용량 보고서 목록에 ‘저장된 보고서 형식이 없습니다’가 표시되는 이유는 무엇인가요?
탭 구성 도움말은 신청한 내역이 없을 때 이 문구가 표시된다고 설명합니다. 보고서 목록의 신청 내역에 관한 안내입니다. 이 문구만으로 광고 집행 실적이 없거나 통계가 삭제됐다고 판단할 근거는 없습니다. 파일 생성 실패를 뜻하는 상태 표시와도 구별합니다.