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:
- SDK para desenvolvedores do iOS 4.0 ou mais recente
- SDK do Google Analytics para apps para dispositivos móveis (iOS v2)
- Um aplicativo iOS que você deseja avaliar por meio do Google Analytics
- Uma nova propriedade de aplicativo e vista (perfil) do Google Analytics.
Como começar
Há três etapas para começar a usar o SDK:
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.