Pelacakan Peristiwa

Panduan developer ini menjelaskan cara menggunakan Google Analytics SDK v4 untuk Android guna mengukur peristiwa di aplikasi Anda.

Ringkasan

Peristiwa adalah cara yang berguna untuk mengumpulkan data tentang interaksi pengguna dengan komponen interaktif aplikasi Anda, seperti penekanan tombol atau penggunaan item tertentu dalam game.

Peristiwa terdiri dari empat kolom yang dapat Anda gunakan untuk mendeskripsikan interaksi pengguna dengan konten aplikasi:

Nama Kolom	Jenis	Wajib	Deskripsi
Kategori	`String`	Ya	Kategori peristiwa
Tindakan	`String`	Ya	Tindakan peristiwa
Label	`String`	Tidak	Label peristiwa
Nilai	`Long`	Tidak	Nilai peristiwa

Penerapan

Untuk mengirim peristiwa ke Google Analytics, gunakan HitBuilders.EventBuilder dan kirim hit, seperti yang ditunjukkan dalam contoh ini:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
// Build and send an Event.
t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setLabel(getString(labelId))
    .build());

Lihat Konfigurasi Lanjutan untuk detail tentang metode getTracker.

Peristiwa Non-interaksi

Dalam beberapa kasus, Anda mungkin ingin mengirim peristiwa sebagai peristiwa non-interaksi. Untuk melakukannya, teruskan true ke setNonInteraction:

t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setNonInteraction(true)
    .build());

Untuk informasi selengkapnya tentang hit non-interaksi dan kapan menggunakannya, baca tentang peristiwa non-interaksi di Pusat Bantuan Analytics.

Lihat cuplikan kode dari Aplikasi Contoh

Cuplikan berikut menunjukkan contoh Fragment yang mengirim peristiwa:

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 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 Event hits.
 */
public class EventFragment extends Fragment {

  @Override
  public View onCreateView(LayoutInflater inflater, ViewGroup container,
      Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

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

    setupEvent(view, R.id.video1Play, R.string.videoCategory, R.string.videoPlay, R.string.video1);
    setupEvent(view, R.id.video1Pause, R.string.videoCategory, R.string.videoPause,
        R.string.video1);
    setupEvent(view, R.id.video2Play, R.string.videoCategory, R.string.videoPlay, R.string.video2);
    setupEvent(view, R.id.video2Pause, R.string.videoCategory, R.string.videoPause,
        R.string.video2);

    setupEvent(view, R.id.book1View, R.string.bookCategory, R.string.bookView, R.string.book1);
    setupEvent(view, R.id.book1Share, R.string.bookCategory, R.string.bookShare, R.string.book1);

    final Button dispatchButton = (Button) view.findViewById(R.id.eventDispatch);
    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().getApplicationContext()).dispatchLocalHits();
      }
    });
    return view;
  }

  private void setupEvent(View v, int buttonId, final int categoryId, final int actionId,
      final int labelId) {
    final Button pageviewButton = (Button) v.findViewById(buttonId);
    pageviewButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        // Get tracker.
        Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
            TrackerName.APP_TRACKER);
        // Build and send an Event.
        t.send(new HitBuilders.EventBuilder()
            .setCategory(getString(categoryId))
            .setAction(getString(actionId))
            .setLabel(getString(labelId))
            .build());
      }
    });
  }
}