תזמוני משתמשים

במדריך למפתחים נסביר איך למדוד תזמוני משתמש באמצעות Google Analytics SDK v4 ל-Android.

סקירה

מדידת תזמוני משתמש היא דרך מובנית למדוד תקופת זמן ב-Google Analytics. כך ניתן למדוד זמני טעינה של משאבים, לדוגמה.

תזמוני משתמש כוללים את השדות הבאים:

שם השדה	סוג	חובה	תיאור
קטגוריה	String	כן	הקטגוריה של האירוע המתוזמן
ערך	long	כן	מדידת התזמון באלפיות השנייה
שם	String	כן	שם האירוע המתוזמן
לייבל	String	לא	התווית של האירוע המתוזמן

הנתונים של תזמוני משתמש מופיעים בעיקר בדוח 'תזמוני משתמש למהירות אפליקציה'.

הטמעה

כדי לשלוח תזמון משתמש ל-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();
  }
}