고급 구성 - iOS SDK

이 문서에서는 iOS v2용 Google 애널리틱스 SDK의 고급 구성 기능을 간략하게 설명합니다.

개요

iOS용 Google 애널리틱스 SDK는 두 가지 클래스를 사용하여 구현의 전체 상태를 관리하고 Google 애널리틱스 서버로 데이터를 전송합니다.

GAI - 새 GAITracker 객체 가져오기와 앱 수준의 선택 해제 설정 및 전달 설정을 포함하여 구현의 전역 상태를 처리하는 싱글톤입니다.
GAITracker - Google 애널리틱스로 데이터를 보내는 클래스입니다. 고유한 속성 ID당 하나씩 여러 추적기를 인스턴스화할 수 있습니다.

여러 트래커 사용

SDK 버전 2부터는 고유한 추적 ID당 하나씩, 여러 추적기를 한 번에 구현할 수 있습니다. 모든 추적기는 GAI 싱글톤에서 보유한 동일한 전역 상태를 공유합니다.

다음 예에서 화면 조회수는 각각 고유한 속성 ID가 있는 두 개의 추적기를 사용하여 두 개의 개별 속성으로 전송됩니다.

#import "RootViewController.h"
#import "GAI.h"

@interface RootViewController ()

@end

@implementation RootViewController
{
- (void)viewDidLoad {
  [super viewDidLoad];

  // Send a screen view to the first property.
  id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"];
  [tracker1 sendView:@"/HomeScreen"];

  // Send another screen view to the second property.
  id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"];
  [tracker2 sendView:@"Home"];
}

@end

자동 화면 및 포착되지 않은 예외 측정과 같은 자동 측정 기능은 하나의 추적기만 사용하여 Google 애널리틱스로 데이터를 전송합니다. 이러한 기능을 사용 중이고 다른 추적기를 통해 데이터를 전송하려면 수동으로 전송해야 합니다.

참고로 자동 화면 측정은 지정된 GAITrackedViewController의 tracker 속성에 지정된 추적기를 사용합니다. 포착되지 않은 예외 측정은 GAI 인스턴스에 지정된 기본 추적기를 사용합니다.

기본 추적기

구현에서 여러 추적기를 사용할 수 있지만 전역적으로 하나의 기본 추적기가 있습니다. 검색된 첫 번째 Tracker가 기본 추적기가 됩니다.

기본 추적기를 가져오려면 다음을 사용하세요.

// Get default tracker.
id myDefault = [GAI sharedInstance].defaultTracker;

기본 추적기를 설정하려면 다음을 사용하세요.

// Get a new tracker.
id newTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID");

// Set the new tracker as the default tracker, globally.
[GAI sharedInstance].defaultTracker = newTracker;

샘플링

클라이언트 측 샘플링을 사용 설정하면 Google 애널리틱스로 전송되는 조회수를 제한할 수 있습니다. 앱에 사용자가 많거나 Google 애널리틱스로 대량의 데이터를 전송하는 경우 샘플링을 사용 설정하면 보고가 중단되지 않습니다.

예를 들어 클라이언트 측 샘플링을 50%의 비율로 구현하려면 다음 코드를 사용합니다.

// Set a sample rate of 50%.
[tracker setSampleRate:50.0];  // Sample rate is a double.

앱 수준 선택 해제

앱 수준 선택 해제 플래그를 사용 설정하여 앱 전체에서 Google 애널리틱스를 사용 중지할 수 있습니다. 설정된 플래그는 앱의 수명 기간 동안 또는 재설정될 때까지 유지됩니다.

앱 수준의 선택 해제 설정을 가져오려면 다음을 사용하세요.

// Get the app-level opt out preference.
if ([GAI sharedInstance].optOut) {
  ... // Alert the user they have opted out.
}

앱 수준 선택 해제 플래그를 설정하려면 다음을 사용합니다.


// Set the app-level opt out preference.
[[GAI sharedInstance].setOptOut = YES];

테스트 및 디버깅

iOS용 Google 애널리틱스 SDK는 Google 애널리틱스로 전송되는 데이터에 대한 유용한 정보를 로그에 출력하는 디버그 모드를 제공합니다.

// Enable debug mode.
[GAI sharedInstance].debug = YES;