utag.sync.jsの仕組み | インストール

前提条件

この記事で説明されている手順を完了するには、以下の権限が必要です：

タグテンプレートの管理
この権限は、タグテンプレートを追加および管理するために必要です。
JavaScriptドラフトの昇格
この権限は、JavaScript拡張機能を公開するために必要です。

動作原理

始める前に、同期（sync）と非同期（async）のJavaScriptの違いと、それがiQタグ管理インストールにどのように関連するかを学ぶことが重要です。(詳細を学ぶ)。

この記事で説明されているutag.sync.jsスクリプトは、Adobe TargetやOptimizelyなどのA/Bおよび多変量テストタグをサポートするためにページに追加できる追加ファイルです。このスクリプトはページコードの<head>セクションに配置され、最も一般的なベンダー要件に準拠して同期的にロードされます。ファイル内容はiQタグ管理で管理されます。

この機能は、TealiumのフリッカーフリーAdobe Targetソリューションを使用する際に必要です。

utag.sync.jsの有効化

デフォルトでは、iQタグ管理アカウント/プロファイルを保存して公開してもutag.sync.jsファイルは公開されません。まずプロファイルレベルで有効にして保存し、適用する必要があります。

utag.sync.jsスクリプトを有効にするには、次の手順に従います：

保存/公開をクリックします。
構成公開構成をクリックします。
一般公開タブから、実装セクションまでスクロールダウンし、utag.sync.jsファイルを生成オプションをオンに切り替えます。
保存をクリックします。
変更を希望する環境に保存して公開します。

このプロファイルの最新バージョンをすべての公開環境に公開する必要があります。そうしないと、utag.sync.jsファイルを参照するページのロードが防止されます。

有効にすると、utag SyncスコープがJavaScriptまたはAdvanced JavaScript拡張機能のスコープドロップダウンリストに表示されます。

utag.sync.jsファイルの編集

次の2つの方法のいずれかを使用してコードを追加できます：

推奨：utag Syncスコープを持つ拡張セット
タグテンプレートを編集します。

utag.sync.jsファイルの内容を次のように追加、編集、または変更します：

変更するファイルのJavaScriptコードまたはAdvanced JavaScriptコード拡張機能に移動します。
拡張機能の名前をクリックして展開します。
スコープドロップダウンリストからutag Syncを選択します。
構成セクションで、編集ボックスにカーソルを置き、必要に応じて内容を追加、編集、または変更します。
変更を保存して公開します。

サイトにutag.sync.jsを追加する

utag.sync.jsスクリプトは、ページの<head>セクションに配置するよう設計されています。ページがレンダリングされる際の最適なユーザーエクスペリエンスのために、通常ベンダーコードがロードされる場所と同じ場所にスクリプトを配置することが望ましいです。

utag.sync.jsファイルへのパスには、次のパラメータが含まれます：

account
iQタグ管理アカウントの名前。
profile
iQタグ管理アカウント内のプロファイルの名前。デフォルト値はmainです。
environment (env)
一つ以上の公開環境：Dev、QA、Prod、またはCustom。

例：

<script src="https://tags.tiqcdn.com/utag/[account]/[profile]/[env]/utag.sync.js"></script>

アカウントの環境管理画面から特定のスクリプトを取得するには、次の手順に従います：

管理メニューで環境管理をクリックします。環境管理ダイアログが表示されます。
Tealiumスクリプトタブには、ファイルにコピーして貼り付けるためのコードが表示されます。
サンプルHTMLタブをクリックして、utag.sync.jsの配置のサンプルHTMLを表示します。
必要に応じてサンプルHTMLをコピーしてページに使用します。
OKをクリックしてからキャンセルをクリックしてウィンドウを閉じます。

ユニバーサルデータオブジェクト（UDO）へのアクセス

utag.sync.jsファイルは、ユニバーサルデータオブジェクト（utag_data）よりも先にロードされる可能性があるため、そのコードはこれらの変数を参照できないかもしれません。使用するカスタムコードを徹底的にテストすることを確認してください。

本番環境への公開

プロファイルでutag.sync.jsが有効になると、Prod環境への後続の公開にはこのファイルが含まれます。AdvancedおよびBasic JavaScript拡張機能は、特定の環境への公開から制限される場合があり、これにより、同期変更をデプロイする環境をより詳細に制御できます。