Android용 Google 애널리틱스 SDK: v1.x에서 v2.x로 마이그레이션

이 이전 가이드에서는 SDK 버전 2의 새로운 기능을 설명하고 개발자에게 v1.x 구현에서 이전하는 팁을 제공합니다. v1.x 구현에서 이전할 필요가 없는 개발자는 지금 버전 2를 시작하면 됩니다.

소개

최근 Google 애널리틱스에서는 Android 버전 2용 업데이트된 Google 애널리틱스 SDK를 출시했습니다. SDK 버전 2에서는 새로운 기능과 앱 개발자를 위해 특별히 설계된 새로운 보고 인터페이스를 지원합니다.

기존의 모든 Google 애널리틱스 개발자는 Android용 Google 애널리틱스 SDK 버전 2로 이전하여 새로운 기능과 보고서를 활용하는 것이 좋습니다.

버전 2의 새로운 기능

Android용 Google 애널리틱스 SDK 버전 2에서는 앱 개발자를 위해 설계된 새로운 보고 환경, 강력한 새 측정기준 및 측정항목 등을 제공합니다. 개발자가 버전 2를 통해 얻을 수 있는 이점은 다음과 같습니다.

앱 개발자를 위한 더욱 강력한 보고서
앱 개발자를 위해 표준 보고서가 새롭게 디자인되어 개발자가 사용자 획득 및 환경에 관한 새로운 통계를 얻을 수 있도록 참여 흐름 및 Google Play 소스와 같은 새 보고서가 추가되었습니다. 버전 2의 속성을 구성하는 가장 좋은 방법을 자세히 알아보려면 계정 구성 권장사항을 참고하세요.
새로운 앱 측정기준 및 측정항목
화면 이름 및 화면 조회수, 앱 이름, 앱 버전 등 새로운 앱별 측정기준 및 측정항목이 SDK 버전 2와 함께 도입되었습니다.
비정상 종료 및 예외 측정
Android용 Google 애널리틱스 SDK에는 예외 측정 및 예외 조회 유형이 도입되었습니다. 예외 측정을 사용하면 비정상 종료 및 심각하지 않은 예외의 수와 유형을 측정할 수 있습니다. 예외 측정을 구현하는 방법은 예외 개발자 가이드를 참고하세요.
맞춤 측정기준 및 측정항목
맞춤 측정기준을 만들어 새로운 방식으로 데이터를 분류하세요. 맞춤 측정기준 및 측정항목에 대해 자세히 알아보기
소셜 상호작용 측정
삽입된 소셜 플러그인 및 위젯으로 사용자 상호작용을 측정하여 앱에서 소셜의 가치를 파악하세요. 소셜 상호작용 측정에 관해 자세히 알아보기

시작하기 전에

모든 개발자는 이전을 시작하기 전에 다음 두 단계를 실행하는 것이 좋습니다.

  1. Android v2용 Google 애널리틱스 SDK 다운로드
  2. 새 앱 보고서 및 데이터에 액세스하는 데 사용할 앱 보기 (프로필)를 생성합니다.

위 단계를 완료한 후 아래 단계에 따라 이전 경로를 진행합니다.

EasyTracker에서 이전

EasyTracker 라이브러리의 v1에서 v2로 앱을 이전하려면 다음 세 단계를 진행합니다.

  1. GoogleAnalytics.xml 리소스 파일에서 매개변수 업데이트
  2. 메서드 이름 업데이트
  3. broadcast receiver 업데이트 (Google Play 캠페인 추적)

1. GoogleAnalytics.xml의 매개변수 업데이트

버전 2로 이전할 때 GoogleAnalytics.xml 리소스 파일의 매개변수를 업데이트하세요. v1.x 이후 일부 매개변수가 변경되었고 새 매개변수가 버전 2에 추가되었습니다.

아래 표는 버전 2에서 업데이트된 매개변수를 보여줍니다.

v1.x 매개변수 이름v2.x 매개변수 이름
ga_api_keyga_trackingId
ga_auto_activity_trackingga_autoActivityTracking
ga_dryRun지원 중단됨

자세한 내용은 신규 및 업데이트된 EasyTracker 매개변수를 참조하세요.

2. 업데이트 메서드 이름

EasyTracker 버전 2에서 대부분의 구문은 동일하게 유지되지만 메서드 이름과 구문에는 구현을 업데이트해야 하는 몇 가지 눈에 띄는 차이점이 있습니다.

3. Broadcast Receiver 업데이트 (Google Play 캠페인 추적)

v1.x를 사용하여 Google Play 캠페인 추적을 구현한 개발자는 수신자의 클래스 경로가 변경되었음을 알아야 합니다. 자세한 내용은 Google Play 캠페인 추적 가이드를 참조하세요.

맞춤 구현에서 이전

Android용 애널리틱스 SDK v1.x에서 EasyTracker 라이브러리를 사용하지 않았다면 버전 2부터 EasyTracker를 사용하는 것이 좋습니다.

EasyTracker 라이브러리가 이제 SDK에 포함되며 모든 개발자에게 권장됩니다. Google 애널리틱스 SDK v2에서 EasyTracker 사용을 시작합니다.

단일 구현에서 여러 속성 ID를 사용하는 등 고급 데이터 수집이 필요한 경우 고급 구성 가이드에서 SDK v2.x의 고급 기능을 사용하는 방법에 대해 자세히 알아보세요.