Sugerencias del cliente de User-Agent

Información general

Cada vez que un explorador web realiza una solicitud a un servidor web, el encabezado de la solicitud incluye información sobre el explorador y el entorno en el que se ejecuta el explorador. Todos estos datos se acumulan en una cadena denominada User-Agent cadena.

A continuación, se muestra un ejemplo de lo que puede ser User-Agent tiene el aspecto de una solicitud procedente de un explorador Chrome que se ejecuta en una Mac OS dispositivo.

NOTA

A lo largo de los años, la cantidad de información del explorador y del dispositivo incluida en la variable User-Agent La cadena ha crecido y se ha modificado varias veces. El ejemplo siguiente muestra una selección de los más comunes User-Agent información.

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36`
Campo Valor
Nombre del software Chrome
Versión de software 105
Versión completa del software 105.0.0.0
Nombre del motor de diseño AppleWebKit
Versión del motor de diseño 537.36
Sistema operativo Mac OS X
Versión del sistema operativo 10.15.7
Device Intel Mac OS X 10_15_7

Casos de uso

User-Agent Las cadenas se han utilizado durante mucho tiempo para proporcionar a los equipos de marketing y desarrollo información importante sobre cómo los navegadores, sistemas operativos y dispositivos muestran el contenido del sitio, así como sobre cómo interactúan los usuarios con los sitios web.

User-Agent las cadenas también se utilizan para bloquear el correo no deseado y filtrar bots que rastrean sitios para diversos fines adicionales.

User-Agent cadenas en Adobe Experience Cloud

Las soluciones de Adobe Experience Cloud utilizan la variable User-Agent cadenas de varias formas.

  • Adobe Analytics utiliza el User-Agent para aumentar y obtener información adicional relacionada con los sistemas operativos, navegadores y dispositivos utilizados para visitar un sitio web.
  • Adobe Audience Manager y Adobe Target califican a los usuarios finales para campañas de segmentación y personalización, según la información proporcionada por la User-Agent cadena.

Introducción a las sugerencias del cliente User-Agent

En los últimos años, los propietarios de sitios y los proveedores de marketing han utilizado User-Agent cadenas junto con otra información incluida en los encabezados de solicitud para crear huellas digitales. Estas huellas dactilares pueden utilizarse como medio para identificar a los usuarios sin su conocimiento.

A pesar del importante propósito que User-Agent Las cadenas sirven para los propietarios del sitio, los desarrolladores de exploradores han decidido cambiar la forma en que User-Agent las cadenas funcionan, para limitar los posibles problemas de privacidad para los usuarios finales.

La solución que desarrollaron se llama Sugerencias del cliente de User-Agent. Las sugerencias del cliente siguen permitiendo que los sitios web recopilen la información necesaria sobre el explorador, el sistema operativo y el dispositivo, a la vez que brindan una mayor protección contra los métodos de seguimiento encubiertos, como la huella digital.

Las sugerencias del cliente permiten a los propietarios de sitios web acceder a gran parte de la misma información disponible en la User-Agent cadena, pero de una forma más preservada de la privacidad.

Cuando los navegadores modernos envían un usuario a un servidor web, todo el User-Agent se envía en cada solicitud, independientemente de si es necesaria. Por otro lado, las sugerencias del cliente refuerzan un modelo en el que el servidor debe solicitar al explorador la información adicional que desea conocer sobre el cliente. Al recibir esta solicitud, el explorador puede aplicar sus propias políticas o configuración de usuario para determinar qué datos se devuelven. En lugar de exponer todo User-Agent de forma predeterminada en todas las solicitudes, el acceso ahora se administra de forma explícita y auditable.

Compatibilidad con exploradores

Sugerencias del cliente de User-Agent se han introducido con Google Chrome ​versión 89.

Los exploradores adicionales basados en Chromium admiten la API de sugerencias del cliente, como:

  • Microsoft Edge
  • Opera
  • Brave
  • Chrome for Android
  • Opera for Android
  • Samsung Internet

Categorías

Existen dos categorías de sugerencias del cliente User-Agent:

Sugerencias de cliente de baja entropía

Las sugerencias de cliente de baja entropía incluyen información básica que no se puede usar para los usuarios de huellas digitales. Información como la marca del explorador, la plataforma y si la solicitud procede de un dispositivo móvil.

Las sugerencias de cliente de baja entropía están habilitadas de forma predeterminada en el SDK web y se pasan en cada solicitud.

Encabezado HTTP JavaScript Incluido en User-Agent de forma predeterminada Incluido en las sugerencias del cliente de forma predeterminada
Sec-CH-UA brands
Sec-CH-UA-Platform platform
Sec-CH-UA-Mobile mobile

Sugerencias de cliente de entropía alta

Las sugerencias de cliente de alta entropía son información más detallada sobre el dispositivo cliente, como la versión de la plataforma, la arquitectura, el modelo, la integridad (plataformas de 64 o 32 bits) o la versión completa del sistema operativo. Esta información podría utilizarse en la toma de huellas digitales.

Encabezado HTTP JavaScript Incluido en User-Agent de forma predeterminada Incluido en las sugerencias del cliente de forma predeterminada
Sec-CH-UA-Platform-Version platformVersion No
Sec-CH-UA-Arc architecture No
Sec-CH-UA-Model model No
Sec-CH-UA-Bitness Bitness No
Sec-CH-UA-Full-Version-List fullVersionList No

Las sugerencias de cliente de alta entropía están deshabilitadas de forma predeterminada en el SDK web. Para habilitarlos, debe configurar manualmente el SDK web para solicitar sugerencias de cliente de alta entropía.

Las sugerencias de cliente de alta entropía afectan a las soluciones de Experience Cloud

Algunas soluciones de Adobe Experience Cloud dependen de la información incluida en las sugerencias de cliente de alta entropía al generar informes.

Si no habilita las sugerencias de cliente de alta entropía en su entorno, los informes y características de Adobe Analytics y Audience Manager que se describen a continuación no funcionarán.

Informes de Adobe Analytics basados en sugerencias de cliente de alta entropía

Los siguientes informes de Adobe Analytics no funcionarán mientras se deshabiliten las sugerencias de cliente de alta entropía.

Características del Audience Manager que dependen de sugerencias de cliente de alta entropía

Si los rasgos del Audience Manager utilizan cualquiera de las siguientes propiedades, debe habilitar las sugerencias de cliente de alta entropía. De lo contrario, las características dejarán de funcionar.

  • Versión del sistema operativo
  • Modelo de dispositivo
  • Fabricante del dispositivo
  • Proveedor de dispositivo

Habilitar sugerencias de cliente de alta entropía

Para habilitar las sugerencias de cliente de alta entropía en la implementación del SDK web, debe incluir el complemento highEntropyUserAgentHints contexto, tal como se describe en la sección documentación de configuración, junto con la configuración existente.

Por ejemplo, para recuperar sugerencias de cliente de alta entropía de propiedades web, la configuración tendría este aspecto:

context: ["highEntropyUserAgentHints", "web"]

Ejemplo

Las sugerencias del cliente contenidas en los encabezados de la primera solicitud realizada por el explorador a un servidor web contendrán la marca del explorador, la versión principal del explorador y un indicador de si el cliente es un dispositivo móvil. Cada fragmento de datos tendrá su propio valor de encabezado en lugar de agruparse en un solo User-Agent como se muestra a continuación:

Sec-CH-UA: "Chromium";v="101", "Google Chrome";v="101", " Not;A Brand";v="99"

Sec-CH-UA-Mobile: ?0

Sec-CH-UA-Platform: "macOS

El equivalente User-Agent para el mismo explorador tendría este aspecto:

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.54 Safari/537.36

Aunque la información es similar, la primera solicitud al servidor contiene sugerencias del cliente. Solo incluyen un subconjunto de lo que está disponible en la variable User-Agent cadena. Falta en la solicitud la arquitectura del sistema operativo, la versión completa del sistema operativo, el nombre del motor de diseño, la versión del motor de diseño y la versión completa del explorador.

Sin embargo, en solicitudes posteriores, la variable Client Hints API permite a los servidores web solicitar detalles adicionales sobre el dispositivo. Cuando se solicitan estos valores, según la política del explorador o la configuración del usuario, la respuesta del explorador puede incluir esa información.

A continuación se muestra un ejemplo del objeto JSON devuelto por el Client Hints API cuando se solicitan valores de entropía altos:

{
   "architecture":"x86",
   "bitness":"64",
   "brands":[
      {
         "brand":" Not A;Brand",
         "version":"99"
      },
      {
         "brand":"Chromium",
         "version":"100"
      },
      {
         "brand":"Google Chrome",
         "version":"100"
      }
   ],
   "fullVersionList":[
      {
         "brand":" Not A;Brand",
         "version":"99.0.0.0"
      },
      {
         "brand":"Chromium",
         "version":"100.0.4896.127"
      },
      {
         "brand":"Google Chrome",
         "version":"100.0.4896.127"
      }
   ],
   "mobile":false,
   "model":"",
   "platformVersion":"12.2.1"
}

En esta página