Ir para o console

Registrar eventos

Os eventos apresentam insights sobre o que está acontecendo em seu app, como ações do usuário, eventos do sistema ou erros.

O Analytics registra automaticamente alguns eventos para você. Você não precisa adicionar códigos para recebê-los. Se o app precisar coletar dados adicionais, é possível registrar até 500 tipos diferentes de eventos do Analytics nele. Não há limite para o volume total de eventos que seu app registra.

Antes de começar

Se você está adicionando o Analytics ao seu app pela primeira vez, siga as etapas a seguir:

Conectar seu app ao Firebase console

  1. Instale o SDK do Firebase.
  2. No Console do Firebase, adicione seu app ao projeto do Firebase.

Adicionar o Analytics ao app

  1. Adicione a dependência do Firebase ao seu Podfile:
    pod 'Firebase/Analytics'
  2. Execute pod install e abra o arquivo .xcworkspace criado.
  3. Importe o módulo do Firebase no seu UIApplicationDelegate:

    Swift

    import Firebase
    

    Objective-C

    @import Firebase;
    
  4. Configure uma instância compartilhada do FirebaseApp, que é normalmente encontrada no método application:didFinishLaunchingWithOptions: do aplicativo:

    Swift

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

    Objective-C

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

Registrar eventos

Após configurar a instância do FirebaseApp, será possível registrar eventos com o método logEventWithName().

Para ajudar você a começar, o SDK do Analytics define vários eventos sugeridos comuns entre tipos diferentes de apps, como os de varejo, comércio eletrônico, viagem e jogos. Para saber mais sobre esses eventos e quando usá-los, consulte os artigos de Eventos e propriedades na Central de Ajuda do Firebase.

Encontre detalhes de implementação nos seguintes locais:

  • Eventos sugeridos: ver o arquivo de cabeçalho FIREventNames.h.
  • Parâmetros prescritos: ver o arquivo de cabeçalho FIRParameterNames.h.

O exemplo a seguir mostra como registrar um evento kFIRSelectContent sugerido:

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"
                                 }];

Além dos parâmetros prescritos, adicione os seguintes parâmetros a qualquer evento:

  • Parâmetros personalizados: podem ser registrados para a geração de relatórios do Analytics. Eles também são usados como filtros em definições de público-alvo que podem ser aplicados a todos os relatórios. Os parâmetros personalizados também são incluídos nos dados exportados para o BigQuery caso seu app esteja vinculado a um projeto do BigQuery.

  • Parâmetro kFIRParameterValue: kFIRParameterValue é um parâmetro de uso geral que é útil para acumular uma métrica importante que pertence a um evento. Alguns exemplos são receita, distância, tempo e pontos.

Caso seu aplicativo tenha necessidades específicas não cobertas por um tipo de evento sugerido, registre seus próprios eventos personalizados, conforme mostrado neste exemplo:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Objective-C

 [FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

Ver eventos no console de depuração do Xcode

Você pode ativar o registro detalhado para monitorar se o SDK está registrando adequadamente os eventos. Isso inclui os eventos registrados manual e automaticamente.

Você pode ativar o registro detalhado da seguinte forma:

  1. No Xcode, selecione Produto > Esquema > Editar esquema...
  2. Selecione Executar no menu esquerdo.
  3. Selecione a aba Argumentos.
  4. Na seção Argumentos transmitidos na inicialização, adicione -FIRAnalyticsDebugEnabled.

Na próxima vez que você executar seu app, os eventos serão exibidos no console de depuração do Xcode, o que ajuda a verificar imediatamente se os eventos estão sendo enviados.

Ver eventos no painel

É possível ver estatísticas agregadas sobre os seus eventos do Analytics nos painéis do Firebase console. Elas são atualizadas periodicamente ao longo do dia. Para fazer testes imediatos, use o resultado do console de depuração, conforme descrito na seção anterior.

Você pode acessar esses dados no Firebase console da seguinte forma:

  1. Abra seu projeto no Console do Firebase.
  2. Selecione Analytics no menu para ver o painel de relatórios do Analytics.

Na guia Eventos, você encontra os relatórios de eventos criados automaticamente para cada tipo diferente de evento do Analytics registrado pelo seu app. Saiba mais sobre o painel de relatórios do Analytics na Central de Ajuda do Firebase.