utag.jsの自己ホスティング

始める前に、アカウントマネージャーに連絡して、この機能の契約条件を確認し、利用可能性と適切なライセンスが維持されていることを確認してください。

概要

Tealium iQは、utag.jsファイルを私たちのサーバーに公開します。utag.jsがあなたのウェブサイトに実装されると、そのファイルはtags.tiqcdn.comから取得されます。外部のJavaScriptファイルをロードできない（または他の制限がある）要件がある場合、これらのファイルを自分のサーバーに自己ホスティングする機能を提供しています。生成されたutagファイルは依然として私たちのサーバーに公開されますが、それらはまた.zipアーカイブで利用可能になり、あなたのシステムに簡単に転送することができます。

自己ホスティングの主な違いは、あなたのウェブサイトでutag.jsをロードするために使用されるコードスニペットにあります。そのファイルへのドメインとパスは、ファイルをホストするあなたのサーバーの場所を反映するように更新する必要があります。以下の例では、Tealiumの標準的な場所から自己ホスティングの場所へのURLの変更を見ることができます。

オリジナルのTealiumスニペット:

<!-- Tealium Universal Tag -->
<script type="text/javascript">
(function(a,b,c,d){
a='//tags.tiqcdn.com/utag/[ACCOUNT]/[PROFILE]/[ENV]/utag.js';
b=document;c='script';d=b.createElement(c);d.src=a;
d.type='text/java'+c;d.async=true;
a=b.getElementsByTagName(c)[0];a.parentNode.insertBefore(d,a)
})();
</script>

自己ホスティングスニペット:

<!-- Tealium Universal Tag -->
<script type="text/javascript">
(function(a,b,c,d){
a='//YOURDOMAIN.com/CUSTOM/PATH/[ENV]/utag.js';
b=document;c='script';d=b.createElement(c);d.src=a;
d.type='text/java'+c;d.async=true;
a=b.getElementsByTagName(c)[0];a.parentNode.insertBefore(d,a)
})();
</script>

.zipアーカイブの有効化

最初のステップは、iQから必要なファイルを取得するためにzipアーカイブを有効にすることです。zipアーカイブは、公開が行われるたびに作成されるdistro.zipという名前のファイルです。これには、utag.jsのインスタンスを実行するためのすべての必要なファイルが含まれています。このファイルはデフォルトでは生成されないため、有効にする必要があります。

distroファイルを有効にするには：

1. 管理メニューで、公開構成の構成をクリックします。公開構成ダイアログが表示されます。
2. 一般公開タブの実装セクションで、distro.zipファイルを生成する構成を見つけて、それをオンに切り替えます。
3. 保存をクリックします。

公開ファイルの場所を構成する

公開ファイルの場所は、utag.jsコードが後続のutagファイル（例えば、utag.4.js）をロードする場所を指示する構成です。utag.jsをロードするためのコードスニペットは、あなたのカスタムの自己ホスティングの場所を使用するように調整されますが、他のutagファイルのロードはutag.js内のロジックとTealiumのサーバーがデフォルトの場所に基づいて動的に行われます。

公開ファイルの場所を変更するには：

1. 管理メニューで、公開構成の構成をクリックします。公開構成ダイアログが表示されます。
2. 一般公開タブの公開URLセクションで、自己ホスティングのファイルへのドメインとフルパスを入力します。それぞれの環境について1つずつ（実際のファイル名は省略します）例えば、//example.com/custom/path/prod/
3. 保存をクリックします。

パスに環境を含めて、組み込みのDev、QA、Prodターゲットをサポートします。

すべての環境を公開する

これで、ダウンロード可能なdistro.zipファイルを有効にしました。コードセンターのコードスニペットが、Tealiumではなく、あなたがホストするutag.jsのカスタムロケーションを表示するようになったことに気付くでしょう。

最後のステップは、すべての環境ターゲット（Dev、QA、Prod）にプロファイルを公開することです。これにより、各環境に対してdistro.zipファイルが生成されます。

公開ワークフロー

distro.zipファイルをダウンロードして確認するには：

1. バージョンタブから、最後に公開されたバージョンを見つけ、各環境の公開詳細を展開し、Distro Zipファイルをダウンロードをクリックします。
2. distro.zipファイルを、カスタム公開URL構成で指定された場所のサーバー上で解凍します。
3. コードセンターからのコードを使用して、utag.jsコードスニペットをあなたのウェブサイトに追加します。
4. ブラウザのコンソールを使用して、あなたのウェブページがutag.jsをあなたの自己ホスティングの場所からロードしていること、そしてTealiumのドメインtags.tiqcdn.comからではないことを確認します。

バージョンラベルの使用

最後に、utagファイルをあなたのライブサイトで利用可能にした後、iQでリリースされたバージョンに**バージョンラベル**を付けるという最後のステップを踏むことをお勧めします。これにより、あなたのアカウントのユーザーに、あなたの内部ソフトウェアリリースサイクルを完了したバージョンがどれであるかを示すことができます。

SHA256ダイジェスト署名

さらなるセキュリティ上の懸念に対して、distro.zipをダウンロードした公開詳細エリアからDistro Verificationリンクをクリックすることで、アーカイブ内の各ファイルのSHA-256チェックサムを表示することができます。

その後、あなたのお気に入りのチェックサムユーティリティを使用して、ホストされた場所のファイルのダイジェスト署名を確認することができます。これがutag.jsのSHA-256チェックサムで、iQで見た値と一致します。