Google Analytics SDK for iOS v2 (Beta) でカスタム変数を使う

GoogleAnalytics for iOS の基礎の基礎

入手先

Downloads - iOS SDK - Google Analytics — Google Developers

とりあえず使ってみる

とりあえず使うだけなら非常に簡単。
以下のようにするだけでトラッキングしてくれる。

この例ではViewDidLoadでsendViewしているが、基本的にどこで実行してもよい。
同じViewController内で画面が切り替わるような場合は、
画面を切り替えるメソッド内で実行してやればよい。

AppDelegate.m

#import "GAI.h"

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // GoogleAnalytics
    // (オプション)キャッチされない例外エラーをトラッキングするか。デフォルト:有効
    [GAI sharedInstance].trackUncaughtExceptions = YES;

    // (オプション)ディスパッチインターバル。デフォルト:20秒
    [GAI sharedInstance].dispatchInterval = 20;

    // (オプション)YESにするとより多くのデバッグ情報を取得する。デフォルト:有効
    [GAI sharedInstance].debug = YES;

    // トラッカーインスタンスの生成。自分のトラッカーIDに変える
    id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"UA-YOUR-TRACKING-ID"];

    // トラッカーIDひとつしか使わないならここでデフォルトトラッカーを置き換え
    [GAI sharedInstance].defaultTracker = tracker;

    return YES;
}

YourViewController.m

#import "GAI.h"

@implementation YourViewController

- (void)viewDidLoad
{
    [super viewDidLoad];

    [[GAI sharedInstance].defaultTracker sendView:@"任意のスクリーンネーム"];
}

@end

カスタム変数(Custom Dimensions & Metrics)を使う

GoogleAnalyticsはデフォルトでiOSのversionや画面解像度、地域、デバイスの種類、アクティブユーザー数、などなど様々な値を取得してくれる。
しかし、独自の値を取得したいということもある。

そのような場合、まずGoogleAnalyticsのWebページからアナリティクス設定を開く。

次にカスタム定義から[カスタムディメンション]や[カスタム指標]を開いて任意のカスタムディメンション/指標を作成する。

あとはコード上でそれらに対して送信してやるだけ。

CustomMetric

id tracker = [GAI sharedInstance].defaultTracker;

// NSNumber
[tracker setCustom:1
                    metric:@1];

[tracker sendView:@"任意のスクリーンネーム"];

CustomDimension

id tracker = [[GAI sharedInstance].defaultTracker;

// NSString
[tracker setCustom:1
              dimension:@"任意の文字列"]; 

[tracker sendView:@"任意のスクリーンネーム"];