User ID – SDK para iOS

Este guia do desenvolvedor demonstra como implementar o User ID por meio do SDK do Google Analytics para iOS v3.x.

Visão geral

O recurso User ID permite a avaliação de atividades dos usuários distribuídas em vários dispositivos no Google Analytics, como atribuir a interação de uma campanha de marketing em um dispositivo móvel a uma conversão que ocorre em outro dispositivo móvel ou em um navegador.

Quando os User IDs são enviados com os hits do Google Analytics por meio do campo userId, seus relatórios refletem uma contagem mais precisa dos usuários únicos e apresentam novas opções de relatórios de vários dispositivos. Saiba mais sobre as vantagens de usar o User ID.

Este guia mostra como usar o campo userId e o SDK do Google Analytics para iOS com o intuito de enviar User IDs ao Google Analytics.

Pré-requisitos

Antes de enviar o User ID ao Google Analytics:

Implementação

Quando um usuário é conhecido no seu aplicativo para iOS, você deve enviar um ID que o representa com todos os hits do Google Analytics, como exibições de página, eventos, transações de comércio eletrônico etc., por meio do campo userId.

Para enviar o User ID, defina o campo userId usando a sintaxe do "e" comercial do Protocolo de avaliação e o nome do parâmetro kGAIUserId, como neste exemplo:

/**
 * An example method called when a user signs in to an authentication system.
 *
 * @param user represents a generic User object returned by an authentication system on sign in.
 */
- void signInWithUser:(User *)user {

  id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

  // You only need to set User ID on a tracker once. By setting it on the tracker, the ID will be
  // sent with all subsequent hits.
  [tracker set:kGAIUserId
         value:user.id];

  // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles).
  [tracker send:[[GAIDictionaryBuilder createEventWithCategory:@"UX"            // Event category (required)
                                                        action:@"User Sign In"  // Event action (required)
                                                         label:nil              // Event label
                                                         value:nil] build]];    // Event value
}

Este exemplo mostra como ver o User ID:

NSString *userId = [tracker get:kGAIUserId];