Android용 Google 애널리틱스 SDK v3 (기존) - 시작하기

이 문서에서는 Android v3용 Google 애널리틱스 SDK를 사용하는 방법을 설명합니다.

시작하기 전에

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() 메서드에 전송 메서드를 추가합니다.

package com.example.app;

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;

/**
 * An example Activity using Google Analytics and EasyTracker.
 */
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(this).activityStart(this);  // Add this method.
  }

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

3. analytics.xml 파일 만들기

EasyTracker를 사용하는 경우 전역 구성 설정은 XML로 정의된 리소스를 사용하여 관리됩니다. 프로젝트의 res/values 디렉터리에 analytics.xml이라는 파일을 만들고 다음 리소스를 추가합니다.

<?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 매개변수 참조를 확인하세요. 애플리케이션 요구사항에 따라 디스패치 기간을 변경하여 조회를 올바르게 전송하고 있는지 확인할 수 있습니다. 예를 들어 실시간 데이터를 확인하려면 5s와 같은 낮은 값으로 설정하면 됩니다.

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

다음 단계

캠페인, 인앱 결제 및 거래, 사용자 상호작용 이벤트 측정 등 Google 애널리틱스를 통해 더 많은 작업을 할 수 있습니다.

다음 개발자 가이드에서는 앱에서 Google 애널리틱스 기능을 구현하는 방법을 자세히 설명합니다.

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