Monitoraggio eventi - SDK per Android

Questa guida per gli sviluppatori descrive come misurare gli eventi nella tua app utilizzando l'SDK Google Analytics per Android v3.

Panoramica

Gli eventi sono un modo utile per raccogliere dati sull'interazione di un utente con i componenti interattivi della tua app, come la pressione di un pulsante o l'utilizzo di un determinato elemento in un gioco.

Un evento è costituito da quattro campi che puoi utilizzare per descrivere l'interazione di un utente con i contenuti dell'app:

Nome campo Campo tracker Tipo Obbligatorio Descrizione
Categoria Fields.EVENT_CATEGORY String Sì Categoria dell'evento
Azione Fields.EVENT_ACTION String Sì Azione dell'evento
Etichetta Fields.EVENT_LABEL String No Etichetta dell'evento
Valore Fields.EVENT_VALUE Long No Valore dell'evento

Implementazione

Per inviare un evento a Google Analytics, utilizza MapBuilder.createEvent() e invia l'hit, come in questo esempio:

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