O Google Analytics coleta dados de uso e comportamento do seu aplicativo. O SDK registra dois tipos principais de informações:
- Eventos: o que acontece no seu app, como ações do usuário, eventos do sistema ou erros.
- Propriedades do usuário: atributos que você define para descrever segmentos da 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. Não é preciso adicionar códigos para ativá-los.
Antes de começar
Adicione o Firebase ao seu projeto do JavaScript, caso ainda não tenha feito isso, e verifique se o Google Analytics está ativado no seu projeto do Firebase:
Se estiver criando um novo projeto do Firebase, ative o Google Analytics durante o fluxo de trabalho de criação do projeto.
Se estiver usando um projeto do Firebase que não tenha o Google Analytics ativado, acesse a guia Integrações das suas
para ativá-lo. > Configurações do projeto
Ao ativar o Google Analytics no seu projeto, seus apps da Web do Firebase são vinculados a fluxos de dados do Google Analytics associados a uma propriedade App + Web.
Adicionar o SDK do Analytics ao seu app
Dependendo de como seu app da Web é hospedado, sua configuração pode ser gerenciada automaticamente ou pode ser necessário atualizar seu objeto de configuração do Firebase. Se o app da Web já usa o Google Analytics, pode ser necessário fazer a configuração adicional descrita em Usar o Firebase com uma tag gtag.js existente.
Verifique se o objeto de configuração do Firebase no seu código contém
measurementId
. Esse ID é criado automaticamente quando você ativa o Analytics no seu projeto do Firebase e registra um app da Web. Ele é necessário para usar o Analytics.Se o aplicativo usar o Firebase Hosting e URLs reservados para os SDKs do Firebase:
O Firebase configurará seu aplicativo automaticamente. Para concluir a configuração, adicione os scripts do card Seus apps nas Configurações do projeto à tag <body> do app, se já não tiver feito isso.
Se o app não usa URLs reservados: se você estiver trabalhando com um app da Web existente, atualize o objeto de configuração do Firebase no código para garantir que o campo
measurementId
esteja presente. O objeto de configuração será semelhante ao exemplo a seguir:// 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" };
Instale o SDK do Firebase para JavaScript e inicialize o Firebase, caso ainda não tenha feito isso.
Adicione o SDK do Analytics para JavaScript e inicialize o Google 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();
Usar o Firebase com a tag gtag.js existente
Se você já tinha o Google Analytics em execução no seu app usando o trecho gtag.js, seu app poderá exigir uma configuração adicional se você planeja executar um dos seguintes procedimentos:
- Adicionar chamadas do Google Analytics do Firebase para a página, mas também continuar usando chamadas
gtag()
diretamente na mesma página - Usar o mesmo ID de métricas entre chamadas
gtag()
diretas e dados do Google Analytics enviados para o Firebase
Para garantir que seus eventos estejam disponíveis para uso por todos os serviços do Firebase, execute 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 delas. - Chame
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 o registro de eventos
Depois de inicializar o
serviço do Analytics, comece a registrar eventos com o
método logEvent()
.
Alguns eventos são recomendados para todos os apps, outros são indicados para tipos de negócios ou indústrias específicas. Você precisa enviar os parâmetros prescritos aos eventos sugeridos para garantir o máximo de detalhes nos relatórios e aproveitar os recursos e as integrações assim que forem disponibilizados. Nesta seção, demonstramos a geração de registros de um evento pré-definido. Para mais informações sobre a geração de registros de eventos, consulte Registrar eventos.
No exemplo a seguir, mostraremos como registrar um evento recomendado para indicar que um usuário recebeu uma notificação no seu app:
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óximas etapas
- Use o DebugView para verificar seus eventos.
- Explore seus dados no Console do Firebase.
- Conheça os guias sobre eventos e propriedades do usuário.
- Saiba como exportar seus dados para o BigQuery.