El CUID te permite agrupar eventos del mismo usuario en distintos dispositivos, fuentes de medios o canales.
¿Qué es el CUID?
El ID de usuario del cliente (CUID) es un identificador de usuario único. Normalmente, el propietario de la aplicación lo genera y lo establece en el momento del registro del usuario. El CUID permite a los propietarios de aplicaciones seguir el recorrido de los usuarios en diferentes dispositivos.
Ejemplo
Un usuario con dos o más dispositivos tiene el mismo CUID en todas las apps. Cada vez que el usuario realiza un evento en un dispositivo móvil o de escritorio, el SDK registra el evento junto con el CUID. Esto posibilita que el anunciante combine los datos de los dispositivos en una vista integral del usuario.
Algunos casos de uso:
- Las compras in-app realizadas por el mismo usuario en la misma app en varios dispositivos (teléfono, tableta, TV, ordenador) se pueden unificar en una única vista.
- Puedes compartir datos de rendimiento del usuario entre varias plataformas (escritorio, móvil, TV) para lograr una experiencia de usuario integral.
Configuración del CUID
Se recomienda establecer el CUID lo antes posible durante el flujo de inicialización del SDK para que el mayor número posible de eventos pueda asociarse a un CUID.
Android nativo
Una vez que el CUID esté disponible, puedes establecerlo llamando a setCustomerUserID. Solo puedes asociar el CUID con eventos in-app que se produzcan después de configurarlo. Por lo tanto, el evento de instalación no incluirá el CUID cuando llames a start antes de setCustomerUserID.
Asociar el CUID con el evento de instalación
Si necesitas asociar el evento de instalación al CUID, te recomendamos configurarlo antes de llamar a start.
Importante: Recuerda que establecer el CUID antes de start puede bloquear al SDK para que no envíe el evento de instalación y, por tanto, impedir que se produzca 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, puedes ejecutar el método start y configurar el CUID desde la clase global Application o desde una clase Activity , según la implementación de la app. Para más información, consulta Selecciona en qué clase iniciar el SDK.
Si el SDK se inicia en la clase Application
Si quieres asociar el CUID con el evento de instalación al iniciar desde la clase global Application class, asegúrate de retrasar el envío del evento de instalación usando el waitForCustomerUserId método. Este método pone al SDK en modo de espera hasta que se configure el CUID.
Nota: Si por algún motivo falla la configuración del CUID, el SDK permanecerá en modo de espera y no enviará ningún evento.
Si el SDK se inicia en una clase de Activity
Si quieres asociar el CUID con el evento de instalación al iniciar desde una clase Activity class, no tienes que retrasar el envío del evento de instalación. Simplemente llama a setCustomerUserId antes de llamar a start.
Instrucciones para desarrolladores
Indica al desarrollador lo siguiente:
- Usa
waitForCustomerUserIdsi el SDK se inicia en la clase globalApplication - Enlaces para desarrolladores:
- Si quieres asociar el CUID con el evento de instalación, consulta aquí.
iOS nativo
Utiliza el método customerUserId para establecer el CUID. La ubicación de customerUserId en relación con el método start determina qué eventos puedes asociar con el CUID.
- Si llamas a
customerUserIdantes de llamar astart, el SDK asocia el CUID con la instalación y los siguientes eventos in-app - Si lo llamas después de
start, el SDK solo asocia el CUID con los eventos registrados después de configurarlo.
Instrucciones para desarrolladores
Indica al desarrollador que consulte Setting the Customer User ID en el Dev Hub.
Unity
Instrucciones para desarrolladores
Indica al desarrollador que consulte Setting the Customer User ID en el Dev Hub.
React Native
Instrucciones para desarrolladores
Indica al desarrollador que consulte la referencia de la API setCustomerUserId en el Dev Hub.
Web
Para ver la guía completa de implementación, consulta Set customer user ID en Integrate AppsFlyer Web SDK.
CUID y privacidad
AppsFlyer valora y respeta la privacidad de tus usuarios y no permite la recopilación ni la transferencia de datos personales sensibles a la plataforma de AppsFlyer.
Para proteger la privacidad de tus usuarios, no debes diseñar el CUID de forma que contenga información que identifique directamente al usuario. Esto incluye números de seguro social o de identificación nacional.
Si el CUID contiene la dirección de correo electrónico o el número de teléfono de un usuario, debes aplicarle hash antes de enviarlo a AppsFlyer. No envíes nunca CUID sin aplicar Hashing que contengan datos personales a AppsFlyer.
Ver también
- Reportes de la trayectoria del usuario (para obtener más información sobre el CUID en los reportes de raw data)
- Prácticas recomendadas por Google para evitar el envío de Información Personal Identificable (PII)