Ereignis-Tracking

In diesem Entwicklerleitfaden wird beschrieben, wie Sie das Google Analytics SDK Version 4 für Android verwenden, um Ereignisse in Ihrer App zu messen.

Überblick

Ereignisse sind nützlich, um Daten zur Interaktion eines Nutzers mit interaktiven Komponenten Ihrer App zu erfassen, z. B. dem Drücken von Schaltflächen oder der Verwendung eines bestimmten Artikels in einem Spiel.

Ein Ereignis besteht aus vier Feldern, mit denen Sie die Interaktion eines Nutzers mit Ihrem App-Inhalt beschreiben können:

Feldname	Typ	Erforderlich	Beschreibung
Kategorie	`String`	Ja	Die Ereigniskategorie
Aktion	`String`	Ja	Die Ereignisaktion
Label	`String`	Nein	Die Ereigniskennzeichnung
Wert	`Long`	Nein	Der Ereigniswert

Implementierung

Wenn Sie ein Ereignis an Google Analytics senden möchten, verwenden Sie HitBuilders.EventBuilder und senden Sie den Treffer, wie in diesem Beispiel gezeigt:

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

Weitere Informationen zur Methode getTracker finden Sie unter Erweiterte Konfiguration.

Ereignisse ohne Interaktion

In manchen Fällen möchten Sie ein Ereignis als Ereignis ohne Interaktion senden. Übergeben Sie dazu true an setNonInteraction:

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

Weitere Informationen zu Treffern ohne Interaktion und ihrer Verwendung finden Sie in der Analytics-Hilfe unter Ereignisse ohne Interaktion.

Code-Snippet aus der Beispielanwendung ansehen

Das folgende Snippet zeigt ein Beispiel-Fragment, das ein Ereignis sendet:

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