이 문서에서는 Android SDK의 레거시 버전을 설명합니다. 분석 도구를 처음 사용하는 경우 최신 SDK를 사용하세요. 자세히 알아보기

Android용 Google 애널리틱스 SDK v2 (기존) - 개요

Android용 Google 애널리틱스 SDK를 사용하면 개발자가 앱에서 사용자 참여 데이터를 쉽게 수집할 수 있습니다. 이 문서에서는 SDK의 값에 대한 개요와 단일 속성 ID 및 EasyTracker를 사용하여 앱을 측정하는 방법을 안내합니다.

소개

Android용 Google 애널리틱스 SDK를 사용하면 개발자가 앱에서 사용자 참여 데이터를 쉽게 수집할 수 있습니다. 그러면 개발자는 Google 애널리틱스 보고서를 사용하여 다음을 측정할 수 있습니다.

  • 애플리케이션을 사용 중인 활성 사용자 수입니다.
  • 애플리케이션이 사용되는 곳
  • 특정 기능 채택 및 사용
  • 인앱 구매 및 거래
  • 애플리케이션이 비정상 종료되는 수와 유형입니다.
  • 기타 유용한 측정항목도 많이 있습니다.

또한 Android용 Google 애널리틱스 SDK는 Google Play 설치부터 인앱 구매 및 거래까지 마케팅 채널의 실적에 대한 포괄적인 가시성을 제공하여 모바일 마케팅 캠페인의 성공을 모니터링하는 도구를 제공합니다.

시작하기 전에

SDK를 구현하기 전에 다음 사항을 확인하세요.

시작하기

SDK를 시작하려면 다음 세 단계를 따르세요.

  1. AndroidManifest.xml 업데이트
  2. EasyTracker 메서드 추가
  3. analytics.xml 파일 만들기

이 단계를 완료하면 Google 애널리틱스로 다음을 측정할 수 있습니다.

  • 앱 설치
  • 활성 사용자 및 인구통계
  • 화면 및 사용자 참여도
  • 비정상 종료 및 예외

1. AndroidManifest.xml 업데이트

다음 권한을 추가하여 AndroidManifest.xml 파일을 업데이트합니다.

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

2. EasyTracker 메서드 추가

다음 예시와 같이 각 Activities의 onStart() 및 onStop() 메서드에 전송 메서드를 추가합니다.

/**
 * An example Activity in your app with Analytics
 * implemented.
 */
public class myTrackedActivity extends Activity {
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
  }

  @Override
  public void onStart() {
    super.onStart();
    ... // The rest of your onStart() code.
    EasyTracker.getInstance().activityStart(this); // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance().activityStop(this); // Add this method.
  }
}

EasyTracker에서 메서드를 호출하려면 Context이 필요합니다. 위의 예에서 다음 줄을 사용합니다. 

EasyTracker.getInstance.activityStart(this);

컨텍스트 설정을 처리합니다 하지만 다른 클래스 또는 메서드에서 EasyTracker를 호출해야 하는 경우 먼저 EasyTracker의 setContext(Context ctx) 메서드를 호출해야 합니다.

// Set Context before using EasyTracker. Note that the SDK will
// use the application context.
EasyTracker.getInstance().setContext(this);

// EasyTracker is now ready for use.

3. analytics.xml 파일 만들기

Android용 Google 애널리틱스 SDK 버전 2에서 구성 옵션은 이 가이드의 analytics.xml이라는 xml 리소스 파일에서 관리됩니다. 이 파일을 프로젝트의 res/values 디렉터리에 생성하고 추적 ID를 추가해야 합니다. 다음 예는 추적 ID를 추가하고 Activity 및 예외 측정을 사용 설정하는 방법을 보여줍니다.

<?xml version="1.0" encoding="utf-8" ?>

<resources>
  <!--Replace placeholder ID with your tracking ID-->
  <string name="ga_trackingId">UA-XXXX-Y</string>

  <!--Enable automatic activity tracking-->
  <bool name="ga_autoActivityTracking">true</bool>

  <!--Enable automatic exception tracking-->
  <bool name="ga_reportUncaughtExceptions">true</bool>
</resources>

린트 검사기에서 추적 ID에 숫자 대시 ('-')를 사용하면 경고할 수 있습니다. <resources> 태그에 속성을 더 추가하여 이 경고를 억제할 수 있습니다.

<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="TypographyDashes">

구현을 구성하는 데 사용할 수 있는 전체 매개변수 목록은 analytics.xml 매개변수 참조를 확인하세요.

수고하셨습니다. 이제 앱이 Google 애널리틱스로 데이터를 전송하도록 설정되었습니다.

다음 단계

캠페인, 인앱 결제 및 거래, 사용자 상호작용 이벤트 측정 등 Google 애널리틱스를 통해 더 많은 작업을 할 수 있습니다. 구현에 이러한 기능을 추가하는 방법을 알아보려면 다음 개발자 가이드를 참고하세요.

  • 고급 구성 – 여러 추적기를 포함한 고급 구성 옵션에 대해 자세히 알아보세요.
  • 캠페인 측정 – 캠페인 측정을 구현하여 앱 설치를 유도하는 채널 및 캠페인을 파악하는 방법을 알아봅니다.
  • 이벤트 측정 – 이벤트를 사용하여 버튼, 동영상, 기타 미디어와 같은 양방향 콘텐츠의 사용자 참여도를 측정하는 방법을 알아봅니다.
  • 인앱 결제 측정 – 인앱 결제 및 거래를 측정하는 방법을 알아봅니다.
  • 사용자 시간 - 앱에서 사용자 시간을 측정하여 로드 시간, 미디어 참여 등을 측정하는 방법을 알아봅니다.
  • Analytics.xml 매개변수 – analytics.xml 구성 매개변수의 전체 목록을 참조하세요.