Comece a usar o Google Analytics

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

  1. Adicione o Firebase ao seu projeto da Apple, 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 (Configurações) > Configurações do projeto para ativá-lo.

    Ao ativar o Google Analytics no seu projeto, seus apps do Firebase são vinculados aos fluxos de dados do Google Analytics.

  2. (Recomendado). Adicione o framework AdSupport ao seu projeto para ativar outros recursos, como atribuição de públicos e campanhas.

Adicionar o SDK do Analytics ao seu app

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

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

Saiba mais sobre o IDFA, o identificador de publicidade do dispositivo, na documentação da Apple Privacidade do usuário e uso de dados e Transparência no rastreamento de apps.

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

  1. Importe o módulo FirebaseCore no UIApplicationDelegate, assim como qualquer outro módulo do Firebase usado pelo delegado do app. Por exemplo, para usar o Cloud Firestore e o Authentication:

    SwiftUI

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

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

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

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Se você estiver usando a SwiftUI, crie um delegado do aplicativo e o anexe ao struct App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Também é necessário desativar o swizzling do delegado do app. Para mais informações, consulte as instruções da SwiftUI.

    SwiftUI

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


Desativar o registro de atribuição da rede de publicidade da Apple (opcional)

Para sua comodidade, o SDK registra automaticamente seu app na Apple para atribuir a rede de publicidade com a SKAdNetwork. Se você quiser desativar esse recurso, defina o valor de GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED como NO (booleano) no arquivo info.plist do app.

Iniciar o registro de eventos

Após configurar a instância do FirebaseApp será possível 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, demonstramos como registrar um evento recomendado para indicar que um usuário clicou em um elemento específico do seu app:

Swift

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

Objective-C

Observação: este produto do 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 ver este evento no console de depuração do Xcode, ative a depuração do Analytics:

  1. No Xcode, selecione Product > Scheme > Edit scheme...
  2. Selecione Run no menu à esquerda.
  3. Selecione a guia Arguments.
  4. Na seção Arguments Passed On Launch, adicione -FIRAnalyticsDebugEnabled.

Próximas etapas