Client Hints と Adobe Target Delivery API

最終更新日： 2024年7月22日

作成対象：

  • 開発者

Client Hints は、オファーリクエストで Adobe Target に送信する必要があります。

通常は、使用可能なすべての Client Hints を Target に送信することをお勧めします。 詳しくは、 クライアントサイド実装の節の User-agent and Client Hints を参照してください。

配信 API の直接呼び出し

ブラウザーから

この場合、ブラウザーは低エントロピーの Client Hints を送信し、リクエストヘッダーを介して自動的に Target します。 ただし、この実装にはブラウザーレベルのいくつかの制限があります。 最初 – リクエストが https で行われない限り、Client Hints ヘッダーはブラウザーから送信されません。 2 番目 – ページに Target まれる最初のリクエストでは Client Hints は送信されません。 Client Hints ヘッダーは、2 番目のリクエスト以降のすべてのリクエストでのみ送信されます。 つまり、オーディエンスのセグメント化とパーソナライゼーションは、Target ーザーが最初のページ訪問では実行できません。 これらの両方の制限を回避するには、ブラウザーで User Agent Client Hints API を使用して、Client Hints を直接収集し、リクエストペイロードで送信することを強くお勧めします。

サーバーから

この場合、Client Hints は、配信 API リクエストに応じて、ブラウザーから Target に手動で転送する必要があります。

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

形式

クライアントヒントヘッダー Sec-CH-UA および Sec-CH-UA-Full-Version-List の形式は、クライアントヒントブラウザー API （navigator.userAgentData.brands/navigator.userAgentData.getHighEntropyValues）の結果とは異なります。 これらの形式は両方とも、配信 API で受け入れられます。 配信 API は、値をリクエストヘッダーで使用される形式に正規化します。これは、プロファイルスクリプトで Client Hints にアクセスする場合に注意する必要があります。

前のページ考慮事項と既知の制限事項
次のページ配信 API

Target