Client Hints und die Adobe Target Delivery API

Client Hints müssen bei der Angebotsanfrage an Adobe Target gesendet werden.

Im Allgemeinen wird empfohlen, alle verfügbaren Client Hints an Target zu senden. Weitere Informationen finden Sie User-agent und Client Hints im Abschnitt Client-seitige Implementierung.

Bereitstellungs-API - Direktaufrufe

Vom Browser

In diesem Fall sendet der Browser Client Hints mit niedriger Entropie automatisch über Anfrage-Header an Target. Es gibt jedoch einige Einschränkungen auf Browser-Ebene bei dieser Implementierung. Erstens - es werden keine Client Hints-Header vom Browser gesendet, es sei denn, die Anfrage erfolgt über HTTPS. Zweitens - Client-Hinweise werden bei der ersten Anforderung nicht an Target auf der Seite gesendet. Client Hints-Header werden nur bei der zweiten Anfrage und danach bei allen Anfragen gesendet. Dies bedeutet, dass die Zielgruppensegmentierung und Personalisierung vom Target beim ersten Seitenbesuch nicht durchgeführt werden kann. Um diese beiden Einschränkungen zu umgehen, empfehlen wir dringend, die User Agent Client Hints-API im Browser zu verwenden, um die Client Hints direkt zu erfassen und über die Anfrage-Payload zu senden.

Von einem Server

In diesem Fall müssen die Client Hints manuell vom Browser an Target auf der Bereitstellungs-API-Anfrage weitergeleitet werden.

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
    }]
  }
}'

Formatierung

Die Client Hints-Header Sec-CH-UA und Sec-CH-UA-Full-Version-List haben ein anderes Format als die Ergebnisse aus der Browser-API für Client Hints (navigator.userAgentData.brands/navigator.userAgentData.getHighEntropyValues). Beide Formate werden von der Bereitstellungs-API akzeptiert. Die Bereitstellungs-API normalisiert die Werte in das in den Anfragekopfzeilen verwendete Format. Dies ist wichtig, wenn Sie in Profilskripten auf Client-Hinweise zugreifen.