Campo de ID de usuario de cliente (CUID)

Para:
Marketers Desarrolladores
Última actualización:

De un vistazo: El CUID te permite agrupar eventos del mismo usuario a través de diferentes dispositivos, fuentes de medios o canales.

¿Qué es el CUID?

El ID de usuario de cliente (CUID) es un identificador de usuario único. Por lo general, es generado y configurado por el propietario de la aplicación en el momento del registro del usuario. El CUID permite a los propietarios de aplicaciones seguir la trayectoria de los usuarios a través de diferentes dispositivos.

Ejemplos

Un usuario con dos o más dispositivos tiene el mismo CUID dentro de una aplicación. Cada vez que el usuario realiza un evento en un dispositivo móvil o de escritorio, el evento se captura junto con el CUID. Esto permite al anunciante combinar los datos de los dispositivos en una vista holística del usuario.

Algunos casos de uso:

  • Las compras in-app realizadas por el mismo usuario en la misma aplicación pero en múltiples dispositivos (teléfono, tableta, TV, escritorio) se pueden combinar en una sola vista.
  • El rendimiento del usuario en un juego instalado en múltiples plataformas (escritorio, móvil, TV) se puede compartir entre estas plataformas para lograr una experiencia de usuario holística.

Cómo configurar el CUID

Se recomienda establecer el CUID lo antes posible en el flujo de inicialización del SDK para que el mayor número posible de eventos obtengan una asociación de CUID.

Establecer el CUID en Android

Una vez que el CUID esté disponible, puedes configurarlo llamando a setCustomerUserId. El CUID solo se puede asociar con eventos in-app que ocurren después de que se configuró. Por lo tanto, el evento de instalación no se asociará con el CUID cuando se llame a start antes de a setCustomerUserID.

Asociar el CUID con el evento de instalación

Si es importante que asocies el evento de instalación al CUID, debes configurarlo antes de llamar a start.

Importante: Recuerda que establecer el CUID antes de start puede bloquear el SDK para que no envíe el evento de instalación y así evitar que ocurra la atribución. Esto puede ocurrir, por ejemplo, cuando el usuario inicia la aplicación por primera vez y luego sale antes de que el SDK pueda establecer el CUID.

En Android, el método start y la configuración del CUID se pueden ejecutar desde la clase Application global o una clase Activity, dependiendo de la implementación de la aplicación. Para obtener más información, consulta Seleccionar en qué clase iniciar el SDK.

Si el SDK se inicia en la clase Application

Si deseas asociar el CUID con el evento de instalación cuando se inicia desde la clase Application global, asegúrate de retrasar el envío del evento de instalación utilizando el método waitForCustomerUserId. Este método pone el SDK en modo de espera hasta que se establezca el CUID.

Nota: Si por alguna razón la configuración del CUID falla, el SDK permanecerá en modo de espera y no enviará ningún evento.

Si el SDK comienza en una clase Activity

Si deseas asociar el CUID con el evento de instalación cuando se inicia desde una clase Activity, no tienes que retrasar el envío del evento de instalación. Simplemente llama a setCustomerUserId antes de llamar a start.

Instrucciones para el desarrollador

Informa al desarrollador de lo siguiente:

  • Usa waitForCustomerUserId si el SDK comienza en la clase Application global.
  • Enlaces para desarrolladores:
    • Si quieres asociar el CUID con el evento de instalación, consulta aquí.

Establecer el CUID en iOS

Utiliza el método customerUserId para establecer el CUID. La ubicación del customerUserId en relación con el método start determina qué eventos se pueden asociar con el CUID.

  • Si se llama a customerUserId antes de llamar a start, el CUID se asocia con la instalación y los siguientes eventos in-app.
  • Si se llama después de start, el CUID solo se asocia con los eventos registrados después de establecer el CUID.

Instrucciones para el desarrollador

Remite al desarrollador a los siguientes enlaces:

CUID y privacidad

AppsFlyer valora y respeta la privacidad de sus usuarios y no permite la recopilación o transferencia de datos personales confidenciales a la plataforma AppsFlyer.

Para asegurar la privacidad de tus usuarios, no está permitido diseñar el CUID con información que identifique directamente al usuario. Esto incluye números de seguridad social o de identificación nacional.

Además, si el CUID establecido contiene la dirección de correo electrónico o número de teléfono de un usuario, dicha información siempre debe ser con hash al enviarla a AppsFlyer. Está prohibido enviar CUID que contengan datos personales sin hash a AppsFlyer.

Lectura adicional

Consulta los reportes de la trayectoria del usuario para obtener más información sobre el CUID en los reportes de raw data.