Campo ID de usuário cliente (CUID)

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

Visão geral: o CUID permite agrupar eventos do mesmo usuário em diferentes dispositivos, fontes de mídia ou canais.

O que é o CUID?

O ID de usuário cliente (CUID) é um identificador de usuário exclusivo. Geralmente é gerado e definido pelo proprietário do aplicativo no momento do registro do usuário. O CUID permite que os proprietários de aplicativos acompanhem as jornadas do usuário em diferentes dispositivos.

Exemplos

Um usuário com dois ou mais dispositivos tem o mesmo CUID em um aplicativo. Cada vez que o usuário executa um evento em um dispositivo móvel ou desktop, o evento é capturado junto com o CUID. Isso permite que o anunciante combine os dados dos dispositivos em uma visão holística do usuário.

Alguns casos de uso:

  • As compras in-app realizadas pelo mesmo usuário no mesmo aplicativo, mas em vários dispositivos (telefone, tablet, TV, desktop) podem ser combinadas em uma única visualização.
  • O desempenho do usuário em um jogo instalado em várias plataformas (desktop, celular, TV) pode ser compartilhado entre essas plataformas para obter uma experiência de usuário holística.

Configuração do CUID

É recomendável 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 obtenha uma associação de CUID.

Definir o CUID no Android

Assim que o CUID estiver disponível, você poderá defini-lo chamando setCustomerUserID. O CUID só pode ser associado a eventos in-app ocorridos após sua definição. Portanto, o evento de instalação não será associado ao CUID quando start for chamado antes de setCustomerUserID.

Associar o CUID ao evento de instalação

Se for importante associar o evento de instalação ao CUID, você deve defini-lo antes de chamar start.

Importante: lembre-se de que definir o CUID antes de start pode impedir que o SDK envie o evento de instalação e, assim, impedir que a atribuição aconteça. Isso pode ocorrer, por exemplo, quando o usuário inicia o aplicativo pela primeira vez e sai antes que o SDK possa definir o CUID.

No Android, o método start e a configuração do CUID podem ser executados a partir da classe Application global ou de 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 iniciar na classe Application

Se você deseja associar o CUID ao evento de instalação ao iniciar a partir da classe Application global, certifique-se de atrasar o envio do evento de instalação usando o método waitForCustomerUserId . Esse método coloca o SDK no modo de espera até que o CUID seja definido.

Observação: se, por algum motivo, a configuração do CUID falhar, o SDK permanecerá no modo de espera e não enviará nenhum evento.

Se o SDK iniciar em uma classe Activity

Se você deseja associar o CUID ao evento de instalação ao iniciar a partir de uma classe Activity, não é necessário atrasar o envio do evento de instalação. Basta chamar setCustomerUserId antes de chamar start.

Instruções do desenvolvedor

Informe o desenvolvedor do seguinte:

Definir o CUID no iOS

Use o método customerUserId para definir o CUID. A localização de customerUserId  em relação ao método start determina quais eventos podem ser associados ao CUID.

  • Se customerUserId for chamado antes de chamar start, o CUID será associado à instalação e aos seguintes eventos in-app
  • Se for chamado após start, o CUID será associado apenas aos eventos registrados após a configuração do CUID.

Instruções do desenvolvedor

Consulte o desenvolvedor nos seguintes links:

CUID e privacidade

A AppsFlyer valoriza e respeita a privacidade de seus usuários e não permite a coleta ou transferência de dados pessoais confidenciais para a plataforma da AppsFlyer.

Para proteger a privacidade de seus usuários, não é permitido projetar o CUID com informações que identifiquem diretamente o usuário. Isso 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 usuário, essas informações sempre devem ser criptografadas ao serem enviadas para a AppsFlyer. É proibido enviar CUIDs sem hash contendo dados pessoais para a AppsFlyer.

Leitura adicional

Consulte Relatórios de jornada do usuário para saber mais sobre o CUID em relatórios de dados brutos.