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

Configuração avançada – SDK para iOS

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

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 objetos GAITracker, 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.
id myDefault = [GAI sharedInstance].defaultTracker;

Para definir o tracker padrão, use:

// Get a new tracker.
id newTracker = [[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;