カスタム速度 - iOS SDK

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

概要

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

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

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

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

実装

Google アナリティクスにカスタム速度を送信するには、GAIDictionaryBuilder.createTimingWithCategory:interval:name:label: を使って速度のヒットを作成し、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]];
}