ระยะเวลาของผู้ใช้

คู่มือนักพัฒนาซอฟต์แวร์นี้จะอธิบายวิธีวัดระยะเวลาของผู้ใช้ด้วย 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();
  }
}