Web SDK JavaScript ライブラリのインストール

Web SDK タグ拡張機能 ​ を使用しない場合は、Adobe CDN でホストされているスタンドアロンのJavaScript ライブラリを参照して、web SDKをインストールできます。 ライブラリを直接参照するか、ダウンロードして独自のインフラストラクチャにホストすることができます。 縮小された形式と完全な形式で利用できます。

Web SDK ライブラリは、次の URL 構造を使用して利用できます。

  • 縮小: https://cdn1.adoberesources.net/alloy/<VERSION>/alloy.min.js
  • フル: https://cdn1.adoberesources.net/alloy/<VERSION>/alloy.js

URL に含める最新バージョンについては、Web SDK リリースノート ​ を参照してください。 例えば、バージョン 2.19.1 のフルバージョンの URL は https://cdn1.adoberesources.net/alloy/2.19.1/alloy.js です。

ベースコードとライブラリローダーの追加

追加するコードは、次の 2 つのセクションで構成されます。

  • ベースコード:Web SDKが非同期で読み込まれるときに、コマンドをキューに入れることでブートストラップを可能にします。 詳しくは、​ ベースコード ​ を参照してください。 Adobeでは、ページ読み込み時に web SDK コマンドを呼び出す際の競合状態を避けるために、ライブラリを非同期で読み込む際にベースコードを使用することをお勧めします。
  • ライブラリローダー:JavaScript ライブラリ全体を読み込みます。

Web SDKを呼び出す可能性のあるスクリプトの前に、次のコードブロックをできるだけ <head> タグの高い位置に追加します。

<!-- Base code -->
<script>
  !function(n,o){o.forEach(function(o){n[o]||((n.__alloyNS=n.__alloyNS||
  []).push(o),n[o]=function(){var u=arguments;return new Promise(
  function(i,l){n.setTimeout(function(){n[o].q.push([i,l,u])})})},n[o].q=[])})}
  (window,["alloy"]);
</script>
<!-- Library loader -->
<script src="https://cdn1.adoberesources.net/alloy/<VERSION>/alloy.min.js" async></script>

Web SDKを同期的に読み込む場合は、ライブラリを読み込む際に async 属性を削除できます。 async 属性ブロックを削除すると、ブラウザーがライブラリを取得して実行する間、HTMLは解析を行います。 プライマリコンテンツをユーザーに表示する前にこのような追加の遅延を行うことは、通常はお勧めしませんが、組織のニーズに応じて合理的な場合があります。

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1