Campo de ID do utilizador do cliente (CUID)

Para:
Profissionais de marketing Desenvolvedores
Última atualização:

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.

Android nativoiOS nativoUnityReact Native

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 waitForCustomerUserId se o SDK for iniciado na classe Application global
  • Links para desenvolvedores:
    • Se quiser associar o CUID ao evento de instalação, veja aqui.

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