Registrar eventos

Os eventos apresentam insights sobre o que está acontecendo em seu app, como ações do usuário, eventos do sistema ou erros.

O Analytics registra automaticamente alguns eventos para você. Você não precisa adicionar códigos para recebê-los. Se o app precisar coletar dados adicionais, é possível registrar até 500 tipos diferentes de eventos do Analytics nele. Não há limite para o volume total de eventos que seu app registra. Como os nomes de eventos diferenciam letras maiúsculas e minúsculas, registrar dois eventos com nomes que diferem apenas no uso de caixa baixa/alta resultará na criação de dois eventos distintos.

Antes de começar

Se você ainda não tiver adicionado o Analytics ao seu app, inicialize em Activity o objeto com.google.firebase.analytics..FirebaseAnalytics:

Java
Android

private FirebaseAnalytics mFirebaseAnalytics;
// ...
// Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

Kotlin
Android

private lateinit var firebaseAnalytics: FirebaseAnalytics
// ...
// Obtain the FirebaseAnalytics instance.
firebaseAnalytics = FirebaseAnalytics.getInstance(this)

Registrar eventos

Depois de criar uma instância FirebaseAnalytics, use-a para registrar eventos com o método logEvent().

Para ajudar nos primeiros passos, o SDK do Analytics define vários eventos sugeridos que são comuns entre tipos diferentes de apps, incluindo apps de varejo, comércio eletrônico, viagem e jogos. Para saber mais sobre esses eventos e quando usá-los, consulte os artigos de Eventos e propriedades na Central de Ajuda do Firebase.

Os detalhes de implementação dos tipos de eventos sugeridos podem ser encontrados nos seguintes locais:

Veja no exemplo a seguir como registrar um evento SELECT_CONTENT sugerido:

Java
Android

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

Kotlin
Android

val bundle = Bundle()
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id)
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name)
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle)

Além dos parâmetros prescritos, adicione os seguintes parâmetros a qualquer evento:

  • Parâmetros personalizados: podem ser registrados para a geração de relatórios do Analytics. Eles também são usados como filtros em definições de público-alvo que podem ser aplicados a todos os relatórios. Os parâmetros personalizados também estão incluídos nos dados exportados ao BigQuery caso seu app seja vinculado a um projeto do BigQuery.

  • Parâmetro VALUE: VALUE é um parâmetro de uso geral, útil para coletar uma métrica principal pertencente a um evento. Exemplos incluem receita, distância, horário e pontos.

Caso seu aplicativo tenha necessidades específicas não atendidas por um tipo de evento sugerido, registre seus próprios eventos personalizados, conforme mostrado neste exemplo:

Java
Android

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin
Android

val params = Bundle()
params.putString("image_name", name)
params.putString("full_text", text)
firebaseAnalytics.logEvent("share_image", params)

Visualizar eventos no registro de depuração do Android Studio

Você pode ativar o registro detalhado para monitorar se o SDK está registrando adequadamente os eventos. Isso inclui os eventos registrados manual e automaticamente.

Ative o registro detalhado com uma série de comandos adb:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Esse comando exibe os eventos no logcat do Android Studio, ajudando a verificar imediatamente se eles estão sendo enviados.

Ver eventos no painel

Você pode ver estatísticas agregadas sobre os eventos nos painéis de controle do Console do Firebase. Eles são atualizados periodicamente ao longo do dia. Para fazer testes imediatos, use a saída do logcat conforme descrito na seção anterior.

Você pode acessar esses dados no Firebase console da seguinte forma:

  1. Abra seu projeto no Console do Firebase.
  2. Selecione Analytics no menu para ver o painel de relatórios do Analytics.

Na guia Eventos, você encontra os relatórios de eventos criados automaticamente para cada tipo diferente de evento registrado pelo seu app. Saiba mais sobre o painel de relatórios do Analytics na Central de Ajuda do Firebase.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.