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

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

개요

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

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

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

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

값 설정 및 전송

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

// 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 애널리틱스 서버로 전송하는 것은 금지됩니다. 자세한 내용은 서비스 약관을 참고하세요.