Adicionar o Google Analytics ao seu app para iOS

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 Google Analytics dentro de AppDelegate. Isso permite que seu aplicativo envie dados ao Google Analytics. Você deve:

  • incluir os cabeçalhos necessários;
  • definir o rastreador do Google Analytics em didFinishLaunchingWithOptions;
  • substituir YOUR_TRACKING_ID pelo seu próprio ID de acompanhamento do Google Analytics, como UA-47605289-8;
  • enviar exceções e informações de log (opcional).

Para fazer essas alterações, primeiro adicione o Google Analytics em AppDelegate:

#import <GoogleAnalytics/GAI.h>
#import <GoogleAnalytics/GAIDictionaryBuilder.h>

Em seguida, modifique 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ê envia uma exibição de tela nomeada ao Google Analytics sempre que o usuário abre ou muda de telas no seu aplicativo. Abra um controlador de visualizações que você quer acompanhar ou, no caso de um aplicativo novo, abra o controlador de visualizações padrão. Seu código deve:

  • adicionar os cabeçalhos necessários:
    #import <GoogleAnalytics/GAI.h>
    #import <GoogleAnalytics/GAIDictionaryBuilder.h>
    #import <GoogleAnalytics/GAIFields.h>
  • modificar o método ou função 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