Monitoraggio eventi

Questa guida per gli sviluppatori descrive come utilizzare l'SDK di Google Analytics v4 per Android per misurare gli eventi nella tua app.

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	Tipo	Obbligatorio	Descrizione
Categoria	`String`	Sì	Categoria dell'evento
Azione	`String`	Sì	Azione dell'evento
Etichetta	`String`	No	Etichetta dell'evento
Valore	`Long`	No	Valore dell'evento

Implementazione

Per inviare un evento a Google Analytics, utilizza HitBuilders.EventBuilder e invia l'hit, come mostrato in questo esempio:

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

Per maggiori dettagli sul metodo getTracker, consulta Configurazione avanzata.

Eventi non di interazione

In alcuni casi potresti voler inviare un evento come evento di non interazione. A questo scopo, passa true a setNonInteraction:

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

Per ulteriori informazioni sugli hit non di interazione e su quando utilizzarli, consulta le informazioni sugli eventi non di interazione nel Centro assistenza Analytics.

Visualizzare uno snippet di codice dall'applicazione di esempio

Lo snippet seguente mostra un esempio Fragment che invia un evento:

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