Пользовательское время

В этом руководстве для разработчиков описывается, как измерять время пользователя с помощью Google Analytics SDK v4 для Android.

Обзор

Измерение времени пользователя обеспечивает собственный способ измерения периода времени в Google Analytics. Это может быть полезно, например, для измерения времени загрузки ресурсов.

Пользовательские тайминги имеют следующие поля:

Имя поля	Тип	Необходимый	Описание
Категория	String	Да	Категория временного события
Ценить	long	Да	Измерение времени в миллисекундах
Имя	String	Да	Название запланированного события
Этикетка	String	Нет	Ярлык запланированного события

Данные о времени пользователя можно найти в основном в отчете о времени пользователя App Speed.

Выполнение

Чтобы отправить данные о времени пользователя в Google Analytics, создайте 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();
  }
}