Visão geral: 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. Normalmente, é gerado e estabelecido pelo proprietário da app no momento da inscrição do utilizador. O CUID permite que os donos de apps acompanhem as trajetórias dos utilizadores em diferentes dispositivos.
Exemplo
Um utilizador com dois ou mais dispositivos terá sempre o mesmo CUID dentro de uma app. Todas as vezes que o utilizador realiza um evento num dispositivo móvel ou desktop, o evento é registado juntamente com o CUID. Isto permite ao anunciante combinar os dados dos dispositivos numa visualização unificada do utilizador.
Alguns exemplos de utilização:
- Compras na app feitas pelo mesmo utilizador em vários dispositivos (telefone, tablet, TV, desktop) podem ser integradas numa única visão.
- O desempenho do utilizador num jogo instalado em várias plataformas (desktop, telemóvel, TV) pode ser partilhado para oferecer uma experiência de utilizador completa.
Configuração do CUID
É aconselhável definir o CUID o mais cedo possível na inicialização do SDK, para que o maior número de eventos possível esteja associado a um CUID.
Assim que o CUID estiver disponível, pode ser configurado chamando setCustomerUserID. O CUID só será vinculado a eventos na app que ocorrerem após a sua definição. Portanto, o evento de instalação não será associado ao CUID se setCustomerUserID for chamado antes de setCustomerUserID.
Associar o CUID ao evento de instalação
Se for importante associar o evento de instalação ao CUID, deve configurá-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, o método start e a configuração do CUID podem ser realizados a partir da classe Application global ou de uma classe Activity, dependendo da implementação da app. Para obter mais informações, consulte Selecionar em que classe iniciar o SDK.
Se o SDK for iniciado na classe Application
Se desejar associar o CUID ao evento de instalação ao iniciar a partir da classe Application global, deve adiar o envio do evento de instalação utilizando o método waitForCustomerUserId. Este método coloca o SDK em modo de espera até o CUID ser definido.
Nota: 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 desejar associar o CUID ao evento de instalação ao começar por uma classe Activity, não precisa atrasar o envio do evento de instalação. Basta executar start antes de executar start.
INSTRUÇÕES PARA O DESENVOLVEDOR
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.
Use o método customerUserId para definir o CUID. A localização de start em relação ao método start determina que eventos podem ser associados ao CUID.
- Se
customerUserIdfor executado antes destart, o CUID será associado à instalação e aos eventos internos seguintes. - Se for chamado após
start, o CUID apenas estará associado aos eventos registados depois da configuração do CUID.
INSTRUÇÕES PARA O DESENVOLVEDOR
Indique ao seu programador a Definição do ID do utilizador do cliente no Dev Hub.
INSTRUÇÕES PARA O DESENVOLVEDOR
Indique ao seu programador a Definição do ID do utilizador do cliente no Dev Hub.
INSTRUÇÕES PARA O DESENVOLVEDOR
Indique ao seu programador a referência da API setCustomerUserId no Dev Hub.
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 utilizadores, não é permitido criar o CUID com informação que identifique o utilizador diretamente. Isto inclui números de segurança social ou de identificação nacional.
Além disso, se o CUID definido contiver o endereço de e-mail ou número de telefone de um utilizador, essa informação deve ser sempre encriptada quando enviada para a AppsFlyer. É proibido enviar CUIDs não encriptados contendo 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
This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.