O CUID permite agrupar eventos do mesmo utilizador, independentemente do dispositivo, fonte de media ou canal.
O que é o CUID?
O ID de utilizador do cliente (CUID) é um identificador exclusivo de utilizador. O proprietário do aplicativo normalmente o gera e define no momento do registro do usuário. O CUID permite que os donos de apps acompanhem as trajetórias dos utilizadores em diferentes dispositivos.
Exemplo
Um usuário com dois ou mais dispositivos tem o mesmo CUID em todos os apps. Sempre que o usuário realiza um evento em um dispositivo mobile ou desktop, o SDK captura o evento junto com o CUID. Isto permite ao anunciante combinar os dados dos dispositivos numa visualização unificada do utilizador.
Alguns exemplos de utilização:
- Compras in-app feitas pelo mesmo usuário no mesmo aplicativo em vários dispositivos (celular, tablet, TV, desktop) podem ser combinadas em uma única visualização.
- Você pode compartilhar dados de performance do usuário em várias plataformas (desktop, mobile, TV) para alcançar uma experiência do usuário holística.
Configuração do CUID
Recomendamos definir o CUID o mais cedo possível no fluxo de inicialização do SDK para que o maior número possível de eventos possa ser associado a um CUID.
Iniciando o SDK no Android native
Assim que o CUID estiver disponível, pode ser configurado chamando setCustomerUserID. Você só pode associar o CUID a eventos in-app que ocorram depois de defini-lo. Portanto, o evento de instalação não será associado ao CUID quando você chamar
start
antes de
setCustomerUserID.
Associar o CUID ao evento de instalação
Se você precisar associar o evento de instalação ao CUID, recomendamos defini-lo antes de chamar start.
Importante: Tenha em mente que definir o CUID antes de start pode impedir que o SDK envie o evento de instalação e, consequentemente, impedir a atribuição. Isso pode ocorrer, por exemplo, quando o utilizador inicia a aplicação pela primeira vez e sai antes do SDK conseguir definir o CUID.
No Android, você pode executar o start método e configurar o CUID na classe global Application ou em uma classe Activity , dependendo da implementação do aplicativo. Para obter mais informações, consulte Selecionar em qual classe iniciar o SDK.
Se o SDK for iniciado na classe Application
Se você quiser associar o CUID ao
install
evento quando iniciar a partir da classe global
Application
class, certifique-se de adiar o envio do evento de instalação usando o
waitForCustomerUserId
método. Esse método coloca o SDK em modo de espera até que o CUID seja definido.
Observação: se, por algum motivo, a definição do CUID falhar, o SDK permanecerá em modo de espera e não enviará nenhum evento.
Se o SDK for iniciado numa classe Activity
Se você quiser associar o CUID ao evento de instalação ao iniciar a partir de uma classe Activity , não será necessário adiar o envio do evento de instalação. Basta executar start antes de executar start.
Instruções para desenvolvedores
Informe o desenvolvedor sobre o seguinte:
- Use
waitForCustomerUserIdse o SDK for iniciado na classeApplicationglobal - Links para desenvolvedores:
- Se quiser associar o CUID ao evento de instalação, veja aqui.
Android nativo iOS nativo UnityReact nativo
Use o método customerUserId para definir o CUID. A posição de customerUserId em relação ao método start determina quais eventos você pode associar ao CUID.
- Se você chamar
customerUserIdantes de chamarstart, o SDK associará o CUID à instalação e aos seguintes eventos in-app - Se você chamá-lo após
start, o SDK associará o CUID apenas aos eventos registrados depois que você o definir.
Instruções para desenvolvedores
Indique ao seu programador a Definição do ID do utilizador do cliente no Dev Hub.
Unity
Instruções para desenvolvedores
Indique ao seu programador a Definição do ID do utilizador do cliente no Dev Hub.
CONTEXTO
Instruções para desenvolvedores
Indique ao seu programador a referência da API setCustomerUserId no Dev Hub.
Web
Para obter o passo a passo completo da implementação, consulte Definir ID de usuário do cliente em Integrar o SDK web da AppsFlyer.
CUID e privacidade
A AppsFlyer valoriza e respeita a privacidade dos seus utilizadores e não permite a recolha nem a transferência de dados pessoais sensíveis para a plataforma AppsFlyer.
Para proteger a privacidade dos seus usuários, você não deve criar o CUID de forma que ele contenha informações que identifiquem diretamente o usuário. Isto inclui números de segurança social ou de identificação nacional.
Se o CUID contiver o endereço de e-mail ou o número de telefone de um usuário, você deverá aplicar hashing antes de enviá-lo para a AppsFlyer. Nunca envie CUIDs sem hashing que contenham dados pessoais para a AppsFlyer.
Ver também
- Relatórios de jornada do utilizador (para mais informações sobre o CUID em relatórios de dados brutos)
- Práticas recomendadas da Google para evitar enviar PII