Este guia do desenvolvedor demonstra como implementar o User-ID usando o SDK do Google Analytics para Android 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 por meio do campo userId
, seus relatórios refletem uma contagem mais precisa de usuários únicos e oferecem novas opções de relatórios de dispositivos diferentes.
Saiba mais sobre as vantagens de usar o User-ID.
Neste guia, mostramos como usar o campo userId
e o SDK do Google Analytics para Android para enviar IDs do usuário ao Google 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
Implementação
Quando um usuário é conhecido no seu app Android, você precisa enviar um ID que o representa com todos os hits do Google Analytics, como visualizações de página, eventos, transações de e-commerce 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 Fields.USER_ID
, como neste exemplo:
/** * An example method called when a user signs in to an authentication system. * * @param User user represents a generic User object returned by an authentication system on sign in. */ public void onUserSignIn(User user) { Tracker t = GoogleAnalytics.getInstance(context).getTracker("UA-XXXX-Y"); // 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(Fields.USER_ID, user.getId()); // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles). t.send(MapBuilder .createEvent("UX", // Event category (required) "Sign In", // Event action (required) null, // Event label null) // Event value .build() ); }