Czas działań użytkownika

Z tego przewodnika dla programistów dowiesz się, jak mierzyć czas działań użytkowników za pomocą pakietu SDK Google Analytics w wersji 4 na Androida.

Przegląd

Pomiar czasu użytkownika to natywny sposób pomiaru czasu w Google Analytics. Może to na przykład pomóc w mierzeniu czasu wczytywania zasobów.

Czasy działań użytkownika zawierają te pola:

Nazwa pola	Typ	Wymagane	Opis
Kategoria	String	Tak	Kategoria zdarzenia zaplanowanego na czas
Wartość	long	Tak	Pomiar czasu w milisekundach
Nazwa	String	Tak	Nazwa zdarzenia zaplanowanego na czas
Wytwórnia	String	Nie	Etykieta zdarzenia licznika czasu

Dane o czasie działań użytkowników można znaleźć głównie w raporcie Czas użytkownika dotyczącym szybkości aplikacji.

Implementacja

Aby wysłać do Google Analytics czas użytkownika, utwórz TimingBuilder i użyj w tym celu 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());

Więcej informacji o metodzie getTracker znajdziesz w sekcji Konfiguracja zaawansowana.

Zobacz fragment kodu z przykładowej aplikacji

Ten fragment kodu pokazuje przykładowy element Fragment, który wysyła czas działania użytkownika:

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();
  }
}