SDK do Google Analytics para iOS v2 (legado) – visão geral

Com o SDK do Google Analytics para iOS, os desenvolvedores podem coletar dados de engajamento do usuário com facilidade nos aplicativos. Este documento fornece uma visão geral do valor do SDK, bem como um guia para começar a medir seu app usando um único ID de propriedade e o EasyTracker.

Introdução

Com o SDK do Google Analytics para iOS, é fácil para os desenvolvedores coletar dados de engajamento dos usuários nos apps. Os desenvolvedores podem usar os relatórios do Google Analytics para avaliar:

  • O número de usuários ativos que estão usando os aplicativos.
  • A origem geográfica em que o aplicativo está sendo usado.
  • A adoção e o uso de recursos específicos.
  • Compras e transações no aplicativo.
  • O número e o tipo de falhas do aplicativo.
  • E muitas outras métricas úteis.

Antes de começar

Antes de começar a implementar o SDK, verifique se você tem:

Como começar

Há três etapas para começar a usar o SDK:

  1. Adicionar cabeçalhos e bibliotecas ao projeto
  2. Inicializar o rastreador
  3. Adicionar a medição de telas

Depois de concluir essas etapas, você poderá avaliar os itens a seguir com o Google Analytics:

  • Instalações de aplicativos
  • Usuários ativos e informações demográficas
  • Telas e engajamento dos usuários
  • Falhas e exceções

1. Adição de arquivos de cabeçalho e configuração do seu projeto

Faça o download do SDK do Google Analytics para iOS e adicione estes arquivos do pacote do SDK ao seu aplicativo:

  • GAI.h
  • GAITracker.h
  • GAITrackedViewController.h
  • GAITransaction.h
  • GAITransactionItem.h
  • libGoogleAnalytics.a

O SDK do Google Analytics usa os frameworks CoreData e SystemConfiguration. Sendo assim, você precisará adicionar o seguinte às bibliotecas vinculadas do destino do aplicativo:

  • libGoogleAnalytics.a
  • CoreData.framework
  • SystemConfiguration.framework

2. Inicialização do rastreador

Para inicializar o rastreador, importe o cabeçalho GAI.h no arquivo .m do delegado do aplicativo e adicione este código ao método application:didFinishLaunchingWithOptions: dele:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Optional: automatically send uncaught exceptions to Google Analytics.
  [GAI sharedInstance].trackUncaughtExceptions = YES;
  // Optional: set Google Analytics dispatch interval to e.g. 20 seconds.
  [GAI sharedInstance].dispatchInterval = 20;
  // Optional: set debug to YES for extra debugging information.
  [GAI sharedInstance].debug = YES;
  // Create tracker instance.
  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"UA-YOUR-TRACKING-ID"];

}

id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

No exemplo acima, "UA-YOUR-Tracking-ID" representa um marcador de posição do ID de acompanhamento atribuído a você quando você criou a vista do aplicativo (perfil) do Google Analytics. Se você usa apenas um ID de acompanhamento no seu aplicativo, é melhor usar o método padrão do rastreador.

3. Como implementar a medição de telas

Para medir automaticamente as visualizações no seu app, peça para os controladores de visualização estenderem GAITrackedViewController, uma classe de conveniência que estende UIViewController, e fornecer o nome da visualização a ser dado a cada controlador de visualização nos seus relatórios. Cada vez que essa visualização é carregada, uma exibição de tela é enviada ao Google Analytics.

Por exemplo, suponha que você tenha uma vista da propriedade "Sobre" que gostaria de avaliar com um cabeçalho de controlador de visualização com esta aparência:

@interface AboutViewController : UIViewController

Você atualizaria esse cabeçalho para dizer:

#import "GAITrackedViewController.h"

@interface AboutViewController : GAITrackedViewController

Também seria necessário fornecer o nome da vista da propriedade a ser usado nos relatórios do Google Analytics. Um bom lugar para colocar isso é o método de inicialização do controlador de visualizações, se você tiver um, ou o método viewDidAppear::

- (void)viewDidAppear:(BOOL)animated {
  [super viewDidAppear:animated];
  self.trackedViewName = @"About Screen";
}

Contanto que trackedViewName seja definido antes de sendView: ser chamado, a medição automática de telas vai ocorrer. Sempre que a visualização aparecer, uma chamada para sendView: com o nome da visualização fornecido será gerada.

Para saber mais sobre a medição de telas, consulte o Guia para desenvolvedores de telas.

Parabéns! Agora seu aplicativo está configurado para enviar dados ao Google Analytics.

Próximas etapas

Você pode fazer muito mais com o Google Analytics, incluindo avaliar campanhas, pagamentos e transações no aplicativo e eventos de interação dos usuários. Consulte os guias do desenvolvedor a seguir para saber como adicionar esses recursos à sua implementação:

  • Configuração avançada: saiba mais sobre as opções de configuração avançada, incluindo como usar vários rastreadores.
  • Avaliação de campanhas: saiba como implementar a avaliação de campanhas para compreender quais canais e campanhas estão promovendo instalações de aplicativos.
  • Avaliação de eventos: saiba como avaliar o engajamento dos usuários com conteúdos interativos, como botões, vídeos e outras mídias que usam eventos.
  • Avaliação de pagamentos no aplicativo: saiba como avaliar pagamentos e transações no aplicativo.
  • Velocidade do usuário: saiba como avaliar a velocidade do usuário no seu aplicativo para medir os tempos de carregamento, o engajamento com a mídia e muito mais.