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 hits do Google Analytics usando o campo userId, seus relatórios refletem uma contagem mais precisa dos usuários únicos e oferecem novas opções de relatórios entre 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 para enviar IDs de usuário ao Analytics.

Pré-requisitos

Antes de enviar o User ID ao Google Analytics:

• Configure o User ID.
• Revise a política de User ID.
• Saiba como o User ID funciona consultando a Referência do recurso User ID

Importante: você decide fornecer e enviar seus próprios IDs ao Google Analytics, o que geralmente exige que você já tenha implementado um sistema de autenticação no aplicativo e ofereça uma experiência com login aos usuários.

Implementação

Quando um usuário é conhecido no seu aplicativo iOS, você precisa 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., usando o campo userId.

Para enviar o User-ID, defina o campo userId usando a sintaxe do "e" comercial do Measurement Protocol 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 encontrar o User ID:

NSString *userId = [tracker get:kGAIUserId];