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 do iOS, 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 tem o Google Analytics ativado, acesse a guia Integrações das suas
para ativá-lo. > Configurações do projeto
Ao ativar o Google Analytics no seu projeto, seus aplicativos do Firebase são vinculados aos fluxos de dados do Google Analytics.
(Recomendado). Adicione o framework AdSupport ao seu projeto para ativar outros recursos, como atribuição de públicos e campanhas.
Adicione o SDK do Analytics ao seu aplicativo
- Adicione a dependência do Firebase ao seu Podfile:
pod 'Firebase/Analytics'
- Execute
pod install
e abra o arquivo.xcworkspace
criado. - 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 aplicativos, outros são indicados para tipos de negócios ou indústrias específicas. Você precisa adicionar 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 aplicativo:
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 Produto > Esquema > Editar esquema...
- Selecione Executar no menu esquerdo.
- Selecione a aba Argumentos.
- Na seção Argumentos transmitidos na inicialização, 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.