Ereignis-Tracking – Android SDK

In diesem Entwicklerleitfaden wird beschrieben, wie Sie mit dem Google Analytics SDK for Android Version 3 Ereignisse in Ihrer App erfassen.

Ü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 Tracker-Feld Typ Erforderlich Beschreibung
Kategorie Fields.EVENT_CATEGORY String Ja Die Ereigniskategorie
Aktion Fields.EVENT_ACTION String Ja Die Ereignisaktion
Label Fields.EVENT_LABEL String Nein Die Ereigniskennzeichnung
Wert Fields.EVENT_VALUE Long Nein Der Ereigniswert

Implementierung

Um ein Ereignis an Google Analytics zu senden, verwenden Sie MapBuilder.createEvent() und senden Sie den Treffer, wie in diesem Beispiel:

@Override
public void onClick(View v) {
  // May return null if a EasyTracker has not yet been initialized with a
  // property ID.
  EasyTracker easyTracker = EasyTracker.getInstance(this);

  // MapBuilder.createEvent().build() returns a Map of event fields and values
  // that are set and sent with the hit.
  easyTracker.send(MapBuilder
      .createEvent("ui_action",     // Event category (required)
                   "button_press",  // Event action (required)
                   "play_button",   // Event label
                   null)            // Event value
      .build()
  );
}