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
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.
(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.
- No Xcode, com seu projeto de aplicativo aberto, navegue até File > Add Packages .
- Quando solicitado, adicione o repositório Firebase Apple Platform SDK:
- Escolha a biblioteca do Analytics.
- 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.
- Quando terminar, o Xcode começará automaticamente a resolver e baixar suas dependências em segundo plano.
https://github.com/firebase/firebase-ios-sdk
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:
- Importe o módulo
FirebaseCore
em seuUIApplicationDelegate
, 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; // ...
- Configure uma instância compartilhada do
FirebaseApp
no métodoapplication(_: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];
- Se você estiver usando SwiftUI, deverá criar um delegado de aplicativo e anexá-lo à sua estrutura de
App
por meio deUIApplicationDelegateAdaptor
ouNSApplicationDelegateAdaptor
. 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
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 visualizar este evento no console de depuração do Xcode, habilite a depuração do Analytics:
- No Xcode, selecione Produto > Esquema > Editar esquema...
- Selecione Executar no menu à esquerda.
- Selecione a guia Argumentos .
- Na seção Arguments Passed On Launch , adicione
-FIRAnalyticsDebugEnabled
.
Próximos passos
- Use o DebugView para verificar seus eventos.
- Explore seus dados no console do Firebase.
- Explore os guias sobre eventos e propriedades do usuário.
- Saiba como exportar seus dados para o BigQuery.
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
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.
(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.
- No Xcode, com seu projeto de aplicativo aberto, navegue até File > Add Packages .
- Quando solicitado, adicione o repositório Firebase Apple Platform SDK:
- Escolha a biblioteca do Analytics.
- 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.
- Quando terminar, o Xcode começará automaticamente a resolver e baixar suas dependências em segundo plano.
https://github.com/firebase/firebase-ios-sdk
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:
- Importe o módulo
FirebaseCore
em seuUIApplicationDelegate
, 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; // ...
- Configure uma instância compartilhada do
FirebaseApp
no métodoapplication(_: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];
- Se você estiver usando SwiftUI, deverá criar um delegado de aplicativo e anexá-lo à sua estrutura de
App
por meio deUIApplicationDelegateAdaptor
ouNSApplicationDelegateAdaptor
. 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
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 visualizar este evento no console de depuração do Xcode, habilite a depuração do Analytics:
- No Xcode, selecione Produto > Esquema > Editar esquema...
- Selecione Executar no menu à esquerda.
- Selecione a guia Argumentos .
- Na seção Arguments Passed On Launch , adicione
-FIRAnalyticsDebugEnabled
.
Próximos passos
- Use o DebugView para verificar seus eventos.
- Explore seus dados no console do Firebase.
- Explore os guias sobre eventos e propriedades do usuário.
- Saiba como exportar seus dados para o BigQuery.