[Alpha]{class="badge informative"}

コンテキストと転送ヘッダー

Web SDKは、ブラウザーでページ URL、画面サイズ、タイムゾーンなどの詳細をページから読み取り、各イベントに追加します。 サーバーには読み込むページがないので、Server SDKはコンテキストデータのセットを小さくします。 また、訪問者のリクエストから詳細を転送して、Edge Networkがそれらを使用できるようにします。

実装の詳細 implementation-details

SDKは、すべてのイベントにxdm.implementationDetails オブジェクトを追加します。 このオブジェクトは、イベントを送信したライブラリを識別します。

{
  "implementationDetails": {
    "name": "https://ns.adobe.com/experience/alloy-node",
    "version": "0.2.1",
    "environment": "server"
  }
}

versionの値が、インストールされている@adobe/alloy-node パッケージのバージョンと一致しています。 このデータをオフにすることはできません。

受信リクエストを渡す request

訪問者に関するコンテキストを追加するには、受信リクエストをforRequestにrequest プロパティとして渡します。

const visitor = alloy.forRequest({ request: req });

request値は、次を含むheaders プロパティを持つ任意のオブジェクトにできます。

プレーンオブジェクトを自分で作成する場合は、{ headers: { "user-agent": "..." } }などの小文字のヘッダー名を使用します。

転送されたヘッダー forwarded-headers

requestを渡すと、SDKは、次のヘッダーをそのヘッダーからEdge Networkに送信する各リクエストにコピーします。 これらのヘッダーがなければ、Edge Networkはサーバーを訪問者として見なし、デバイスと場所の検索は訪問者ではなくサーバーを表します。

SDKは、このテーブルのヘッダーのみを転送します。 訪問者のCookie、Authorization、Refererのヘッダーは転送されません。

Edge Networkでは、データストリームで有効になっている場合に、位置情報やデバイス検索などの機能にこれらのヘッダーが使用されます。 サーバーがプロキシまたはロードバランサーの背後で実行されている場合は、訪問者の実際のIP アドレスにX-Forwarded-ForまたはForwardedが設定されていることを確認します。

ブラウザーは、デフォルトでは、低エントロピーのクライアントヒントをいくつか送信するだけです。 その他の応答を受け取るには、サーバーがブラウザーに対してAccept-CH応答ヘッダーを付けて要求する必要があります。

参照元ヘッダーのページ URL page-url

受信リクエストにReferer ヘッダーがある場合、SDKはその値をxdm.web.webPageDetails.URLとして使用します。 Referer ヘッダーには、リクエストを行ったページのアドレスが含まれているため、次の場合にのみ正確です。

xdm オブジェクトで設定した値は、Referer値よりも優先されます。 ページ URLを明示的に設定するには：

await visitor.sendEvent({
  xdm: {
    eventType: "web.webpagedetails.pageViews",
    web: {
      webPageDetails: {
        URL: `https://www.example.com${req.url}`
      }
    },
    identityMap: {
      Email: [{ id: "visitor@example.com", primary: true }]
    }
  }
});

SDKで収集されないデータ not-collected

Web SDKがブラウザーで収集できる次のデータは、サーバー上に信頼できるソースがないので、サーバーSDKは追加しません。

ブラウザーがサーバーに送信した場合など、アプリケーションがこれらの値を認識している場合は、自分でxdm オブジェクトに追加します。