Neste guia de início rápido, mostraremos como adicionar o Google Analytics ao seu app e como começar a registrar os eventos.
O Google Analytics coleta dados de uso e comportamento do seu app. 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 você 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) > Configurações do projeto
Ao ativar o Google Analytics no 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:
API modular da Web
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);
API com namespace da Web
import firebase from "firebase/compat/app"; import "firebase/compat/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 tags gtag.js existentes
Se você já tinha o Google Analytics em execução no seu app usando o snippet 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 eventos sugeridos junto com os parâmetros prescritos 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, vamos mostrar como registrar um evento recomendado para indicar que um usuário recebeu uma notificação no seu app:
API modular da Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
API com namespace da Web
firebase.analytics().logEvent('notification_received');
Próximas etapas
- Use o DebugView para verificar seus eventos.
- Confira 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.