User-ID

Este guia do desenvolvedor demonstra como implementar o User ID por meio do SDK v4 do Google Analytics para Android.

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.

Este guia mostra como usar o campo userId e o SDK do Google Analytics para Android para enviar User-IDs ao Google Analytics.

Antes de começar

Antes de iniciar a implementação, os desenvolvedores devem fazer o seguinte:

Implementação

Quando um usuário é conhecido no seu aplicativo Android, 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 no rastreador usando a sintaxe do "e" comercial do Measurement Protocol e o nome do parâmetro &uid, como neste exemplo:

  // Get tracker.
  Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
      TrackerName.APP_TRACKER);

  // 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.
  t.set("&uid", user.getId());

  // This hit will be sent with the User ID value and be visible in
  // User-ID-enabled views (profiles).
  t.send(new HitBuilders.EventBuilder()
      .setCategory("UX")
      .setAction("User Sign In")
      .build());