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

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

概要

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

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

自己ホスティングされたユニバーサルタグ

自己ホスティングされたユニバーサルタグの場合、コードスニペットのtags.tiqcdn.comをタグをホスティングしているサーバーのアドレスに置き換えます：

<!-- 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>

タグをサイトに追加する方法の詳細については、ユニバーサルタグ（utag.js）のインストールを参照してください。

.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内のロジックとデフォルトの場所に基づいて動的に行われます。

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

1. 管理メニューで公開構成の構成をクリックします。公開構成ダイアログが表示されます。
2. 一般公開タブの公開URLセクションで、自己ホスティングファイルのドメインと完全なパスを入力します（実際のファイル名は省略）。例：//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. ブラウザのコンソールを使用して、ウェブページがTealium（例：tags.tiqcdn.com）ではなく、自己ホスティングの場所からutag.jsをロードしていることを確認します。

バージョンラベルの使用

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

SHA256ダイジェスト署名

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

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