Definir um User ID

O Google Analytics tem uma chamada setUserID, que permite armazenar um ID de usuário para quem usa seu aplicativo. Essa chamada é opcional e geralmente é utilizada por organizações que querem usar o Google Analytics com o BigQuery para associar dados de análise do mesmo usuário em vários aplicativos, dispositivos ou provedores de estatísticas.

Observação: você é responsável por garantir que seu uso do ID de usuário esteja em conformidade com os Termos de Serviço do Google Analytics. Isso inclui evitar o uso de informações de identificação pessoal não autorizadas e fornecer avisos apropriados sobre o uso de identificadores na sua Política de Privacidade. Seu User ID não precisa conter informações que um terceiro possa usar para determinar a identidade de um usuário individual. Por exemplo, não é permitido usar o endereço de e-mail ou o CPF do usuário como um User ID.

Há muitas formas de criar IDs de usuário válidos. Uma abordagem é usar um identificador que você atribuiu e somente você poderá rastrear de volta para um usuário individual. Por exemplo, considere uma desenvolvedora fictícia de jogos para dispositivos móveis, a AwesomeGameCompany, que tem seu próprio AwesomeGameCompanyID interno criado para cada usuário. Se não for possível que uma organização externa rastreie AwesomeGameCompanyID de volta para o usuário original, ela poderá usar AwesomeGameCompanyID ou, melhor ainda, uma versão hash de AwesomeGameCompanyID, como o valor do ID de usuário para o Analytics. Isso permitiria que ela calculasse valores como o gasto total de um usuário em todos os seus jogos.

A definição de um User ID nunca é necessária para que o Google Analytics funcione corretamente. Se você quer apenas encontrar eventos que pertencem ao mesmo usuário no mesmo aplicativo em um único dispositivo, use user_pseudo_id. Esse valor é gerado automaticamente pelo Google Analytics e é armazenado no BigQuery para cada evento.

Como configurar o User ID

Defina um User ID com o seguinte método:

Swift

Observação: este produto do Firebase não está disponível no destino macOS.

Analytics.setUserID("123456")

Objective-C

Observação: este produto do Firebase não está disponível no destino macOS.

[FIRAnalytics setUserID:@"123456"]

Android

mFirebaseAnalytics.setUserId("123456");

API modular da Web

import { getAnalytics, setUserId } from "firebase/analytics";

const analytics = getAnalytics();
setUserId(analytics, "123456");

API com namespace da Web

firebase.analytics().setUserId("123456");

Dart

await FirebaseAnalytics.instance.setUserId(id: '123456');

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserID("123456");

C++

analytics::SetUserId("123456");

Depois de definir um ID de usuário, todos os eventos futuros serão marcados automaticamente com esse valor, e você poderá acessá-lo ao consultar o valor user_id no BigQuery. Adicionar um ID do usuário não vai afetar nenhum evento registrado anteriormente pelo Google Analytics.

Para saber mais sobre como acessar dados do Google Analytics no BigQuery, consulte este guia de desenvolvimento.