ビルド

ビルドは、クライアントデバイス上で実行されるすべてのコードを含むファイルのセットです。

これは、ライブラリ内で指定した変更と、それ以前に送信、承認、または公開されたすべてのものの組み合わせです。

ビルドは、互いに参照するクライアント側コードファイルで構成されます。 これらのファイルは、ライブラリ用に選択した環境とホストを使用してホスト場所に配信されます。 サイト上でデプロイするコードは同じ場所を示すので、ユーザがサイトやアプリケーションにアクセスするとファイルが読み込まれる可能性があります。

ファイルの内容 file-contents

ライブラリは、そこに含める必要のあるタグリソース(拡張機能、ルール、データ要素)のセットを定義します。

ビルドには、すべてのモジュールコード(拡張機能開発者によって指定)と、ライブラリ内に含まれるリソースを強化するために必要な設定(ユーザーが入力)が含まれています。 例えば、ルール内で使用されていないアクションを拡張機能が提供している場合、それらのアクションを実行するコードはビルド内には含まれません。

ビルドは、メインライブラリファイルに分割され、多数の小さなファイルになる可能性があります。 メインライブラリファイルは埋め込みコードで参照され、実行時にページに読み込まれます。 次が含まれます。

  • ルールエンジン
  • すべての拡張機能の設定
  • すべてのデータ要素のコードと設定
  • すべてのルールイベントコードと設定
  • すべての条件コードと設定
  • 「ライブラリ読み込み済み」または「ページボトム」のイベントが含まれるルールのイベントコードと設定(すぐに必要となることがわかっているため)。

小さなファイルには、必要に応じてページに読み込まれる個々のアクションのコードと設定が含まれています。 ルールがトリガーされ、実行する必要があるアクションなどの条件が評価されると、小さいファイルの 1 つから、その特定のアクションに必要なコードと設定が取得されます。 つまり、必要なアクションを実行するために必要なコードのみがページに読み込まれるので、メインライブラリをできるだけ小さくすることができます。

ファイル形式 file-format

ビルド用のデフォルトのファイル形式は、拡張機能、データ要素およびルールを希望する方法で実行するために必要なすべてのコードを含むファイルのパッケージです。

ただし、場合によっては、実行可能なクライアント側コードファイルではなく、ユーザーが .zip アーカイブを望むこともあります。 例えば、自身でビルドをホストし、そのビルドを別のデプロイメントで使用する場合は、アーカイブを作成できます。 ライブラリフィールドへの自己ホスト型パスで何らかの値を指定すると、環境を保存できます。 新しいコードと共に、アーカイブされたダウンロードへのリンクが利用可能になります。 ライブラリが構築されたら、Akamai に zip ファイルをデプロイし、assets.adobedtm.com/... からダウンロードするオプションがあります。

NOTE
ビルドを作成するまで、その場所には何も存在しません。

ファイル形式に関係なく、ビルドは常にホストで指定された場所に配信されます。

ビルドを完了するには、ライブラリを選択し、公開プロセスのそのレベルで使用可能なビルドオプション(開発用ビルド、ステージング用ビルドなど)を選択します。

縮小化 minification

縮小化では、ファイルからの実行に不要なデータを削除することで、帯域幅コストを削減し、速度を向上させます。

Experience Platformなら、パフォーマンスを向上させるために、次のようなあらゆる要素を最小化できます。

  • メインのタグライブラリ
  • 拡張機能開発者が拡張機能の一部として提供するモジュールコード
  • Experience Platform ユーザーが提供するカスタムコード
NOTE
モジュールコードとカスタムコードが既に最小化されている場合は、Experience Platformが再度最小化します。 この2番目の縮小は、さらなるメリットをもたらしませんが、害を引き起こすことはなく、Experience Platformの複雑さが軽減され、メンテナンスが容易になります。

クライアントサイドで提供されるコードは、すべて縮小されたバージョンのコードを指します。 このことは、縮小されたファイルの標準的な命名規則に従ったファイル名に見られます。

launch-%environment_id%.min.js

縮小されていないコードを表示するには、ファイル名から .min を削除します。

launch-%environment_id%.js

拡張機能の開発者が拡張機能で縮小コードを提供する場合、Experience Platformは縮小されていないビルドで縮小されていないコードを提供しません。 同様に、Experience Platform ユーザーが縮小コードをカスタムコードボックスに入れた場合、そのコードは縮小されていないビルドでも縮小されます。 Experience Platformでは何も縮小しません。

縮小化について詳しくは、 このスタックパス記事を参照してください

ビルドを実行すると、最初に縮小されていないライブラリが構築され、次にライブラリ全体が一度に縮小されます。

ビルドの詳細を表示 build-details

IMPORTANT
ライブラリにはタグリソースのリビジョンが保存されますが、ビルド​は、サイトに配信されるファイルを含む、そのライブラリの特定時点のスナップショットです。

ビルドとビルドの詳細は、ライブラリ​または​ 環境 ​からアクセスして、現在のライブビルドを表示し、ビルドに含まれるもの(拡張機能、データ要素、ルール)を調べることができます。

ライブラリからのビルドの詳細の表示

タグプロパティで、公開フロー​を開き、ライブラリを選択します。

ライブラリを強調表示するデータ コレクション UIでの 公開フロー。

詳細パネルでは、次の項目を確認できます。

  • 前回のビルド環境 – 前回のビルドを受け取った環境にリンクします。 このライブラリがその環境の現在のビルドであるかどうかを示します(現在​または​現在)。

  • 現在のビルド – 現在その環境に存在するビルド。 公開されたライブラリの場合、このセクションの稲妻アイコンがライブ制作ビルドに表示されます。

  • リストされている各ビルドについて、次を表示できます。

    • ステータス - ビルドが作成された日時。
    • 環境 - ビルドがデプロイされた環境。
    • User - ビルドを作成したユーザー。

右側の詳細パネルに表示されるライブラリの詳細

環境からのビルドの表示

ビルドは、環境とその環境にビルドされたライブラリに関連付けられます。 ビルドには、コンパイルされたリソースが実際に含まれています。

詳細パネルから​ 環境 ​を選択します。 環境の詳細パネルには、最近のビルド、現在のライブビルド、および関連するライブラリのリストが表示されます。

現在のビルドを強調表示する 環境の詳細パネル。

次に、ビルドを選択して詳細を開きます。 ビルドの詳細には、そのビルドに含まれる​拡張機能、データ要素​および​ ルール ​が表示されます。

拡張機能、データ要素、ルールを強調する詳細を作成します。

NOTE
ビルドには、ライブラリにリストされているリソース以外のリソースを含めることができます。 ビルドにパッケージ化された​拡張機能、データ要素​および​ ルール ​には、ライブラリのコンテンツとアップストリームのコンテンツが含まれます。 これは、サイトまたはアプリに公開される完全なスナップショットです。

詳細パネルを使用して、環境​または​ ライブラリ ​に戻ります。

recommendation-more-help
experience-platform-help-tags