Este guia mostra como adicionar o Google Analytics ao seu app para iOS com o objetivo de avaliar a atividade do usuário em telas nomeadas. Se você não tiver um aplicativo ainda e só quiser ver como funciona o Google Analytics, confira nosso aplicativo de exemplo.
O Google Analytics usa o CocoaPods para instalar e gerenciar dependências. Abra uma janela do terminal e navegue até o local do projeto Xcode do seu aplicativo. Se você ainda não tiver criado um Podfile para seu aplicativo, crie um agora:
pod init
Abra o Podfile criado para seu aplicativo e adicione o seguinte:
pod 'GoogleAnalytics'
Salve o arquivo e execute:
pod install
Isso cria um arquivo .xcworkspace
para seu aplicativo. Use esse arquivo futuramente no desenvolvimento do aplicativo.
Inicializar o Google Analytics no seu aplicativo
Com o arquivo de configuração do seu projeto, você está pronto para começar a implementação. Primeiro, configure o objeto compartilhado do Analytics dentro de AppDelegate
. Isso permite que seu aplicativo envie dados ao Google Analytics. Você deve:
- incluir os cabeçalhos necessários;
- Defina o rastreador do Analytics em
didFinishLaunchingWithOptions
. - Substitua
YOUR_TRACKING_ID
pelo seu próprio ID de acompanhamento do Google Analytics, comoUA-47605289-8
. - enviar exceções e informações de log (opcional).
Para fazer essas mudanças, primeiro adicione o Analytics em AppDelegate
:
#import <GoogleAnalytics/GAI.h> #import <GoogleAnalytics/GAIDictionaryBuilder.h>
Em seguida, substitua o método didFinishLaunchingWithOptions
para configurar o Google Analytics:
GAI *gai = [GAI sharedInstance]; [gai trackerWithTrackingId:@"YOUR_TRACKING_ID"]; // Optional: automatically report uncaught exceptions. gai.trackUncaughtExceptions = YES; // Optional: set Logger to VERBOSE for debug information. // Remove before app release. gai.logger.logLevel = kGAILogLevelVerbose;
Adicionar o acompanhamento de telas
Aqui, você vai enviar uma exibição de tela nomeada ao Google Analytics sempre que o usuário abrir ou mudar de tela no seu app. Abra um controlador que você quer acompanhar ou, se for um aplicativo novo, abra o controlador de vista padrão. Seu código deve:
- Adicione os cabeçalhos necessários:
#import <GoogleAnalytics/GAI.h> #import <GoogleAnalytics/GAIDictionaryBuilder.h> #import <GoogleAnalytics/GAIFields.h>
- Use uma substituição de função ou método
viewWillAppear
para inserir o acompanhamento de tela. - fornecer um nome para a tela e executar o acompanhamento.
id<GAITracker> tracker = [GAI sharedInstance].defaultTracker; [tracker set:kGAIScreenName value:name]; [tracker send:[[GAIDictionaryBuilder createScreenView] build]];
Próximas etapas
- Leia o Guia de implementação de aplicativos para dispositivos móveis e saiba como usar o Google Analytics para avaliar as interações dos usuários e responder a perguntas sobre o uso do aplicativo.
- Consulte as opções de configuração adicionais, como amostragem, testes e depuração, as configurações de desativação etc.
- Se seu aplicativo exigir, ative os recursos opcionais, como avaliação de campanhas de instalação de comércio eletrônico avançado, IDFA (identificador para anunciantes) e iAd.