고급 구성 - iOS SDK

이 문서에서는 iOS v2용 Google 애널리틱스 SDK의 일부 고급 구성 기능을 개략적으로 설명합니다.

개요

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

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

여러 추적기 사용

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

다음 예에서는 화면 조회가 2개의 추적기를 통해 전송되어 각각 고유한 속성 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;