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 da web. 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 JavaScript 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 da Web do Firebase são vinculados aos fluxos de dados do Google Analytics associados a uma propriedade App + Web .
Adicione o Analytics SDK ao seu aplicativo
Dependendo de como seu aplicativo da web está hospedado, sua configuração pode ser tratada automaticamente ou pode ser necessário atualizar seu objeto de configuração do Firebase . Se seu aplicativo da web já usa o Google Analytics, pode ser necessário fazer uma configuração adicional descrita em Usar Firebase com marcação gtag.js existente .
Verifique se o objeto de configuração do Firebase em seu código contém
measurementId
. Esse ID é criado automaticamente quando você habilita o Analytics em seu projeto do Firebase e registra um aplicativo da web e é necessário para usar o Analytics.Se seu aplicativo usa o Firebase Hosting e usa URLs reservados para os SDKs do Firebase :
O Firebase lida automaticamente com a configuração do seu aplicativo. Para concluir a configuração, adicione os scripts do cartão Seus aplicativos nas configurações do projeto à tag <body> do seu aplicativo, caso ainda não o tenha feito.
Se seu aplicativo não usa URLs reservados : se você estiver trabalhando com um aplicativo da Web existente , atualize o objeto de configuração do Firebase em seu código para garantir que o campo
measurementId
esteja presente. O objeto de configuração deve ser semelhante ao seguinte exemplo:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc", authDomain: "project-id.firebaseapp.com", databaseURL: "https://project-id.firebaseio.com", projectId: "project-id", storageBucket: "project-id.appspot.com", messagingSenderId: "637908496727", appId: "2:637908496727:web:a4284b4c99e329d5", measurementId: "G-9VP01NDSXJ" };
Se ainda não o fez, instale o Firebase JS SDK e inicialize o Firebase .
Adicione o Analytics JS SDK e inicialize o Analytics:
Web version 9
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
Web version 8
import firebase from "firebase/app"; import "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
Use o Firebase com tags gtag.js existentes
Se você já tinha o Google Analytics em execução em seu aplicativo usando o snippet gtag.js , seu aplicativo pode exigir configuração adicional se você planeja fazer um dos seguintes:
- Adicione chamadas do Google Analytics do Firebase à página, mas também planeje continuar usando chamadas
gtag()
diretamente na mesma página. - Deseja usar o mesmo ID de medição entre as chamadas
gtag()
diretas e os dados do Google Analytics enviados ao Firebase.
Para garantir que seus eventos estejam disponíveis para uso por todos os serviços do Firebase, conclua as seguintes etapas adicionais de configuração:
- Remova a linha
gtag('config', ' GA_MEASUREMENT_ID ');
em queGA_MEASUREMENT_ID
é omeasurementId
do seu app da Web do Firebase. Se você tiver outros IDs para outras propriedades do Google Analytics na página, não precisará remover a linha de configuração deles. - Certifique-se de chamar
firebase.analytics()
antes de enviar qualquer evento comgtag()
.
Caso contrário, os eventos enviados para esse ID com chamadas gtag()
não serão associados ao Firebase e não estarão disponíveis para segmentação em outros serviços do Firebase.
Iniciar registro de eventos
Depois de inicializar o serviço Analytics , 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 exemplo a seguir demonstra como registrar um evento recomendado para indicar que um usuário recebeu uma notificação em seu aplicativo:
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web version 8
firebase.analytics().logEvent('notification_received');
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 da web. 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 JavaScript 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 da Web do Firebase são vinculados aos fluxos de dados do Google Analytics associados a uma propriedade App + Web .
Adicione o Analytics SDK ao seu aplicativo
Dependendo de como seu aplicativo da web está hospedado, sua configuração pode ser tratada automaticamente ou pode ser necessário atualizar seu objeto de configuração do Firebase . Se seu aplicativo da web já usa o Google Analytics, pode ser necessário fazer uma configuração adicional descrita em Usar Firebase com marcação gtag.js existente .
Verifique se o objeto de configuração do Firebase em seu código contém
measurementId
. Esse ID é criado automaticamente quando você habilita o Analytics em seu projeto do Firebase e registra um aplicativo da web e é necessário para usar o Analytics.Se seu aplicativo usa o Firebase Hosting e usa URLs reservados para os SDKs do Firebase :
O Firebase lida automaticamente com a configuração do seu aplicativo. Para concluir a configuração, adicione os scripts do cartão Seus aplicativos nas configurações do projeto à tag <body> do seu aplicativo, caso ainda não o tenha feito.
Se seu aplicativo não usa URLs reservados : se você estiver trabalhando com um aplicativo da Web existente , atualize o objeto de configuração do Firebase em seu código para garantir que o campo
measurementId
esteja presente. O objeto de configuração deve ser semelhante ao seguinte exemplo:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc", authDomain: "project-id.firebaseapp.com", databaseURL: "https://project-id.firebaseio.com", projectId: "project-id", storageBucket: "project-id.appspot.com", messagingSenderId: "637908496727", appId: "2:637908496727:web:a4284b4c99e329d5", measurementId: "G-9VP01NDSXJ" };
Se ainda não o fez, instale o Firebase JS SDK e inicialize o Firebase .
Adicione o Analytics JS SDK e inicialize o Analytics:
Web version 9
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
Web version 8
import firebase from "firebase/app"; import "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
Use o Firebase com tags gtag.js existentes
Se você já tinha o Google Analytics em execução em seu aplicativo usando o snippet gtag.js , seu aplicativo pode exigir configuração adicional se você planeja fazer um dos seguintes:
- Adicione chamadas do Google Analytics do Firebase à página, mas também planeje continuar usando chamadas
gtag()
diretamente na mesma página. - Deseja usar o mesmo ID de medição entre as chamadas
gtag()
diretas e os dados do Google Analytics enviados ao Firebase.
Para garantir que seus eventos estejam disponíveis para uso por todos os serviços do Firebase, conclua as seguintes etapas adicionais de configuração:
- Remova a linha
gtag('config', ' GA_MEASUREMENT_ID ');
em queGA_MEASUREMENT_ID
é omeasurementId
do seu app da Web do Firebase. Se você tiver outros IDs para outras propriedades do Google Analytics na página, não precisará remover a linha de configuração deles. - Certifique-se de chamar
firebase.analytics()
antes de enviar qualquer evento comgtag()
.
Caso contrário, os eventos enviados para esse ID com chamadas gtag()
não serão associados ao Firebase e não estarão disponíveis para segmentação em outros serviços do Firebase.
Iniciar registro de eventos
Depois de inicializar o serviço Analytics , 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 exemplo a seguir demonstra como registrar um evento recomendado para indicar que um usuário recebeu uma notificação em seu aplicativo:
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web version 8
firebase.analytics().logEvent('notification_received');
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.