En esta página, se describe cómo usar el reconocimiento de dispositivo para almacenar y recuperar datos personalizados con dispositivos específicos. Puedes recuperar de forma confiable los datos personalizados más adelante, cuando tu app se instale en el mismo dispositivo, incluso después de que se restablezca. Esto te permite detectar y evitar que se vuelva a usar un dispositivo en función de una acción o un comportamiento que especifiques, a la vez que se preserva la privacidad del usuario.
¿Cómo funciona el reconocimiento de dispositivo?
El reconocimiento de dispositivo les brinda a las apps la capacidad de almacenar y recuperar datos personalizados asociados con un dispositivo específico de una manera que preserva la privacidad del usuario. Los datos se almacenan en los servidores de Google, lo que permite que tu app recupere de forma confiable tus datos personalizados, incluso después de que se haya reinstalado la app o se haya restablecido el dispositivo. Por ejemplo, puedes usar la función para recuperar dispositivos en los que encontraste evidencia de abuso grave, dispositivos que ya canjearon elementos de alto valor (como una prueba gratuita) o dispositivos que se usan de forma reiterada para crear cuentas nuevas con fines abusivos. El reconocimiento de dispositivo preserva la privacidad del usuario, ya que la app que realiza la solicitud solo puede recuperar los datos limitados que asoció con los dispositivos, sin acceder a ningún identificador de dispositivo o usuario. Después de activar el reconocimiento de dispositivo, puedes hacer lo siguiente:
- Lee datos por dispositivo: Puedes leer tres valores personalizados o bits para cada dispositivo cuando obtienes un veredicto de integridad. Puedes definir tu propio significado para estos valores; por ejemplo, puedes tratar los valores como tres marcas independientes o combinarlos para representar ocho etiquetas personalizadas.
- Modifica los datos por dispositivo: Después de obtener un token de integridad, puedes usarlo para realizar una llamada del servidor al servidor de Google Play y modificar uno o más de los valores. Tienes hasta 14 días para usar el token. Esto te permite modificar un valor si, por ejemplo, el abuso solo se hace evidente en el período de dos semanas posterior a la primera vez que realizas una verificación de integridad. Cuando modificas un valor, también se almacenan el mes y el año en que se realizó la modificación.
Requisitos previos y consideraciones del reconocimiento de dispositivos
El reconocimiento de dispositivo solo se puede usar para almacenar y recuperar información con el objetivo de proteger la seguridad de la app y mitigar el abuso, el fraude y el acceso no autorizado. No puedes usar el reconocimiento de dispositivo para crear huellas digitales o hacer un seguimiento de usuarios o dispositivos individuales, ni para hacer un seguimiento de características sensibles de los usuarios o los dispositivos, como el género, la edad o los datos de ubicación.
El reconocimiento de dispositivos tiene los siguientes requisitos previos:
- El reconocimiento de dispositivo se puede usar en teléfonos, tablets, dispositivos plegables, TVs, Android Auto y Wear OS. En Wear, el reconocimiento de dispositivo solo está disponible en dispositivos que se envían con Wear OS 5 o versiones posteriores. El reconocimiento de dispositivo no se admite en emuladores.
- El reconocimiento de dispositivo requiere que se instalen y habiliten versiones recientes de Google Play Store y de los Servicios de Google Play en el dispositivo.
- El reconocimiento de dispositivo requiere que la cuenta de usuario tenga una licencia de Play. De lo contrario, no se evaluará el veredicto.
El reconocimiento de dispositivo tiene las siguientes consideraciones de tiempo:
- Después de verificar un token de integridad, tienes hasta 14 días para usarlo y almacenar datos personalizados de reconocimiento de dispositivo.
- El reconocimiento de dispositivo incluye marcas de tiempo para que puedas considerar los datos modificados recientemente como de mayor prioridad que los datos que se modificaron hace mucho tiempo. Considera ignorar o restablecer los datos después de un período lo suficientemente largo como para tener en cuenta que los dispositivos pueden cambiar de propietario o reacondicionarse y revenderse.
- Los bits de recuperación de un dispositivo se almacenarán durante 3 años después del último acceso de lectura o escritura.
- Si necesitas borrar todos los datos asociados con un dispositivo, tu app puede restablecer los tres valores de ese dispositivo como falsos. Esto restablecerá automáticamente las marcas de tiempo.
Para los desarrolladores con varias apps y los que transfieren apps, el reconocimiento de dispositivo funciona de la siguiente manera:
- Todas las apps de tu cuenta de desarrollador de Google Play tienen acceso a los mismos tres valores por dispositivo. En otras palabras, si una de tus apps modifica uno de los valores, todas tus apps leerán el valor modificado cuando se instalen en el mismo dispositivo.
- Si una app se transfiere de una cuenta de desarrollador a otra, el reconocimiento de dispositivo reflejará los datos por dispositivo de la nueva cuenta de desarrollador, no los de la anterior.
Activa el reconocimiento de dispositivo
Cuando tengas todo listo, activa el reconocimiento de dispositivo en Play Console:
- Accede a tu cuenta de Play Console.
- Selecciona la app que usará el reconocimiento de dispositivo.
- Navega a Protegido con Play en el menú de la izquierda.
- Junto a la API de Play Integrity, haz clic en Administrar.
- En la sección Respuestas de la página, haz clic en Cambiar respuestas.
- Activa el reconocimiento de dispositivo.
- Haz clic en Guardar cambios.
Cuando actives o desactives el reconocimiento de dispositivo, se borrarán todas las respuestas de prueba de la API de Play Integrity que hayas configurado en Play Console, y deberás volver a crearlas.
Lee los valores de reconocimiento de dispositivo
El reconocimiento de dispositivo funciona tanto en las solicitudes clásicas como en las estándar de la API de Play Integrity. En las solicitudes estándar, el reconocimiento de dispositivo se actualiza en la llamada de preparación. En otras palabras, después de modificar los datos por dispositivo, deberás realizar otra preparación para ver el valor actualizado. Una vez que se habilite el reconocimiento de dispositivo, podrás leer los valores de reconocimiento de dispositivo en tus veredictos de integridad.
Modifica los valores de reconocimiento de dispositivo
Puedes modificar los valores de reconocimiento de dispositivo realizando una llamada a la API de servidor a servidor similar a la de decodificación del veredicto de integridad. Si configuras
un bit como true, también se actualizará su fecha de escritura (incluso si ya era true).
Si configuras un bit como false, se restablecerá su fecha de escritura para que quede vacía. Los bits que no se especifiquen en una solicitud permanecerán sin cambios. Hay un pequeño retraso de propagación
entre la escritura de bits y la posibilidad de volver a leerlos en el veredicto. Esta demora puede ser de hasta 30 segundos, aunque, por lo general, es mucho más corta. Las solicitudes de escritura de reconocimiento de dispositivo deberían ser menos frecuentes que las solicitudes de tokens de integridad. No se descuentan de tu cuota de solicitudes de tokens de integridad, pero están sujetas a límites de frecuencia independientes.
playintegrity.googleapis.com/v1/PACKAGE_NAME/deviceRecall:write -d \
'{
"integrityToken": "INTEGRITY_TOKEN",
"newValues": {
"bitFirst": true,
"bitThird": false
}
}'newValues.BitFirst = true // ForceSendFields optional for value true newValues.BitSecond = false // ForceSendFields required for value false newValues.BitThird = nil // do not set ForceSendFields for unspecified bits newValues.ForceSendFields = []string{"BitSecond"}