既存のアプリに組み込んでいた「Google Analytics SDK for iOS」が v1 だったので最新の v2(Beta) に置き換えてみた。

v1のときと違って、Xcodeプロジェクトへの導入はかなり簡単になってました。

下準備

• Google Analyticsでアプリ用のトラッキングコードを作成。
• Google Analytics SDK for iOS v2(Beta)をダウンロード。
  Google Analytics for Mobile Apps iOS SDK v2

導入ステップ

1. ヘッダファイルとライブラリの追加
2. トラッカーの設定(初期化)
3. スクリーントラッキングの追加

1. ヘッダファイルとライブラリの追加

Xcodeのプロジェクトに、Google Analytics SDK for iOS の中から必要なヘッダファイルとライブラリのみを追加します。

ダウンロードした Google Analytics SDK を解凍して、「Library」フォルダ内の以下のファイルをXcodeのプロジェクトにそのままドラッグアンドドロップ。

• GAI.h
• GAITracker.h
• GAITrackedViewController.h
• GAITransaction.h
• GAITransactionItem.h
• libGoogleAnalytics.a

“Copy items into destination group’s folder (if needed)” をチェックしてプロジェクト内に実ファイルをコピー。

次に、以下のフレームワークとGoogle Analyticsのライブラリファイルをアプリのターゲットの “Link Binary With Libraries” に追加します。

• CoreData.framework
• SystemConfiguration.framework
• libGoogleAnalytics.a
  ※[Add Other…]ボタンからファイルを直接指定する。

2. トラッカーの設定(初期化)

アプリケーションデリゲートのソースファイル(ex. AppDelegate.m)に、”GAI.h”ヘッダファイルをインポート。

#import "GAI.h"

アプリケーションデリゲートの “application:didFinishLaunchingWithOptions:” メソッドに以下を追加。

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

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

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

    // トラッカーインスタンスの生成。
    // UA-YOUR-TRACKING-ID は自分のGAトラッキングIDに置き換える。
    id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"UA-YOUR-TRACKING-ID"];
    
    return YES;
}

3. スクリーントラッキングの追加

解析したいビューコントローラのヘッダファイルを書き換えます。

例えばビューコントローラのインターフェースが以下のようになっていた場合、

@interface MainViewController : UIViewController

“GAITrackedViewController.h” をインポートしてさらに “UIViewController” を継承する “GAITrackedViewController” に置き換えます。

#import "GAITrackedViewController.h"

@interface MainViewController : GAITrackedViewController

Google Analyticsのトラッキングレポートに、ユーザーがアプリ内でどのビューをどれだけオープンしたか確認できるレポートを追加するには、ビューコントローラのソースファイルの viewDidLoad メソッドに解析のためのスクリーン名を設定しておきます。

- (void)viewDidLoad {
  [super viewDidLoad];
  // Screen Name はこのビュー固有のスクリーン名にする
  self.trackedViewName = @"Screen Name";
}

ここまででの作業で、以下の解析が行えるようになります。

• アプリのインストール数
• アクティブユーザー数とユーザーの統計
• 画面遷移とユーザーエンゲージメント
• クラッシュレポート

[Google Analytics SDK for iOS v2 (Beta) – Overview]