Configuração avançada – SDK para iOS

Importante: este documento descreve uma versão legada do SDK. Os novos usuários devem usar o SDK mais recente.

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.

Para evitar inconsistências de relatórios, cada uma das vistas do app (perfis) precisa conter dados coletados com a mesma taxa de amostragem. Se versões diferentes do seu aplicativo usarem taxas de amostragem diferentes, você precisará configurar filtros de vista da propriedade (perfil) usando a dimensão de versão do aplicativo para manter os dados de cada versão do aplicativo separados.

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;