インストール

ユニバーサルデータオブジェクト（`utag_data`）

ユニバーサルデータオブジェクト（UDO）は、utag_dataというJavaScriptオブジェクトです。Webページの動的データは、このオブジェクトを通じてTealiumタグに渡されます。このオブジェクトのプロパティには、ビジネスに固有で、特定のベンダーに依存しない一般的な用語を使用します。

以下は、ユニバーサルタグutag.jsを読み込む_前_に行うutag_dataの宣言例です。

<!-- Tealium Universal Data Object -->
<script type="text/javascript">
  var utag_data={
      "page_type"     : "section",
      "site_section"  : "men",
      "page_name"     : "Men's Fashion | Acme Inc.",
      "country_code"  : "US",
      "currency_code" : "USD"};
</script>

詳細：

ユニバーサルタグ（`utag.js`）

ユニバーサルタグは、utag.jsという小さなJavaScriptコードです。サイトにサードパーティタグを読み込むために必要な、生成済みのコードがすべて含まれています。次のコードをページに挿入することで、タグ管理からタグを実行できるようになります。

<!-- Tealium Universal Tag -->
<script type="text/javascript">
  (function(a,b,c,d) {
      a='//tags.tiqcdn.com/utag/ACCOUNT/PROFILE/ENVIRONMENT/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のファイルパスには、次の属性が含まれます。

属性	説明	例
`account`	Tealiumアカウント名	`companyXYZ`
`profile`	Tealiumプロファイル名	`main`
`environment`	Tealium環境名	`prod`

たとえば、exampleアカウントのsampleプロファイルにあるprod環境の場合、スクリプトコードのa=行にある場所を次のコードに置き換えます。

//tags.tiqcdn.com/utag/example/sample/prod/utag.js

utag.sync.jsの詳細については、utag.sync.jsを参照してください。

コードの取得

アカウント名とプロファイル名が不明な場合は、Tealium管理者に問い合わせるか、アカウントで使用している権限システムに応じて、プラットフォームからコードスニペットを取得できます。

プラットフォーム権限

プラットフォーム権限を使用するアカウントでは、タグ管理 > 環境を管理に移動してコードスニペットを取得します。

クライアント側の管理メニューで、環境を管理をクリックします。環境を管理ダイアログが表示されます。
Webサイトで使用している環境の編集アイコンをクリックします。
環境を編集画面が表示されます。
コードスニペットセクションで、クリップボードにコピーをクリックしてコードスニペットを選択します。
スクリプトコードのa=行にある場所を置き換えます。

詳細については、環境の管理を参照してください。

レガシー権限

レガシー権限を使用するアカウントでは、タグ管理 > コードセンターに移動してコードスニペットを取得します。

管理メニューで、コードセンターをクリックします。コードセンターダイアログが表示されます。
サイドパネルで環境を選択します。
次のいずれかの方法で、テキストボックスに表示されているコードを選択します。
- クリックしてドラッグし、コード全体を選択します。
- コードにマウスポインターを合わせると表示されるすべて選択ボタンをクリックします。
コードをコピーします。
サイト作成ツールまたはバックエンドシステムにコードを貼り付けます。

詳細については、コードセンターを参照してください。

詳細については、環境の管理を参照してください。

コードの配置

Webサイトのすべてのページで、開始<body>タグの直後にユニバーサルタグのコードを貼り付けます。この位置に配置すると、最も多くのベンダーとの互換性が確保され、訪問が次のページに移動する前にサードパーティのトラッキングを完了できます。

次の例は、コードの配置場所を示しています。

<head>
  <!-- code -->
</head>
<body>
  <TEALIUM CODE SNIPPET GOES HERE>
  <!-- code -->
</body>

ユニバーサルタグutag.jsがどのように読み込まれるかを理解するには、処理順序の詳細を参照してください。

インストールの検証

utag.jsが正しくインストールされ、動作していることを検証するには、次のツールを使用します。

ユニバーサルタグ（utag）デバッガー

ユニバーサルタグデバッガー（「utagデバッガー」）を使用すると、サイト内を移動しながら、データレイヤーとトラッキングコールをリアルタイムで簡単に検証できます。Web Companionと似ていますが、utag.js内の各トラッキングイベントで取得されたデータに重点を置いています。

サイト内を移動したり、ページ内イベントをトリガーしたりすると、utag.jsによるトラッキングコールがツールに表示され、更新されます。

ユニバーサルタグデバッガーのインストール方法と使用方法については、詳細を参照してください。

Web Companion

Web Companionは、タグ構成の確認、サイト上のデータの検査、および新しい構成の迅速かつ簡単な作成とテストを可能にするブラウザツールです。このツールを起動することで、utag.jsライブラリがサイトで正しく読み込まれていることをすばやく検証できます。

アカウント情報
ページで現在実行されているアカウント、プロファイル、バージョン、環境がこのタブに表示されます。

ターゲット環境（デフォルトでは無効）
ページコードで検出された環境はオレンジ色の枠で示されます。現在表示している環境は青色で強調表示されます。環境を変更するには、読み込むターゲット環境をクリックしてから、ページを更新をクリックします。

この機能を有効にするには、パブリッシュ構成でWeb Companionの構成をオンにします。
環境を切り替えるその他の方法について確認してください。

タグと拡張機能タブ
このタブには、読み込まれたタグと、リクエストが正常に送信されたかどうかが表示されます。正常に完了した拡張機能も表示されます。

タイマー
各Tealium JavaScriptライブラリの読み込み時間と送信時間が、タブの下部に表示されます。

変更の保存
Web Companionを通じてプロファイルに適用した変更はブックマークレットの下部にあるキューに追加され、保存…ボタンをクリックするまでコミットされません。変更をコミットしない場合は、該当する変更の横にあるXボタンをクリックして、その変更をキューから削除することもできます。

Web Companionのインストール方法と使用方法については、詳細を参照してください。