useBeacon

最新のブラウザーのほとんどに navigator.sendBeacon() ネイティブメソッドが含まれています。HTTP 経由で Web サーバーに少量のデータを非同期に送信します。useBeacon 変数が有効な場合、AppMeasurement は navigator.sendBeacon() メソッドを使用できます。これは、ページがアンロードされる前に情報を送信する離脱リンクなどの状況で役立ちます。

useBeacon が有効である場合、アドビに送信される次のヒットでは、標準の GET イメージリクエストの代わりに、ブラウザーの navigator.sendBeacon() メソッドが使用されます。この変数は、s.t()s.tl() の両方のイメージリクエストに適用されます。AppMeasurement 2.17.0 以降が必要です。

TIP
AppMeasurement は、離脱リンクイメージリクエストで useBeacon を自動的に有効にします。

訪問者が useBeacon をサポートしていないブラウザーを使用している場合、navigator.sendBeacon() 変数は無視されます。この変数を使用するには、AppMeasurement 2.16.0 以降が必要です。

Web SDK 拡張機能を使用した sendBeacon API の使用

Action Configuration 内の Document will unload チェックボックスにより、Adobeに送信されたデータが sendBeacon API を使用しているかどうかが決まります。

  1. Adobe ID 資格情報を使用して、Adobe Experience Platform Data Collection にログインします。
  2. 目的のタグプロパティをクリックします。
  3. 「​ ルール ​」タブに移動し、目的のルールをクリックします。
  4. ​ アクション ​ で、目的のアクションをクリックするか、「+」 イコンをクリックして新しいアクションを追加します。
  5. 「​ 拡張機能 ​」ドロップダウンリストを Adobe Experience Platform Web SDK に設定し、「​ アクションタイプ ​ を イベントを送信 に設定します
  6. 右側のチェックボックス ドキュメントをアンロードします をクリックします。

このチェックボックスをオンにすると、データは sendBeacon API を使用してAdobeに送信されます。 デフォルトでは選択解除されています。

Web SDK を手動で実装する sendBeacon API の使用

イベントを送信する際に、documentUnloadingtrue に設定します。 設定されていない場合、デフォルト値は false です。

alloy("sendEvent", {
  "documentUnloading": true,
  "xdm": {}
});

詳しくは、Web SDK ドキュメントの sendBeacon API の使用を参照してください。

Adobe Analytics拡張機能を使用したビーコンの使用

Adobe Analytics 拡張機能には、この変数を使用する専用のフィールドはありません。AppMeasurement 構文に従って、カスタムコードエディターを使用します。

AppMeasurementの s.useBeacon と Analytics 拡張機能のカスタムコードエディター

s.useBeacon 変数は、AppMeasurement がブラウザーの navigator.sendBeacon() メソッドを使用するかどうかを決定するブール値です。デフォルト値は false です。navigator.sendBeacon() の非同期性を使用する場合は、トラッキング関数を呼び出す前にこの変数を true に設定します。

s.useBeacon = true;
NOTE
トラッキングコールの実行後、この変数は false にリセットされます。実装が同じページ読み込みで複数のイメージリクエストを送信する場合(単一ページのアプリケーションなど)、各トラッキングコールの前にこの変数を true に設定します。
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690