Klienttips och Adobe Target Delivery API

Klienttips måste skickas till Adobe Target för erbjudandebegäran.

I allmänhet rekommenderas du att skicka alla tillgängliga klienttips till Target. Mer information finns i Användare-agent och Klienttips i avsnittet Implementering på klientsidan.

Direktanrop till leverans-API

Från webbläsaren

I det här fallet skickar webbläsaren automatiskt tips för klienten med låg entropi till Target via begäranderubriker. Men det finns ett par begränsningar på webbläsarnivå för den här implementeringen. Först skickas inga tips för klienttips från webbläsaren om inte begäran görs via https. Andra - Klienttips skickas inte vid den första begäran till Target på sidan. Klienttipsrubriker skickas endast för den andra begäran och alla begäranden därefter. Det innebär att målgruppssegmentering och personalisering inte kan utföras av Target vid första sidbesöket. För att komma runt båda dessa begränsningar rekommenderar vi att du använder API:t för användaragentens klienttips i webbläsaren för att samla in klienttips direkt och skicka dem på nyttolasten för begäran.

Från en server

I det här fallet måste klienttipsen vidarebefordras manuellt från webbläsaren till Target på förfrågan för leverans-API.

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

Formatering

Klienttipsrubrikerna Sec-CH-UA och Sec-CH-UA-Full-Version-List har ett annat format än resultaten från klienttipsens webbläsar-API (navigator.userAgentData.brands/navigator.userAgentData.getHighEntropyValues). Båda dessa format accepteras av leverans-API. Leverans-API:t normaliserar värdena till det format som används i begäranderubrikerna, vilket är viktigt att tänka på vid åtkomst av klienttips i profilskript.