カスタム速度

このドキュメントでは、Android 向け Google アナリティクス SDK v4 を使った カスタム速度の測定方法について説明します。

概要

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

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

フィールド名	タイプ	必須	説明
カテゴリ	String	はい	測定するイベントのカテゴリ
値	long	はい	測定された時間（ミリ秒単位）
名前	String	はい	測定するイベントの名前
ラベル	String	×	測定するイベントのラベル

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

実装

カスタム速度を Google アナリティクスに送信するには、TimingBuilder を作成し、Tracker を使って送信します。

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);

// Build and send timing.
t.send(new HitBuilders.TimingBuilder()
    .setCategory(getTimingCategory())
    .setValue(getTimingInterval())
    .setVariable(getTimingName())
    .setLabel(getTimingLabel())
    .build());

getTracker メソッドの詳細については、 高度な構成をご覧ください。

サンプルアプリのコード スニペット

次のスニペットは、カスタム速度を送信する Fragment の例を示しています。

package com.google.android.apps.mobileplayground;

import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.ViewGroup;
import android.widget.Button;
import android.widget.EditText;
import com.google.android.apps.mobileplayground.AnalyticsSampleApp.TrackerName;
import com.google.android.gms.analytics.GoogleAnalytics;
import com.google.android.gms.analytics.HitBuilders;
import com.google.android.gms.analytics.Tracker;

/**
 * Class to exercise Timing hits.
 */
public class TimingFragment extends Fragment {
  @Override
  public View onCreateView(LayoutInflater inflater, ViewGroup container,
      Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    View view = inflater.inflate(R.layout.timing, container, false);

    final Button sendButton = (Button) view.findViewById(R.id.timingSend);
    sendButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        // Get tracker.
        Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
            TrackerName.APP_TRACKER);

        // Build and send timing.
        t.send(new HitBuilders.TimingBuilder()
            .setCategory(getTimingCategory())
            .setValue(getTimingInterval())
            .setVariable(getTimingName())
            .setLabel(getTimingLabel())
            .build());
      }
    });

    final Button dispatchButton = (Button) view.findViewById(R.id.timingDispatch);
    dispatchButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        // Manually start a dispatch (Unnecessary if the tracker has a dispatch interval)
        GoogleAnalytics.getInstance(getActivity().getBaseContext()).dispatchLocalHits();
      }
    });
    return view;
  }

  private String getTimingCategory() {
    return ((EditText) getView().findViewById(R.id.editTimingCategory)).getText().toString().trim();
  }

  private long getTimingInterval() {
    String value =
        ((EditText) getView().findViewById(R.id.editTimingInterval)).getText().toString().trim();
    if (value.length() == 0) {
      return 0;
    }
    return Long.valueOf(value);
  }

  private String getTimingName() {
    return ((EditText) getView().findViewById(R.id.editTimingName)).getText().toString().trim();
  }

  private String getTimingLabel() {
    return ((EditText) getView().findViewById(R.id.editTimingLabel)).getText().toString().trim();
  }
}