iOS アプリにアナリティクスを追加する

このガイドでは、アナリティクスを iOS アプリに追加して、名前付きのスクリーンに対するユーザー行動を測定する方法について説明します。アプリを作成する前にアナリティクスの仕組みを確認するには、サンプルアプリをご覧ください。

アナリティクスは、CocoaPods を使用して、依存ライブラリのインストールと管理を行います。ターミナルウィンドウを開き、アプリケーションの Xcode プロジェクトの場所に移動してください。アプリの Podfile をまだ作成していない場合は、ここで作成します。

pod init

アプリ用に作成した Podfile を開き、次の内容を追加します。

pod 'GoogleAnalytics'

ファイルを保存し、次のコマンドを実行します。

pod install

これにより、アプリ用の .xcworkspace ファイルが作成されます。このファイルは、アプリケーションで今後行うあらゆる開発で利用できます。

アプリ向けにアナリティクスを初期化する

設定ファイルをプロジェクトに追加したら、実装を開始するための準備は完了です。まず、AppDelegate 内で共有アナリティクスオブジェクトを設定します。これにより、アプリからアナリティクスにデータを送信できるようになります。必要な手順は以下のとおりです。

必要なヘッダーを含める。
didFinishLaunchingWithOptions 内にアナリティクストラッキングツールを設定する。
YOUR_TRACKING_ID を独自のアナリティクストラッキング ID（例: UA-47605289-8）に置き換える。
例外情報とログ情報を送信する（省略可）。

これらの変更を行うには、まず Swift プロジェクトに BridgingHeader が含まれていることを確認してから、この BridgingHeader 内にアナリティクスを追加します。

#import <GoogleAnalytics/GAI.h>
#import <GoogleAnalytics/GAIDictionaryBuilder.h>

最後に、didFinishLaunchingWithOptions メソッドをオーバーライドして、アナリティクスを設定します。

guard let gai = GAI.sharedInstance() else {
  assert(false, "Google Analytics not configured correctly")
}
gai.tracker(withTrackingId: "YOUR_TRACKING_ID")
// Optional: automatically report uncaught exceptions.
gai.trackUncaughtExceptions = true

// Optional: set Logger to VERBOSE for debug information.
// Remove before app release.
gai.logger.logLevel = .verbose;

スクリーントラッキングを追加する

ここでは、ユーザーがアプリのスクリーンを開くか変更するたびに、名前付きのスクリーンビューをアナリティクスに送信するよう設定します。トラッキングするビューコントローラを開くか、新しいアプリである場合はデフォルトのビューコントローラを開きます。次の内容をコードに追加します。

必要なヘッダーを追加する:

#import <GoogleAnalytics/GAI.h>
#import <GoogleAnalytics/GAIDictionaryBuilder.h>
#import <GoogleAnalytics/GAIFields.h>BridgingHeader.h

viewWillAppear メソッドまたは関数オーバーライドを使用して、スクリーントラッキングを挿入する。
スクリーンの名前を設定して、トラッキングを実行する。

guard let tracker = GAI.sharedInstance().defaultTracker else { return }
tracker.set(kGAIScreenName, value: name)

guard let builder = GAIDictionaryBuilder.createScreenView() else { return }
tracker.send(builder.build() as [NSObject : AnyObject])ViewController.swift

注: スクリーンがコード経由でユーザーに強制的に表示される場合でも、ストーリーボードが使われる場合でも、スクリーンを表す各 UIViewController に対してトラッキングコードを追加することができます。アプリのスクリーンビューをアナリティクスで区別する必要がある場合は、すべての UIViewController に名前を設定します。共有トラッカーに記録されるすべてのアクティビティは、スクリーン名が置換または消去（nil に設定）されるまで、最新のスクリーン名を送信します。

次のステップ

Google アナリティクスを使用してユーザーの接点を測定する方法と、アプリの使用状況に関する質問の回答については、モバイルアプリ実装ガイドをご覧ください。
サンプリング、テストとデバッグ、オプトアウト設定などの追加の設定オプションを確認します。
アプリで必要になる場合は、拡張 e コマース、IDFA（広告主識別子）、iAd インストールキャンペーン測定などのオプション機能を有効にします。