O Google Analytics coleta dados de uso e comportamento do seu aplicativo. 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
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
para ativá-lo. > Configurações do projeto
When you enable Google Analytics in your project, your Firebase apps
are linked to Google Analytics data streams.
- (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.
- No Xcode, com seu projeto do app aberto, navegue até File > Add Packages.
- Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas da Apple:
- Escolha a biblioteca do Google Analytics.
- 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.
- Quando terminar, o Xcode começará a resolver e fazer o download das dependências em segundo plano automaticamente.
https://github.com/firebase/firebase-ios-sdk
Saiba mais sobre o IDFA, o identificador de publicidade no nível 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:
- Importe o módulo do Firebase no
UIApplicationDelegate
:Swift
import Firebase
Objective-C
@import Firebase;
- Configure uma
instância compartilhada do
FirebaseApp
, normalmente no métodoapplication: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 de 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 parâmetros prescritos aos eventos sugeridos 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
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Objective-C
[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:
- No Xcode, selecione Product > Scheme > Edit scheme...
- Selecione Run no menu à esquerda.
- Selecione a guia Arguments.
- Na seção Arguments Passed On Launch, adicione
-FIRAnalyticsDebugEnabled
.
Próximas etapas
- Use o DebugView para verificar seus eventos.
- Explore seus dados no Console do Firebase.
- Conheça os guias sobre eventos e propriedades do usuário.
- Saiba como exportar seus dados para o BigQuery.