맞춤 측정기준 및 측정항목 - iOS SDK

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

개요

맞춤 측정기준을 사용하면 Google 애널리틱스에서 메타데이터를 조회수, 사용자, 세션수와 연결할 수 있고, 맞춤 측정항목을 사용하면 Google 애널리틱스에서 자체 측정항목을 만들고 늘릴 수 있습니다.

  1. Google 애널리틱스 웹 인터페이스를 사용하여 맞춤 측정기준 또는 측정항목을 구성합니다. 맞춤 측정기준 또는 측정항목을 구성하는 방법 알아보기 (고객센터)
  2. 앱에서 맞춤 측정기준 및 측정항목 값을 설정하고 전송합니다.

맞춤 측정기준 및 측정항목은 다음 두 필드로 구성됩니다.

  • NSNumber 색인: 맞춤 측정기준 또는 측정항목의 색인입니다. 이 색인은 1부터 시작합니다.
  • NSString 값: 맞춤 측정기준 또는 측정항목의 값입니다. 이 경우 측정항목이 통화 유형으로 구성된 경우 정수 또는 고정 소수점 소수점 값으로 파싱됩니다.

값 설정 및 전송

맞춤 측정기준 값을 설정하고 전송하는 방법은 다음과 같습니다.

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] build]];

맞춤 측정기준 값은 화면 조회수, 이벤트, 전자상거래, 사용자 시간, 소셜 상호작용과 같은 모든 Google 애널리틱스 조회 유형과 함께 전송될 수 있습니다. 맞춤 측정기준의 정의된 범위에 따라 처리 시점에 측정기준 값과 연결되는 조회가 결정됩니다.

맞춤 측정항목 값을 설정하고 전송하는 방법은 다음과 같습니다.

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];


// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];


[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

구현 관련 고려사항

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

맞춤 측정기준 고려사항

사용자 및 세션 수준 범위가 있는 값은 이전 조회에 적용됩니다.

  • 사용자 또는 세션 수준 범위가 포함된 맞춤 측정기준 값은 과거 조회수를 포함하여 현재 세션의 모든 조회에 적용됩니다. 세션 또는 사용자 수준 범위가 있는 맞춤 측정기준 값이 현재 세션의 이전 조회에 적용되지 않도록 하려면 조회에 값을 적용하기 전에 새 세션을 시작하세요.
  • 예를 들어 멤버십 유형을 사용자 수준의 맞춤 측정기준으로 사용 중이고 사용자가 세션 중에 멤버십을 업그레이드하는 경우 새 맞춤 측정기준 값을 설정하기 전에 새 세션을 시작하는 것이 좋습니다. 이렇게 하면 업그레이드 이전의 조회가 이전 멤버십 값과 연결되는 반면 새 조회는 새 값과 연결됩니다.

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

  • 사용자 또는 세션 수준의 맞춤 측정기준 값은 함께 전송된 조회가 보기 (프로필)에서 필터링되더라도 현재 및 향후 세션의 모든 조회에 계속 적용됩니다.
  • 맞춤 측정기준 값을 필터링하면 해당 맞춤 측정기준 값의 범위에 따라 조회가 필터링됩니다. 데이터가 처리될 때 필터와 맞춤 측정기준 값이 상호작용하는 방식을 자세히 알아보세요.

커스텀 측정항목의 고려사항

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

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

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

자동 화면 측정으로 값 설정

  • 자동 화면 측정을 통해 전송된 화면 조회수에 맞춤 측정기준 값을 적용하려면 뷰 컨트롤러의 viewDidAppear: 메서드 중에 값을 설정하세요. 예를 들어 뷰 컨트롤러의 .m 파일은 다음과 같을 수 있습니다.
#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [super viewDidAppear:animated];   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

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

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