오류 메시지별 추천 해결책
업로드 중에 오류가 발생해도 당황하지 마세요. 데이터 가져오기 시에는 업로드 파일에서 예상하지 못한 데이터가 나타날 수 있어, 이러한 현상은 종종 발생합니다. 아래의 표에는 나타날 수 있는 오류 메시지와 문제 해결 방법이 제시되어 있습니다.
아래의 메시지에서 X, Y, Z와 같은 매개변수는 자리표시자이며, 런타임 시에는 실제 값으로 대체됩니다.
추천 해결 방법이 '파일 수정'이면 업로드 파일을 직접 수정해도 되고, 오류가 해결되도록 파일을 재생성해도 됩니다.
| 메시지 | 의미 | 해결책 |
|---|---|---|
| API 매개변수 X를 찾을 수 없습니다. | 관리 API를 이용해 데이터를 업로드하려고 했지만, 필수 매개변수가 없습니다. | 코드에 누락된 매개변수를 추가하세요. |
| X 헤더 중에서 1개 이상을 사용해야 합니다. | 업로드 파일에 필수 헤더가 없습니다. | 가져오는 데이터 유형에 대해 데이터 세트 세부정보를 검토하고, 업로드 파일이 필수 스키마와 일치하는지 확인하세요. |
| X열에 대한 액세스가 거부되었습니다. | 선택한 속성에 대해 권한이 충분하지 않습니다. | 데이터를 업로드할 속성에 대한 편집자 역할이 있는지 확인합니다. |
| X열 헤더가 없습니다. | 업로드 파일에 지정된 열 헤더가 없습니다. | 파일을 수정하고 누락된 헤더를 추가하세요. |
| X열 헤더를 사용할 수 없습니다. | 애널리틱스로 가져올 수 없는 데이터에 대해 열 헤더가 지정되었습니다. | 선택한 가져오기 유형에 대해 사용할 수 있는 측정기준과 측정항목을 검토하세요. |
| 입력 파일의 열 헤더가 없습니다. | 업로드 파일에 열 헤더가 없습니다. | 파일을 수정하고 적절한 헤더를 추가하세요. 업로드 파일 포맷을 참조하세요. |
| uid X에 대한 맞춤 데이터 소스를 찾을 수 없습니다. | 이 가져오기(일명 맞춤 데이터 소스 ID)에 대해 제공된 데이터 세트 ID를 찾을 수 없습니다. | 이 업로드에 대해 데이터 세트 ID가 올바른지 확인하세요. 자세히 알아보려면 데이터 세트 만들기를 참조하세요. |
| 환불 가져오기에서 업로드를 삭제할 수 없습니다. | 환불 데이터 업로드 파일을 삭제할 수 없습니다. 환불 데이터를 참조하세요. | |
| X열 헤더가 중복됩니다. | 업로드 파일에 중복된 열 헤더가 있습니다. 각 측정기준 또는 측정항목 이름은 업로드 파일당 한 번씩만 나타날 수 있습니다. | 파일을 수정하고 중복 헤더를 삭제하거나 변경하세요. |
| X번 열에 열 헤더가 비어 있습니다. | 업로드 파일에 열 헤더가 없습니다. | 파일을 수정하고 누락된 헤더를 추가하세요. |
| 줄 길이 한도(X)를 초과했습니다. | 업로드 파일의 하나 이상의 입력란이나 행이 최대 입력란 또는 줄 길이 한도를 초과했습니다. |
업로드 중인 데이터의 양을 줄이세요. 특정 입력란 길이 한도는 Analytics.js 입력란 참조사항을 확인하세요. |
| 파일에 열이 X개 있습니다. 최대 열 개수는 Y개입니다. | 업로드 파일에 열이 너무 많습니다. | 업로드 중인 측정기준 또는 측정항목의 개수를 줄이세요. |
| 데이터 가져오기 스키마에서 X 헤더를 찾을 수 없습니다. | 업로드 파일에 데이터 세트 스키마에서 정의되지 않은 헤더가 있습니다. 업로드 파일의 각 열에 스키마에서 정의된 측정기준 또는 측정항목 1개와 일치하는 헤더가 있어야 합니다. | 파일을 수정하고 누락된 헤더를 추가하세요. 데이터 세트 스키마를 얻는 방법에 대해 알아보기 |
| 권한이 충분하지 않습니다. | 이 속성에 업로드할 권한이 없습니다. | 애널리틱스로 데이터를 가져오려면 속성 수준에서 편집자 역할이 필요합니다. |
| X행에서 CSV 형식이 잘못되었습니다. | 업로드 파일에 형식 문제가 있습니다. 예상되는 문제는 다음과 같습니다.
|
파일을 수정하고 포맷 오류가 있는 행을 검토하세요. 오류 메시지에 나타난 행이 실제 오류가 발생한 행이 아닐 수 있으므로 이전 행에서도 문제가 있는지 확인해야 합니다. |
| 계정 ID X의 형식이 잘못되었습니다. | 계정 ID의 형식이 잘못되었습니다. 애널리틱스 계정 ID는 UA-XXXXXX-X 형식이어야 합니다. | 코드를 수정하고 계정 ID가 올바른 형식인지 확인하세요. |
| Z열, Y행에서 셀 데이터 'X'가 잘못되었습니다. 사용 가능한 날짜 형식은 YYYYMMDD입니다(예: 20131217). | 업로드 파일에서 지정된 위치의 데이터에 잘못된 날짜 형식이 있습니다. 올바른 날짜 형식은 YYYYMMDD입니다. | 파일을 수정하고 날짜 형식을 수정하세요. |
| Z열, Y행에서 셀 데이터 'X'가 잘못되었습니다. 올바른 데이터 유형은 (유형)입니다. | 업로드 파일에서 지정된 위치의 데이터가 잘못된 유형입니다. 예를 들어 열에 숫자 데이터가 포함되어야 하지만, 파일에서 열에 문자열 값이 들어 있습니다. | 셀에서 데이터가 올바른 유형이 되도록 수정하세요. |
| Z열, Y행에서 셀 데이터 'X'가 잘못되었습니다. 연도가 2005년 또는 그 이후여야 합니다. | 업로드 파일에서 지정된 위치의 데이터에 잘못된 연도가 있습니다. 2005년 이전의 데이터는 업로드할 수 없습니다. | 2005년 이전의 데이터가 포함된 행을 삭제하세요. |
| 고객 데이터 X가 잘못되었습니다. | 업로드 파일에 처리될 수 없는 데이터가 있습니다. | 업로드 파일을 수정하고 데이터를 고치세요. |
| 업로드된 데이터의 열 헤더 이름 X가 잘못되었습니다. | 업로드 파일에 잘못된 열 헤더 이름이 있습니다. 오타가 있는지 확인하세요. 열 헤더 이름은 ga:name 형식의 올바른 측정기준 또는 측정항목 이름이어야 합니다. | 열 헤더가 데이터 세트 스키마와 일치하는지 확인하세요. |
| 맞춤 데이터 소스 ID X의 형식이 잘못되었습니다. | 잘못된 맞춤 데이터 소스 ID 형식에 대한 오류 메시지입니다. | 코드를 수정하고 맞춤 데이터 소스 ID가 올바른 형식인지 확인하세요. 맞춤 데이터 소스에 대해 자세히 알아보기 |
| 속성 ID X의 형식이 잘못되었습니다. | 속성 ID의 형식이 잘못되었습니다. 애널리틱스의 속성 ID는 UA-XXXXXX-X 형식이어야 합니다. | 코드를 수정하고 속성 ID가 올바른 형식인지 확인하세요. |
| 여러 개의 오류가 발생했습니다. | 여러 오류의 목록이 있습니다. | |
| 속성 ID X를 찾거나 액세스할 수 없습니다. | 이 업로드에서 지정된 속성 ID가 부정확하거나 이 속성으로 데이터를 업로드할 권한이 없습니다. | 데이터를 업로드할 속성에 대한 편집자 역할이 있는지 확인합니다. |
| 속성 ID가 계정 ID와 일치하지 않습니다(속성 ID: X, 계정 ID: Y). | 지정된 계정에 속하지 않은 속성으로 데이터를 가져오려고 했습니다. | 코드를 수정하고 계정 ID와 속성 ID가 정확한지 확인하세요. |
| 할당량을 초과했습니다. | 데이터 가져오기 할당량을 초과했습니다. | 데이터 가져오기의 제한사항을 검토하세요. |
| X행에 올바른 개수인 Z개가 아닌 Y개의 열만 있습니다. | 지정된 행에 1개 이상의 데이터 열이 누락되었습니다. | 업로드 파일의 행을 수정하고 누락된 데이터 열을 추가하세요. |
| X행, Y열: 데이터가 잘못되었습니다. 'google' 소스('ga:source' = 'google')를 이용해 업로드할 수 있는 비용 데이터만 '자연' 비용 데이터('ga:medium' = '자연')입니다. | 소스 측정기준을 이용해 비용 데이터를 업로드하려고 하지만, 매체 측정기준이 '자연'이 아닙니다. | ga:source 측정기준이 google인 모든 행에서 ga:medium 측정기준을 자연으로 변경하세요. |
| X행, Y열: Z헤더는 필수 입력란입니다. | 업로드 파일의 지정된 위치에서 필수 데이터가 누락되었습니다. | 파일을 수정하고 누락된 데이터를 추가하세요. |
| X행: 파일에 잘못된 문자가 있습니다. UTF-8로 인코딩된 문자만 지원됩니다. | 업로드 파일에 잘못된 문자가 포함되어 있습니다. 데이터 가져오기의 파일은 UTF-8로 인코딩되어야 합니다. | 업로드 파일의 인코딩을 UTF-8로 변경하세요. |
| X행: Y헤더에 1개 나 이상의 값을 입력해야 합니다. | 업로드 파일에서 필수 데이터 측정기준 또는 측정항목이 누락되었습니다. | 가져오는 데이터 유형에 대해 데이터 세트 세부정보를 검토하고 데이터에 필수 값이 포함되어 있는지 확인하세요. |
| X행의 환불 가져오기가 잘못되었습니다. ga:transactionId가 포함되어야 하며, ga:transactionRevenue는 선택사항입니다. ga:productSku가 지정되면 ga:quantityRefunded를 지정해야 합니다. ga:productPrice는 ga:productSku를 이용해서만 선택적으로 지정할 수 있습니다. | 업로드 파일에 포함된 환불 데이터 가져오기에 대한 데이터가 잘못되었습니다. | 환불 데이터 스키마 요건에 맞춰 업로드 데이터를 수정하세요. |
| 일시적인 오류가 발생했습니다. 나중에 다시 시도해 주세요. | 일시적인 서버 오류가 발생했습니다. | 몇 분만 기다렸다가 다시 요청해 보세요. |
| 내부 오류가 발생했습니다. | 서버 오류가 발생했습니다. | 드물긴 하지만, 연결 문제 또는 서버의 구성 오류로 인해 서비스에 대한 액세스가 차단될 수 있습니다. 대체로 이러한 문제는 단시간에 해결될 수 있습니다. 오류가 계속되면 Google로 의견을 보내주세요. |
| 업로드 요청 URL은 https://www.googleapis.com/upload/analytics/로 시작해야 합니다. | 업로드 요청에서 필요한 URL이 누락되었습니다. | 코드에 올바른 URL을 추가하세요. 자세히 알아보려면 애널리틱스 개발자 가이드에서 업로드: uploadData를 참조하세요. |
| 계정 ID X, 속성 번호 Y의 웹 속성이 활성화되지 않았습니다. | 업로드 요청에서 지정된 계정과 연결되지 않은 웹 속성이 지정되었습니다. | 요청을 수정하고 계정 ID와 속성 ID가 모두 정확한지 확인하세요. |
