Rastrear exibições de tela

O Google Analytics rastreia transições de tela e anexa informações sobre a tela atual para eventos. Assim, ele permite que você rastreie métricas, como o envolvimento ou comportamento do usuário por tela. Grande parte dessa coleta de dados acontece automaticamente, mas também é possível registrar exibições de tela manualmente. O rastreamento manual de telas é útil quando seu aplicativo não utiliza um UIViewController ou Activity dedicado para cada tela que você quer rastrear, como em um jogo.

Rastrear telas automaticamente

O Analytics rastreia automaticamente algumas informações sobre telas no seu aplicativo, como o nome da classe do UIViewController ou Activity em foco no momento. Quando ocorre uma transição de tela, o Analytics registra um evento screen_view que identifica a nova tela. Os eventos que ocorrem nessas telas são marcados automaticamente com o parâmetro firebase_screen_class (por exemplo, menuViewController ou MenuActivity) e um firebase_screen_id gerado. Caso seu aplicativo use um UIViewController ou Activity diferente para cada tela, o Analytics poderá rastrear automaticamente todas as transições de tela e gerar um relatório sobre o envolvimento dos usuários dividido por tela. Caso contrário, você ainda poderá gerar esses relatórios registrando eventos screen_view manualmente.

Rastrear telas manualmente

É possível registrar manualmente os eventos screen_view, mesmo que o rastreamento automático esteja ativado. É possível registrar esses eventos no estado viewDidAppear para iOS e onResume para Android. Quando screen_class não está definido, o Analytics define um valor padrão com base no UIViewController ou Activity que está em foco quando a chamada é feita.

Swift

Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                                AnalyticsParameterScreenClass: screenClass])

Objective-C

[FIRAnalytics logEventWithName:kFIREventScreenView
                    parameters:@{kFIRParameterScreenClass: screenClass,
                                 kFIRParameterScreenName: screenName}];

Java

mFirebaseAnalytics.setCurrentScreen(this, screenName, null /* class override */);

O nome e a classe da tela continuarão iguais até que Activity seja alterado ou até que você faça uma nova chamada para setCurrentScreen().

Kotlin+KTX

firebaseAnalytics.setCurrentScreen(this, screenName, null /* class override */)

O nome e a classe da tela continuarão iguais até que Activity seja alterado ou até que você faça uma nova chamada para setCurrentScreen().