Configuração avançada – SDK para iOS

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

Este documento contém 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 aos servidores do Google Analytics.

• GAI: um singleton que processa o estado global da implementação, incluindo a aquisição de novos objetos GAITracker, bem como as configurações de desativação e de envio no nível do app.
• GAITracker: a classe de onde você envia dados para o Google Analytics. É possível instanciar vários rastreadores, um por ID exclusivo da 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 rastreadores compartilham o mesmo estado global de seu singleton GAI.

No exemplo a seguir, uma exibição de tela é enviada para duas propriedades separadas usando dois rastreadores, cada um com seu próprio ID 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

Lembre-se de que os recursos de medição automatizada, como a avaliação automática de telas e exceções não identificadas, usam 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 avaliação automática de telas usa o rastreador especificado na propriedade tracker de um determinado GAITrackedViewController. A avaliaçã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, ela tem globalmente um rastreador padrão. O primeiro Tracker recuperado se torna o rastreador padrão.

Para obter o rastreador padrão, use:

// Get default tracker.
id myDefault = [GAI sharedInstance].defaultTracker;

Para definir o rastreador 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 da propriedade (perfis) do seu aplicativo deve 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 separados os dados de cada versão do seu aplicativo.

Desativação no nível do aplicativo

Você pode ativar uma sinalização de desativação no nível do aplicativo que desativará o Google Analytics em todo o aplicativo. Depois de definida, a sinalização permanecerá durante a vida útil do aplicativo ou até ser 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 flag 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 imprime informações úteis sobre quais dados estão sendo enviados ao Google Analytics nos seus registros.

// Enable debug mode.
[GAI sharedInstance].debug = YES;