documentUnloading （Web SDK）

documentUnloading プロパティを使用すると、ブラウザーのsendBeacon メソッドを使用してAdobeにデータを送信できます。 このメソッドは、JavaScript言語自体ではなく、ブラウザーのWeb APIの一部です。 一般的なリクエストに時間がかかりすぎると、ブラウザーはリクエストをキャンセルできます。 Web SDKにsendBeaconを使用するように指示して、ページから移動した後でリクエストがバックグラウンドで実行されるようにすることができます。 このプロパティを有効にすると、アンロード時にブラウザーによってデータリクエストがキャンセルされるのを防ぐことができます。

Web SDKは、訪問者IDが確立された後にのみsendBeaconを使用します。 IDが確立される前（新規訪問者の最初のイベントなど）、Web SDKは、応答でIDを受信できるように、fetchを使用してEdge Networkにイベントを送信します。 ​ バージョン 2.36.1以降、これらのfetch要求はkeepalive オプションを使用して、訪問者がページから移動してもブラウザーが要求の送信を完了するようにします。

一部のブラウザーでは、一度にsendBeaconで送信できるデータ量に64 KBの制限があります。 keepaliveを使用するfetch要求にも同じ制限が適用されます。 ペイロードが大きすぎるため、ブラウザーがイベントを拒否した場合、Web SDKは通常のトランスポート方式を使用してフォールバックします。 特定のブラウザーでより大きなペイロードが許可されている場合でも、Adobe データ収集サーバーはペイロードを64 KBに切り捨てます。

sendEvent コマンドの実行時にdocumentUnloading ブール値を設定します。 デフォルト値はfalseです。 sendBeacon メソッドを使用してAdobeにデータを送信する場合は、このプロパティをtrueに設定します。

alloy("sendEvent", {
  "xdm": adobeDataLayer.getState(reference),
  "documentUnloading": true
});

documentUnloadingと共に送信されたイベントを検証 validate

sendBeacon リクエストが完了する前にページが移動した場合、Chrome開発者ツールは、ブラウザーが引き続きリクエストを送信する場合でも、リクエスト（タイプ ping）を​ （キャンセル済み） ​として表示できます。 keepaliveでfetchを使用して送信されたリクエストは、同様にキャンセルされたとして表示できます。 このラベルだけでは、データが失われたかどうかを確認することはできません。

Web SDKのデバッグログも配信を確認できません。 ブラウザーはsendBeacon リクエストに対する応答を返さないため、ログには、Web SDKがsendBeaconを使用してリクエストを送信したことのみが示されます。

ナビゲーションを再生する前に、検査ツールを開きます。 キャプチャされたサーバーレスポンスを探すか、接続されたEdge Trace/Assurance セッションで、Edge Networkで受信リクエストを探します。 共有された検査ワークフローとその証拠の制限については、要求を中止するを参照してください。 Edgeの領収書の確認だけでは、下流の処理を確立することはできません。

イベントが失われる場合 data-loss

documentUnloading プロパティは、ページの読み込み解除時にWeb SDKがまだ送信していないイベントに役立ちません。 例えば、Web SDKは、同意がpending （defaultConsentを参照）の間、または処理中のID リクエストが完了するのを待つ間、イベントを保持します。 2つ目のケースでは、デバッグログにDelaying request while retrieving ECID from server.が表示されます

Web SDK タグ拡張機能を使用したドキュメントのアンロード

Web SDK タグ拡張機能を使用する場合、Send event アクションを設定すると、ドキュメントがアンロードされます チェックボックスを使用できます。