获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Comece a usar o Google Analytics

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 para 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 ativá-los.

Antes de você começar

  1. Se ainda não o fez, adicione o Firebase ao seu projeto Apple e verifique se o Google Analytics está 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, vá para 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 AdSupport ao seu projeto para habilitar recursos adicionais, como públicos e atribuição de campanha.

Adicione o Analytics SDK ao seu aplicativo

Use o Swift Package Manager para instalar e gerenciar 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 Firebase Apple Platform SDK:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Escolha a biblioteca do Analytics.
  5. Para uma experiência ideal com o Analytics, recomendamos habilitar 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 coleta de IDFA ou com coleta 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 no rastreamento de aplicativos da Apple.

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

  1. Importe o módulo FirebaseCore em seu UIApplicationDelegate , bem como quaisquer outros módulos Firebase usados ​​pelo delegado do aplicativo. Por exemplo, para usar Cloud Firestore e autenticação:

    SwiftUI

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

    Rápido

    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 seu aplicativo:

    SwiftUI

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

    Rápido

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Se você estiver usando SwiftUI, deverá criar um delegado de aplicativo e anexá-lo à sua estrutura de App por meio de UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Você também deve desativar o swizzling de delegado de 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 com a 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.

Iniciar registro de eventos

Depois de configurar a instância 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 específicos de negócios ou verticais. 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 se beneficiar de recursos e integrações futuras assim que estiverem disponíveis. Esta seção demonstra o log de um evento predefinido, para obter mais informações sobre o log de eventos, consulte Log de eventos .

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",
])

Objective-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 à esquerda.
  3. Selecione a guia Argumentos .
  4. Na seção Arguments Passed On Launch , adicione -FIRAnalyticsDebugEnabled .

Próximos passos

,

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 para 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 ativá-los.

Antes de você começar

  1. Se ainda não o fez, adicione o Firebase ao seu projeto Apple e verifique se o Google Analytics está 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, vá para 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 AdSupport ao seu projeto para habilitar recursos adicionais, como públicos e atribuição de campanha.

Adicione o Analytics SDK ao seu aplicativo

Use o Swift Package Manager para instalar e gerenciar 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 Firebase Apple Platform SDK:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Escolha a biblioteca do Analytics.
  5. Para uma experiência ideal com o Analytics, recomendamos habilitar 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 coleta de IDFA ou com coleta 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 no rastreamento de aplicativos da Apple.

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

  1. Importe o módulo FirebaseCore em seu UIApplicationDelegate , bem como quaisquer outros módulos Firebase usados ​​pelo delegado do aplicativo. Por exemplo, para usar Cloud Firestore e autenticação:

    SwiftUI

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

    Rápido

    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 seu aplicativo:

    SwiftUI

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

    Rápido

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Se você estiver usando SwiftUI, deverá criar um delegado de aplicativo e anexá-lo à sua estrutura de App por meio de UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Você também deve desativar o swizzling de delegado de 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 com a 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.

Iniciar registro de eventos

Depois de configurar a instância 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 específicos de negócios ou verticais. 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 se beneficiar de recursos e integrações futuras assim que estiverem disponíveis. Esta seção demonstra o log de um evento predefinido, para obter mais informações sobre o log de eventos, consulte Log de eventos .

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",
])

Objective-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 à esquerda.
  3. Selecione a guia Argumentos .
  4. Na seção Arguments Passed On Launch , adicione -FIRAnalyticsDebugEnabled .

Próximos passos