Google Analytics Management API 변경 로그

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

이 페이지에서는 애플리케이션에 영향을 미칠 수 있는 Google Analytics Management API 변경사항을 설명합니다. API 개발자는 이 목록을 주기적으로 참고하여 새로운 소식을 확인하는 것이 좋습니다. 아래 구독 섹션에 나열된 피드를 통해 변경사항을 확인할 수도 있습니다.

관련 변경 로그 구독

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

Management API와 Provisioning API를 포함합니다.

Management API의 사용자 데이터 보관 설정

이제 WebProperty 리소스에 추가된 새로운 'dataRetentionTtl' 및 'dataRetentionResetOnNewActivity' 필드를 사용하여 프로그래매틱 방식으로 사용자 데이터 보관 설정을 구성할 수 있습니다.

Management API의 쓰기 작업

Management API에서 웹 서비스, 보기(프로필), 목표 리소스에 대한 쓰기 작업(예: 만들기, 업데이트, 삭제, 패치)을 더 이상 허용 목록에 추가할 필요가 없습니다. Management API에서 모든 쓰기 작업의 기본 일일 한도는 쓰기 50회입니다. 자세한 내용은 한도 및 할당량 페이지를 참고하세요.

커스텀 측정항목

버그 수정 출시입니다. min_value가 설정되지 않은 경우 TIME 유형의 맞춤 측정항목이 생성되지 않는 문제가 해결되었습니다. 이제 min_value 없이 요청하면 기본 min_value0인 맞춤 측정항목이 생성됩니다.

통화

버그 수정 출시입니다. 통화의 하위 집합이 애널리틱스 웹 인터페이스에서는 지원되지만 API에서는 지원되지 않는 문제가 해결되었습니다. 이 출시 버전에서는 다음 통화에 대한 지원이 추가되었습니다.

  • UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL

자세한 내용은 다음을 참고하세요. - 보기(프로필) 참조. - 통화 참조 고객센터 도움말.

이 출시 버전에서는 Management API에 리마케팅 잠재고객이 추가되었습니다.

리마케팅 잠재고객

Management API를 사용하면 Google 애널리틱스 속성에 대해 리마케팅 잠재고객을 create, get, list, update, patch할 수 있습니다. 리마케팅 잠재고객의 작동 방식에 대해 자세히 알아보려면 고객센터 도움말인 애널리틱스의 리마케팅 잠재고객 정보를 참고하세요.

샘플링되지 않은 보고서

샘플링되지 않은 보고서 API의 일일 보고서 개수가 더 이상 100개로 제한되지 않습니다. API는 웹 인터페이스를 통해 샘플링되지 않은 보고서를 생성할 때와 동일한 속성별, 일일 토큰 시스템을 사용합니다.

샘플링되지 않은 보고서

현재 사용자가 액세스할 수 없는 샘플링되지 않은 보고서는 더 이상 Management API 응답 메시지 내에 다운로드 링크가 없습니다. 이 행동은 이제 보고서 소유자만 생성된 문서의 다운로드 링크를 볼 수 있는 UI 대시보드 기능과 일치합니다.

보기(프로필)

이 출시 버전에서는 보기(프로필) 리소스에 botFilteringEnabled 속성이 추가되었습니다. 이 속성은 보기(프로필)에 봇 필터링이 사용 설정되었는지 여부를 나타냅니다. 자세한 내용은 보기(프로필) 참조 문서를 참고하세요.

샘플링되지 않은 보고서

이 출시 버전에서는 샘플링되지 않은 보고서에 delete 메서드가 추가되었습니다. 자세한 내용은 샘플링되지 않은 보고서 삭제 참조 문서를 참고하세요.

세그먼트

버그 수정 출시입니다. 이 출시 버전에서는 세그먼트 목록 메서드를 호출할 때 정의에 통화 값이 포함된 세그먼트가 잘못 표시되는 문제가 해결되었습니다.

세그먼트

버그 수정 출시입니다. 이 출시 버전에서는 여러 세그먼트(프로필)에 비공개 세그먼트를 고정한 사용자가 세그먼트 목록 메서드를 호출할 때 500 오류 응답을 가져오는 문제가 해결되었습니다.

일괄 처리

이 출시 버전에서는 일반적인 일괄 처리 지원 외에 User Permissions API에 대한 특별 지원이 추가되었습니다. 사용자 권한 요청을 일괄 처리하면 성능이 크게 향상되고 할당량 사용이 줄어듭니다.

보기(프로필)

이 출시 버전에서는 이제 삽입 작업 중에 설정되지 않은 경우 보기(프로필) currency 속성이 USD로 기본 설정됩니다. 또한 이전에 currency 속성 없이 생성된 보기(프로필)에서 getlist 작업을 실행하면 USD가 반환됩니다.

필터

이 출시 버전에서는 DEVICE_CATEGORY=mobileDEVICE_CATEGORY=tablet으로 대체되어야 하는 지원 중단된 필터 필드 IS_MOBILEIS_TABLET이 최종 삭제됩니다. IS_MOBILEIS_TABLET을 사용하도록 필터 필드를 설정하는 삽입, 업데이트, 패치 요청은 오류를 반환합니다.

  • Management API에서 필터를 사용하는 방법에 관한 자세한 내용은 필터 개발자 가이드를 참고하세요.

  • 필터 리소스에 대한 전체 매개변수 목록은 필터 참조를 참고하세요.

필터

이 출시 버전에서는 모든 필터 세부정보 섹션에 fieldIndex 속성을 추가하여 필터 필드에 맞춤 측정기준을 사용할 수 있도록 지원이 추가되었습니다. 예를 들어 이제 "field": "CUSTOM_DIMENSION""fieldIndex": "1"로 필터 표현식을 설정하여 첫 번째 맞춤 측정기준에서 필터가 작동하도록 할 수 있습니다.

  • Management API에서 필터를 사용하는 방법에 관한 자세한 내용은 필터 개발자 가이드를 참고하세요.

  • 필터 리소스에 대한 전체 매개변수 목록은 필터 참조를 참고하세요.

또한 이 출시 버전에서는 "comparisonValue": "0"으로 목표를 만들지 못하는 문제가 해결되었습니다.

  • Management API에서 목표를 사용하는 방법에 관한 자세한 내용은 목표 개발자 가이드를 참고하세요.

  • 목표 리소스에 대한 전체 매개변수 목록은 목표 참조를 참고하세요.

이 출시 버전에서는 dailyUpload 리소스가 최종 종료되고 삭제됩니다. dailyUpload 리소스는 2014년 6월 20일에 공식적으로 지원 중단되었으며, 이제 모든 비용 데이터는 업로드 리소스를 사용하여 가져와야 합니다.

이 출시 버전에서는 Management API에 새 컬렉션 두 개(맞춤 측정기준 및 맞춤 측정항목)가 추가되었습니다.

맞춤 측정기준 및 측정항목

이제 Management API를 사용하여 맞춤 측정기준 및 측정항목을 만들고, 표시하고, 가져오고, 패치하고, 업데이트할 수 있습니다.

이제 컬렉션에 리소스가 포함되지 않은 경우 모든 컬렉션의 list 메서드 응답에 items 속성에 대한 빈 목록이 포함됩니다. 이전에는 items 속성이 응답에서 생략되었습니다. Google 애널리틱스 구성 데이터의 쿼리 및 응답에 대한 자세한 내용은 API 참조를 참고하세요.

버그 수정

이 출시 버전에는 Google Analytics Management API에 대한 새로운 범위가 도입되었습니다. - analytics.manage.users.readonly - 'Google 애널리틱스 사용자 권한'을 참고하세요.

DEVICE_CATEGORY 필터 필드가 추가되었으며 IS_MOBILEIS_TABLET은 이제 지원 중단됩니다. DEVICE_CATEGORY=mobileDEVICE_CATEGORY=tablet을 사용하세요.

이제 보기(프로필) 리소스에 향상된 전자상거래가 사용 설정되었는지(true), 사용 중지되었는지(false)를 나타내는 enhancedECommerceTracking 속성이 포함됩니다.

이 출시 버전에는 새로운 데이터 가져오기 유형이 포함되며 dailyUpload 리소스가 지원 중단됩니다.

데이터 가져오기

Management API를 사용하여 Google 애널리틱스 계정으로 데이터를 가져오는 방법에 대해 자세히 알아보려면 데이터 가져오기 개발자 가이드를 참고하세요.

업로드

  • upload 리소스가 이제 다음과 같은 업로드 유형을 지원합니다.
    • 캠페인 데이터
    • 콘텐츠 데이터
    • 비용 데이터
    • 제품 데이터
    • 환불 데이터
    • 사용자 데이터
  • upload 리소스에 기존 비용 데이터 customDataSources를 이전하기 위한 새로운 migrateDataImport 메서드가 있습니다.

일일 업로드 지원 중단

  • dailyUpload 리소스가 이제 지원 중단됩니다. 데이터 가져오기 기능을 사용하기 위한 이전에 관한 자세한 내용은 이전 가이드를 참고하세요.
  • dailyUpload 리소스는 6개월 동안 계속 작동하며 6개월 후에는 uploadType 속성이 analytics#dailyUploads로 설정된 나머지 customDataSources은 자동으로 이전되고 upload 리소스오 함께만 사용할 수 있습니다.
  • dailyUpload 리소스의 현재 사용자는 최대한 빨리 자신의 코드를 업데이트하고 업로드 리소스를 사용하도록 이전해야 합니다.

이 출시 버전에는 2개의 새로운 구성 API가 추가되었습니다.

  • Management API의 Google Ads 링크를 사용하면 Google Ads 계정과 Google 애널리틱스 속성 간의 연결을 생성, 표시, 가져오기, 업데이트, 패치 및 삭제할 수 있고 Google Ads 데이터에 연결된 보기(프로필)를 관리할 수 있습니다.

필터

  • Management API의 필터를 사용하면 Google 애널리틱스 계정용 필터를 생성, 표시, 가져오기, 업데이트, 패치, 삭제할 수 있습니다. 프로필 필터 링크를 사용하면 필터 및 보기(프로필) 간의 링크를 생성, 표시, 가져오기, 업데이트, 패치 및 삭제할 수 있습니다.

샘플링되지 않은 보고서: Management API

샘플링되지 않은 보고서라고 하는 새로운 리소스가 Management API에 추가됩니다. 샘플링되지 않은 보고서는 샘플링되지 않은 데이터를 사용하여 생성된 Google 애널리틱스(GA) 보고서입니다.샘플링되지 않은 보고서는 현재 GA 프리미엄 사용자에게만 제공됩니다.

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

세그먼트 컬렉션이 다음과 같이 변경되었습니다.

  • 이제 사용자 및 시퀀스 세그먼트가 API에서 지원됩니다.
  • 이제 세그먼트 컬렉션에서 기본 제공 및 맞춤 세션 수준사용자 수준 세그먼트를 모두 반환합니다.
  • 이제 세그먼트의 definition 속성에서 새 세그먼트 구문을 사용합니다. 여기에는 definition: ""에서 definition: "sessions::condition::"으로 변경되는 기존 세션 수준 세그먼트의 정의가 포함됩니다.
  • 세그먼트가 사용자가 웹 인터페이스에서 만든 CUSTOM인지, Google 애널리틱스에서 제공하는 BUILT_IN인지 여부를 나타내기 위해 새로운type 속성이세그먼트 리소스에 추가되었습니다.

실험

이제 다음 애드센스 측정항목을 최적화 목표로 사용할 수 있습니다.

  • ga:adsenseAdsClicks — 사이트에서 애드센스 광고가 클릭된 횟수
  • ga:adsenseAdsViewed — 조회된 애드센스 광고의 수. 한 광고 단위 내에 여러 광고를 표시할 수 있습니다.
  • ga:adsenseRevenue — 애드센스 광고에서 발생한 총 수익

새 계정 요약 컬렉션

  • AccountSummaries 컬렉션이 Management API에 추가되었습니다. 권한이 있는 사용자가 빠른 단일 요청으로 액세스할 수 있는 각 계정, 속성, 보기(프로필)에 대한 정보의 요약을 제공합니다. 자세한 내용은 계정 요약 개발자 가이드를 참고하세요.

ga:isMobilega:isTablet 측정기준의 지원 중단으로 인해 기본 세그먼트가 다음과 같이 변경되었습니다.

  • 세그먼트 gaid::-11의 이름이 모바일 트래픽에서 모바일 및 태블릿 트래픽으로 변경되었습니다. 이 세그먼트의 정의가 ga:isMobile==Yes에서 ga:deviceCategory==mobile,ga:deviceCategory==tablet으로 변경되었습니다. ga:isMobile에 태블릿 트래픽이 포함되었으며 새 정의에 반영됩니다. 태블릿을 제외한 모바일 트래픽만 필요한 경우 새로운 모바일 트래픽 세그먼트(gaid::-14)로 전환하세요.
  • 세그먼트 gaid::-13의 정의가 ga:isTablet==Yes에서 ga:deviceCategory==tablet으로 변경되었습니다. 계속해서 태블릿 트래픽을 나타냅니다.
  • 세그먼트 gaid::-14가 추가되었습니다. 세그먼트의 이름은 모바일 트래픽이고 정의는 ga:deviceCategory==mobile입니다.

버그 수정:

  • 보기(프로필)의 시간대 정보가 수정되었습니다. 세부정보: 이 정보가 수정되기 전에 Management API에서 보기(프로필)를 표시할 때 보기(프로필)에 대한 잘못된 시간대 정보가 반환되었습니다. 이제 보기(프로필)의 시간대 정보가 Google 애널리틱스 관리 인터페이스에 설정된 정보와 일치합니다.

이 출시 버전에는 웹 서비스, 보기(프로필), 목표 리소스에 대한 쓰기 작업 및 사용자 권한 관리를 사용 설정하는 새로운 리소스 3개가 도입되었습니다.

계정 설정 및 구성 API

  • 이제 보기(프로필)를 생성, 업데이트, 패치, 삭제할 수 있습니다. 새로운 방법에 대한 자세한 내용은 보기(프로필) 참조를 참고하세요.
  • 이제 웹 서비스 및 목표를 생성, 업데이트, 패치할 수 있습니다. 새로운 방법에 대한 자세한 내용은 웹 서비스 참조목표 참조를 참고하세요.
  • 이제 get 메서드로 단일 웹 서비스, 보기(프로필) 또는 목표를 요청할 수 있습니다.
  • 이 기능은 현재 제한적 베타 버전에서 개발자 프리뷰로 제공됩니다. 가입하려면 베타 액세스 권한을 요청하세요.

Management API의 사용자 권한

  • 새로운 accountUserLinks 리소스를 사용하여 사용자의 계정 권한을 관리할 수 있습니다.
  • 새로운 webpropertyUserLinks 리소스를 사용하여 사용자의 속성 권한을 관리할 수 있습니다.
  • 새로운 profileUserLinks 리소스를 사용하여 사용자의 보기(프로필) 권한을 관리할 수 있습니다.
  • 이제 승인된 사용자의 권한을 계정, 웹 서비스보기(프로필) 리소스의 일부로 사용할 수 있습니다.
  • 새 범위가 도입되었으며 사용자 권한을 관리하는 데 필요합니다. https://www.googleapis.com/auth/analytics.manage.users.
  • 자세한 내용은 사용자 권한 개발자 가이드를 참고하세요.

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

  • 모든 세그먼트 ID가 양의 정수에서 영숫자 문자열로 변경됩니다. 사용자의 세그먼트 ID를 저장한 경우 새 ID를 사용하도록 업데이트하는 것이 좋습니다.
  • 세그먼트 컬렉션에서는 기존 방문 수준 세그먼트만 반환합니다. 신규 방문자, 동질 집단, 시퀀스 세그먼트는 현재 API에서 지원되지 않습니다.
  • 세그먼트 컬렉션에서는 동일한 음수 ID의 기존 기본 세그먼트를 계속 반환하지만 새로운 기본 세그먼트는 현재 지원되지 않습니다.

이 출시 버전에서는 웹 속성 리소스에 2개의 새로운 속성이 추가되었습니다.

  • profileCount - 속성의 프로필 수를 반환합니다. 이 리소스를 사용하면 프로필이 없는 속성(profileCount = 0)을 필터링할 수 있습니다.
  • industryVertical - 속성에 대해 선택한 업종/카테고리를 반환합니다.

버그 수정:

  • 이제 프로필 리소스eCommerceTracking 속성이 웹 인터페이스의 관리 섹션에 있는 전자상거래 설정과 일치합니다. 전자상거래 추적을 사용하는 경우 true, 그렇지 않은 경우 false를 반환합니다.
  • 이제 웹 속성 리소스에 웹 속성이 PREMIUM인지 또는 STANDARD인지를 나타내는 level 속성이 포함됩니다.
  • 실험 리소스에 액세스하고 수정할 수 있도록 Management API v3에 새 엔드포인트가 추가되었습니다.
  • 이제 프로필이 웹사이트용으로 구성되었는지 또는 앱용으로 구성되었는지 나타낼 수 있도록 프로필 리소스type 속성이 포함됩니다. 사용할 수 있는 두 가지 값은 WEB 또는 APP입니다.

이 출시 버전에는 Management API에 유용한 오류 응답이 추가되었습니다.

  • API 오류 응답 본문에 새로운 오류 코드, 이유, 설명이 추가되었습니다. Management AP의 버전 2.4버전 3.0의 모든 코드가 문서화되었습니다.

이 출시 버전에서는 데이터가 추가되고 기존 기능이 변경되고 버그가 수정되었습니다.

새로운 데이터

  • 이제 고급 세그먼트 컬렉션에 Data Export API 세그먼트 매개변수에서 사용할 수 있는 segmentId 필드가 포함됩니다.

변경사항

  • max-results의 데이터 유형이 integer로 변경되었습니다.

  • max-results의 기본값 및 최댓값이 1,000으로 변경되었습니다.

버그 수정

  • Google 웹사이트 최적화 도구 실험용 계정, 웹 서비스 및 프로필이 해당 컬렉션에 더 이상 포함되지 않습니다.

이 출시 버전에서는 API의 두 가지 새로운 버전과 많은 새로운 기능이 추가되었으며 이전 버전은 지원 중단되었습니다. 이 변경사항은 API에서 데이터를 요청하고 처리하는 방식에 영향을 미칩니다.

버전 3.0

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

  • 새로운 데이터

    • 완전한 이벤트 목표 표현
    • GA 사용자 인터페이스를 딥 링크하는 데 사용할 수 있는 내부 웹 속성 ID
    • 기본 페이지 및 사이트 쿼리 매개변수의 프로필 구성
  • 변경사항

버전 2.4

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

  • 변경사항

    • 할당량 정책
    • Google API 콘솔과 통합하여 API 액세스를 관리하고 추가 할당량을 요청
    • 기존 승인 메커니즘 및 OAuth 2.0에 대한 지속적인 지원
    • 요청하기 위한 새로운 URL: https://www.googleapis.com/analytics/v2.4/management/…
    • XML 전용 응답
    • Google 데이터 자바스크립트 클라이언트 라이브러리는 지원되지 않습니다.
    • XML 출력이 버전 2.3과 일치하므로 다른 기존 Google 데이터 클라이언트 라이브러리가 계속 작동합니다.

지원 중단

  • 기존 Management API 버전 2.3 버전은 지원 중단됩니다. 2개월 동안 더 사용할 수 있으며 그 뒤에는 모든 v2.3 요청이 v2.4 응답을 반환합니다.

Google Analytics Management API의 베타 버전입니다.

새로운 피드

업데이트된 클라이언트 라이브러리

  • Management API가 Google 애널리틱스 Data Export API와 동일한 라이브러리에 출시됩니다. Google 데이터 자바 및 자바스크립트 라이브러리가 모두 업데이트되었습니다. 라이브러리 getManagementFeed() 메서드에 적절한 피드 URI를 지정하여 각 피드에 액세스할 수 있습니다.

새 문서

  • Google 애널리틱스 개발자 문서에 새로운 Management API의 작동 방식을 설명하는 새로운 섹션이 작성되었습니다.