Este documento apresenta uma visão geral de alguns dos recursos de configuração avançada do SDK do Google Analytics para iOS v2.
Visão geral
O SDK do Google Analytics para iOS usa duas classes para gerenciar o estado global da implementação e enviar dados para os servidores do Google Analytics.
GAI
: um Singleton que processa o estado global da implementação, incluindo o recebimento de novos objetosGAITracker
, bem como a configuração de desativação no nível do app e as configurações de envio.GAITracker
: a classe da qual você envia dados para o Google Analytics. Vários rastreadores podem ser instanciados, um por ID exclusivo de propriedade.
Uso de vários rastreadores
A partir da versão 2 do SDK, você pode usar vários rastreadores em uma única implementação, um por ID de acompanhamento exclusivo. Todos os trackers compartilham o mesmo estado
global armazenado pelo singleton
GAI
.
No exemplo a seguir, uma exibição de tela é enviada a duas propriedades diferentes usando dois rastreadores, cada um com seu próprio ID de propriedade exclusivo:
#import "RootViewController.h" #import "GAI.h" @interface RootViewController () @end @implementation RootViewController { - (void)viewDidLoad { [super viewDidLoad]; // Send a screen view to the first property. id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"]; [tracker1 sendView:@"/HomeScreen"]; // Send another screen view to the second property. id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"]; [tracker2 sendView:@"Home"]; } @end
Os recursos de medição automatizada, como a tela automática e a medição de exceções não capturadas, usarão apenas um rastreador para enviar dados ao Google Analytics. Se você usa esses recursos e quer enviar dados por meio de outros rastreadores, precisa fazer isso manualmente.
Para referência, a medição automática de tela usa o rastreador especificado na propriedade tracker
de um determinado GAITrackedViewController
.
A medição de exceções não identificadas usa o rastreador padrão especificado na instância GAI
.
Rastreador padrão
Embora uma implementação possa usar vários rastreadores, no mundo todo ela tem um
rastreador padrão. O primeiro Tracker
recuperado se torna o rastreador
padrão.
Para encontrar o rastreador padrão, use:
// Get default tracker. idmyDefault = [GAI sharedInstance].defaultTracker;
Para definir o tracker padrão, use:
// Get a new tracker. idnewTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID"); // Set the new tracker as the default tracker, globally. [GAI sharedInstance].defaultTracker = newTracker;
Amostragem
Você pode ativar a amostragem do cliente para limitar o número de hits enviados ao Google Analytics. Se seu aplicativo tem um número grande de usuários ou envia um grande volume de dados ao Google Analytics, ativar a amostragem ajuda a garantir relatórios ininterruptos.
Por exemplo, para implementar a amostragem do cliente a uma taxa de 50%, use este código:
// Set a sample rate of 50%. [tracker setSampleRate:50.0]; // Sample rate is a double.
Desativação no nível do aplicativo
Você pode ativar uma sinalização de desativação no nível do app que desativará o Google Analytics em todo o aplicativo. Depois de definida, a sinalização persistirá durante a vida útil do aplicativo ou até que seja redefinida.
Para acessar a configuração de desativação no nível do aplicativo, use:
// Get the app-level opt out preference. if ([GAI sharedInstance].optOut) { ... // Alert the user they have opted out. }
Para definir a sinalização de desativação no nível do app, use:
// Set the app-level opt out preference. [[GAI sharedInstance].setOptOut = YES];
Como testar e depurar
O SDK do Google Analytics para iOS oferece um modo de depuração que mostra informações úteis sobre quais dados estão sendo enviados ao Google Analytics nos seus registros.
// Enable debug mode. [GAI sharedInstance].debug = YES;