Começar a usar o Google Analytics

Neste artigo, mostramos como configurar um aplicativo para usar o Google Analytics. Se quiser configurar um site para usar o Google Analytics, veja o artigo Configurar o Google Analytics para um site e/ou app.

Antes de começar

Adicione o Firebase ao projeto da Apple e verifique se o Google Analytics está ativado no projeto do Firebase:

(Recomendado) Adicione o framework AdSupport ao seu projeto para ativar outros recursos, como públicos-alvo e atribuição de 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 de app aberto, acesse File > Add Packages.
  2. Quando for a hora, adicione o repositório do SDK do Firebase para as plataformas da 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 do IDFA.
  6. Quando terminar, o Xcode vai começar a resolução e fazer o download das dependências em segundo plano automaticamente.
  7. Quando terminar, o Xcode vai começar a resolução e fazer o download das dependências em segundo plano automaticamente.

Saiba mais sobre o IDFA, o identificador de publicidade no nível do dispositivo, nos documentos Privacidade do usuário e uso de dados e Transparência no rastreamento de apps da Apple (ambos os links em inglês).

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

  1. Importe o módulo do Firebase em UIApplicationDelegate:

    Swift

    import FirebaseCore
    import FirebaseAnalytics
            

    Objective-C

    @import FirebaseCore;
    @import FirebaseAnalytics;
            
  2. Configure uma instância compartilhada do FirebaseApp, normalmente no método application:didFinishLaunchingWithOptions: do app:

    Swift

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

    Objective-C

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

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

Para sua comodidade, o SDK registra automaticamente seu aplicativo com a Apple para atribuição da 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.

Próximas etapas