カスタム速度 - iOS SDK

このデベロッパー ガイドでは、iOS 向け Google アナリティクス SDK v3 を使った カスタム速度の測定方法について説明します。

概要

カスタム速度の測定は、Google アナリティクスで時間の長さを測定するために備わっている機能で、リソースの読み込み時間などを測定する際に役立ちます。

カスタム速度には次のフィールドがあります。

フィールド名 トラッカー フィールド 必須 説明
Category kGAITimingCategory NSString 必須 測定するイベントのカテゴリ
Value kGAITimingValue NSNumber 必須 測定された時間(ミリ秒単位)
Name kGAITimingVar NSString 必須 測定するイベントの名前
Label kGAITimingLabel NSString いいえ 測定するイベントのラベル

カスタム速度データは、主にアプリ上でのカスタム速度レポートに表示されます。

実装

Google アナリティクスにカスタム速度を送るには、次のように GAIDictionaryBuilder.createTimingWithCategory:interval:name:label: を使って「timing」タイプのヒットを作成し、send: を使って送ります。

/*
 * Called after a list of high scores finishes loading.
 *
 * @param loadTime The time it takes to load a resource.
 */
- (void)onLoad:(NSTimeInterval)loadTime {

  // May return nil if a tracker has not already been initialized with a
  // property ID.
  id tracker = [[GAI sharedInstance] defaultTracker];

  [tracker send:[[GAIDictionaryBuilder createTimingWithCategory:@"resources"
                                                      interval:@((NSUInteger)(loadTime * 1000))
                                                          name:@"high scores"
                                                         label:nil] build]];
}