Comece a usar o Google Analytics

Este guia de 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 no seu aplicativo, 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 ; você não precisa adicionar nenhum código para ativá-los.

Antes de você começar

  1. Adicione o Firebase ao seu projeto Apple , caso ainda não o tenha feito, e certifique-se de que o Google Analytics esteja 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, acesse a guia Integrações do seu > Configurações do projeto para habilitá-lo.

    Quando você ativa o Google Analytics no seu projeto, seus aplicativos do Firebase são vinculados aos fluxos de dados do Google Analytics.

  2. (Recomendado) . Adicione a estrutura 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 dependências do Firebase.

  1. No Xcode, com o projeto do seu aplicativo aberto, navegue até File > Add Packages .
  2. Quando solicitado, adicione o repositório SDK das plataformas Apple do Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Escolha a biblioteca Analytics.
  5. Adicione o sinalizador -ObjC à seção Outros sinalizadores de vinculador das configurações de compilação do seu destino.
  6. Para uma experiência ideal com o Analytics, recomendamos ativar o Google Analytics no seu projeto do Firebase e adicionar o SDK do Firebase para Google Analytics ao seu aplicativo. Você pode selecionar a biblioteca sem coleção IDFA ou com coleção IDFA.
  7. 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 da Apple sobre privacidade do usuário e uso de dados e transparência no rastreamento de aplicativos .

A seguir, execute algumas etapas de configuração:

  1. Importe o módulo FirebaseCore em seu UIApplicationDelegate , bem como quaisquer outros módulos Firebase que seu delegado de aplicativo usa. Por exemplo, para usar o Cloud Firestore e o Authentication:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objetivo-C

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

    SwiftUI

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

    Rápido

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

    Objetivo-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Se estiver usando SwiftUI, você deve criar um delegado de aplicativo e anexá-lo à estrutura App por meio de UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Você também deve desativar o swizzling de delegado do aplicativo. Para obter mais informações, consulte as instruções do SwiftUI .

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          


(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 FirebaseApp , você poderá 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 setores específicos. 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 para se beneficiar de recursos e integrações futuras assim que estiverem disponíveis. Esta seção demonstra o registro de um evento predefinido. Para obter mais informações sobre o registro de eventos, consulte Registrar eventos .

O exemplo a seguir demonstra como registrar um evento recomendado para indicar que um usuário clicou em um elemento específico do 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 transmitidos na inicialização , adicione -FIRAnalyticsDebugEnabled .

Próximos passos