데이터 가져오기 개발자 가이드

Google Analytics Management API를 사용하면 Google 애널리틱스의 데이터 가져오기 기능에 프로그래매틱 방식으로 액세스할 수 있습니다.

소개

Management API를 사용하면 데이터 세트를 나열하는 것은 물론 업로드된 파일을 업로드, 나열, 삭제 및 가져올 수 있습니다. 데이터 가져오기 기능의 이점을 개괄적으로 알아보려면 도움말 센터의 데이터 가져오기 정보를 읽어보세요.

데이터 가져오기를 사용 설정하는 Management API의 두 가지 리소스는 다음과 같습니다.

  • 웹 인터페이스에서 데이터 세트라고 하는 맞춤 데이터 소스 리소스로, 업로드된 파일의 컨테이너 역할을 합니다. 맞춤 데이터 소스 모음은 Google 애널리틱스 속성과 연결된 모든 데이터 세트를 나타냅니다.
  • 업로드 리소스: 업로드된 파일을 나타냅니다. 업로드 리소스 모음은 데이터 세트에 업로드한 모든 파일을 나타냅니다.

사용 사례

데이터 가져오기 기능에는 세 가지 최상위 카테고리가 있으며, 각 카테고리에는 고유한 사용 사례가 있습니다. 조직은 다음과 같습니다.

조회 데이터 가져오기

환불 데이터

전체 또는 부분 환불된 전자상거래 데이터를 Google 애널리틱스에 업로드할 수 있습니다. 이렇게 하면 Google 애널리틱스 전자상거래 보고서의 데이터와 처리된 환불 데이터를 손쉽게 자동으로 조정할 수 있습니다.

환불 데이터를 Google 애널리틱스로 가져오는 방법을 알아보려면 환불 데이터 가져오기의 예를 참고하세요.

확장 데이터 가져오기

사용자 데이터

외부 CRM 도구에서 개인 식별이 불가능한 사용자 데이터를 업로드하고 가장 가치 있는 사용자 세그먼트에 대한 Google Ads 리마케팅 잠재고객을 만들 수 있습니다.

사용자 데이터를 Google 애널리틱스로 가져와서 Google Ads 리마케팅 잠재고객을 만드는 방법은 다음을 참고하세요.

캠페인 데이터

캠페인 데이터를 Google 애널리틱스로 가져와 비즈니스에 대한 캠페인 실적 분석을 맞춤설정할 수 있습니다.

캠페인 데이터를 Google 애널리틱스로 가져오는 방법에 대해 알아보려면 Management API를 이용해 캠페인 데이터 가져오기를 참고하세요.

지역 데이터

지역 ID의 매핑을 지역에 가져와 맞춤 지역별로 Google 애널리틱스 데이터에 대한 보고서를 만들 수 있습니다. 예를 들어 미국에서는 동부, 중부, 서부 주 그룹에서 운영될 수 있고, 유럽에서는 북부, 중부 및 남아있는 국가 그룹에서 운영될 수 있습니다. 데이터를 가져올 때 ga:regionId, ga:cityId, ga:countryIsoCode 또는 ga:subContinentCode을 키로 사용할 수 있습니다. 도시 ID와 국가 ID는 지역 타겟팅 표에서 확인할 수 있습니다. 국가 ISO 코드 및 아대륙 코드는 ISO-3166-1 alpha-2UN M.49 표에 각각 나와 있습니다.

지역 데이터 가져오기에 대해 자세히 알아보려면 지역 데이터 가져오기의 예를 참고하세요.

콘텐츠 데이터

작성자 및 주제와 같은 콘텐츠 관련 메타데이터를 업로드하여 Google 애널리틱스를 활용하여 웹사이트에 게시된 기사를 심층 분석할 수 있습니다.

Google 애널리틱스로 콘텐츠 데이터를 가져오는 방법에 대해 알아보려면 콘텐츠 데이터 가져오기의 예를 참고하세요.

제품 데이터

Google 애널리틱스로 제품 데이터를 가져오면 페이지뷰 및 이벤트와 같은 조회와 함께 전송해야 하는 전자상거래 데이터의 양이 줄어들고 데이터가 줄어듭니다. 단일 제품 ID 또는 SKU를 가져온 제품 데이터와 결합하여 보고서의 제품 측정기준 및 측정항목을 채울 수 있습니다.

제품 데이터를 Google 애널리틱스로 가져오는 방법을 알아보려면 Management API를 통해 제품 데이터 가져오기를 참고하세요.

요약 데이터 가져오기

비용 데이터

Google 이외의 유료 캠페인에 대한 비용 데이터를 업로드하고 Google 애널리틱스 플랫폼을 활용하여 ROI 분석을 수행하고 모든 온라인 광고 및 마케팅 투자에 대한 캠페인 실적을 비교할 수 있습니다.

비용 데이터를 Google 애널리틱스로 가져오는 방법을 알아보려면 Management API를 이용해 비용 데이터 가져오기를 참고하세요.

개념

처리 상태

파일을 업로드하면 업로드가 검증되고 처리되기 전까지는 업로드 상태가 PENDING로 유지됩니다. 처리가 완료되면 상태가 COMPLETED로 변경됩니다.

처리 중에 오류가 발생하여 업로드가 실패한 경우 업로드 상태가 FAILED입니다. 파일의 문제를 파악할 수 있도록 오류 목록이 제공됩니다. 다음은 유효성 검사에 실패한 업로드에 대한 응답 예입니다.

{
  id: "YU4DersR_ORzyzXC_AoWw",
  kind: "analytics#upload",
  accountId: "12345",
  customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
  status: "FAILED",
  errors:
  [
    "Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
    "Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
    "Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
    "Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
  ]
}

비용 데이터 합계와 덮어쓰기 비교

비용 데이터를 위한 맞춤 데이터 소스 / 데이터 세트를 만들 때 업로드된 파일에 기존 행과 일치하는 키 (예: 날짜, 소스, 매체)를 가진 데이터 행이 포함된 경우를 처리하는 방법을 지정할 수 있습니다. 옵션은 다음과 같습니다.

  • summation (기본값) - 이전에 일치하는 모든 데이터에 새 데이터가 추가되고 측정항목이 합산됩니다.
  • overwrite - 새로운 데이터가 이전의 일치하는 데이터를 덮어씁니다.

데이터 세트에 설정된 유형을 확인하려면 맞춤 데이터 소스 목록 메서드를 사용하여 importBehavior 속성이 OVERWRITE 또는 SUMMATION로 설정되어 있는지 확인하세요.

비용 데이터 행 수준 합산과 덮어쓰기 비교

헤더에 ga:importBehavior 열을 포함하여 업로드하는 각 파일의 데이터 세트 동작을 재정의할 수도 있습니다. 행별로 행 단위로 ga:importBehavior 값을 SUMMATION 또는 OVERWRITE로 설정할 수 있습니다.

예를 들어 다음 파일은 Facebook/cpcYahoo/cpc에 대한 이전 비용 데이터를 덮어쓰지만 Bing/cpc에 대한 행은 해당 날짜와 소스/매체 조합의 기존 비용 데이터에 추가됩니다.

ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE

형식 및 제약조건

Google 애널리틱스에 데이터를 업로드하려면 올바른 형식의 CSV 파일이어야 합니다. 이 섹션에서는 모든 데이터 가져오기 유형에 업로드하는 데 유효한 것으로 간주되기 전에 충족해야 하는 제약 조건을 설명합니다.

아래 제약 조건을 위반하거나 파싱 오류가 있는 경우 업로드 요청이 실패하고 오류 메시지가 표시됩니다. API는 사용자가 잘못된 업로드 수를 줄일 수 있도록 단일 응답으로 최대 10개의 오류를 보고합니다.

파일 제약 조건

  • 인코딩: UTF-8
  • 파일 크기 한도: 1GB

헤더 제약 조건

  • 첫 번째 행은 열 헤더로 간주되며 필수 항목입니다. 특정 열에 포함될 측정기준과 측정항목을 정의해야 합니다.

행 제약조건

  • 행 한도는 1MB입니다.

셀 서식 지정

  • 셀의 최대 길이는 2,048자(영문 기준)입니다.
  • 셀의 선행 및 후행 공백은 제거됩니다.
  • 셀 안에 쉼표를 지정하려면 셀 값을 큰따옴표 안에 넣어야 합니다. 예: source1,"medium,ether",group1,100 - 두 번째 셀 값은 보통,에테르입니다.
  • 셀에서 큰따옴표를 지정하려면 시작 및 끝 큰따옴표 외에도 큰따옴표를 다른 큰따옴표로 이스케이프 처리합니다. 예: source1,"medium""ether",group1,100 - 두 번째 셀 값은 medium"ether입니다.