utag.sync.jsの動作方法
この記事では、A/Bテストと多変量タグを実装するためにutag.sync.jsを使用する方法について説明します。
前提条件
この記事で説明する手順を完了するには、以下の権限が必要です：
- タグテンプレートの管理
タグテンプレートを追加し、管理するためにこの権限が必要です。 - JavaScriptドラフトのプロモーション
JavaScriptの拡張機能を公開するためにこの権限が必要です。
動作方法
始める前に、同期（sync）と非同期（async）のJavaScriptの違いと、それがiQタグ管理のインストールにどのように関連するかを理解することが重要です。(詳細を学ぶ)。
この記事で説明するutag.sync.jsスクリプトは、Adobe TargetやOptimizelyなどのA/Bテストと多変量テストタグをサポートするためにページに追加できる追加のファイルです。このスクリプトはページコードの<head>セクションに配置され、最も一般的なベンダー要件に準拠するために同期的にロードされます。ファイルの内容はiQタグ管理で管理されます。
この機能は、Tealium Flicker-Free Adobe Targetソリューションを使用する際に必要です。
utag.sync.jsの有効化
デフォルトでは、utag.sync.jsファイルはiQタグ管理のアカウント/プロファイルを保存して公開したときには公開されません。まず、プロファイルレベルで有効化、保存、適用する必要があります。
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)
1つ以上の公開環境：Dev、QA、Prod、またはCustom。
例：
<script src="https://tags.tiqcdn.com/utag/[account]/[profile]/[env]/utag.sync.js"></script>
アカウントのCode Centerから特定のスクリプトを取得するための手順は以下のとおりです：
- 管理メニューでCode Centerをクリックします。Code Centerダイアログが表示されます。
- Tealium Scriptタブには、ファイルに切り取って貼り付けることができるコードが表示されます。
utag.sync.jsの配置のサンプルHTMLを表示するためにSample HTMLタブをクリックします。- 必要に応じてサンプルHTMLを切り取り、ページで使用します。
- OKをクリックし、次にキャンセルをクリックしてウィンドウを閉じます。
ユニバーサルデータオブジェクト（UDO）へのアクセス
utag.sync.jsファイルは、ユニバーサルデータオブジェクト（utag_data）よりも先にロードされる可能性があるため、コードはこれらの変数を参照できないかもしれません。使用するカスタムコードを十分にテストすることを確認してください。
本番環境への公開
プロファイルでutag.sync.jsが有効化されると、その後のProd環境へのすべての公開にこのファイルが含まれます。AdvancedとBasicのJavaScript拡張機能は特定の環境への公開から制限することができ、これにより同期変更をデプロイする環境に対する制御がよりエンリッチメントされます。
最終更新日 :: 2024年March月29日