Este documento descreve uma versão legada do SDK para iOS. Se você não tem experiência com o Analyitcs, use o SDK mais recente. Saiba mais

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

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Com o SDK do Google Analytics para iOS, fica mais fácil para os desenvolvedores coletarem dados de engajamento dos usuários nos apps. Este documento oferece 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, fica mais 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 medir:

  • 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 o seguinte:

Como começar

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

  1. Adicionar cabeçalhos e bibliotecas ao projeto
  2. Inicialize o tracker
  3. Adicionar medição de tela

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. Portanto, você precisará adicionar o seguinte às bibliotecas vinculadas do aplicativo de destino:

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

2. Inicialização do rastreador

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

- (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, "quot;UA-YOUR-TRACKING-ID" veja um marcador de ID de acompanhamento atribuído quando você criou a vista da propriedade (perfil) do aplicativo do Google Analytics. Se você estiver usando apenas um ID de acompanhamento no seu app, é melhor usar o método padrão de rastreador.

3. Como implementar a medição de tela

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

Por exemplo, suponha que você tenha uma visualização "Sobre" que queira medir com um cabeçalho do controlador de visualização semelhante a este:

@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 fazer isso é o método de inicialização do controlador de visualização, se você tiver um, ou o método viewDidAppear::

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

Se trackedViewName for definido antes de sendView: ser chamado, a medição automática de tela será feita. Sempre que a visualização aparece, uma chamada para sendView: com o nome da visualização fornecido é gerada.

Para saber mais sobre a medição de tela, 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 seguintes guias do desenvolvedor para saber como adicionar esses recursos à 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.