Usar mais recursos do Google Analytics e do Firebase com apps da AdMob

Depois de concluir a configuração básica da AdMob, também é possível adicionar o SDK do Firebase para o Google Analytics e aproveitar outros recursos do Firebase e do Analytics. Saiba como começar a usar o Google Analytics posteriormente nesta página.

Esses níveis crescentes de configuração oferecem suporte a recursos que podem ajudar você a otimizar a experiência do usuário do seu aplicativo e a receita de publicidade. Confira a tabela de recursos a seguir e seus links para saber mais.

Recurso	Adicionar SDK de anúncios para dispositivos móveis e ativar métricas do usuário	Adicionar o SDK de anúncios para dispositivos móveis, ativar as métricas do usuário e vincular a AdMob ao Firebase	Adicionar o SDK de anúncios para dispositivos móveis, ativar as métricas dos usuários, vincular a AdMob ao Firebase e adicionar o SDK do Firebase para Analytics
Veja métricas do usuário em sua conta da AdMob
Coletar automaticamente as análises de eventos e propriedades do usuário do seu app
Conferir métricas dos usuários selecionadas na AdMob
Explore e trabalhe com seus dados de análise com o Firebase
Verificar as principais métricas no Console do Firebase
Marcar conversões de campanhas publicitárias
Criar públicos-alvo personalizados
Exportar e analisar dados no BigQuery
Acesse mais recursos de personalização para seus dados de análise
Registrar eventos personalizados para análises e modelos (como registro de eventos de comércio eletrônico para métricas ARPU e ARPPU)
Configurar conversões personalizadas para campanhas publicitárias
Usar outros produtos do Firebase (como a Configuração remota e o Teste A/B)

Comece a usar o Google Analytics

O Google Analytics é o mecanismo de análise do Firebase que oferece acesso a insights importantes sobre dados. Comece a usar o Google Analytics no seu aplicativo adicionando o SDK do Firebase para o Google Analytics.

Por que adicionar o SDK do Firebase para o Google Analytics?

Utilize a configuração básica da AdMob para visualizar estatísticas agregadas de eventos e propriedades do usuário coletados automaticamente no painel do Google Analytics do Console do Firebase sem adicionar nenhum código ao seu app.

No entanto, se você quiser coletar dados de eventos personalizados ou propriedades do usuário adicionais, precisará usar o SDK do Firebase para o Google Analytics. Utilize esse SDK para registrar até 500 tipos diferentes de eventos de análise. Não há limite para o volume total de eventos registrados pelo seu aplicativo. Um exemplo de caso de uso para registrar eventos personalizados é incluir no cálculo de receita os dados de um evento personalizado chamado ecommerce_purchase. Isso ajuda a representar melhor as métricas ARPU e ARPPU.

Ao adicionar o SDK do Firebase para o Google Analytics, você também pode incluir conversões personalizadas para campanhas publicitárias e ativar o uso de outros produtos do Firebase.

As etapas a seguir descrevem como começar a usar o SDK do Firebase para Google Analytics no seu aplicativo. Depois de inicializar o SDK, acesse a documentação do Google Analytics para saber como começar a registrar eventos no seu aplicativo.

Etapa 1: adicionar um arquivo de configuração ao app

Se você registrou o aplicativo no Firebase antes de criar um link da AdMob, então já adicionou um arquivo de configuração do Firebase ao seu aplicativo. Verifique se há um arquivo GoogleService-Info.plist na raiz do seu projeto do Xcode. Verifique também se o arquivo de configuração foi adicionado a todos os destinos.

Se você não tiver esse arquivo de configuração no seu app, expanda esta seção para saber como adicioná-lo.

1. No card Seus apps das settings > Configurações do projeto, selecione o ID do pacote do app que precisa de um arquivo de configuração.

2. Clique em Fazer download de GoogleService-Info.plist para solicitar o arquivo de configuração do Firebase para iOS (GoogleService-Info.plist).

   • Você pode fazer o download do arquivo de configuração do Firebase para iOS novamente a qualquer momento em settings > Configurações do projeto.

   • Verifique se o nome do arquivo de configuração não contém caracteres adicionais, como (2).

3. Mova o arquivo de configuração para a raiz do seu projeto XCode. Se solicitado, selecione a opção para adicionar o arquivo de configuração a todos os destinos.

Se o projeto tiver vários IDs de pacotes, associe cada ID com um app registrado no Console do Firebase para que tenha o próprio arquivo GoogleService-Info.plist.

Etapa 2: adicionar o SDK do Firebase para o Google Analytics ao seu aplicativo

1. Adicione a dependência do SDK do Firebase para o Google Analytics ao seu Podfile:

   pod 'FirebaseAnalytics'
   

2. Execute pod install e abra o arquivo .xcworkspace criado.

3. Importe o módulo FirebaseCore no UIApplicationDelegate, assim como qualquer outro módulo do Firebase usado pelo delegado do app. Por exemplo, para usar o Cloud Firestore e o Authentication:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

4. Configure uma instância compartilhada do FirebaseApp no método application(_:didFinishLaunchingWithOptions:) do delegado do app:

   SwiftUI

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

   Swift

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

   Objective-C

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

5. Se você estiver usando a SwiftUI, crie um delegado do aplicativo e o anexe ao struct App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Também é necessário desativar o swizzling do delegado do app. Para mais informações, consulte as instruções da SwiftUI.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

Implementar a geração de registros de eventos personalizados

Esta seção mostra um exemplo de como implementar a geração de registros de eventos personalizados no seu aplicativo. Este exemplo específico é para o evento personalizado ecommerce_purchase, que é útil para gerar registros de aplicativos vinculados à AdMob, especialmente para calcular ARPU e ARPPU.

Por que ecommerce_purchase é importante para ARPU e ARPPU?

Uma métrica importante para seu aplicativo é a receita por usuário, que pode ser ainda mais segmentada em ARPU e ARPPU. Essas duas métricas são exibidas no card Métricas do usuário da sua conta da AdMob e no painel Analytics do Console do Firebase. No entanto, a receita não é medida diretamente. Ela é a soma dos seus ganhos estimados da AdMob e dos dois valores de eventos de análise a seguir:

• in_app_purchase: quando um usuário conclui uma compra no app processada pela App Store no iTunes, como uma assinatura inicial, desbloqueio de serviços premium ou compra de itens em jogos

• ecommerce_purchase: quando um usuário conclui uma transação, como compras on-line, compra de cupons ou itens com desconto ou compra de ingressos de cinema

Sem nenhum código adicional no seu aplicativo, o SDK de anúncios para dispositivos móveis coleta automaticamente dados de análise para eventos in_app_purchase. Porém, se você também quiser incluir dados de eventos ecommerce_purchase no cálculo da receita, será necessário implementar a geração de registros personalizados usando o SDK do Firebase para o Google Analytics.

Veja como implementar a geração de registros de eventos personalizados no seu aplicativo:

1. Verifique se você concluiu a seção Introdução ao Google Analytics desta página, que inclui a configuração do app para usar o Firebase, a adição do SDK do Firebase para o Google Analytics e a inicialização do SDK.

2. Registre um evento ecommerce_purchase (Swift | Obj-C). Veja um exemplo:

   Swift

   Analytics.logEvent(AnalyticsEventPurchase, parameters: [
     AnalyticsParameterCoupon: "SummerPromo",
     AnalyticsParameterCurrency: "JPY",
     AnalyticsParameterValue: 10000,
     AnalyticsParameterShipping: 500,
     AnalyticsParameterTransactionID: "192803301",
   ])

   Objective-C

   [FIRAnalytics logEventWithName:kFIREventPurchase
                       parameters:@{
     kFIRParameterCoupon: @"SummerPromo",
     kFIRParameterCurrency: @"JPY",
     kFIRParameterValue: @10000,
     kFIRParameterShipping: @500,
     kFIRParameterTransactionID: @"192803301",
   }];

Para saber mais sobre como registrar eventos personalizados no seu aplicativo, acesse a documentação do Google Analytics.

Usar outros produtos do Firebase no seu app

Depois de adicionar o SDK do Firebase para Google Analytics, você também pode começar a usar outros produtos do Firebase, como a Configuração remota e o Teste A/B.

• A Configuração remota permite que você altere o comportamento e a aparência do app sem publicar uma atualização para ele, sem custos e sem limite de usuários ativos por dia.

• O Teste A/B permite testar alterações na IU, nos recursos ou nas campanhas de engajamento do seu app para saber, antes da implementação, se elas afetarão as principais métricas (como receita e retenção).

Otimizar a monetização de anúncios para seu app

Teste diferentes formatos ou configurações de anúncios com um pequeno subconjunto de usuários e implemente o anúncio para todos de acordo com esses resultados. Para saber mais, confira os tutoriais abaixo:

• Testar a adoção de novos formatos dos anúncios (informações gerais | implementação).

• Otimizar a frequência dos anúncios (informações gerais | implementação).