Este início rápido mostra como adicionar o Google Analytics ao seu aplicativo e começar a registrar eventos.
O Google Analytics coleta dados de uso e comportamento para seu aplicativo. O SDK registra dois tipos principais de informações:
- Eventos: o que está acontecendo em seu aplicativo, como ações do usuário, eventos do sistema ou erros.
- Propriedades do usuário: Atributos que você define para descrever segmentos de sua base de usuários, como preferência de idioma ou localização geográfica.
O Analytics registra automaticamente alguns eventos e propriedades do usuário ; você não precisa adicionar nenhum código para ativá-los.
Antes de você começar
Se ainda não o fez, adicione o Firebase ao seu projeto Android e verifique se o Google Analytics está ativado no seu projeto Firebase:
Se você estiver criando um novo projeto do Firebase, ative o Google Analytics durante o fluxo de trabalho de criação do projeto.
Se você estiver usando um projeto existente do Firebase que não tenha o Google Analytics ativado, vá para a guia Integrações de suas > Configurações do projeto para ativá-lo.
Quando você ativa o Google Analytics em seu projeto, seus aplicativos do Firebase são vinculados aos fluxos de dados do Google Analytics.
Adicione o Analytics SDK ao seu aplicativo
No arquivo Gradle do módulo (nível do aplicativo) (geralmente
<project>/<app-module>/build.gradle
), adicione a dependência para a biblioteca Analytics Android. Recomendamos usar o Firebase Android BoM para controlar o controle de versão da biblioteca.Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics-ktx' }
Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.
(Alternativa) Adicionar dependências da biblioteca Firebase sem usar o BoM
Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca Firebase em sua linha de dependência.
Observe que, se você usar várias bibliotecas do Firebase em seu aplicativo, recomendamos usar o BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0' }
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics' }
Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.
(Alternativa) Adicionar dependências da biblioteca Firebase sem usar o BoM
Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca Firebase em sua linha de dependência.
Observe que, se você usar várias bibliotecas do Firebase em seu aplicativo, recomendamos usar o BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics:21.2.0' }
Declare o objeto
com.google.firebase.analytics.FirebaseAnalytics
na parte superior de sua atividade:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Inicialize-o no método
onCreate()
:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Iniciar registro de eventos
Depois de criar uma instância do FirebaseAnalytics
, você pode começar a registrar eventos com o método logEvent()
.
Certos eventos são recomendados para todos os aplicativos ; outros são recomendados para tipos específicos de negócios ou verticais. Você deve enviar eventos sugeridos junto com seus parâmetros prescritos, para garantir o máximo de detalhes disponíveis em seus relatórios e se beneficiar de recursos e integrações futuras assim que estiverem disponíveis. Esta seção demonstra o log de um evento predefinido, para obter mais informações sobre o log de eventos, consulte Log de eventos .
O código a seguir registra um evento SELECT_CONTENT
quando um usuário clica em um elemento específico em seu aplicativo.
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") }
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);
Você pode ativar o registro detalhado para monitorar o registro de eventos pelo SDK para ajudar a verificar se os eventos estão sendo registrados corretamente. Isso inclui eventos registrados automática e manualmente.
Você pode ativar o log 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, ajudando você a verificar imediatamente se os eventos estão sendo enviados.
Próximos passos
- Use o DebugView para verificar seus eventos.
- Explore seus dados no console do Firebase.
- Explore os guias sobre eventos e propriedades do usuário.
- Saiba como exportar seus dados para o BigQuery.
Este início rápido mostra como adicionar o Google Analytics ao seu aplicativo e começar a registrar eventos.
O Google Analytics coleta dados de uso e comportamento para seu aplicativo. O SDK registra dois tipos principais de informações:
- Eventos: o que está acontecendo em seu aplicativo, como ações do usuário, eventos do sistema ou erros.
- Propriedades do usuário: Atributos que você define para descrever segmentos de sua base de usuários, como preferência de idioma ou localização geográfica.
O Analytics registra automaticamente alguns eventos e propriedades do usuário ; você não precisa adicionar nenhum código para ativá-los.
Antes de você começar
Se ainda não o fez, adicione o Firebase ao seu projeto Android e verifique se o Google Analytics está ativado no seu projeto Firebase:
Se você estiver criando um novo projeto do Firebase, ative o Google Analytics durante o fluxo de trabalho de criação do projeto.
Se você estiver usando um projeto existente do Firebase que não tenha o Google Analytics ativado, vá para a guia Integrações de suas > Configurações do projeto para ativá-lo.
Quando você ativa o Google Analytics em seu projeto, seus aplicativos do Firebase são vinculados aos fluxos de dados do Google Analytics.
Adicione o Analytics SDK ao seu aplicativo
No arquivo Gradle do módulo (nível do aplicativo) (geralmente
<project>/<app-module>/build.gradle
), adicione a dependência para a biblioteca Analytics Android. Recomendamos usar o Firebase Android BoM para controlar o controle de versão da biblioteca.Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics-ktx' }
Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.
(Alternativa) Adicionar dependências da biblioteca Firebase sem usar o BoM
Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca Firebase em sua linha de dependência.
Observe que, se você usar várias bibliotecas do Firebase em seu aplicativo, recomendamos usar o BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0' }
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics' }
Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.
(Alternativa) Adicionar dependências da biblioteca Firebase sem usar o BoM
Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca Firebase em sua linha de dependência.
Observe que, se você usar várias bibliotecas do Firebase em seu aplicativo, recomendamos usar o BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics:21.2.0' }
Declare o objeto
com.google.firebase.analytics.FirebaseAnalytics
na parte superior de sua atividade:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Inicialize-o no método
onCreate()
:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Iniciar registro de eventos
Depois de criar uma instância do FirebaseAnalytics
, você pode começar a registrar eventos com o método logEvent()
.
Certos eventos são recomendados para todos os aplicativos ; outros são recomendados para tipos específicos de negócios ou verticais. Você deve enviar eventos sugeridos junto com seus parâmetros prescritos, para garantir o máximo de detalhes disponíveis em seus relatórios e se beneficiar de recursos e integrações futuras assim que estiverem disponíveis. Esta seção demonstra o log de um evento predefinido, para obter mais informações sobre o log de eventos, consulte Log de eventos .
O código a seguir registra um evento SELECT_CONTENT
quando um usuário clica em um elemento específico em seu aplicativo.
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") }
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);
Você pode ativar o registro detalhado para monitorar o registro de eventos pelo SDK para ajudar a verificar se os eventos estão sendo registrados corretamente. Isso inclui eventos registrados automática e manualmente.
Você pode ativar o log 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, ajudando você a verificar imediatamente se os eventos estão sendo enviados.
Próximos passos
- Use o DebugView para verificar seus eventos.
- Explore seus dados no console do Firebase.
- Explore os guias sobre eventos e propriedades do usuário.
- Saiba como exportar seus dados para o BigQuery.