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構成で指定された場所のあなたのサーバーで解凍します。
3. コードセンターからのコードを使用して、utag.jsコードスニペットをあなたのウェブサイトに追加します。
4. ブラウザのコンソールを使用して、あなたのウェブページがutag.jsをあなたの自己ホスティングの場所からロードしていることを確認します（例えば、tags.tiqcdn.comではない）。

バージョンラベルの使用

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

SHA256ダイジェスト署名

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

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