Adicionar o Google Analytics ao seu aplicativo para iOS

Este guia mostra como adicionar o Google Analytics ao seu aplicativo para iOS com o objetivo de medir 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 para 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 'Google/Analytics'

Salve o arquivo e execute:

pod install

Isso cria um arquivo .xcworkspace para o seu aplicativo. Utilize esse arquivo para todo o desenvolvimento futuro do seu aplicativo.

Acessar um arquivo de configuração

Clique no botão abaixo para acessar um arquivo de configuração a ser adicionado ao seu projeto.

O arquivo de configuração fornece informações específicas de serviço para seu aplicativo. Para acessá-lo, você precisa selecionar um projeto existente para seu aplicativo ou criar um novo. Você também precisa fornecer um ID de pacote para o seu aplicativo.

Get a Configuration File

Adicionar o arquivo de configuração ao seu projeto

Arraste o arquivo GoogleService-Info.plist do qual você acabou de fazer o download até a raiz do seu projeto Xcode e adicione-o a todos os segmentos.

Inicializar o Google Analytics para seu aplicativo

Agora que você tem o arquivo de configuração para seu projeto, está pronto para começar a implementar. Primeiro, configure o objeto do Google Analytics compartilhado em AppDelegate. Isso permite que seu aplicativo envie dados para o Google Analytics. Você pode fazer o seguinte:

  • Incluir os cabeçalhos necessários.
  • Definir o rastreador do Google Analytics em didFinishLaunchingWithOptions.
  • Enviar exceções e informações de log (opcional).

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

#import <Google/Analytics.h>

Em seguida, modifique o método didFinishLaunchingWithOptions para configurar GGLContext:

// Configure tracker from GoogleService-Info.plist.
NSError *configureError;
[[GGLContext sharedInstance] configureWithError:&configureError];
NSAssert(!configureError, @"Error configuring Google services: %@", configureError);

// Optional: configure GAI options.
GAI *gai = [GAI sharedInstance];
gai.trackUncaughtExceptions = YES;  // report uncaught exceptions
gai.logger.logLevel = kGAILogLevelVerbose;  // remove before app release

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ção que você deseja acompanhar ou, se o aplicativo for novo, abra o controlador de visualização padrão. Seu código deve fazer o seguinte:

  • Adicionar o cabeçalho <Google/Analytics.h> obrigatório.
  • Faça uma modificação do 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