Client Hints e o Adobe Target Delivery API

As Client Hints devem ser enviadas para Adobe Target na solicitação de ofertas.

Geralmente, é recomendável enviar todas as Client Hints disponíveis para Target. Para obter mais informações, consulte User-agent e Client Hints na seção Implementação do lado do cliente.

Chamadas diretas da API de entrega

No navegador

Nesse caso, o navegador enviará Client Hints de baixa entropia para Target automaticamente por meio de cabeçalhos de solicitação. Mas há algumas limitações no nível do navegador com essa implementação. Primeiro - nenhum cabeçalho de Client Hints será enviado do navegador do, a menos que a solicitação esteja sendo feita em https. Segunda - As Client Hints não serão enviadas na primeira solicitação para Target na página. Os cabeçalhos de Client Hints serão enviados somente na segunda solicitação e em todas as solicitações a partir de então. Isso significa que a segmentação e a personalização do público-alvo não podem ser realizadas por Target na primeira visita à página. Para contornar essas duas limitações, recomendamos usar a API User Agent Client Hints no navegador para coletar as Client Hints diretamente e enviá-las na carga da solicitação.

De um servidor

Nesse caso, as Client Hints devem ser encaminhadas manualmente do navegador para Target na solicitação da 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
    }]
  }
}'

Formatação

Os cabeçalhos de Client Hints Sec-CH-UA e Sec-CH-UA-Full-Version-List têm um formato diferente dos resultados da API do navegador de Client Hints (navigator.userAgentData.brands/navigator.userAgentData.getHighEntropyValues). Ambos os formatos são aceitos pela API de entrega. A API de entrega normalizará os valores no formato usado nos cabeçalhos da solicitação, o que é importante ter em mente ao acessar as Client Hints nos scripts de perfil.