맞춤 측정기준 및 측정항목 - Android SDK v2 (기존)

이 개발자 가이드에서는 Android v2용 Google 애널리틱스 SDK를 사용하여 맞춤 측정기준 및 측정항목을 구현하는 방법을 설명합니다.

개요

Android용 Google 애널리틱스 SDK를 사용하여 맞춤 측정기준 또는 측정항목 값을 설정하면 해당 값은 전달되는 다음 조회와 함께 매개변수로 전송됩니다. 이러한 값은 화면 조회수, 이벤트, 전자상거래, 사용자 시간, 소셜 상호작용 등 모든 Google 애널리틱스 조회 유형에 적용될 수 있습니다.

맞춤 측정기준 또는 측정항목은 크게 두 가지 단계로 구현할 수 있습니다.

  1. Google 애널리틱스 웹 인터페이스를 사용하여 맞춤 측정기준 또는 측정항목을 정의합니다.
    웹 인터페이스의 속성 설정 섹션에서 맞춤 측정기준 또는 측정항목의 색인, 이름, 범위를 설정합니다.
    맞춤 측정기준 또는 측정항목을 정의하는 방법 알아보기
  2. 맞춤 측정기준 및 측정항목 값을 설정하고 수집하는 코드를 구현합니다.
    앱에 코드를 추가하여 이전 단계에서 정의한 색인에서 Google 애널리틱스 조회의 맞춤 측정기준 또는 측정항목 값을 설정합니다.

이 도움말의 나머지 부분에서는 맞춤 측정기준 또는 측정항목 값을 설정하고 Google 애널리틱스로 전송하는 코드를 구현하는 방법을 설명합니다.

맞춤 측정기준

맞춤 측정기준 값은 모든 Google 애널리틱스 조회 유형에 설정할 수 있습니다. 값을 적용할 전송 호출 직전에 맞춤 측정기준 값을 설정합니다.

맞춤 측정기준의 정의된 범위에 따라 처리 시점에 해당 값과 연결될 수 있는 추가 조회가 결정됩니다.

맞춤 측정기준 값을 설정하려면 다음 필드가 필요합니다.

  • Integer 색인: 맞춤 측정기준 정의의 색인입니다. 이 색인은 1부터 시작합니다.
  • String 값: 맞춤 측정기준의 값입니다.

맞춤 측정기준 값 설정

맞춤 측정기준 값을 설정하려면 값을 연결하려는 전송 호출 전에 setCustomDimension를 호출합니다.

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

구현 관련 고려사항

이 섹션에서는 맞춤 측정기준을 구현할 때 유의해야 할 추가 고려사항을 간략히 설명합니다.

사용자 및 세션 수준 범위가 많음

사용자 또는 세션 수준 범위가 있는 맞춤 측정기준 값은 과거 조회수를 포함하여 현재 세션의 모든 조회에 적용됩니다. 세션 또는 사용자 수준 범위가 있는 맞춤 측정기준 값을 현재 세션의 이전 조회에 적용하지 않으려면 조회에 값을 적용하기 전에 새 세션을 시작하세요.

예를 들어 멤버십 유형을 사용자 수준 맞춤 측정기준으로 사용 중이고 사용자가 세션 중에 멤버십을 업그레이드하는 경우 새 맞춤 측정기준 값을 설정하기 전에 새 세션을 시작하는 것이 좋습니다. 이렇게 하면 업그레이드 이전의 조회가 이전 멤버십 값과 연결되는 반면 새 조회는 새 값과 연결됩니다.

맞춤 측정기준 및 보기 (프로필) 필터

사용자 또는 세션 수준의 맞춤 측정기준 값은 함께 전송된 조회가 보기 (프로필)에서 필터링되더라도 현재 또는 향후 세션의 모든 조회에 계속 적용됩니다.

맞춤 측정기준 값을 필터링하면 해당 맞춤 측정기준 값의 범위에 따라 조회가 필터링됩니다.

데이터가 처리될 때 필터와 맞춤 측정기준 값이 상호작용하는 방식을 자세히 알아보세요.

자동 화면 측정으로 값 설정

EasyTracker의 자동 화면 측정을 통해 전송된 화면 조회수에 맞춤 측정기준 값을 적용하려면 onStart() 중에 activityStart()가 호출되기 전에 값을 설정합니다.

onStart() 실행 시 값을 알 수 없는 경우 수동 화면 측정을 대신 사용하는 것이 좋습니다.

개인 식별 정보 (PII)를 값으로 전송해서는 안 됩니다.

Google 애널리틱스 서비스 약관에 따라 개인 식별 정보 (PII)를 Google 애널리틱스 서버로 전송하는 것은 금지됩니다. 자세한 내용은 서비스 약관을 참고하세요.

커스텀 측정항목

맞춤 측정기준은 특정 조회에 신중하게 적용하고 범위로 관리해야 하지만, 맞춤 측정항목이 적용되는 조회는 일반적으로 보고에 영향을 미치지 않으므로 측정항목 값이 확인될 때마다 맞춤 측정기준을 설정할 수 있습니다.

맞춤 측정항목 값을 설정하려면 다음 필드가 필요합니다.

  • Integer 색인 – 맞춤 측정항목 정의의 색인입니다.
  • Integer 값: 맞춤 측정항목의 값입니다. 값은 음수일 수 있습니다.

커스텀 측정항목 값 설정

커스텀 측정항목 값을 설정하려면 다른 전송 호출 전에 setCustomMetric를 호출합니다.

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

또는 통화 맞춤 측정항목을 설정하는 방법은 다음과 같습니다.

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

구현 관련 고려사항

다음 섹션에서는 맞춤 측정기준 또는 측정항목 구현을 계획할 때 유의해야 할 추가 고려사항을 간략히 설명합니다.

맞춤 측정항목 값이 보고서에서 집계됨

맞춤 측정항목 값은 Google 애널리틱스의 다른 사전 정의된 측정항목과 마찬가지로 보고서에서 집계됩니다. 따라서 커스텀 측정항목 값 1를 설정하여 보고서에서 측정항목의 집계 총계를 증가시킵니다.

맞춤 측정항목 및 보기 (프로필) 필터

일반적으로 맞춤 측정항목 값은 원할 때마다 설정할 수 있지만 조회 (프로필)에서 필터링될 가능성이 있는 조회에는 맞춤 측정항목 값을 설정하지 않는 것이 좋습니다. 조회가 보기 (프로필) 필터로 필터링되면 연결된 맞춤 측정항목 값도 필터링됩니다. 맞춤 측정기준 및 측정항목과 보기 (프로필) 필터에 대해 자세히 알아보기