Google Analytics Core Reporting API 변경 로그

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Google은 새로운 기능을 제공하고 이전 버전에서 발견된 결함을 복구하기 위해 Google 애널리틱스 Core Reporting API를 정기적으로 업데이트합니다. 대부분의 경우 이 변경사항은 API 개발자에게 투명하게 공개됩니다. 하지만 개발자가 기존 애플리케이션을 수정해야 하는 경우도 있습니다.

이 페이지에서는 애플리케이션에 영향을 미칠 수 있는 Google 애널리틱스 Core Reporting API의 변경사항에 대해 설명합니다. API 개발자는 정기적으로 이 목록을 확인하여 새로운 공지사항을 확인하는 것이 좋습니다. 아래 구독 섹션에 나열된 피드를 통해 변경사항을 확인할 수도 있습니다.

관련 변경 로그 구독

모든 수집, 구성, Reporting API가 포함됩니다.

Core Reporting API, 다채널 유입경로 Reporting API, Real Time Reporting API가 포함됩니다.

User Activity API의 최초 출시 버전입니다.

  • User Activity API를 사용하면 지정된 기간에 단일 클라이언트 ID 또는 사용자 ID와 연결된 모든 데이터를 가져올 수 있습니다. 이 API는 기본적으로 사용자 데이터에 대한 자동 액세스 권한을 해당 사용자에게 직접 제공하려는 속성 소유자를 지원하기 위한 것입니다. 자세한 내용은 User Activity API 가이드를 참고하세요.

이 출시 버전에서는 애널리틱스 Reporting API v4 결과 집합에 반환되는 최대 행 수가 증가했습니다.

애널리틱스 Reporting API v4 ReportData 객체에 반환되는 최대 행 수가 10,000개에서 100,000개로 증가했습니다.

이 출시 버전에는 Google 애널리틱스 Reporting API v4의 리소스 기반 할당량 시스템 미리보기가 추가되어 애널리틱스 360(프리미엄) 고객에게 더 높은 샘플링 기준점을 사용할 수 있습니다.

이 출시 버전에서는 관련 상품 기능과 관련 측정기준 및 측정항목이 지원 중단되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요. 데이터 삭제에 대한 자세한 내용은 데이터 지원 중단 정책을 참고하세요.

이번 출시 버전에서는 다음과 같은 측정기준과 측정항목이 지원 중단되었습니다.

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

이 출시 버전에서는 API에 새 측정기준이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요. 또한 이 출시 버전에서는 지원 중단된 여러 측정기준 및 측정항목이 삭제되었습니다. Google 애널리틱스 API의 데이터 지원 중단 정책에서 데이터 삭제의 전체 과정에 대해 알아보세요.

시간

  • ga:dateHourMinute: ga:date, ga:hour, ga:minute를 결합한 새로운 측정기준

데이터 삭제

이 출시 버전에서는 지원 중단된 다음과 같은 측정기준과 측정항목이 삭제되었습니다.

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

이 출시 버전에서는 API의 기존 측정항목과 측정기준이 업데이트되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

사용자 측정항목

사용자 수를 더 효율적으로 집계할 수 있도록 사용자 수활성 사용자 수 측정항목 계산 방법이 업데이트되었습니다. 측정항목에 약간의 변화가 있을 수도 있습니다. 자세한 내용은 사용자 측정항목에서 사용자 수를 식별하는 방법을 참고하세요.

계산 방법 업데이트의 영향을 받는 사용자 측정항목:

  • ga:users - 요청된 기간 동안 총 사용자 수
  • ga:1dayusers - 요청된 기간 동안 각 날짜의 1일 총 활성 사용자 수
  • ga:7dayusers - 요청된 기간 동안 각 날짜의 7일 총 활성 사용자 수
  • ga:14dayusers - 요청된 기간 동안 각 날짜의 14일 총 활성 사용자 수
  • ga:30dayusers - 요청된 기간 동안 각 날짜의 30일 총 활성 사용자 수

순 이벤트 수

ga:uniqueEvents의 지원 중단 기간이 곧 종료됩니다. 2017년 3월 26일 이후 ga:uniqueEvents의 정의가 업데이트되고 비공개 ga:uniqueEventsTemporary 측정항목이 API에서 삭제됩니다. 자세한 내용은 순 이벤트 수 도움말 문서를 참고하세요.

이 출시 버전에서는 API에 새 측정기준이 추가되고 오류 메시지가 개선되었으며 이전에 발표된 애드센스 측정기준 및 측정항목의 변경사항이 적용됩니다.

사용자 측정기준

  • 측정기준 - ga:userBucket - 지정된 사용자에 대해 사용자 버킷 측정기준(값: 1~100)이 사용자가 할당된 버킷을 나타냅니다. 자세한 내용은 리마케팅 캠페인 테스트 도움말을 참고하세요.

오류 메시지

이전에는 API에서 충족되지 않은 조건이 있는 데이터를 요청할 때 잘못된 오류 메시지 Unknown dimension(s): 또는 Unknown metric(s):를 반환했다면 이제 API에서 Restricted metric(s): ... can only be queried under certain conditions. 메시지를 반환합니다.

애드센스 측정기준 및 측정항목

애드센스에 연결되지 않은 보기는 애드센스 측정기준 및 측정항목 쿼리가 제한됩니다. 애드센스와 연결되지 않은 보기로 이러한 측정기준 및 측정항목을 쿼리하면 오류가 발생합니다.

버그 수정 출시입니다. 애드센스 측정기준과 측정항목의 문제가 해결되었으며 이 측정기준과 측정항목의 예정된 변경사항을 알려줍니다.

애드센스 측정기준 및 측정항목

이 출시 버전에서는 2017년 1월 7일부터 발생한 애드센스에 연결되지 않은 보기의 경우 애드센스 측정기준 및 측정항목을 쿼리하면 '알 수 없는 측정항목' 오류가 반환되는 문제가 해결되었습니다.

예정된 변경사항

2017년 1월 31일부터 애드센스와 연결되지 않은 보기는 애드센스 측정기준 및 측정항목 쿼리가 제한됩니다. 애드센스와 연결되지 않은 보기로 이러한 측정기준 및 측정항목을 쿼리하면 오류가 발생합니다.

이 출시 버전에서는 API에 다음과 같은 새 측정항목이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

계산된 측정항목

이 출시 버전에서는 계산된 측정항목에 대한 지원이 추가되었습니다.

  • 측정항목 - ga:calcMetric_ - 요청된 계산된 측정항목의 값입니다. 여기서 는 계산된 측정항목의 사용자 정의 이름을 나타냅니다. ga:calcMetric_의 데이터 유형은 FLOAT, INTEGER, CURRENCY, TIME 또는 PERCENT입니다. 자세한 내용은 계산된 측정항목에 대한 정보를 참고하세요.

이 출시 버전에서는 API에 새 측정항목이 추가되었습니다. 또한 기존 측정항목이 지원 중단되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

이벤트 추적

순 이벤트 수를 더 정확하게 반영하도록 ga:uniqueEvents의 정의가 변경됩니다. 이 변경사항에 영향을 주기 위해 Google에서는 기술적으로 데이터 지원 중단 정책에 따라 현재 ga:uniqueEvents 측정항목에 대한 지원을 중단할 예정입니다. 새 정의를 사용하려면 순 이벤트 수를 더 정확하게 계산하는 비공개 측정항목 ga:uniqueEventsTemporary를 참조하세요. 또한 ga:uniqueEvents의 현재 정의를 유지하는 새로운 측정항목 ga:uniqueDimensionCombinations가 도입됩니다. 적절한 지원 중단 기간(약 6개월) 후 비공개 측정항목 ga:uniqueEventsTemporary가 삭제되고 원래 측정항목 ga:uniqueEvents가 순 이벤트 수를 올바로 나타내게 됩니다. 자세한 내용은 순 이벤트 수 도움말 문서를 참고하세요.

순 이벤트 수

  • 측정항목 - ga:uniqueEvents - 순 이벤트 수를 더 정확하게 반영하도록 ga:uniqueEvents의 정의가 곧 변경됩니다. 기존 정의를 유지하려면 ga:uniqueDimensionCombinations를 대신 사용하세요. 자세한 내용은 순 이벤트 수 도움말 문서를 참고하세요.
  • 측정항목 - ga:uniqueDimensionCombinations - 순 측정기준 조합에서는 보고서의 측정기준별로 순 측정기준-값 조합의 개수를 집계합니다. 이렇게 하면 처리 후에 조합된(연결된) 측정기준을 만들 수 있으며, 이를 통해 추적을 업데이트하거나 맞춤 측정기준을 위한 추가 슬롯을 사용하지 않고도 더욱 유연하게 보고서를 만들 수 있습니다. 자세한 내용은 순 이벤트 수 도움말 문서를 참고하세요.

전환 테스트 – 비공개

  • 측정항목 - ga:uniqueEventsTemporary - 순 이벤트 수로, ga:uniqueEvents의 새로운 정의입니다. 이 측정항목을 사용하여 변경 전에 새 측정항목을 이해할 수 있습니다. 이 측정항목은 비공개이며 측정기준 및 측정항목 참조에 표시되지 않습니다.

이 출시 버전에서는 API에 새 측정기준 및 측정항목이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

DoubleClick Bid Manager

  • 측정기준 - ga:dbmClickAdvertiser - Google 애널리틱스 세션과 일치하는 DBM 클릭의 DBM 광고주 이름(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickAdvertiserId - Google 애널리틱스 세션과 일치하는 DBM 클릭의 DBM 광고주 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickCreativeId - Google 애널리틱스 세션과 일치하는 DBM 클릭의 DBM 광고 소재 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickExchange - Google 애널리틱스 세션과 일치하는 DBM 클릭의 DBM 교환 이름(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickExchangeId - Google 애널리틱스 세션과 일치하는 DBM 클릭의 DBM 교환 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickInsertionOrder - Google 애널리틱스 세션과 일치하는 DBM 클릭의 DBM 게재 신청서 이름(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickInsertionOrderId - Google 애널리틱스 세션과 일치하는 DBM 클릭의 DBM 게재 신청서 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickLineItem - Google 애널리틱스 세션과 일치하는 DBM 클릭의 DBM 광고 항목 이름(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickLineItemId - Google 애널리틱스 세션과 일치하는 DBM 클릭의 DBM 광고 항목 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickSite - Google 애널리틱스 세션과 일치하는 DBM 클릭에 대해 DBM 광고 소재가 표시되고 클릭된 DBM 사이트 이름(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmClickSiteId - Google 애널리틱스 세션과 일치하는 DBM 클릭에 대해 DBM 광고 소재가 표시되고 클릭된 DBM 사이트 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventAdvertiser - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)의 DBM 광고주 이름(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventAdvertiserId - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)의 DBM 광고주 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventCreativeId - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)의 DBM 광고 소재 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventExchange - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)의 DBM 교환 이름(애널리틱스 360만 해당, DBM과의 통합 필요)
  • 측정기준 - ga:dbmLastEventExchangeId - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내 노출 또는 클릭)의 DBM 교환 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventInsertionOrder - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)의 DBM 게재 신청서 이름(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventInsertionOrderId - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)의 DBM 게재 신청서 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventLineItem - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)의 DBM 광고 항목 이름(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventLineItemId - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)의 DBM 광고 항목 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventSite - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)에 대해 DBM 광고 소재가 표시되고 클릭된 DBM 사이트 이름(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dbmLastEventSiteId - Google 애널리틱스 세션과 연결된 마지막 DBM 이벤트(DBM 전환 확인 기간 내의 노출 또는 클릭)에 대해 DBM 광고 소재가 표시되고 클릭된 DBM 사이트 ID(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정항목 - ga:dbmCPA - DBM 수익 eCPA(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정항목 - ga:dbmCPC - DBM 수익 eCPC(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정항목 - ga:dbmCPM - DBM 수익 eCPM(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정항목 - ga:dbmCTR - DBM CTR(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정항목 - ga:dbmClicks - DBM 총 클릭수(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정항목 - ga:dbmConversions - DBM 총 전환수(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정항목 - ga:dbmCost - DBM 비용(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정항목 - ga:dbmImpressions - DBM 총 노출수(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정항목 - ga:dbmROAS - DBM ROAS(애널리틱스 360만 해당, DBM과 통합 필요)
  • 측정기준 - ga:dsAdGroup - DS 광고그룹(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsAdGroupId - DS 광고그룹 ID(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsAdvertiser - DS 광고주(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsAdvertiserId - DS 광고주 ID(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsAgency - DS 대행사(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsAgencyId - DS 대행사 ID(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsCampaign - DS 캠페인(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsCampaignId - DS 캠페인 ID(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsEngineAccount - DS 엔진 계정(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsEngineAccountId - DS 엔진 계정 ID(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsKeyword - DS 키워드(애널리틱스 360만 해당, DS와 통합 필요)
  • 측정기준 - ga:dsKeywordId - DS 키워드 ID(애널리틱스 360만 해당, DS와 통합 필요)
  • ga:dsCPC - 클릭당 광고주 DS 비용(애널리틱스 360만 해당, DS와 통합 필요)
  • ga:dsCTR - DS 클릭률(애널리틱스 360만 해당, DS와 통합 필요)
  • ga:dsClicks - DS 클릭수(애널리틱스 360만 해당, DS와 통합 필요)
  • ga:dsCost - DS 비용(애널리틱스 360만 해당, DS와 통합 필요)
  • ga:dsImpressions - DS 노출수(애널리틱스 360만 해당, DS와 통합 필요)
  • ga:dsProfit - DS 프로필(애널리틱스 360만 해당, DS와 통합 필요)
  • ga:dsReturnOnAdSpend - DS 광고 투자수익(애널리틱스 360만 해당, DS와 통합 필요)
  • ga:dsRevenuePerClick - DS 클릭당수익(애널리틱스 360만 해당, DS와 통합 필요)

이 출시 버전에서는 API에 새 측정기준이 추가되었습니다. 또한 이 출시 버전에서는 함께 쿼리할 수 있는 측정기준 조합에 관한 특정한 제한사항이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

지역 네트워크

  • 측정기준 - ga:continentId - 사용자의 IP 주소 또는 지역 ID에서 가져온 사용자의 대륙 ID

제한사항

다음 그룹에 있는 측정기준은 다른 그룹에 있는 측정기준과 함께 쿼리할 수 없습니다.

  • 쇼핑 정보 그룹 방문
    • ga:checkoutOptions
    • ga:shoppingStage
  • GWO 실험 그룹
    • ga:experimentVariant
    • ga:experimentId
  • 관심분야 그룹
    • ga:interestOtherCategory
  • 구매 의도 관심분야 그룹
    • ga:interestInMarketCategory
  • 내부 프로모션 그룹:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • 브랜딩 관심분야 그룹:
    • ga:interestAffinityCategory

이 출시 버전에는 새로운 한도와 할당량이 도입되었습니다. 자세한 내용은 한도 및 할당량 문서를 참고하세요.

오류 보고

이 출시 버전에서는 실패한(5XX) 보고 요청에 제한이 적용됩니다.

  • 시간당 프로필별 프로젝트당 실패한 요청 10개
  • 일일 프로필별 프로젝트당 실패한 요청 50개

피봇 한도

이 출시 버전에서는 피봇 요청에 대한 제한이 적용됩니다.

  • 이제 보고서 요청에 최대 2개의 피봇을 포함할 수 있습니다.
  • 한 피봇에는 최대 4개의 측정기준을 포함할 수 있습니다.
  • 피봇 측정기준은 요청에서 허용되는 총 측정기준 수에 관한 제한사항의 일부입니다.
  • 피봇 측정항목은 요청에서 허용되는 총 측정항목 수에 관한 제한사항의 일부입니다.

이 출시 버전에서는 API에 새 측정기준 및 측정항목이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

지역 네트워크

  • 측정기준 - ga:metroId - 사용자의 IP 주소 또는 지역 ID에서 가져온 트래픽 도착 위치의 세 자리 지정 시장 지역(Designated Market Area, DMA) 코드

DoubleClick for Publishers

  • 측정항목 - ga:dfpImpressions - 개별 광고 1개가 웹사이트에 게재될 때마다 DFP 광고 노출 1회로 기록됩니다. 예를 들어 광고 단위가 2개 표시된 페이지가 한 번 조회되면 광고 노출 2회가 기록됩니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:dfpCoverage - 게재 비율은 하나 이상의 광고를 반환한 광고 요청의 비율입니다. 일반적으로 게재 비율은 DFP 계정에서 타겟팅 광고를 제공할 수 없는 사이트를 식별하는 데 도움이 됩니다. 구하는 공식은 '광고 노출수/총 광고 요청수 * 100입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:dfpMonetizedPageviews - 연결된 DFP 계정의 광고와 함께 게재된 속성에서 발생한 총 페이지 조회수를 측정합니다. 참고: 페이지 하나에 여러 개의 광고 단위가 있을 수 있습니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:dfpImpressionsPerSession - DFP 광고 노출수와 애널리틱스 세션수의 비율(광고 노출수/애널리틱스 세션수)(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음)
  • 측정항목 - ga:dfpViewableImpressionsPercent - 조회 가능한 광고 노출수의 비율입니다. 광고가 사용자 브라우저 내에 표시되고 사용자가 조회할 기회를 얻게 되면 해당 광고 노출은 조회 가능 노출로 간주됩니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:dfpClicks - 사이트에서 DFP 광고를 클릭한 횟수(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음)
  • 측정항목 - ga:dfpCTR - DFP 광고 클릭으로 이어진 페이지 조회의 비율(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음)
  • 측정항목 - ga:dfpRevenue - 광고가 게재된 노출에 근거한 총 예상 광고 수익(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음)
  • 측정항목 - ga:dfpRevenuePer1000Sessions - DFP 광고에서 애널리틱스 세션 1,000회당 발생한 총 예상 수익입니다. 이 측정항목은 사이트에서 발생한 세션수에 근거하며 광고 노출수는 고려하지 않습니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:dfpECPM - 유효 페이지 조회 1,000회 당 비용입니다. 페이지 조회 1,000회당 DFP 수익입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillImpressions - 백업 광고 노출수는 DFP를 통해 백업 광고로 게재된 모든 애드센스 또는 Ad Exchange 광고 노출수의 합계입니다. 개별 광고가 웹사이트에 게재될 때마다 광고 노출 1회로 기록됩니다. 예를 들어 광고 단위가 2개 표시된 페이지가 한 번 조회되면 광고 노출 2회가 기록됩니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillCoverage - 백업 광고 게재 비율은 하나 이상의 광고가 반환된 백업 광고 요청의 비율입니다. 일반적으로 게재 비율은 게시자 계정에서 타겟팅 광고를 제공할 수 없는 사이트를 식별하는 데 도움이 됩니다. 구하는 공식은 '광고 노출수/총 광고 요청수 * 100'입니다. 애드센스와 Ad Exchange 모두 백업 광고를 제공하는 경우 이 측정항목은 두 백업 광고 계정의 가중치 평균입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillMonetizedPageviews - 연결된 백업 광고 계정의 광고 하나 이상과 함께 게재된 속성에서 발생한 총 페이지 조회수를 측정합니다. 단일 수익 창출 페이지 조회에 여러 광고 노출이 포함될 수 있습니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillImpressionsPerSession - DFP 광고 노출수와 애널리틱스 세션수의 비율(광고 노출수/애널리틱스 세션수)입니다. 애드센스와 Ad Exchange 모두 백업 광고를 제공하는 경우 이 측정항목은 두 백업 광고 계정의 합계입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillViewableImpressionsPercent - 조회 가능한 백업 광고 노출수의 비율입니다. 광고가 사용자 브라우저 내에 표시되고 사용자가 조회할 기회를 얻게 되면 해당 광고 노출은 조회 가능 노출로 간주됩니다. 애드센스와 Ad Exchange 모두 백업 광고를 제공하는 경우 이 측정항목은 두 백업 광고 계정의 가중치 평균입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillClicks - 사이트에서 백업 광고를 클릭한 횟수입니다. 애드센스와 Ad Exchange 모두 백업 광고를 제공하는 경우 이 측정항목은 두 백업 광고 계정의 합계입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillCTR - 광고 클릭으로 이어진 백업 광고 노출수의 비율입니다. 애드센스와 Ad Exchange 모두 백업 광고를 제공하는 경우 이 측정항목은 두 백업 광고 계정의 가중치 평균입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillRevenue - 백업 광고에서 발생한 총 예상 수익입니다. 애드센스와 Ad Exchange 모두 백업 광고를 제공하는 경우 이 측정항목은 두 백업 광고 계정의 합계입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillRevenuePer1000Sessions - 백업 광고에서 애널리틱스 세션 1,000회당 발생한 총 예상 수익입니다. 이 측정항목은 사이트에서 발생한 세션수에 근거하며 광고 노출수는 고려하지 않습니다. 애드센스와 Ad Exchange 모두 백업 광고를 제공하는 경우 이 측정항목은 두 백업 광고 계정의 합계입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).
  • 측정항목 - ga:backfillECPM - 유효 페이지 조회 1,000회 당 비용입니다. 페이지 조회 1,000회당 DFP 백업 광고 수익입니다. 애드센스와 Ad Exchange 모두 백업 광고를 제공하는 경우 이 측정항목은 두 백업 광고 계정의 합계입니다(DFP 연결은 사용 설정되고 DFP 수익 숨기기는 사용 설정되지 않음).

세그먼트 및 샘플링 문제가 해결된 버그 수정 출시입니다.

세그먼트

이 출시 버전에서는 모든 사용자 세그먼트(gaid::-1)가 있는 일부 요청이 Core Reporting API V3에서 더 적게 계산되고 애널리틱스 Reporting API V4에서 두 세그먼트로 분할되는 문제가 해결되었습니다.

샘플링

이 출시 버전에서는 맞춤 표의 일부 요청에서 샘플링된 데이터가 반환되는 문제가 해결되었습니다.

이 출시 버전에서는 새로운 API 버전, 애널리틱스 Reporting API V4를 발표합니다. 이 새로운 API는 Google 애널리틱스의 보고서 데이터에 액세스할 수 있는 최첨단 프로그래매틱 방법입니다.

주요 기능

Google 애널리틱스는 강력한 데이터 보고 인프라를 기반으로 빌드됩니다. 이 API를 통해 개발자는 Google 애널리틱스 플랫폼의 강력한 기능을 이용할 수 있습니다. 애널리틱스 Reporting API V4의 주요 기능은 다음과 같습니다.

  • 측정항목 표현식 - API를 사용하면 기본 제공 측정항목뿐 아니라 수학적 측정항목 표현식도 요청할 수 있습니다. 예를 들어 요청에서 세션수당 목표 달성을 ga:goal1completions/ga:sessions로 표현할 수 있습니다.
  • 여러 기간 - 두 기간을 요청할 수 있으므로 단일 요청에서 두 기간의 데이터를 비교할 수 있습니다.
  • 동질 집단 및 평생 가치 - API에 동질 집단 및 평생 가치 보고서를 요청할 수 있는 다양한 용어가 포함됩니다.
  • 여러 세그먼트 - 이제 단일 요청에서 여러 세그먼트를 요청할 수 있습니다.

시작하기

API를 시작하는 방법에 관한 자세한 내용은 개발자 문서를 참고하세요.

할당량 정책

애널리틱스 Reporting API V4에는 자체 할당량 및 한도가 지정되어 있습니다. 새로운 API이므로 이 한도와 할당량은 변경될 수 있습니다.

마이그레이션

GitHub이전 가이드와 함께 Python 호환성 라이브러리도 제공됩니다.

측정기준 및 측정항목

이 출시 버전에서는 일부 애널리틱스 Reporting API V4 전용 측정기준 및 측정항목도 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 탐색기를 참고하세요.

  • 측정기준 - ga:cohort - 동질 집단 정의를 기준으로 사용자가 속한 동질 집단의 이름입니다. 동질 집단이 정의되는 방식에 따라 사용자는 여러 세그먼트에 속할 수 있는 것과 마찬가지로 여러 동질 집단에 속할 수 있습니다.

  • 측정기준 - ga:cohortNthDay - 동질 집단 정의 날짜를 기준으로 한 0-기반 날짜 오프셋입니다. 예를 들어 첫 방문 날짜를 2015-09-01로 하여 동질 집단이 정의된 경우 2015-09-04의 경우 ga:cohortNthDay는 3이 됩니다.

  • ga:cohortNthMonth - 동질 집단 정의 날짜를 기준으로 한 0-기반 월 오프셋

  • 측정기준 - ga:cohortNthWeek - 동질 집단 정의 날짜를 기준으로 한 0-기반 주 오프셋

  • 측정기준 - ga:acquisitionTrafficChannel - 사용자를 획득한 트래픽 채널입니다. 사용자의 첫 번째 세션에서 추출됩니다. 트래픽 채널은 사용자 획득 시 (사용 가능한 경우 보기 수준에서) 기본 채널 그룹 규칙을 기준으로 계산됩니다.

  • 측정기준 - ga:acquisitionSource - 사용자를 획득한 소스입니다. 사용자의 첫 번째 세션에서 가져옵니다.

  • 측정기준 - ga:acquisitionMedium - 사용자를 획득한 매체(캠페인 추적)입니다. 사용자의 첫 번째 세션에서 가져옵니다.

  • 측정기준 - ga:acquisitionSourceMedium - ga:userAcquisitionSource와 ga:acquisitionMedium의 결합된 가치.

  • 측정기준 - ga:acquisitionCampaign 사용자를 획득한 캠페인입니다. 사용자의 첫 번째 세션에서 가져옵니다.

  • 측정항목 - ga:cohortActiveUsers - 이 측정항목은 0 기반 오프셋 측정기준(ga:cohortNthDay, ga:cohortNthWeek 또는 ga:cohortNthMonth)의 환경설정과 관련이 있습니다. 동질 집단에서 n번째 날짜/주/월에 해당하는 기간에 활성 상태인 사용자 수를 나타냅니다. 예를 들어 ga:cohortNthWeek = 1의 경우 동질 집단에서 두 번째 주에 활성 상태인 사용자 수입니다. 요청에 ga:cohortNthDay, ga:cohortNthWeek 또는 ga:cohortNthMonth가 없는 경우 이 측정항목의 값은 ga:cohortTotalUsers와 같습니다.

  • 측정항목 - ga:cohortTotalUsers - 동질 집단에 속한 사용자 수(동질 집단 크기라고도 함)

  • 측정항목 - ga:cohortAppviewsPerUser - 동질 집단의 사용자당 앱 조회수

  • 측정항목 - ga:cohortGoalCompletionsPerUser - 동질 집단의 사용자당 목표 달성 횟수

  • 측정항목 - ga:cohortPageviewsPerUser - 동질 집단의 사용자당 페이지 조회수

  • 측정항목 - ga:cohortRetentionRate - 동일 집단 유지율

  • 측정항목 - ga:cohortRevenuePerUser - 동질 집단의 사용자당 수익

  • 측정항목 - ga:cohortVisitDurationPerUser - 동질 집단의 사용자당 세션 시간

  • 측정항목 - ga:cohortSessionsPerUser - 동질 집단의 사용자당 세션수

  • 측정항목 - ga:cohortTotalUsersWithLifetimeCriteria - ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium 또는 ga:acquisitionCampaign 측정기준이 포함된 요청의 환경설정과 관련이 있습니다. 동질 집단에서 현재 채널, 소스, 매체 또는 캠페인을 통해 획득한 사용자 수를 나타냅니다. 예를 들어 ga:acquisitionTrafficChannel=Direct의 경우 동질 집단에서 직접 획득한 사용자 수를 나타냅니다. 언급된 측정기준이 없는 경우 으면 이 측정항목의 값은 ga:cohortTotalUsers와 같습니다.

  • 측정항목 - ga:cohortAppviewsPerUserWithLifetimeCriteria - 동질 집단의 획득 측정기준에 대한 사용자당 앱 조회수

  • 측정항목 - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria - 동질 집단의 획득 측정기준에 대한 사용자당 목표 달성 횟수

  • 측정항목 - ga:cohortPageviewsPerUserWithLifetimeCriteria - 동질 집단의 획득 측정기준에 대한 사용자당 페이지 조회수

  • 측정항목 - ga:cohortRevenuePerUserWithLifetimeCriteria - 동질 집단의 획득 측정기준에 대한 사용자당 수익

  • 측정항목 - ga:cohortSessionsPerUserWithLifetimeCriteria - 동질 집단의 획득 측정기준에 대한 사용자당 세션 시간

소셜 데이터 허브 측정기준 및 측정항목이 지원 중단되었으며 2016년 4월 30일부터는 이전 데이터만 보고됩니다. 이 날짜 이후에는 새 데이터가 표시되지 않습니다. 데이터 지원 중단 정책에 따라 이러한 측정기준 및 측정항목은 2016년 9월 30일 이후 삭제됩니다.

전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

소셜 활동

이러한 측정기준 및 측정항목은 지원 중단되었으며 2016년 9월 30일 이후 삭제됩니다. 데이터 삭제에 대한 자세한 내용은 데이터 지원 중단 정책을 참고하세요.

  • 측정기준 - ga:socialActivityEndorsingUrl - 소셜 데이터 허브 활동에서 소셜 활동의 URL(예: Google+ 게시물 URL, 블로그 댓글 URL 등)입니다.
  • 측정기준 - ga:socialActivityDisplayName - 소셜 데이터 허브 활동에서 사회 연결망 사용자가 게시한 소셜 활동의 제목입니다.
  • 측정기준 - ga:socialActivityPost - 소셜 데이터 허브 활동에서 사회 연결망 사용자가 게시한 소셜 활동의 콘텐츠(예: Google+에 게시된 메시지의 콘텐츠)입니다.
  • 측정기준 - ga:socialActivityTimestamp - 소셜 데이터 허브 활동에서 사회 연결망 내 소셜 활동이 발생한 시간입니다.
  • 측정기준 - ga:socialActivityUserHandle - 소셜 데이터 허브 활동에서 소셜 활동을 시작한 사용자의 사회 연결망 핸들(예: 이름 또는 ID)입니다.
  • 측정기준 - ga:socialActivityUserPhotoUrl - 소셜 데이터 허브 활동에서 사용자의 사회 연결망 프로필과 연결된 사진의 URL입니다.
  • 측정기준 - ga:socialActivityUserProfileUrl - 소셜 데이터 허브 활동에서 연결된 사용자의 사회 연결망 프로필의 URL입니다.
  • 측정기준 - ga:socialActivityTagsSummary - 소셜 데이터 허브 활동에서 소셜 활동과 연결된 쉼표로 구분된 태그 집합입니다.
  • 측정기준 - ga:socialActivityAction - 소셜 데이터 허브 활동에서 활동과 연결된 소셜 액션의 유형(예: 투표, 댓글, +1 등)을 나타냅니다.
  • 측정기준 - ga:socialActivityNetworkAction - 소셜 데이터 허브 활동에서 소셜 액션의 유형 및 활동이 발생한 사회 연결망입니다.
  • 측정기준 - ga:socialActivityContentUrl - 소셜 데이터 허브 활동에서 연결된 사회 연결망 사용자가 공유하는 URL입니다.
  • 측정항목 - ga:socialActivities - 소셜 데이터 허브 파트너 네트워크에서 콘텐츠 URL이 공유되거나 언급된 총 활동 수입니다.

이 출시 버전에서는 API에 새 측정기준이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

플랫폼 또는 기기

  • 측정기준 - ga:browserSize - 사용자 브라우저의 표시 영역 크기입니다. 브라우저 크기는 표시 영역의 최초 크기(픽셀 단위)를 가로x세로 형식으로 나타내는 세션 범위 측정 기준입니다. 예: 1920x960.

이 출시 버전에서는 API에 새 매개변수가 추가되었습니다.

빈 행 포함

  • 이 출시 버전에서는 새로운 선택적 매개변수 include-empty-rows가 추가되었습니다. 이 매개변수가 false로 설정되면 데이터가 없는 행이 응답에서 생략됩니다. 기본값은 true이며 브레이킹 체인지가 아닙니다. 따라서 코드를 업데이트할 필요가 없습니다. 자세한 내용은 Core Reporting API 참조 문서를 참고하세요.

이 출시 버전에서는 API에 새 측정항목이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

사용자

  • 측정항목 - ga:1dayUsers - 요청된 기간 동안 각 날짜의 1일 총 활성 사용자 수입니다. 이 측정항목을 쿼리하려면 ga:nthDay, ga:date 또는 ga:day 중 하나 이상을 측정기준으로 지정해야 합니다. 지정된 날짜에 대해 지정된 날짜에 종료되는 1일의 기간 동안 총 순 사용자 수가 반환됩니다.
  • 측정항목 - ga:7dayUsers - 요청된 기간 동안 각 날짜의 7일 총 활성 사용자 수입니다. 이 측정항목을 쿼리하려면 ga:nthDay, ga:date 또는 ga:day 중 하나 이상을 측정기준으로 지정해야 합니다. 지정된 날짜에 대해 지정된 날짜에 종료되는 7일의 기간 동안 총 순 사용자 수가 반환됩니다.
  • 측정항목 - ga:14dayUsers - 요청된 기간 동안 각 날짜의 14일 총 활성 사용자 수입니다. 이 측정항목을 쿼리하려면 ga:nthDay, ga:date 또는 ga:day 중 하나 이상을 측정기준으로 지정해야 합니다. 지정된 날짜에 대해 지정된 날짜에 종료되는 14일의 기간 동안 총 순 사용자 수가 반환됩니다.
  • 측정항목 - ga:30dayUsers - 요청된 기간 동안 각 날짜의 30일 총 활성 사용자 수입니다. 이 측정항목을 쿼리하려면 ga:nthDay, ga:date 또는 ga:day 중 하나 이상을 측정기준으로 지정해야 합니다. 지정된 날짜에 대해 지정된 날짜에 종료되는 30일의 기간 동안 총 순 사용자 수가 반환됩니다.

이 출시 버전에서는 API에 새 측정항목이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

DoubleClick Ad Exchange(AdX)

  • 측정항목 - ga:adxCTR - AdX 광고 클릭으로 이어진 페이지 조회수의 비율
  • 측정항목 - ga:adxClicks - 사이트에서 AdX 광고를 클릭한 횟수
  • 측정항목 - ga:adxCoverage - 게재 비율은 하나 이상의 광고를 반환한 광고 요청의 비율입니다. 일반적으로 게재 비율을 보면 AdX 계정에서 타겟팅 광고를 게재할 수 없는 사이트를 찾을 수 있습니다. 구하는 공식은 '광고 노출수/총 광고 요청수 * 100'입니다.
  • 측정항목 - ga:adxECPM - 유효 페이지 조회 1,000회 당 비용입니다. 페이지 조회 1,000회당 AdX 수익과 같습니다.
  • 측정항목 - ga:adxImpressions - 개별 광고가 웹사이트에 게재될 때마다 AdX 광고 노출 1회로 기록됩니다. 예를 들어 광고 단위가 2개 표시된 페이지가 한 번 조회되면 광고 노출 2회가 기록됩니다.
  • 측정항목 - ga:adxImpressionsPerSession - AdX 광고 노출수와 애널리틱스 세션수의 비율(광고 노출수/애널리틱스 세션수)
  • 측정항목 - ga:adxMonetizedPageviews - 수익 창출 페이지 조회는 연결된 AdX 계정의 광고와 함께 게재된 속성에서 발생한 총 페이지 조회수를 측정합니다. 참고: 페이지 하나에 여러 개의 광고 단위가 있을 수 있습니다.
  • 측정항목 - ga:adxRevenue - AdX 광고에서 발생한 총 예상 수익
  • 측정항목 - ga:adxRevenuePer1000Sessions - AdX 광고에서 애널리틱스 세션 1,000회당 발생한 총 예상 수익입니다. 이 측정항목은 사이트에서 발생한 세션수에 근거하며 광고 노출수는 고려하지 않습니다.
  • 측정항목 - ga:adxViewableImpressionsPercent - 조회 가능한 광고 노출수의 비율입니다. 광고가 사용자 브라우저 내에 표시되고 사용자가 조회할 기회를 얻게 되면 해당 광고 노출은 조회 가능 노출로 간주됩니다.

이 출시 버전에서는 기존 측정기준 또는 측정항목이 지원 중단됩니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

지원 중단된 측정기준

다음 측정기준은 지원 중단되었습니다. 데이터 삭제에 대한 자세한 내용은 데이터 지원 중단 정책을 참고하세요.

  • 측정기준 - ga:adSlotPosition - ga:adSlot을 대신 사용하세요.
  • 측정기준 - ga:nextPagePath - ga:pagePath을 대신 사용하세요.
  • 측정기준 - ga:nextContentGroupXX - ga:contentGroupXX를 대신 사용하세요.

이 출시 버전에서는 API에 새 측정기준이 추가되었습니다. 측정기준과 측정항목의 전체 목록은 측정기준 및 측정항목 참조를 참고하세요.

Google Ads

  • 측정기준 - ga:adQueryWordCount - 검색어의 단어 개수

이 출시 버전에서는 API에 새 측정기준이 추가되었습니다. 측정기준과 측정항목의 전체 목록은 측정기준 및 측정항목 참조를 참고하세요.

플랫폼 또는 기기

  • 측정기준 - ga:dataSource - 조회의 데이터 소스입니다. ga.js 및 analytics.js에서 전송된 조회는 '웹'으로 보고되고 모바일 SDK에서 전송된 조회는 '앱'으로 보고됩니다. 이 값은 재정의할 수 있습니다.
  • 측정기준 - ga:searchAfterDestinationPage - 사용자가 사이트에서 내부 검색을 실행한 후 방문한 페이지

이 출시 버전에서는 API에 새 측정기준 및 측정항목이 추가되고 두 개의 기존 측정항목이 지원 중단되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

전자상거래

  • 측정항목 - ga:transactionsPerUser - 총 거래 수를 총 사용자 수로 나눈 값
  • 측정항목 - ga:revenuePerUser - 배송비와 세금을 제외한 거래의 총 판매 수익을 총 사용자 수로 나눈 값

사용자

  • 측정항목 - ga:sessionsPerUser - 총 세션수를 총 사용자 수로 나눈 값

지역 네트워크

  • 측정기준 - ga:cityId - IP 주소 또는 지역 ID에서 가져온 사용자의 도시 ID
  • 측정기준 - ga:countryIsoCode - IP 주소 또는 지역 ID에서 가져온 사용자의 국가 ISO 코드입니다. 값은 ISO-3166-1 alpha-2 코드로 제공됩니다.
  • 측정기준 - ga:regionId - IP 주소 또는 지역 ID에서 가져온 사용자의 지역 ID입니다. 미국에서는 주로 표시됩니다(예: 뉴욕주).
  • 측정기준 - ga:regionIsoCode - IP 주소 또는 지역 ID에서 가져온 사용자의 지역 ISO 코드입니다. 값은 ISO-3166-2 코드로 제공됩니다.
  • 측정기준 - ga:subContinentCode - IP 주소 또는 지역 ID에서 가져온 사용자의 아대륙 코드입니다. 예를 들어 폴리네시아 또는 북유럽 등이 있습니다. 값은 UN M.49 코드로 제공됩니다.

DoubleClick 캠페인 관리자

  • 측정항목 - ga:dcmROAS - DCM 광고 투자수익(ROAS)(프리미엄만 해당)

지원 중단된 측정항목

다음 측정항목은 지원 중단되었습니다. 데이터 삭제에 대한 자세한 내용은 데이터 지원 중단 정책을 참고하세요. + 측정항목 - ga:dcmROI - ga:dcmROAS를 대신 사용하세요. + 측정항목 - ga:dcmMargen - ga:dcmROAS를 대신 사용하세요.

이 출시 버전에서는 API에 새 측정항목이 추가되고 기존 측정항목 2개에 대한 지원이 중단되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

Google Ads

  • 측정항목 - ga:ROAS - 광고 투자수익(ROAS)은 총 거래 수익과 목표값을 파생된 광고비로 나눈 값입니다.

지원 중단된 측정기준 및 측정항목

다음 측정기준과 측정항목은 지원 중단되었습니다. 데이터 삭제에 대한 자세한 내용은 데이터 지원 중단 정책을 참고하세요. + 측정항목 - ga:ROI - ga:ROAS를 대신 사용하세요. + 측정항목 - ga:margin - ga:ROAS를 대신 사용하세요.

이 출시 버전에서는 API에 새 측정항목이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

애드센스

  • 측정항목 - ga:adsenseCoverage - 1개 이상의 광고를 반환한 광고 요청의 비율
  • 측정항목 - ga:adsenseViewableImpressionPercent - 조회 가능한 노출수의 비율

이 출시 버전에는 새로운 세션 측정항목, 새로운 트래픽 소스 측정기준, 새로운 DoubleClick Campaign Manager 측정기준 및 측정항목이 추가되었습니다.

측정기준 및 측정항목

전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

세션

  • 측정항목 - ga:hits - Google 애널리틱스에 전송된 총 조회수입니다. 이 측정항목은 모든 조회 유형(예: 페이지 조회, 이벤트, 타이밍)의 합계입니다.

트래픽 소스

  • 측정기준 - ga:campaignCode - 수동 캠페인 추적을 사용하는 경우 utm_id 캠페인 추적 매개변수의 값

DoubleClick 캠페인 관리자

  • 측정기준 - ga:dcmClickAd - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmClickAdId - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmClickAdType - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고 유형 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmClickAdTypeId - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고 유형 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmClickAdvertiser - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고주 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmClickAdvertiserId - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고주 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmClickCampaign - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 캠페인 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmClickCampaignId - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 캠페인 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmClickCreative - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고 소재 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmClickCreativeId - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고 소재 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmClickCreativeType - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고 소재 유형 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmClickCreativeTypeId - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고 소재 유형 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmClickCreativeVersion - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 광고 소재 버전(프리미엄만 해당)
  • 측정기준 - ga:dcmClickRenderingId - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 렌더링 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmClickSite - Google 애널리틱스 세션과 일치하는 DCM 클릭에 대해 DCM 광고 소재가 표시되고 클릭된 사이트 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmClickSiteId - Google 애널리틱스 세션과 일치하는 DCM 클릭에 대해 DCM 광고 소재가 표시되고 클릭된 사이트 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmClickSitePlacement - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 사이트 게재위치 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmClickSitePlacementId - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 사이트 게재위치 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmClickSpotId - Google 애널리틱스 세션과 일치하는 DCM 클릭의 DCM 플러드라이트 구성 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmFloodlightActivity - 플러드라이트 전환과 연결된 DCM 플러드라이트활동 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmFloodlightActivityAndGroup - 플러드라이트 전환과 연결된 DCM 플러드라이트 활동 이름 및 그룹 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmFloodlightActivityGroup - 플러드라이트 전환과 연결된 DCM 플러드라이트 활동 그룹 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmFloodlightActivityGroupId - 플러드라이트 전환과 연결된 DCM 플러드라이트 활동 그룹 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmFloodlightActivityId - 플러드라이트 전환과 연결된 DCM 플러드라이트 활동 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmFloodlightAdvertiserId - 플러드라이트 전환과 연결된 DCM 플러드라이트 광고주 ID입니다(프리미엄만 해당)
  • 측정기준 - ga:dcmFloodlightSpotId - 플러드라이트 전환과 연결된 DCM 플러드라이트 구성 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventAd - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventAdId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventAdType - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고 유형 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventAdTypeId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고 유형 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventAdvertiser - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고주 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventAdvertiserId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고주 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventAttributionType - ClickThrough와 ViewThrough 두 개의 값을 사용할 수 있습니다. Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트가 클릭이었던 경우 값은 ClickThrough입니다. Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트가 광고 노출이었던 경우 값은 ViewThrough입니다(프리미엄만 해당).
  • 측정기준 - ga:dcmLastEventCampaign - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 캠페인 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventCampaignId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 캠페인 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventCreative - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고 소재 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventCreativeId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고 소재 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventCreativeType - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고 소재 유형 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventCreativeTypeId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고 소재 유형 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventCreativeVersion - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 광고 소재 버전(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventRenderingId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 렌더링 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventSite - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)에 대해 DCM 광고 소재가 표시되고 클릭된 사이트 이름(프리미엄만 해당).
  • 측정기준 - ga:dcmLastEventSiteId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)에 대해 DCM 광고 소재가 표시되고 클릭된 DCM 사이트 ID(프리미엄만 해당).
  • 측정기준 - ga:dcmLastEventSitePlacement - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 사이트 게재위치 이름(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventSitePlacementId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 사이트 게재위치 ID(프리미엄만 해당)
  • 측정기준 - ga:dcmLastEventSpotId - Google 애널리틱스 세션과 연결된 마지막 DCM 이벤트(DCM 전환 확인 기간 내 노출 또는 클릭)의 DCM 플러드라이트 구성 ID(프리미엄만 해당)
  • 측정항목 - ga:dcmFloodlightQuantity - DCM 플러드라이트 전환수(프리미엄만 해당)
  • 측정항목 - dcmFloodlightRevenue - DCM 플러드라이트 수익(프리미엄만 해당)

이 출시 버전에는 새로운 콘텐츠 분류 측정기준 및 측정항목이 추가되었습니다.

측정기준 및 측정항목

전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

콘텐츠 분류

  • 측정기준 - ga:landingContentGroupXX - 사용자 세션에서 첫 번째로 일치하는 콘텐츠 그룹
  • 측정기준 - ga:nextContentGroupXX - 다른 콘텐츠 그룹 이후에 방문한 콘텐츠 그룹을 나타냅니다.
  • 측정기준 - ga:contentGroupXX - 속성의 콘텐츠 그룹. 콘텐츠 그룹은 추적 코드 또는 페이지 제목/URL 정규 표현식이나 사전 정의된 규칙에 따라 결정될 수 있는 논리적인 구조를 제공하는 콘텐츠 모음입니다.
  • 측정기준 - ga:previousContentGroupXX - 다른 콘텐츠 그룹 이전에 방문한 콘텐츠 그룹을 나타냅니다.
  • 측정항목 - ga:contentGroupUniqueViewsXX: 지정된 콘텐츠 그룹에 대한 세션 내 서로 다른(고유한) 페이지 수. pagePath 및 pageTitle을 모두 고려하여 고유성을 판단합니다.

이 출시 버전에는 세그먼트에 대한 새로운 dateOfSession 조건이 포함되고 새로운 향상된 전자상거래 측정기준 및 측정항목이 추가되었습니다.

세그먼트

이제 세그먼트에서 특정 기간 내에 세션을 시작한 사용자 그룹으로 세그먼트를 제한할 수 있는 새로운 dateOfSession 조건을 지원합니다. 자세한 내용은 세그먼트 개발자 가이드를 참고하세요.

측정기준 및 측정항목

향상된 전자상거래에 대한 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

향상된 전자상거래

  • 측정기준 - ga:internalPromotionCreative - 프로모션을 위해 디자인된 광고 소재 콘텐츠
  • 측정기준 - ga:internalPromotionId - 프로모션에 사용 중인 ID
  • 측정기준 - ga:internalPromotionName - 프로모션의 이름
  • 측정기준 - ga:internalPromotionPosition - 웹페이지 또는 애플리케이션 화면에서 프로모션의 위치
  • 측정기준 - ga:orderCouponCode - 주문 수준 쿠폰의 코드
  • 측정기준 - ga:productBrand - 판매하는 제품의 브랜드 이름
  • 측정기준 - ga:productCategoryHierarchy - 제품이 분류되어 있는 계층별 카테고리(향상된 전자상거래)
  • 측정기준 - ga:productCategoryLevelXX - 제품 카테고리 계층 구조 내 등급(1~5), 맨 위에서부터 시작
  • 측정기준 - ga:productCouponCode - 제품 수준 쿠폰의 코드
  • 측정기준 - ga:productListName - 제품이 표시되는 제품 목록의 이름
  • 측정기준 - ga:productListPosition - 제품 목록에서 제품이 표시되는 위치
  • 측정기준 - ga:productVariant - 제품의 구체적인 옵션(예: 사이즈는 XS, S, M, L, 색상은 빨간색, 파란색, 녹색, 검은색
  • 측정기준 - ga:checkoutOptions - 결제 절치에서 지정한 사용자 옵션(예: 배송 옵션: FedEx, DHL, UPS, 결제 옵션: Visa, MasterCard, AmEx). 이 측정기준은 쇼핑 단계와 함께 사용되어야 합니다.
  • 측정기준 - ga:shoppingStage - 사용자가 한 세션에서 완료한 여러 쇼핑 단계(예: Product_VIEW, ADD_TO_CART, CHECKOUT 등
  • 측정항목 - ga:internalPromotionCTR - 사용자가 내부 프로모션을 보기 위해 클릭연결한 비율(클릭수/프로모션이 표시된 횟수)
  • 측정항목 - ga:internalPromotionClicks - 내부 프로모션 클릭수
  • 측정항목 - ga:internalPromotionViews - 내부 프로모션 조회수
  • 측정항목 - ga:localProductRefundAmount - 지정된 제품에 대한 환불 금액(현지 통화)
  • 측정항목 - ga:localRefundAmount - 거래에 대한 환불 금액(현지 통화)
  • 측정항목 - ga:productAddsToCart - 제품이 장바구니에 추가된 횟수
  • 측정항목 - ga:productCheckouts - 제품이 결제 절차에 포함된 횟수
  • 측정항목 - ga:productDetailViews - 사용자가 제품 세부정보 페이지를 조회한 횟수
  • 측정항목 - ga:productListClicks - 제품이 제품 목록에 표시되었을 때 사용자가 해당 제품을 클릭한 횟수
  • 측정항목 - ga:productListViews - 제품이 제품 목록에 표시된 횟수
  • 측정항목 - ga:productListCTR - 사용자가 제품 목록의 제품을 클릭연결한 비율
  • 측정항목 - ga:productRefunds - 제품이 환불 처리된 횟수
  • 측정항목 - ga:productRefundAmount - 제품과 연결된 총 환불 금액
  • 측정항목 - ga:productRemovesFromCart - 제품이 장바구니에서 삭제된 횟수
  • 측정항목 - ga:productRevenuePerPurchase - 구매 건당 평균 제품 수익(일반적으로 제품 쿠폰 코드와 함께 사용됨)
  • 측정항목 - ga:buyToDetailRate - 순 구매수를 제품 세부정보 페이지의 조회수로 나눈 값
  • 측정항목 - ga:cartToDetailRate - 제품 추가 수를 제품 세부정보 조회수로 나눈 값
  • 측정항목 - ga:quantityAddedToCart - 장바구니에 추가된 제품 단위의 수
  • 측정항목 - ga:quantityCheckedOut - 결제에 포함된 제품 단위의 수
  • 측정항목 - ga:quantityRefunded - 환불된 제품 단위의 수
  • 측정항목 - ga:quantityRemovedFromCart - 장바구니에서 삭제된 제품 단위의 수
  • 측정항목 - ga:refundAmount - 거래에 대해 환불된 통화 금액
  • 측정항목 - ga:totalRefunds - 환불 처리된 횟수

이 출시 버전에서는 열 헤더 이름에 대한 버그가 수정되고 새로운 측정기준 및 측정항목이 추가되었습니다.

측정기준 및 측정항목

전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

시스템

  • 측정기준 - ga:sourcePropertyDisplayName - 롤업 속성의 소스 속성 표시 이름. 롤업 속성에 대해서만 유효합니다.
  • 측정기준 - ga:sourcePropertyTrackingId - 롤업 속성의 소스 속성 추적 ID. 롤업 속성에 대해서만 유효합니다.

채널 그룹

  • 측정기준 - ga:channelGrouping - 보기(프로필) 내에서 공유되는 기본 채널 그룹
  • 측정기준 - ga:correlationModelId - 관련 제품의 상관관계 모델 ID
  • 측정기준 - ga:queryProductId - 쿼리되는 제품의 ID
  • 측정기준 - ga:queryProductName - 쿼리되는 제품의 이름
  • 측정기준 - ga:queryProductVariation - 쿼리되는 제품의 옵션
  • 측정기준 - ga:relatedProductId - 관련 제품의 ID
  • 측정기준 - ga:relatedProductName - 관련 제품의 이름
  • 측정기준 - ga:relatedProductVariation - 관련 제품의 옵션
  • 측정항목 - ga:correlationScore - 관련 제품의 상관관계 점수
  • 측정항목 - ga:queryProductQuantity - 쿼리되는 제품의 수량
  • 측정항목 - ga:relatedProductQuantity - 관련 제품의 수량

헤더 열 이름 수정

  • 2014년 4월 16일 출시 버전에 지원 중단된 측정기준이나 측정항목을 쿼리하면 API에서 대체 측정기준 또는 측정항목이 포함된 열 헤더를 반환하는 버그가 있었습니다. 이제 요청에 사용된 동일한 측정기준 또는 측정항목 이름을 올바르게 반환합니다.

이 출시 버전에는 측정기준 및 측정항목이 추가되고 이름이 변경되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

새로운 측정기준 및 측정항목

Core Reporting API에 다음과 같은 측정기준이 추가되었습니다.

애드워즈

  • 측정기준 - ga:isTrueViewVideoAd - Yes 또는 No - 광고가 Google Ads TrueView 동영상 광고인지 여부를 나타냅니다.

시간

  • 측정기준 - ga:nthHour - 지정한 기간의 각 시간에 대한 색인입니다. 기간 첫날(시작 날짜)의 첫 1시간에 대한 색인은 0, 다음 1시간에 대한 색인은 1이고 이런 식으로 계속됩니다.

측정기준 및 측정항목 이름이 변경됨

모든 방문자방문 기반 측정기준과 측정항목의 이름이 각각 사용자세션을 대신 사용하도록 변경되었습니다.

다음 측정기준 및 측정항목의 이름이 변경되었습니다. 데이터 이름 변경에 대한 자세한 내용은 데이터 지원 중단 정책을 참고하세요.

대상

  • 측정기준 - ga:visitorAgeBracket - ga:userAgeBracket을 대신 사용하세요.
  • 측정기준 - ga:visitorGender - ga:userGender을 대신 사용하세요.

전자상거래

  • 측정항목 - ga:transactionRevenuePerVisit - ga:transactionRevenuePerSession을 대신 사용하세요.
  • 측정항목 - ga:transactionsPerVisit - ga:transactionsPerSession을 대신 사용하세요.

이벤트 추적

  • 측정항목 - ga:eventsPerVisitWithEvent - ga:eventsPerSessionWithEvent를 대신 사용하세요.
  • 측정항목 - ga:visitsWithEvent - ga:sessionsWithEvent를 대신 사용하세요.

목표 전환

  • 측정항목 - ga:goalValuePerVisit - ga:goalValuePerSession을 대신 사용하세요.
  • 측정항목 - ga:percentVisitsWithSearch - ga:percentSessionsWithSearch를 대신 사용하세요.
  • 측정항목 - ga:searchVisits - ga:searchSessions을 대신 사용하세요.

페이지 추적

  • 측정항목 - ga:pageviewsPerVisit - ga:pageviewsPerSession을 대신 사용하세요.

세션

  • 측정기준 - ga:visitLength - ga:sessionDurationBucket을 대신 사용하세요.
  • 측정항목 - ga:avgTimeOnSite - ga:avgSessionDuration를 대신 사용하세요.
  • 측정항목 - ga:timeOnSite - ga:sessionDuration를 대신 사용하세요.
  • 측정항목 - ga:visitBounceRate - ga:bounceRate를 대신 사용하세요.
  • 측정항목 - ga:visits - ga:sessions를 대신 사용하세요.

소셜 상호작용

  • 측정기준 - ga:socialInteractionNetworkActionVisit - ga:socialInteractionNetworkActionSession을 대신 사용하세요.
  • 측정항목 - ga:socialInteractionsPerVisit - ga:socialInteractionsPerSession를 대신 사용하세요.

사용자

  • 측정기준 - ga:daysSinceLastVisit - ga:daysSinceLastSession을 대신 사용하세요.
  • 측정기준 - ga:visitCount - ga:sessionCount을 대신 사용하세요.
  • 측정기준 - ga:visitorType - ga:userType을 대신 사용하세요.
  • 측정기준 - ga:visitsToTransaction - ga:sessionsToTransaction을 대신 사용하세요.
  • 측정항목 - ga:newVisits - ga:newUsers를 대신 사용하세요.
  • 측정항목 - ga:percentNewVisits - ga:percentNewSessions를 대신 사용하세요.
  • 측정항목 - ga:visitors - ga:users를 대신 사용하세요.

세그먼트: Core Reporting API v2.4 및 v3.0

Core Reporting API에서 새로운 세그먼트가 지원됩니다.

  • 이제 segment 매개변수가 사용자 및 시퀀스 세그먼트를 지원합니다. segment 매개변수를 사용하여 웹 인터페이스에서 생성된 사용자 수준세션 수준 세그먼트를 쿼리할 수 있습니다.
  • 동적 세그먼트의 새로운 구문을 segment 매개변수와 함께 사용할 수 있습니다. 자세한 내용은 세그먼트 개발자 가이드를 참고하세요.
  • dynamic:: 접두어는 지원 중단되었습니다. 최대한 빨리 새로운 구문으로 이전하는 것이 좋습니다.

이 출시 버전에는 새로운 데이터 표 응답 형식이 포함되어 있으며 측정기준 및 측정항목이 추가되고 지원 중단되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

데이터 표 출력

Google 차트 시각화를 사용하여 Google 애널리틱스 데이터를 더 쉽게 렌더링할 수 있도록 API가 선택적으로 응답에 데이터 표 객체를 반환할 수 있습니다.

  • 선택적 output 쿼리 매개변수가 API에 추가되었습니다. 응답에서 애널리틱스 데이터의 출력 형식(기본적으로 JSON)을 선택하는 데 사용할 수 있습니다. datatable로 설정하면 데이터 표 객체가 포함된 dataTable 속성이 응답에 포함됩니다. 이 객체는 Google 차트와 함께 직접 사용할 수 있습니다. 자세한 내용은 Core Reporting API 참조를 참고하세요.

새로운 측정기준 및 측정항목

다음 측정기준 및 측정항목이 Core Reporting API에 추가되었습니다.

시간

  • 측정기준 - ga:minute - 시간(분)을 반환합니다. 가능한 값은 00~59입니다.
  • 측정기준 - ga:nthMinute - 지정한 기간의 각 분에 대한 색인입니다. 기간 첫날(시작 날짜)의 첫 1분에 대한 색인은 0, 다음 1분에 대한 색인은 1이고 이런 식으로 계속됩니다.

대상

  • 측정기준 - ga:visitorAgeBracket - 방문자의 연령대
  • 측정기준 - ga:visitorGender - 방문자의 성별
  • 측정기준 - ga:interestAffinityCategory - 사용자가 지정된 카테고리에 관심을 가질 가능성이 크다는 것을 나타냅니다.
  • 측정기준 - ga:interestInMarketCategory - 사용자가 지정된 카테고리에서 제품 또는 서비스를 구매할 가능성이 크다는 것을 나타냅니다.
  • 측정기준 - ga:interestOtherCategory: 사용자가 지정된 카테고리에 관심이 있을 가능성이 크고 구매할 가능성이 크다는 것을 나타냅니다.

세그먼트에 허용되는 측정기준 및 측정항목

이제 세그먼트에서 다음 측정기준과 측정항목을 사용할 수 있습니다.

  • 측정기준 - ga:sourceMedium - ga:sourcega:medium을 결합한 값
  • 측정항목 - ga:localItemRevenue - 제품 수익(현지 통화)

지원 중단된 측정기준 및 측정항목

다음 측정기준과 측정항목은 지원 중단되었습니다. 데이터 삭제에 대한 자세한 내용은 데이터 지원 중단 정책을 참고하세요.

  • 측정기준 - ga:isMobile - ga:deviceCategory를 대신 사용하세요(예: ga:deviceCategory==mobile).
  • 측정기준 - ga:isTablet - ga:deviceCategory를 대신 사용하세요(예: ga:deviceCategory==tablet).
  • 측정항목 - ga:entranceBounceRate - ga:visitBounceRate를 대신 사용하세요.

이 출시 버전에서는 API에 새 측정기준 및 측정항목이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

애드센스

  • 애드센스 데이터에 대한 액세스 권한이 추가되었습니다.

    • 측정항목 - ga:adsenseRevenue - 애드센스 광고에서 발생한 총 수익
    • 측정항목 - ga:adsenseAdUnitsViewed - 조회된 애드센스 광고 단위의 수 광고 단위는 애드센스 광고 코드 하나를 추가하여 게재되는 광고 조합입니다. 자세한 내용은 https://support.google.com/adsense/answer/32715를 참고하세요.
    • 측정항목 - ga:adsenseAdsViewed - 조회된 애드센스 광고의 수. 한 광고 단위 내에 여러 광고를 표시할 수 있습니다.
    • 측정항목 - ga:adsenseAdsClicks - 사이트에서 애드센스 광고가 클릭된 횟수
    • 측정항목 - ga:adsensePageImpressions - 애드센스 광고가 게재된 페이지 조회수. 한 페이지 노출에 여러 광고 단위가 포함될 수 있습니다.
    • 측정항목 - ga:adsenseCTR - 애드센스 광고 클릭으로 이어진 페이지 노출의 비율 (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • 측정항목 - ga:adsenseECPM - 페이지 노출 1,000회당 예상 비용. 페이지 노출 1,000회당 애드센스 수익입니다. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • 측정항목 - ga:adsenseExits - 사용자가 애드센스 광고를 클릭하여 종료된 세션수

시간

  • 측정기준 - ga:isoYear - 방문의 ISO 연도. 세부정보: http://ko.wikipedia.org/wiki/ISO_week_date ga:week는 그레고리력을 나타내므로 ga:isoYearga:isoWeek와 함께만 사용해야 합니다.
  • 측정기준 - ga:isoYearIsoWeek - ga:isoYearga:isoWeek를 결합한 값

Google Ads

  • 이 데이터는 Google Ads 보고서에 포함됩니다.

새로운 샘플 크기 컨트롤 및 상대적 날짜 기능

상대적 날짜
  • 상대적 날짜에 대한 지원이 Core Reporting API에 추가되었습니다. 이제 today, yesterday, NdaysAgo이 유효한 start-dateend-date 쿼리 매개변수 값입니다.
  • 이 값을 사용하면 현재 날짜의 쿼리된 시간 및 쿼리에 지정된 보기(프로필)의 시간대를 기준으로 자동으로 기간이 결정됩니다. 자세한 내용은 API 참조를 참고하세요.
샘플링 수준
  • 보고 조회의 샘플링 수준(결과를 계산하는 데 사용된 방문수)을 설정할 수 있는 새로운 매개변수 samplingLevel이 도입되었습니다. 허용되는 값은 DEFAULT, FASTER, HIGHER_PRECISION입니다.
  • API 응답에 sampleSizesampleSpace 2개의 필드가 새로 추가되었습니다. 이 값을 사용하여 샘플링된 응답에 사용된 방문 수의 비율을 계산할 수 있습니다.
  • 자세한 내용은 API 참조샘플링을 참고하세요.

버그 수정

  • 이제 ga:adwordsCustomerID에서 Google Ads API AccountInfo.customerId에 해당하는 10자리 Google Ads 고객 ID를 올바르게 반환합니다. 이를 통해 애널리틱스 데이터를 여러 Google Ads 계정과 연결할 수 있습니다.

새로운 세그먼트 출시의 일부로 Core Reporting API에 다음과 같은 변경사항이 포함됩니다.

  • segment 매개변수가 이제 Management API 세그먼트 컬렉션에 반환되는 맞춤 고급 세그먼트의 새로운 영숫자 ID를 지원합니다.
  • 맞춤 세그먼트의 현재 숫자 ID는 이제 지원 중단됩니다. 기존 ID는 6개월 동안 계속 지원됩니다. 사용자 세그먼트 ID를 저장하는 애플리케이션은 새로운 영숫자 ID로 전환하는 것이 좋습니다. 지원 중단 기간이 종료된 후 이전의 숫자 ID가 포함된 쿼리는 오류를 반환합니다.
  • 현재 웹 인터페이스에서 생성된 방문 수준 세그먼트만 segment 매개변수를 통해 쿼리할 수 있습니다.
  • 음수 ID가 있는 기존 기본 세그먼트는 영향을 받지 않습니다. 그러나 새로운 기본 세그먼트는 현재 지원되지 않습니다.

이 출시 버전에서는 API에 새 측정기준 및 측정항목이 추가되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

앱 추적

  • 이 데이터는 앱 프로필 보고서에 포함됩니다.
    • 측정기준 - ga:appId - 애플리케이션의 ID
    • 측정기준 - ga:appInstallerId - 앱을 다운로드한 설치 프로그램(예: Google Play 스토어)의 ID. 기본적으로 앱 설치 프로그램 ID는 PackageManager#getInstallerPackageName 메서드를 기반으로 설정됩니다.
    • 측정기준 - ga:appName - 애플리케이션의 이름
    • 측정기준 - ga:appVersion - 애플리케이션의 버전
    • 측정기준 - ga:exitScreenName - 사용자가 애플리케이션을 종료할 때의 화면 이름
    • 측정기준 - ga:landingScreenName - 조회된 첫 화면의 이름
    • 측정기준 - ga:screenDepth - 문자열로 보고한 세션당 화면 조회수. 막대 그래프 사용 시 유용합니다.
    • 측정기준 - ga:screenName - 화면의 이름
    • 측정항목 - ga:avgScreenviewDuration - 사용자가 화면에서 소비한 평균 시간(초)
    • 측정항목 - ga:timeOnScreen - 현재 화면을 보는 데 소요된 시간
    • 측정항목 - ga:screenviews - 총 화면 조회수. ga:appviews 대신 사용하세요.
    • 측정항목 - ga:uniqueScreenviews: 세션 내 서로 다른(고유한) ga:screenviews 수. ga:uniqueAppviews 대신 사용하세요.
    • 측정항목 - ga:screenviewsPerSession - 세션당 평균 ga:screenviews 수. ga:appviewsPerVisit 대신 사용하세요.

지원 중단됨

다음 측정항목은 지원 중단되었습니다. 대신 새로운 측정항목 이름을 사용하세요.

  • 측정항목 - ga:appviews - 대신 ga:screenviews를 사용하세요.
  • 측정항목 - ga:uniqueAppviews - 대신 ga:uniqueScreenviews를 사용하세요.
  • 측정항목 - ga:appviewsPerVisit - 대신 ga:screenviewsPerSession을 사용하세요.

맞춤 변수 또는 열

  • 맞춤 측정기준 및 측정항목에 대한 액세스:

    • 측정기준 - ga:dimensionXX: 요청된 맞춤 측정기준의 이름. 여기서 XX는 맞춤 측정기준의 번호/색인을 가리킵니다.
    • 측정항목 - ga:metricXX: 요청된 맞춤 측정항목의 이름. 여기서 XX는 맞춤 측정항목의 번호/색인을 가리킵니다.

문서 변경사항

다음 맞춤 변수 측정기준 및 측정항목의 이름이 변경되었습니다. 문서에서만 변경되었으며 쿼리를 업데이트할 필요는 없습니다.

  • ga:customVarName(n)ga:customVarNameXX
  • ga:customVarValue(n)ga:customVarValueXX

전자상거래

  • 측정기준 - ga:currencyCode - ISO 4217 표준을 기반으로 하는 거래의 현지 통화 코드
  • 측정항목 - ga:localItemRevenue - 제품 수익(현지 통화)
  • 측정항목 - ga:localTransactionRevenue - 거래 수익(현지 통화)
  • 측정항목 - ga:localTransactionShipping - 거래 배송비(현지 통화)
  • 측정항목 - ga:localTransactionTax - 거래세(현지 통화)

예외

  • 이 데이터는 예외 추적에서 가져옵니다.
    • 측정기준 - ga:exceptionDescription - 예외에 대한 설명
    • 측정항목 - ga:exceptionsPerScreenview - 발생한 예외수를 화면 조회수로 나눈 값
    • 측정항목 - ga:fatalExceptionsPerScreenview - 발생한 치명적인 예외수를 화면 조회수로 나눈 값

목표 전환

  • 측정기준 - ga:goalCompletionLocation - 대상 위치 유형 목표 달성과 일치하는 페이지 경로 또는 화면 이름
  • 측정기준 - ga:goalPreviousStep1 - 목표 달성 위치 한 단계 전 대상 위치 유형 목표와 일치하는 페이지 경로 또는 화면 이름
  • 측정기준 - ga:goalPreviousStep2 - 목표 달성 위치 두 단계 전 대상 위치 유형 목표와 일치하는 페이지 경로 또는 화면 이름
  • 측정기준 - ga:goalPreviousStep3 - 목표 달성 위치 세 단계 전 대상 위치 유형 목표와 일치하는 페이지 경로 또는 화면 이름

문서 변경사항

다음 목표 전환 측정기준 및 측정항목의 이름이 변경되었습니다. 문서에서만 변경되었으며 쿼리를 업데이트할 필요는 없습니다.

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • 측정항목 - ga:percentSearchRefinements - 한 세션 내에서 내부 검색 키워드 간에 상세검색 예: 전환)이 발생한 횟수의 비율

페이지 추적

  • 측정항목 - ga:pageValue - 이 페이지 또는 페이지 집합의 평균 값. 페이지 값은 (거래 수익 + 총 목표값)을 페이지 또는 페이지 집합의 순 페이지 조회수로 나눈 값입니다.

플랫폼 또는 기기

  • 이 데이터는 HTTP User-Agent 문자열에서 파생됩니다.

    • 측정기준 - ga:deviceCategory - 기기의 유형(데스크톱, 태블릿, 모바일).
    • 측정기준 - ga:isTablet - 태블릿 방문자를 나타냅니다. 가능한 값은 Yes 또는 No입니다.
    • 측정기준 - ga:mobileDeviceMarketingName - 휴대기기에 사용된 마케팅 이름

소셜 상호작용

  • 이 데이터는 사이트 내 소셜 상호작용 추적에서 가져옵니다.

    • 측정기준 - ga:socialEngagementType - 참여 유형. 가능한 값은 Socially Engaged 또는 Not Socially Engaged입니다.

시간

  • 측정기준 - ga:dateHour - ga:datega:hour를 결합한 값
  • 측정기준 - ga:dayOfWeekName - 요일의 이름(영어)
  • 측정기준 - ga:isoWeek - 월요일로 시작하는 ISO 주의 번호. 세부정보: http://ko.wikipedia.org/wiki/ISO_week_date
  • 측정기준 - ga:yearMonth - ga:yearga:month를 결합한 값
  • 측정기준 - ga:yearWeek - ga:yearga:week를 결합한 값

트래픽 소스

  • 측정기준 - ga:fullReferrer - 호스트 이름과 경로가 포함된 전체 참조 URL
  • 측정기준 - ga:sourceMedium - ga:sourcega:medium을 결합한 값
  • 이 출시 버전에는 2개의 새로운 실험 측정항목(- ga:experimentId - ga:experimentVariant)이 추가되었습니다.
  • 이 출시 버전에는 5가지 새로운 사이트 속도 측정항목이 추가되었습니다.
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • 이 출시 버전에는 태블릿 트래픽 gaid::-13에 새로운 기본 세그먼트가 추가되었습니다.

이 출시 버전에서는 API에 새 측정기준 및 측정항목이 추가되었습니다. 측정기준 및 측정항목 참조의 정의를 참고하세요.

앱 추적

  • 이 데이터는 모바일 앱 추적 SDK 보고서에 포함됩니다.
    • 측정항목 - ga:uniqueAppviews - 세션당 앱 조회수
    • 측정항목 - 'ga:appviews - 총 앱 조회수
    • 측정항목 - ga:appviewsPerVisit - 세션당 평균 앱 조회수

트래픽 소스

  • 측정기준 - ga:socialNetwork - 소셜 네트워크 이름을 나타내는 문자열. 트래픽 소스의 추천 소셜 네트워크 또는 소셜 데이터 허브 활동을 위한 소셜 네트워크와 관련이 있을 수 있습니다. 예: Google+, Blogger, Reddit 등
  • 측정기준 - ga:hasSocialSourceReferral - 소셜 소스(Google+, Facebook, 트위터 등의 사회 연결망)를 통해 사이트에 도착한 방문을 나타냅니다. 가능한 값은 Yes 또는 No이며 첫 번째 글자는 대문자로 표기해야 합니다.

소셜 활동

  • 이 데이터는 소셜 데이터 허브 파트너로부터 가져온 외부 활동에서 가져옵니다.
    • 측정기준 - ga:socialActivityDisplayName - 소셜 데이터 허브 활동의 경우 이 문자열은 소셜 네트워크 사용자가 게시한 소셜 활동의 제목을 나타냅니다.
    • 측정기준 - ga:socialActivityEndorsingUrl - 소셜 데이터 허브 활동의 경우 이 문자열은 소셜 활동의 URL을 나타냅니다(예: Google+ 소식 URL, 블로그 댓글 URL).
    • 측정기준 - ga:socialActivityPost - 소셜 데이터 허브 활동의 경우 이 문자열은 소셜 네트워크 사용자가 게시한 소셜 활동의 콘텐츠를 나타냅니다(예: Google+ 소식의 메시지 콘텐츠).
    • 측정기준 - ga:socialActivityTimestamp - 소셜 데이터 허브 활동의 경우 이 문자열은 소셜 활동이 소셜 네트워크에서 발생한 시기를 나타냅니다.
    • 측정기준 - ga:socialActivityUserPhotoUrl - 소셜 데이터 허브 활동의 경우 이 문자열은 사용자의 소셜 네트워크 프로필과 연결된 사진의 URL을 나타냅니다.
    • 측정기준 - ga:socialActivityUserProfileUrl - 소셜 데이터 허브 활동의 경우 이 문자열은 연결된 사용자의 소셜 네트워크 프로필의 URL을 나타냅니다.
    • 측정기준 - ga:socialActivityContentUrl - 소셜 데이터 허브 활동의 경우 이 문자열은 연결된 소셜 네트워크 사용자가 공유하는 URL을 나타냅니다.
    • 측정기준 - ga:socialActivityTagsSummary - 소셜 데이터 허브 활동의 경우 소셜 활동과 연결된 쉼표로 구분된 태그 집합입니다.
    • 측정기준 - ga:socialActivityUserHandle - 소셜 데이터 허브 활동의 경우 이 문자열은 소셜 활동을 시작한 사용자의 사회 연결망 핸들(이름)을 나타냅니다.
    • 측정기준 - ga:socialActivityAction - 소셜 데이터 허브 활동의 경우 이 문자열은 활동과 관련된 소셜 액션의 유형을 나타냅니다(예: 투표, 댓글, +1 등).
    • 측정기준 - ga:socialActivityNetworkAction - 소셜 데이터 허브 활동의 경우 소셜 액션의 유형과 활동이 발생한 소셜 네트워크를 나타냅니다.
    • 측정항목 - ga:socialActivities - 소셜 데이터 허브 파트너 네트워크에서 콘텐츠 URL이 공유/언급된 활동 수

소셜 상호작용

  • 이 데이터는 사이트 내 소셜 상호작용 추적에서 가져옵니다.
    • 측정기준 - ga:socialInteractionAction - 소셜 상호작용의 경우 추적 중인 소셜 액션을 나타내는 문자열(예: +1, 좋아요, 북마크)
    • 측정기준 - ga:socialInteractionNetwork - 소셜 상호작용의 경우 추적 중인 사회 연결망을 나타내는 문자열(예: Google, Facebook, 트위터, LinkedIn)
    • 측정기준 - ga:socialInteractionNetworkAction - 소셜 상호작용의 경우 추적 중인 ga:socialInteractionNetworkga:socialInteractionAction 연결을 나타내는 문자열(예: Google: +1, Facebook: 좋아요)
    • 측정기준 - ga:socialInteractionTarget - 소셜 상호작용의 경우 사회 연결망 액션을 수신하는 URL(또는 리소스)을 나타내는 문자열
    • 측정항목 - ga:socialInteractions - 사이트에서 발생한 소셜 상호작용의 총 횟수
    • 측정항목 - ga:uniqueSocialInteractions - 사이트에서 발생한 고유한 소셜 상호작용의 총 횟수. ga:socialInteractionNetworkga:socialInteractionAction 값 쌍을 기반으로 합니다.
    • 측정항목 - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions. 사이트 방문당 평균 소셜 상호작용 수

지역/네트워크

  • 측정기준 - ga:metro - 트래픽이 발생한 지정 시장 지역(DMA)

페이지 추적

  • 측정기준 - ga:pagePathLevel1 - pagePath의 첫 번째 계층구조 수준에서 모든 pagePath를 롤업하는 측정기준입니다.
  • 측정기준 - ga:pagePathLevel2 - pagePath의 두 번째 계층구조 수준에서 모든 pagePath를 롤업하는 측정기준입니다.
  • 측정기준 - ga:pagePathLevel3 - pagePath의 세 번째 계층구조 수준에서 모든 pagePath를 롤업하는 측정기준입니다.
  • 측정기준 - ga:pagePathLevel4 - pagePath의 네 번째 계층구조 수준에서 모든 pagePath를 롤업하는 측정기준입니다. pagePath 계층구조에서 추가되는 모든 수준이 이 측정기준에서 롤업됩니다.

예외 추적

  • 이 데이터는 예외 추적 데이터에서 가져옵니다.

    • 측정항목 - ga:exceptions - Google 애널리틱스로 전송된 예외수
    • 측정항목 - ga:fatalExceptions - isFatal이 true로 설정된 예외수

사용자 시간

  • 이 데이터는 사용자 시간 데이터에서 가져옵니다.

    • 측정기준 - ga:userTimingCategory - 더 쉬운 보고를 위해 모든 사용자 시간 변수를 논리적 그룹으로 분류하는 문자열
    • 측정기준 - ga:userTimingLabel - 추적 중인 리소스의 작업 이름을 나타내는 문자열
    • 측정기준 - ga:userTimingVariable - 보고서에서 사용자 시간을 더 유연하게 시각화하는 사용할 수 있는 문자열
    • 측정기준 - ga:userTimingValue Google 애널리틱스로 전송하는 데 경과한 시간(밀리초)
    • 측정항목 - ga:userTimingSample - 전송된 샘플 수
    • 측정항목 - ga:avgUserTimingValue - 평균 사용자 시간 값. ga:userTimiingValue/ga:userTimiingSample

기기/플랫폼

  • 이 데이터는 수집된 데이터의 사용자 에이전트에서 가져옵니다.
    • 측정기준 - ga:mobileDeviceBranding - 모바일 제조업체 또는 브랜드 이름 (예: 삼성, HTC, Verizon, T-Mobile)
    • 측정기준 - ga:mobileDeviceModel - 휴대기기 모델(예: Nexus S)
    • 측정기준 - ga:mobileInputSelector - 휴대기기에서 사용되는 선택기(예: 터치스크린, 조이스틱, 클릭 휠, 스타일러스)
    • Dim - ga:mobileDeviceInfo - 휴대기기를 나타내기 위해 사용되는 브랜딩, 모델 및 마케팅 이름

버그 수정

  • 이제 API가 필터 또는 동적 세그먼트의 UTF-8 문자를 올바르게 처리합니다.

이 출시 버전에서는 Google 애널리틱스 프리미엄 계정에서 최대 50개의 맞춤 변수에 액세스할 수 있습니다.

이 출시 버전에서는 2개의 버그가 수정되었습니다.

버그 수정

  • 정규 표현식 안에 특수 문자가 포함된 쿼리 필터에서 더 이상 서버 오류를 반환하지 않습니다.

  • 측정항목 필터를 고급 세그먼트와 결합해도 더 이상 오류가 반환되지 않습니다.

이 출시 버전에는 API에 새로운 사이트 속도 측정항목이 추가되었습니다.

새 측정항목

  • 다음 사이트 속도 측정항목이 추가되었습니다.
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

측정기준 및 측정항목 참조의 정의를 참고하세요.

API 버전 2.3 지원 중단 알림

  • Data Export API 버전 2.3이 2개월 전에 지원 중단되었습니다. 이 서비스는 약 4개월 후에 종료되며 새로운 Core Reporting API 버전 3.0버전 2.4만 지원됩니다.

  • 애플리케이션을 버전 3.0으로 이전하는 것이 좋습니다.

  • 4개월 후에는 기존 버전 2.3 XML 데이터 피드에 대한 요청이 버전 2.4로 전달되고 버전 2.4 XML 응답을 반환합니다. 이때 모든 버전 2.4 할당량 정책이 버전 2.3 요청에 적용됩니다.

  • 버전 2.3 JSON 또는 버전 2.3 JSON 출력을 사용하는 Google 데이터 자바스크립트 클라이언트 라이브러리에 대한 모든 요청은 404 상태 코드를 반환합니다.

  • 전체 할당량을 사용하려면 버전 3.0 및 버전 2.4 모두 Google API 콘솔에 애플리케이션을 등록하고 각 요청에 API 키(또는 OAuth 2.0 토큰)를 사용해야 합니다.

ga:visitLength의 사소한 버그가 수정되었습니다. 이 측정기준이 이제 올바른 데이터를 반환합니다.

이 출시 버전은 모든 Google 애널리틱스 API 개발자에게 영향을 미칩니다. 이 버전에는 API의 두 가지 새로운 버전이 추가되었으며, 애플리케이션을 등록해야 하고 새 할당량 정책이 도입되고, API 이름이 Core Reporting API로 변경되었습니다. 마지막으로 기존 Data Export API 버전 2.3이 지원 중단되었습니다.

버전 3.0

  • Core Reporting API 버전 3.0은 API의 최신 메이저 버전으로 이전 버전과 호환되지 않습니다. 향후 모든 API 개발은 이 버전에서 실행됩니다.

  • 새로운 기능

  • 업데이트

    • 요청하기 위한 새로운 URL: https://www.googleapis.com/analytics/v3/data/ga…
    • 등록 및 개발자 토큰이 필요합니다.
    • 구성 데이터에 대한 모든 요청은 Management API를 통해 실행해야 합니다.

버전 2.4

  • Core Reporting API 버전 2.4는 기존의 Data Export API 버전 2.3과 대부분 호환되는 부 버전 업그레이드입니다.

  • 업데이트

    • 요청하기 위한 새로운 URL: https://www.googleapis.com/analytics/v2.4/data…
    • 등록 및 개발자 토큰이 필요합니다.
    • XML 출력이 버전 2.3과 일치하므로 다른 기존 Google 데이터 클라이언트 라이브러리가 계속 작동합니다.
    • 할당량 오류의 오류 코드가 503에서 403으로 변경되었습니다.
    • JSON 응답은 지원되지 않습니다.
    • Google 데이터 자바스크립트 클라이언트 라이브러리는 지원되지 않습니다.
    • 계정 피드가 없습니다. 구성 데이터에 대한 모든 요청은 Management API를 통해 실행해야 합니다.

등록

  • Google 애널리틱스 API를 사용하여 빌드한 모든 애플리케이션은 Google API 콘솔을 통해 프로젝트로 등록해야 합니다.

  • API에 대한 각 요청에는 API 키(OAuth 2.0의 경우 클라이언트 ID)와 클라이언트 비밀번호를 포함해야 합니다.

할당량 정책

  • 다음 할당량은 두 애널리틱스 API(Management API 및 Data Export API)에 모두 적용됩니다.

    • 일일 프로젝트당 요청 50,000개
    • IP 주소당 초당 쿼리 수(QPS) 10개
  • 다음 할당량은 Data Export API에 적용됩니다.

    • 일일 프로필당 요청 10,000개
    • 프로필당 동시 요청 10개
  • 등록되지 않은 애플리케이션의 경우 소량의 테스트를 수용하기 위해 유예 할당량이 매우 적습니다.

지원 중단

  • 또한 이 출시 버전에서는 버전 2.3이 지원 중단되고 Data Export API에서 계정 피드가 종료됩니다. 6개월 후:

    • 기존 버전 2.3 XML 데이터 피드에 대한 요청이 버전 2.4로 전달되고 버전 2.4 응답을 반환합니다. 이때 모든 버전 2.4 할당량 정책이 버전 2.3 요청에 적용됩니다.

    • 버전 2.3 JSON 출력에 대한 요청은 버전 2.4 응답에서 지원되지 않으며 404 Not Found 상태 코드를 반환합니다. JSON 응답이 필요한 경우 버전 3.0으로 업그레이드하세요.

    • Data Export API에서 계정 피드에 대한 요청은 404 Not Found 상태 코드를 반환합니다. 구성 데이터에 대한 모든 요청은 Management API를 통해 실행해야 합니다.

이 출시 버전에는 최신 Google Ads 데이터와 다양한 측정기준 및 측정항목이 추가되었습니다.

  • 이제 한 시간 이내에 Google Ads 데이터가 업데이트됩니다. 전에는 데이터가 업데이트되는 데 하루가 걸렸습니다.

  • 유효한 Google Ads 데이터의 조합에 대한 제한이 완화되었습니다.

몇 주 전에 ga:impressionsga:adGroup 또는 ga:adContent을 요청하는 API 쿼리는 0을 반환하므로 허용하지 않도록 변경되었습니다. 이제 이 조합을 다시 사용할 수 있으며 올바른 데이터를 반환하도록 수정되었습니다.

이 출시 버전에서는 측정기준 및 측정항목의 잘못된 조합이 수정되었습니다.

수정 완료된 잘못된 측정항목/측정기준 조합

  • 지난달에 데이터 피드에서 데이터를 반환하지 않는 잘못된 쿼리를 허용하지 않도록 API를 변경할 예정이라고 발표되었습니다. 이제 API가 변경되었으며 다음 조합은 유효하지 않습니다.

    • 제품 측정기준은 거래 측정항목과 결합할 수 없습니다.
    • ga:adContent 또는 ga:adGroupga:impressions와 결합할 수 없습니다.

    이제 API는 결과 없이 응답을 반환하는 대신 이러한 조합을 요청하는 모든 쿼리에 대해 400 오류 코드를 반환합니다.

이 출시 버전에서는 측정항목의 신뢰 구간 값이 지원 중단되었습니다.

신뢰 구간 지원 중단

  • 아직 측정항목의 신뢰 구간 값 사용을 중단하지 않은 경우 중단하세요. 이 출시 버전에서는 Data Export API 데이터 피드는 모든 신뢰 구간 값으로 0.0을 반환합니다. 한 달 정도 후에 모든 측정항목 요소에서 이 속성이 완전히 삭제됩니다.

    응답이 샘플링되었는지 확인하려면 응답에 containsSampledData 필드를 사용하세요.

이 출시 버전에는 3개의 새로운 측정항목이 추가되고 두 측정항목의 반환 값이 업데이트되었습니다.

새로운 데이터 업데이트

  • API에 사이트 속도 성능을 처리하는 3가지 새로운 측정항목이 추가되었습니다.
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

측정항목 업데이트

  • 필터에 통화 값을 지정하려면 추적 코드에서 전달된 실제 값을 지정해야 합니다(예: 1단위는 이제 1로 지정됩니다).

  • 이제 ga:CTR이 실제 백분율을 반환합니다(예: 2% 값은 2로 반환됩니다).

이 출시 버전에서는 데이터 피드 성능이 개선되고 새로운 데이터가 추가되었습니다.

성능 개선

  • 이 출시 버전에서는 데이터 피드 지연 시간이 30~35% 개선되었습니다.

새로운 데이터 업데이트

  • 고급 세그먼트에서 허용되는 측정기준 및 측정항목의 목록이 업데이트되었습니다. 업데이트된 목록을 참고하여 요청이 유효한지 확인하세요.

예정 변경사항

  • 현재 통화 필터 값을 마이크로 단위로 지정해야 합니다(예: 통화 단위 1개가 1,000,000으로 지정됨). 앞으로는 추적 코드에서 전달되는 실제 값을 지정해야 합니다(예: 1단위가 1로 지정됨).

  • 현재 ga:CTRpercent이며 0.02 값을 반환합니다. 앞으로는 실제 비율(예: 2)을 반환하도록 변경됩니다.

이 출시 버전에서는 데이터 피드에 데이터가 추가되었습니다.

새로운 데이터 업데이트

  • 시간 측정기준 ga:dayOfWeek가 추가되었습니다.

  • 내부 검색 측정항목 ga:percentVisitsWithSearch가 추가되었습니다.

  • 다음과 같은 이벤트 추적 측정항목이 추가되었습니다.

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

예정 변경사항

현재 API는 다양한 승인 문제에 관해 401 상태 코드를 반환합니다. 앞으로 몇 주 이내에 401 상태가 잘못된 토큰에만 사용되어 개발자가 이 특정한 예외 오류를 처리할 수 있게 됩니다.

이 출시 버전에서는 데이터 피드에 데이터가 크게 추가되었습니다.

새로운 데이터 업데이트

  • ga:visitors의 계산 방식이 특정 기간의 순 방문자수를 반환하도록 변경되어 이제 더 많은 측정기준 및 측정항목 조합이 지원됩니다.

  • 10개의 새로운 Google Ads 측정기준이 추가되었습니다(ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl, ga:adDestinationUrl).

  • ga:organicSearches 측정항목이 캠페인 그룹에 추가되었습니다.

  • ga:searchResultViews 측정항목이 내부 사이트 검색 그룹에 추가되었습니다.

  • 3개의 새로운 시간 기반 측정기준이 추가되었습니다(ga:nthDay, ga:nthWeek, ga:nthMonth).

  • 측정기준 및 측정항목 그룹화 기능이 기능을 더 잘 반영하도록 변경되었습니다.

새로 계산된 측정항목

다음 계산된 측정항목은 기본 측정항목을 사용한 계산에서 파생됩니다. 참고: (n)이 있는 각 이름은 1~20 값을 지원합니다.

  • 목표 기반: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • 콘텐츠 기반: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • 내부 사이트 검색 기반: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • 전자상거래 기반: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

이 출시 버전에서는 데이터 피드에 새로운 기능이 추가되었습니다.

새로운 기능

  • 새로운 XML 요소가 추가되어 사용자가 데이터가 샘플링되었는지를 확인할 수 있습니다. true. 이 요소는 항상 데이터가 샘플링되었는지 여부를 true 또는 false로 반환합니다. 자바 및 자바스크립트 라이브러리도 이 요소에 액세스하기 위한 도우미 메서드로 업데이트되었습니다.

이 출시 버전에서는 2개의 버그가 수정되었습니다.

버그 수정

  • 이전에 측정기준을 사용하여 필터 표현식에 OR 연산자를 추가(예: ga:keyword==store,ga:keyword==bar)하는 경우 각 필터가 여러 쿼리에 개별적으로 적용된 경우와 다른 값이 반환될 수 있었습니다. 이 문제가 해결었으며 이제 OR 연산자를 사용하면 일관된 값이 반환됩니다.

  • 잘못된 필터에 대한 일부 API 오류 메시지가 오류를 야기한 필터가 측정기준 또는 측정항목 필터인지 여부를 포함하지 않도록 업데이트되었습니다(단 실제 문제가 있는 필터 표현식은 계속 반환됩니다).

이 출시 버전에서는 3개의 버그가 수정되었습니다.

버그 수정

  • 자바스크립트 클라이언트 라이브러리의 인코딩 문제가 해결되었습니다. 애널리틱스 Issue Tracker

  • 목표 이름, 목표 경로, 목표 비교 값 또는 목표 비교 유형이 잘못 설정된 경우 계정 피드가 반환되지 않는 문제가 해결되었습니다.

  • 데이터 피드 쿼리 필터 매개변수의 측정기준 및 측정항목을 OR로 연결할 수 없습니다. 예: ga:source==google,ga:visits>5. 이 잘못된 쿼리의 오류 메시지가 Cannot OR dimension filter(s) with metric filter로 업데이트되었습니다.

이 출시 버전에서는 새로운 데이터가 추가되고 버그가 수정되었습니다.

새로운 기능

  • 다음 5개의 측정 기준이 새 카테고리 D8. Adwords에 추가되었습니다.

    • ga:adwordsAdGroupId: Google Ads API AdGroup.id에 해당합니다.
    • ga:adwordsCampaignId: Google Ads API Campaign.id에 해당합니다.
    • ga:adwordsCreativeId: Google Ads Ad.id에 해당합니다.
    • ga:adwordsCriteriaId: Google Ads Criterion.id에 해당합니다.
    • ga:adwordsCustomerId: Google Ads AccountInfo.customerId에 해당합니다.

버그 수정

  • 프로필 중 하나의 목표 또는 단계가 잘못 구성된 경우 계정 피드에서 데이터가 반환되지 않는 문제가 해결되었습니다.

이 출시 버전에서는 여러 가지 새로운 기능이 추가되고 버그가 수정되었습니다.

새로운 기능

  • iPhone 기본 세그먼트(gaid::-11)가 개선되어 이제 모든 휴대기기에서 보고됩니다. ID는 전과 동일하지만(-11) 이제 세그먼트의 이름은 Mobile Traffic입니다.

  • API에서 사용되는 샘플링 레이트가 이제 웹 인터페이스와 동일합니다. 따라서 샘플링된 보고서의 데이터가 웹 인터페이스와 나란히 표시되고 둘 사이의 일관성이 증가합니다.

  • 모든 사용자가 공평하게 리소스에 액세스할 수 있도록 할당량 정책이 업데이트되었습니다. 자세한 내용은 할당량 정책 문서를 참고하세요. 새 정책은 다음과 같습니다.

    • 단일 웹 서비스에서 24시간 동안 최대 10,000개의 요청을 할 수 있습니다.
    • 한 애플리케이션에서 지정된 1초 동안 10개의 요청만 할 수 있습니다.
    • 한 애플리케이션에 한 번에 4개의 대기 중인 요청만 있을 수 있습니다.
  • 측정기준과 측정항목 조합에 대한 일부 제한사항이 완화되었습니다. ga:nextPagePathga:previousPagePath가 이제 D3. Content 그룹에 포함됩니다. D8. Custom Variable 그룹의 이름이 이제 D6. Custom Variable 그룹입니다. 새로운 조합에 대해서는 업데이트된 참조 가이드를 참고하세요.

버그 수정

  • API가 측정항목의 confidenceInterval 값을 보고하는 방식과 관련된 버그가 수정되었습니다. 이전에는 신뢰 구간의 값이 INF 또는 0~1 사이의 숫자여야 했습니다. 이제 모든 신뢰 구간의 값이 INF 또는 0보다 크거나 같은 숫자입니다.

  • 이전에는 ga:itemQuantityga:uniquePurchases가 뒤바뀌어 서로의 값을 반환했습니다. 이제 올바른 데이터를 반환하도록 수정되었습니다.

측정기준 및 측정항목 지원 중단 알림

  • 이전에 지원 중단된 측정기준 및 측정항목의 사용을 아직 중단하지 않았으면 중단하세요.

이 출시 버전에는 다양한 새로운 기능이 추가되었습니다.

이 출시 버전의 주 버전 번호가 2로 증가했습니다.

  • 일부 기능에는 최신 클라이언트 라이브러리를 사용해야 합니다. 자바자바스크립트가 공식적으로 지원됩니다. 타사 라이브러리는 아직 업데이트되지 않았을 수 있습니다.

    • 각 계정 또는 데이터 피드 요청에 GData-Version: 2 헤더를 추가하여 버전 2를 요청할 수 있습니다. 자세한 내용은 문서를 참고하세요.
    • 계정 및 데이터 피드에 새로운 XML 네임스페이스가 추가되었습니다.
      xmlns:ga='http://schemas.google.com/ga/2009'
  • 이제 API에서 Google 데이터 프로토콜 버전 2를 지원합니다.

고급 세분화 지원

  • 동적 세그먼트 쿼리 매개변수:

    • ...&segment=dynamic::표현식
    • 고급 세그먼트를 '즉시' 만들 수 있습니다.
    • 표현식은 모든 측정기준 또는 측정항목일 수 있으며 필터와 동일한 구문을 따라야 합니다.
  • 기본 및 맞춤 세그먼트 쿼리 매개변수:

    • ...&segment=gaid::숫자
    • 여기서 숫자는 Google 애널리틱스 웹 인터페이스에 정의된 고급 세그먼트를 참조하는 ID입니다.
    • ID는 계정 피드에서 찾을 수 있습니다.
  • 계정 피드는 다음 XML 요소와 속성을 통해 세그먼트 데이터를 설명합니다.

    • ga:visitorType==Returning Visitor
  • 데이터 피드는 또한 세그먼트가 API 요청에 적용되었는지 여부를 나타내는 XML 요소를 제공합니다.

  • 고급 세그먼트에 관한 자세한 내용은 문서를 참고하세요.

새로운 목표 데이터 사용 가능

  • 계정 피드에서 사용 가능한 대상 위치 및 참여 유형 목표:

  • goal(n)Completions 규칙을 따르는 목표 5~20에 대해 48개의 새로운 목표 측정항목이 추가되었습니다. 여기서 (n)은 1~20 사이의 숫자입니다.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • 새로운 목표 데이터를 고려하여 GoalCompletionAll, GoalStartsAll, GoalValueAll이 업데이트되었습니다.

새로운 맞춤 변수 데이터

  • 각 프로필에서 수집한 모든 맞춤 변수가 계정 피드에 새로운 XML 요소로 추가되었습니다.

  • 맞춤 변수에 10개의 새로운 측정기준이 추가되었습니다. 이 측정기준은 customVar(n) 규칙을 따릅니다. 여기서 (n)는 1~5 사이의 숫자입니다.

    • ga:customVarName(n)
    • ga:customVarValue(n)

지원 중단된 측정기준 및 측정항목이 삭제됩니다.

  • 이전에 지원 중단된 측정기준 및 측정항목의 사용을 아직 중단하지 않았으면 중단하세요. 지원 중단된 측정기준 및 측정항목은 곧 삭제될 예정이며 요청할 경우 API에서 오류를 반환합니다.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • 다음 측정기준의 이름이 변경되었습니다.

    • ga:countOfVisits는 이제 ga:visitCount입니다.
    • ga:countOfVisitsToATransaction은 이제 ga:visitsToTransaction입니다.

이 출시 버전에서는 새로운 기능이 추가되고 일부 이전 기능이 지원 중단되었습니다.

  • 다음 측정기준과 측정항목은 이제 지원 중단되었습니다. 한 달 내에 API에서 영구적으로 삭제됩니다. 애플리케이션이 중단되지 않도록 코드를 업데이트하세요.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • 다음 측정기준의 이름이 변경되었습니다.

    • ga:countOfVisits는 이제 ga:visitCount입니다.
    • ga:countOfVisitsToATransaction은 이제 ga:visitsToTransaction입니다.
  • 이제 모든 이벤트 추적 데이터가 2개의 새로운 그룹으로 표시됩니다.

    D7. 이벤트(측정기준) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. 이벤트(측정항목) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • 이제 전체 사이트 탐색 데이터가 다음 측정기준을 통해 표시됩니다.

    D6. 탐색 * ga:previousPagePath * ga:nextPagePath

  • 이제 방문 페이지 탐색이 다음 측정기준을 통해 표시됩니다.

    D3. 콘텐츠 * ga:landingPagePath * ga:secondPagePath

  • 데이터 피드의 필터 쿼리 매개변수에서 정규 표현식의 최대 길이가 32자에서 128자로 늘어났습니다.

  • 이제 방문자 -> 방문자 충성도에서 UI를 통해 확인할 수 있는 방문 시간 보고서가 새로운 측정기준을 통해 표시됩니다.

    • ga:visitLength

이 출시 버전에서는 Google 애널리틱스 Data Export API가 다음과 같이 업데이트됩니다.

  • 측정기준과 측정항목 조합에 대한 일부 제한사항이 완화되었습니다. 이제 대부분의 콘텐츠와 방문자 수준 측정기준을 함께 쿼리할 수 있습니다. 예를 들어 ga:pagePathga:source는 이제 유효한 조합입니다. 새로운 조합에 대해서는 업데이트된 참조 가이드를 확인하세요. http://code.google.com/apis/analytics/docs/dest/destReferenceValidCombos.html

  • 한 요청에서 요청할 수 있는 행의 총 수가 10,000개로 늘어났습니다. 반환되는 기본 행 수는 여전히 1,000개이지만 이제 max-results 쿼리 매개변수를 설정하여 늘릴 수 있습니다.

  • 이제 계정 피드에서 각 표 ID에 대해 두 개의 새 데이터 요소(통화 및 시간대)를 반환합니다.

  • 이제 데이터 쿼리에 1개 이상의 유효한 측정항목을 포함해야 합니다.

  • 이전의 모든 지원 중단 변경사항이 적용되었습니다.

이 출시 버전에서는 비공개 베타에서 지원 중단된 기능이 삭제됩니다.

  • 계정 피드 요청에서 더 이상 사용자 이름을 지원하지 않습니다. 대신 다음 형식의 요청만 허용됩니다.
    https://www.google.com/analytics/feeds/accounts/default

  • 다음 측정항목은 삭제될 예정이며 더 이상 작동하지 않습니다. 이 값을 계산하는 방법은 다음 페이지를 참고하세요. http://code.google.com/apis/analytics/docs/dest/destReferenceCommoncalulations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • 다음 측정기준 및 측정항목의 이름이 변경되었습니다. 기존 이름은 더 이상 사용할 수 없습니다. 다음 문서에서 공식 명칭을 사용하고 있는지 확인하세요. http://code.google.com/apis/analytics/docs/dest/destReferenceDimensionMetrics.html

    측정기준 * ga:subContinentRegion ⇒ ga:subContinent * ga:organization ⇒ ga:networkLocation * ga:domain ⇒ ga:networkDomain * ga:visitNumber ⇒ ga:countOfVisits * ga:platform ⇒ ga:operatingSystem * ga:platformVersion ⇒ ga:operatingSystemVersion * ga:content ⇒ ga:adContent * ga:requestUri ⇒ ga:pagePath * ga:requestUri1 ⇒ ga:landingPagePath * ga:requestUriLast ⇒ ga:exitPagePath * ga:internalSearchNext ⇒ ga:searchKeywordRefinement * ga:internalSearchKeyword ⇒ ga:searchKeyword * ga:internalSearchType ⇒ ga:searchCategory * ga:hasInternalSearch ⇒ ga:searchUsed * ga:requestUriFrom ⇒ ga:searchStartPage * ga:requestUriTo ⇒ ga:searchDestinationPage * ga:productCode ⇒ ga:productSku

    측정항목 * ga:newVisitors ⇒ ga:newVisits * ga:pageDuration ⇒ ga:timeOnPage * ga:visitDuration ⇒ ga:timeOnSite * ga:cost ⇒ ga:adCost * ga:clicks ⇒ ga:adClicks * ga:clickThroughRate ⇒ ga:CTR * ga:costPerClick ⇒ ga:CPC * ga:costPerMilleImpressions ⇒ ga:CPM * ga:searchTransitions ⇒ ga:searchRefinements * ga:uniqueInternalSearches ⇒ ga:searchUniques * ga:visitsWithSearches ⇒ ga:searchVisits * ga:productPurchases ⇒ ga:itemQuantity * ga:productRevenue ⇒ ga:itemRevenue * ga:products ⇒ ga:uniquePurchases * ga:revenue ⇒ ga:transactionRevenue * ga:shipping ⇒ ga:transactionShipping * ga:tax ⇒ ga:transactionTax * ga:goalCompletions1 ⇒ ga:goal1Completions * ga:goalCompletions2 ⇒ ga:goal2Completions * ga:goalCompletions3 ⇒ ga:goal3Completions * ga:goalCompletions4 ⇒ ga:goal4Completions * ga:goalStarts1 ⇒ ga:goal1Starts * ga:goalStarts2 ⇒ ga:goal2Starts * ga:goalStarts3 ⇒ ga:goal3Starts * ga:goalStarts4 ⇒ ga:goal4Starts * ga:goalValue1 ⇒ ga:goal1Value * ga:goalValue2 ⇒ ga:goal2Value * ga:goalValue3 ⇒ ga:goal3Value * ga:goalValue4 ⇒ ga:goal4Value