Catch up on everthing we announced at this year's Firebase Summit. Learn more

Registrar eventos

Neste guia, mostraremos como registrar eventos no seu app.

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

O Analytics registra automaticamente alguns eventos para você. Não é necessário adicionar códigos para recebê-los. Caso o aplicativo precise coletar outros dados, é possível registrar até 500 tipos de eventos do Analytics diferentes no app. Não há limite para o volume total de eventos registrados pelo app. 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

Verifique se você configurou seu projeto e pode acessar o Analytics, como descrito em Primeiros passos com o Analytics.

Registrar eventos

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

Para ajudar você a começar, o SDK do Analytics define vários eventos sugeridos, comuns entre tipos diferentes de apps, como os 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.

O 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:

Java

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+KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

Além dos prescritos, é possível adicionar 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 cobertas por um tipo de evento sugerido, registre seus próprios eventos personalizados, conforme mostrado neste exemplo:

Java

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

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

Definir parâmetros padrão de evento

É possível registrar parâmetros em eventos usando setDefaultEventParameters. Os parâmetros padrão são associados a todos os eventos futuros registrados.

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Se um parâmetro for específico no método logEvent(), esse valor será usado no lugar do padrão.

Para limpar um parâmetro padrão, chame o método setDefaultEventParameters com o parâmetro definido como null.

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

É possível 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 seus eventos no logcat do Android Studio, permitindo a verificação imediata do envio dos eventos.

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.

Acesse esses dados no painel Eventos do Console do Firebase. Esse painel mostra os relatórios de eventos criados automaticamente para cada tipo diferente de evento registrado pelo seu app.