Diese Seite wurde von der Cloud Translation API übersetzt.

Ereignis-Tracking

In diesem Entwicklerleitfaden wird beschrieben, wie Sie mit dem Google Analytics SDK Version 4 für Android Ereignisse in Ihrer App messen können.

Übersicht

Ereignisse sind hilfreich, 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 Elements in einem Spiel.

Ein Ereignis besteht aus vier Feldern, mit denen Sie die Nutzerinteraktion mit Ihren App-Inhalten beschreiben können:

Feldname	Typ	Required	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 einigen Fällen kann es sinnvoll sein, ein Ereignis als Ereignis ohne Interaktion zu 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 deren Verwendung finden Sie in der Analytics-Hilfe unter Ereignisse, die keine Interaktion sind.

Code-Snippet aus der Beispielanwendung ansehen

Das folgende Snippet zeigt ein Beispiel für 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());
      }
    });
  }
}