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
  3. Escolha a biblioteca Analytics.
  4. Adicione o sinalizador -ObjC à seção Outros sinalizadores de vinculador das configurações de compilação do seu destino.
  5. 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.
  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 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",
])
ViewController.swift

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"
                                 }];
ViewController.m

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