Sugerencias del cliente y Adobe Target Delivery API

Última actualización: 20 de julio de 2024

Creado para:

  • Desarrollador

Las Client Hints deben enviarse a Adobe Target en la solicitud de ofertas.

En general, se recomienda enviar todas las Client Hints disponibles a Target. Para obtener más información, consulte User-agent y Client Hints en la sección Implementación del lado del cliente.

Llamadas directas de API de envío

Desde el explorador

En este caso, el explorador enviará Client Hints de baja entropía a Target automáticamente a través de encabezados de solicitud. Sin embargo, existen un par de limitaciones a nivel de explorador con esta implementación. Primero: no se enviarán encabezados de Client Hints desde el explorador a menos que se realice la solicitud a través de https. Segundo: las Client Hints no se enviarán en la primera solicitud a Target en la página. Los encabezados de Client Hints solo se enviarán en la segunda solicitud y todas las solicitudes a partir de entonces. Esto significa que Target no puede realizar la segmentación y personalización de audiencias en la primera visita a la página. Para evitar ambas limitaciones, recomendamos encarecidamente utilizar la API de sugerencias del cliente del agente de usuario en el explorador para recopilar las sugerencias del cliente directamente y enviarlas en la carga útil de solicitud.

Desde un servidor

En este caso, las Client Hints deben reenviarse manualmente desde el explorador a Target en la solicitud de API de entrega.

curl -X POST 'http://mboxedge28.tt.omtrdc.net/rest/v1/delivery?client=myClientCode&sessionId=abcdefghijkl00014' -d '{
  "context": {
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Safari/537.36",
    "clientHints": {
      "Sec-CH-UA-Model": "iPhone",
      "Sec-CH-UA-Mobile": true,
      "Sec-CH-UA-Platform": "iOS",
      "Sec-CH-UA": "[ { \"brand\": \"Chromium\", \"version\": \"91\" }, { \"brand\": \" Not;A Brand\", \"version\": \"99\" } ]",
      "Sec-CH-UA-Full-Version-List": "[ { \"brand\": \"Chromium\", \"version\": \"91.1.1.1\" }, { \"brand\": \" Not;A Brand\", \"version\": \"99.1.1.1\" } ]",
      "Sec-CH-UA-Platform-Version": "10.0.0",
      "Sec-CH-UA-Arch": "x86",
      "Sec-CH-UA-Bitness": "64"
    }
  },
  "execute": {
    "mboxes": [{
      "name": "home",
      "index": 1
    }]
  }
}'

Formato

Los encabezados Sec-CH-UA y Sec-CH-UA-Full-Version-List de Client Hints tienen un formato diferente al de los resultados de la API del explorador de Client Hints (navigator.userAgentData.brands/navigator.userAgentData.getHighEntropyValues). La API de entrega acepta ambos formatos. La API de entrega normaliza los valores en el formato utilizado en los encabezados de solicitud, lo que es importante tener en cuenta al acceder a Client Hints en los scripts de perfil.

Página anteriorConsideraciones y limitaciones conocidas
Página siguienteAPI de entrega

Target