업로드 파일 형식

CSV 가져오기 파일을 만들고 포맷하는 방법을 알아보세요.

이 도움말에는 애널리틱스에 업로드할 파일 만들기 및 포맷에 대한 팁이 나와 있습니다. 이 파일은 올바르게 포맷해야 하며, 그렇지 않으면 업로드 오류가 발생할 수 있습니다.

이 도움말에 나와 있는 내용은 다음과 같습니다.

일반적인 고려사항

  1. 데이터 파일은 CSV 형식(쉼표로 값을 구분하는 형식)으로 업로드해야 합니다.
  2. CSV 파일의 헤더는 타겟 데이터 세트의 스키마와 정확히 일치해야 합니다. 열의 순서는 스키마에서 지정한 순서와 동일해야 하며, 모든 열 이름에서 내부 ga. 측정기준 또는 측정항목 이름을 사용해야 하며, 디스플레이 이름(예: ga:source, 소스가 아님)을 사용해서는 안 됩니다.
  3. 업로드된 데이터는 올바르게 포맷해야 합니다. 자세한 내용은 아래를 참조하세요.

업로드 파일 만들기

자유롭게 선택하여 사용자에게 맞는 방법을 사용할 수 있지만, 텍스트 편집기를 사용하거나 스프레드시트 애플리케이션을 사용하는 간단한 방법으로 업로드 파일을 만들 수 있습니다. 업로드 파일을 만드는 방법에 관계없이 업로드 파일 헤더를 만들려면 데이터 세트 스키마가 있어야 합니다.

스키마 가져오기

데이터 세트를 수정하거나 스키마 가져오기 버튼을 클릭하여 데이터 세트의 스키마를 복사하거나 다운로드할 수 있습니다.

데이터 세트 스키마를 가져오는 방법은 다음과 같습니다.
  1. Google 애널리틱스에 로그인합니다.
  2. 관리를 클릭한 후 데이터를 업로드하려는 속성으로 이동합니다.
  3. 속성 항목에서 데이터를 보관할 데이터 세트가 포함된 속성을 선택합니다.
  4. 데이터 가져오기를 클릭합니다.
  5. 타겟 데이터 세트의 이름 링크를 클릭합니다.
  6. 페이지 하단에 있는 스키마 가져오기 버튼을 클릭합니다. 이렇게 하면 아래의 대화상자가 표시됩니다.

텍스트 편집기 이용하기

텍스트 편집기를 이용하여 업로드 파일을 만들려면 스키마를 복사해서 새 파일의 첫 번째 줄에 붙여넣으세요. 그런 다음 이 헤더 아래에 데이터를 한 행에 하나씩 추가할 수 있습니다.

편집기에서 일반 텍스트 파일을 생성하는지 확인하세요. 파일을 명확하게 일반 텍스트(.txt)로 저장하지 않으려면 서식 있는 텍스트 편집기(예: Microsoft Word)를 사용해서는 안 됩니다. 서식 있는 텍스트 형식에는 가져오기 오류를 발생시킬 수 있는 추가 형식과 제어 문자가 포함되어 있습니다.

스프레드시트 이용하기

업로드 데이터용으로 스프레드시트를 사용하려면 위에 나온 단계에 따라 데이터 세트 스키마를 가져온 다음 스키마 템플릿 다운로드 버튼을 클릭하세요. 이렇게 하면 다운로드 디렉토리에 스키마 헤더가 들어갑니다. 그런 다음 자주 사용하는 스프레드시트에서 스키마를 열 수 있습니다. 스프레드시트의 가져오기 기능을 이용해 업로드할 데이터를 가져오세요. 파일을 업로드할 준비가 되면 스프레드시트 프로그램의 다음 이름으로 저장이나 내보내기 기능을 이용해 CSV를 출력 형식으로 선택하세요.

업로드 데이터 포맷

데이터 가져오기에서는 업로드 파일의 각 줄에 단일 조회에 대한 정보가 들어갑니다. 이 조회를 구성하는 개별 측정기준과 측정항목이 쉼표로 서로 구분됩니다. 파일에서 각 줄의 끝에는 줄바꿈이 적용됩니다. 업로드할 실제 데이터 안에 쉼표가 있으면 해당 데이터를 따옴표 안에 넣어야 합니다. 콘텐츠 오류가 발생하는 가장 큰 원인 중 하나는 업로드된 파일에서 쉼표, 따옴표, 줄바꿈 문자를 잘못 사용하는 것입니다. 따라서 데이터 가져오기에서 이러한 기능을 처리하는 방식을 이해하면 나중에 문제 해결에 도움이 됩니다.

쉼표

이름에서 짐작할 수 있지만 CSV 파일에서는 쉼표를 통해 새 셀이 시작됩니다. 즉, 데이터 가져오기에서 이스케이프되지 않은 쉼표가 확인되면 새로운 열 항목을 시작하는 것으로 가정합니다. 아래는 올바르게 포맷된 데이터의 예입니다.

abc123,29.99,Blue,XXL 
def345,100,Red,M
ghi678,1035.20,Green,S

이 경우에는 데이터 가져오기에서 데이터의 4개의 열을 확인합니다.

abc123 29.99 청색 XXL
def345 100 적색 M
ghi678 1035.20 녹색 S

그러나, 예를 들어 숫자 항목을 통화로 포맷(다음과 같이 천 단위를​​ 표시하기 위해 쉼표를 추가)하여 데이터에 추가 쉼표를 추가하는 경우에는 어떻게 되겠습니까?

ghi678,1,035.20,녹색,S

이제 이 파일을 업로드하려고 시도하면 여분의 쉼표에 인해 데이터 가져오기에서 다음과 같은 업로드 표를 만들어 5개의 항목을 인식합니다.

abc123 29.99 청색 XXL
def345 100 적색 M
ghi678 1 035.20 녹색 S

이는 다음과 같은 오류를 발생시킵니다.

'오류: 열 수가 일치하지 않음'

따옴표

큰따옴표는 셀 값을 '이스케이프'하는 데 사용할 수 있습니다. 값에 쉼표가 포함된 경우 일반적으로 셀 값을 따옴표로 묶게 됩니다. 그렇지 않으면, 데이터 가져오기에서 쉼표를 새로운 셀의 시작으로 해석합니다(위 참조).

예:

ghi678,"1,035.20",녹색,S

값 "1,035.20"는 단일 셀로 취급됩니다(단, 데이터 가져오기에서는 이 값을 통화 값이 아닌 문자열로 인식함).

따옴표를 사용하여 셀을 이스케이프하려면 반드시 따옴표의 수가 균형을 이루어야 합니다. 특정 행에 따옴표의 개수가 홀수인 경우 다음의 메시지가 표시되면서 가져오기는 실패합니다.

'오류: X행에 잘못된 CSV 형식이 있음'

줄바꿈

CSV 파일 내에서의 줄바꿈은 새로운 행의 시작을 표시하는 데 사용됩니다. 데이터 가져오기는 셀이 따옴표에 의해 이스케이프된 경우에도 셀 내에서 줄바꿈을 지원하지 않습니다. 행 안에서 추가 줄바꿈은 해당 행 또는 다음 행 중 하나에서 항목 수에 오류가 발생하는 원인이 되며 다음과 같은 오류 메시지가 표시됩니다.

'오류: 잘못된 CSV 행 형식'

다음 단계

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?
true
나에게 맞는 학습 과정 선택하기

Google 애널리틱스 4를 최대한 활용하는 데 도움이 되는 새로운 리소스인 google.com/analytics/learn을 확인해보세요. 새 웹사이트는 동영상, 도움말, 안내 가이드와 함께 Google 애널리틱스 Discord, 블로그, YouTube 채널, GitHub 저장소 링크를 제공합니다.

지금 학습 시작하기

검색
검색어 지우기
검색 닫기
Google 앱
기본 메뉴
5308438375313504930
true
도움말 센터 검색
true
true
true
true
true
69256
false
false