mbox.js の機能

技術担当者が、mbox.js の実装とユーザーのサイトに与える影響を理解するのに役立つ情報を紹介します。

重要

mbox.jsの提供終了:2021年3月31日をもって、mbox.jsライブラリ Adobe Target はサポートされなくなります。2021年3月31日以降、mbox.jsからのすべての呼び出しが正常に失敗し、Targetアクティビティが実行されているページにはデフォルトコンテンツが提供されます。

サイトに発生する可能性のある問題を回避するため、すべてのお客様に、新しいAdobe Experience Platform Web SDKまたはat.js JavaScriptライブラリの最新バージョンに今日までに移行することをお勧めします。 詳しくは、概要:クライアント側webのターゲットを実装します。

Target Standard では、mbox.js バージョン 58 以降が必要です。mbox.js のダウンロードおよび更新の手順については、「mbox の実装」を参照してください。

Target Standard では、mbox.js は別の JavaScript ファイル target.js を呼び出します。Target.js は Adobe がホストし、自動的に更新します。target.js を更新するための操作は不要で、クライアント固有のカスタマイズもありません。

Target.js により、target-global-mbox という mbox がページの <head> セクションに作成されます。

Target.js は、 Extra JavaScript フィールドの mbox.js に追加された JavaScript コードの行によって mbox.js から呼び出されます。target.js を無効にするには、コードのこの行を含めないようにするしかなく、その場合 Target も無効になります。

Target.js の Target での機能は 2 つあります。

  • DOM 操作
  • Visual Experience Composer のビジュアル要素の有効化

DOM 操作

Target.js は、Standard で使用される DOM 操作ライブラリを制御します。Web サイトのコンテンツを表示するために、target.js は sizzle.js(バージョン 1.10.8-pre)を参照します。Sizzle.js は、HTML 要素セレクターを有効にします。sizzle.js 以外は、ネイティブの JavaScript のみが使用されます。jquery は不要です。

さらに、DOM をポーリングするために次のスニペットが使用されます。

https://github.com/dperini/ContentLoaded

Target.js と Visual Experience Composer

Visual Experience Composer を使用アクティビティのエクスペリエンスを設定する場合、Web ページは iFrame で開きます。iFrame がロードされると、Standard は HTML5 postMessage API 呼び出しを送信します。Target.js は postMessage 呼び出しを検出して次の JavaScript ライブラリを Web サイトに含めます。

  • サムネールの生成用: https://html2canvas.hertzen.com/
  • クロスドメインクエリ用: Admin.js、CDQ.base.js、CDQ.host.js、admin.css(iFrames 間でメッセージを送信するために使用)。これらのスクリプトにより、Adobe はページ間でデータを送信できます。

角度サイトとシングルページアプリケーションの考慮事項

Target を角度サイトまたはシングルページアプリケーション(SPA)で実装する場合、mbox.js ではなく at.js ライブラリを使用する必要があります。

詳しくは、「at.js の実装」を参照してください。

このページ