Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Comece a usar o Google Analytics

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 do 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 habilitá-los.

Antes de você começar

  1. Se você ainda não o fez, adicione o Firebase ao seu projeto da Apple e verifique se o Google Analytics está ativado no seu projeto do 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 tem o Google Analytics ativado, acesse 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.

  2. (Recomendado) . Adicione a estrutura do AdSupport ao seu projeto para ativar recursos adicionais, como públicos e atribuição de campanha.

Adicione o SDK do Analytics ao seu aplicativo

Use o Swift Package Manager para instalar e gerenciar as dependências do Firebase.

  1. No Xcode, com seu projeto de aplicativo aberto, navegue até File > Add Packages .
  2. Quando solicitado, adicione o repositório do SDK das plataformas Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Escolha a biblioteca do Analytics.
  5. Para uma experiência ideal com o Analytics, recomendamos ativar o Google Analytics em seu projeto do Firebase e adicionar o SDK do Firebase para Google Analytics ao seu aplicativo. Você pode selecionar a biblioteca sem coleção de IDFA ou com coleção de IDFA.
  6. Quando terminar, o Xcode começará automaticamente a resolver e baixar suas dependências em segundo plano.

Saiba mais sobre o IDFA, o identificador de publicidade no nível do dispositivo, na documentação de privacidade do usuário e uso de dados e transparência de rastreamento de aplicativos da Apple.

Em seguida, execute algumas etapas de configuração:

  1. Importe o módulo FirebaseCore em seu UIApplicationDelegate , bem como qualquer outro módulo Firebase usado pelo delegado do aplicativo. Por exemplo, para usar o Cloud Firestore e a autenticação:

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objetivo-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configure uma instância compartilhada do FirebaseApp no ​​método application(_:didFinishLaunchingWithOptions:) do representante do seu aplicativo:

    Rápido

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objetivo-C

    // Use Firebase library to configure APIs
    [FIRApp configure];


(Opcional) Desative o registro de atribuição da rede de anúncios da Apple

Para sua conveniência, o SDK registra automaticamente seu aplicativo na Apple para atribuição de rede de anúncios com SKAdNetwork . Se você deseja desativar esse recurso, defina o valor de GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED como NO (Booleano) no arquivo info.plist do seu aplicativo.

Comece a registrar eventos

Depois de configurar a instância do FirebaseApp , 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 de negócios ou verticais específicos. Você deve enviar os 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 à medida que forem disponibilizados. Esta seção demonstra o registro de um evento predefinido, para obter mais informações sobre eventos de registro, consulte Eventos de registro.

O exemplo a seguir demonstra como registrar um evento recomendado para indicar que um usuário clicou em um elemento específico em seu aplicativo:

Rápido

Observação: este produto Firebase não está disponível no destino macOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objetivo-C

Observação: este produto Firebase não está disponível no destino macOS.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

Para visualizar este evento no console de depuração do Xcode, habilite a depuração do Analytics:

  1. No Xcode, selecione Produto > Esquema > Editar esquema...
  2. Selecione Executar no menu esquerdo.
  3. Selecione a guia Argumentos .
  4. Na seção Argumentos passados ​​na inicialização , adicione -FIRAnalyticsDebugEnabled .

Próximos passos