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

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

概要

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

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

オリジナルの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アーカイブの有効化

最初のステップは、zipアーカイブの生成を有効にして、Tealium iQから必要なファイルを取得できるようにすることです。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構成で指定された場所のサーバー上で解凍します。distro.zipには以下のファイルが含まれているはずです：
   • utag.js：ユニバーサルタグで、ロードルールと条件に基づいてタグをロードし実行するコードをロードし実行します。
   • utag.#.js：個々のタグコードで、#はタグのUIDを表します。例：utag.1.js。
   • utag.sync.js：A/Bテストと多変量テストタグをサポートするためのページロード前に実行するコード。
   • utag.v.js：セッションカウントと課金に必要なファイル。
   • mobile.html：モバイル構成ファイル。
3. コードセンターからのコードを使用して、utag.jsコードスニペットをあなたのウェブサイトに追加します。
4. ブラウザのコンソールを使用して、あなたのウェブページがutag.jsをあなたの自己ホスティング場所からロードしていることを確認します（例えば、tags.tiqcdn.comではない）。

バージョンラベルの使用

最後に、utagファイルをライブサイトで利用可能にした後、内部のソフトウェアリリースサイクルを完了したバージョンを示すために、Tealium iQで**バージョンラベル**を使用することをお勧めします。

SHA256ダイジェスト署名

追加のセキュリティのために、distro.zipをダウンロードした公開詳細エリアからDistro Verificationリンクをクリックして、ファイルの内容を確認します。Distro Verificationは、アーカイブ内の各ファイルのSHA-256チェックサムを表示します。

あなたのホストした場所のファイルのダイジェスト署名を確認するために、お気に入りのチェックサムユーティリティを使用します。次の図は、Tealium iQで見た値と一致するutag.jsのSHA-256チェックサムを表示しています。