bufferRequests

最終更新日： 2024年7月18日
  • トピック：

作成対象：

  • 管理者
  • 開発者

bufferRequests() メソッドを使用すると、イメージリクエストをAdobeに送信する代わりに、現在のページでキャッシュできます。 このメソッドのトリガーは、ブラウザーが navigator.sendBeacon() をサポートしていない場合や、ページの読み込み時に画像リクエストがキャンセルされる場合に便利です。 Safari などの多くのバージョンの WebKit ブラウザーは、リンクをクリックするとイメージリクエストを停止する動作を通常示します。 bufferRequests() の方法は、AppMeasurement v2.25.0 以降のすべてのバージョンで使用できます。

同じブラウザーセッション内の後続のページで t() または tl() を呼び出し、そのページでまだ bufferRequests() が呼び出されていない場合、そのページのイメージリクエストに加えて、すべてのバッファーされたリクエストが送信されます。 バッファ・リクエストは正しい順序で送信されます。この順序では、現在のページのイメージ・リクエストが最後に送信されます。

TIP
バッファーされた要求のタイムスタンプは、データが送信されたページと共有されます。 バッファされた要求が記録される正確な秒数でより正確な情報が必要な場合は、要求をバッファする前に timestamp ページ変数を設定できます。 この変数を使用する場合は、「タイムスタンプ オプションが有効になっていることを確認します。有効になっていなければ、タイムスタンプが付いたすべてのヒットが完全に失われます。

制限事項

bufferRequests() メソッドを呼び出す場合、次の制限事項に注意してください。 このメソッドでは Window.sessionStorage を使用するので、次のように多くの同じ制限が適用されます。

  • 宛先リンクは、同じドメインとサブドメインに存在する必要があります。 バッファーされたリクエストは、ドメインとサブドメインの両方が同じAdobe Analytics実装を持っている場合でも、両方のドメインで機能しません。 また、この制限により、バッファーされたリクエストを使用して離脱リンクを追跡することはできません。
  • 宛先リンクは、現在のページと同じプロトコルを使用する必要があります。 HTTP と HTTPS の間でバッファーされた要求を送信することはできません。
  • バッファ・リクエストは、最初に bufferRequests() を呼び出さずに t() または tl() を呼び出すか、ブラウザまたはタブが閉じられるまで保存されます。 Adobeに送信する前にブラウザ・セッションが終了すると、未送信のバッファ・リクエストは永久に失われます。
  • ブラウザーが Web Storage API または JSON API をサポートしていない場合、警告がブラウザーコンソールに出力され、AppMeasurementは t() メソッドを使用してイメージリクエストを直ちに送信しようとします。

Web SDK のバッファー済みリクエスト

Web SDK は現在、リクエストをバッファーする機能を提供していません。

Adobe Analytics拡張機能を使用したバッファーされたリクエスト

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

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

t() または tl() を呼び出す前に、bufferRequests() メソッドを呼び出します。 bufferRequests() が呼び出されると、後続のトラッキングコールは、Adobeデータ収集サーバーに送信されるのではなく、セッションストレージに書き込まれます。

// Instantiate the tracking object
var s = s_gi("examplersid");

// Flag the request to be buffered
s.bufferRequests();

// The t() or tl() method then writes the data to session storage instead of sending it to Adobe
s.tl(true,"o","Example link click");

// On a subsequent page, the tracking call sends both the above link tracking call and the page view call
s.t();

Analytics