UET の設定に関して知っておくべきすべてのこと

タグ マネージャーは、静的タグを、実装や更新が容易な動的タグに置換するものです。動的タグは、Web サイトにタグを動的に挿入するためのコンテナー、つまり小さなコード スニペットです。コンテナー タグとは、他の種類のタグを入れるバケットのようなものです。

UET は、主要なタグ管理システムのすべてに対応しています。テスト済みおよびサポート対象のタグ マネージャーの最新のリスト (およびガイドへのリンク) を以下に示します:

• Google タグ マネージャー
• Qubit Opentag
• Tealium
• Ensighten
• Signal
• Adobe Dynamic Tag Manager
• Adobe Launch

UET は、主要な Web サイト プラットフォームのすべてに対応しています。UET タグのインストールが可能なテスト済みおよびサポート対象のプラットフォームの最新のリスト (およびガイドへのリンク) を以下に示します:

• BigCommerce
• Shopify
• WordPress.com
• Wix

SPA Web サイトは、JavaScript の UET タグ トラッキング コードを使用する必要があります。最近 UET トラッキング コードを追加した場合は、既定で SPA 追跡が既に有効になっている可能性があります。確認するには、タグ スニペットに次の 太字のテキストがあるかどうかをチェックします:

<script> (function(w,d,t,r,u) {var f,n,i;w[u]=w[u]||[] ,f=function(){var o={ti:"TAG_ID_HERE", enableAutoSpaTracking: true}; o.q=w[u],w[u]=new UET(o),w[u].push("pageLoad")} ,n=d.createElement(t),n.src=r,n.async=1,n.onload=n .onreadystatechange=function() {var s=this.readyState;s &&s!=="loaded"&& s!=="complete"||(f(),n.onload=n. onreadystatechange=null)},i= d.getElementsByTagName(t)[0],i. parentNode.insertBefore(n,i)})(window,document,"script"," //bat.bing.com/bat.js","uetq"); </script>

タグ スニペットに上記のパラメーターが含まれていない場合に、自動 SPA 追跡を使用する場合は、 Microsoft Advertising UI に移動し、上記の動作が既定で有効になっている新しいイベント スニペットを取得できます。その後、Web サイトを更新して、新しいスニペットを使用できます。

既に SPA ページビューを手動で追跡している場合は、この動作を無効にすることをお勧めします。これを行うには、タグ スニペットの enableAutoSpaTracking パラメーターの値を false に変更します。また、Web サイトでナビゲーションにブラウザー履歴の状態が使用されていない場合は無効にすることもできますが、不明な場合はオンにしておくことをお勧めします。

SPA ページビューを手動で追跡する従来の手順については、以下を参照してください:

SPA イベントは、'page_view' アクションを含み 'page_path' パラメーターが必須 ('page_title' はオプション) となる、 カスタム イベントと同じ構文でトリガーされます。'page_path' パラメーターは '/' で始まる必要があります。例:

window.uetq = window.uetq || []; 
window.uetq.push('event', 'page_view', { 'page_path': '/spa_page' });

SPA イベントをトリガーする方法を 3 つご紹介します。なお、最初の方法を使用することをお勧めします。それぞれの方法について、サンプル Web ページを用意しましたので、適切なコードの動作を確認できます。

• コンテンツを変更する: アプリケーションが動的コンテンツを読み込むたびに SPA イベントをトリガーします。この場合、実際の URL は、最初の読み込み時に標準の pageLoad イベントで自動的に送信されます。この URL は、最終目標として使うことができます。最初のページでトリガーされたカスタム イベントは、すべてこれに関連付けられます。それぞれの SPA イベントは、SPA URL で pageLoad イベントを生成しますが、これは読み込み出来るパスである必要はありません。これらの URL は目標でも参照できます。SPA イベントの後にトリガーされたカスタム イベントは、SPA の pageLoad にのみ関連付けられます (つまり、元の URL には関連付けられません)。
  • このコードが実際に動作するようすは、 「コンテンツの変更」のサンプル Web ページでご覧いただけます。
• すべてのページ: 初回読み込み時を含むすべてのページの SPA イベントをトリガーします。このシナリオは、オート pageLoad イベントを使用しないことを除き、前述のシナリオと同じです。それまでと同様にトリガーされるため、イベントを整理して、他のカスタム イベントがトリガーされる前に SPA イベントがトリガーされるようにすることが重要です。トリガーの順序が不適切な場合、一部またはすべてが、SPA pageLoad イベント (および page_path を含む SPA の URL) ではなく、自動 pageLoad イベント (および元の URL) に関連付けられる可能性があります。
  • このコードが実際に動作するようすは、 「すべてのページ」のサンプル Web ページでご覧いただけます。
• すべてのページ、自動無効化: すべてのページで SPA イベントをトリガーし、さらに、自動ページ読み込みを無効化します。それには、初期化パラメーターに 'disableAutoPageView: true' を追加します (注: コード スニペットを変更して、直接無効化することはしないでください)。このシナリオは前項と同様ですが、初回ページ読み込み時に最初に SPA イベントをトリガーするという要件が削除されています。ただし、後続の SPA イベントは、それらに関連するカスタム イベントの前にトリガーされる必要があります (そうでない場合、以前の SPA イベントに起因することになります)。
  • このコードが実際に動作するようすは、 「すべてのページ、自動無効化」のサンプル Web ページでご覧いただけます。

カスタム イベントのコンバージョン目標やカスタム イベントを使用したリマーケティング リストを作成した場合 (詳細は UET を使ってカスタム イベントを追跡する方法)、カスタム イベントの JavaScript を UET タグ トラッキング コードに追加する必要があります。たとえば、Web ページで追跡するカスタム イベントが、いずれかの Web ページで [今すぐダウンロード] ボタンを選択しているユーザーであるとします。

Web ページ本文中にインストールされたカスタム イベントの UET タグ トラッキング コードの例を確認するには、 こちらの Web ページ (英語のみ) にアクセスし、右クリックしてから、ブラウザーに応じて [ ソースの表示] や [ ページ ソースの表示] を選択します。このページにはボタンもいくつかあります。各ボタンをクリックすると、カスタム イベントがトリガーされます。Fiddler などのサードパーティの監視ツールを使用している場合は、各カスタム イベントをレポートするために、bat.bing.com に HTTP 要求が生成されているのがわかります。

カスタム E コマース イベントの例は、 E コマース顧客のカスタム イベント例でご覧いただけます。

売上変数のコンバージョン目標を作成したら ( UET を使って変数収益をレポートする方法を参照)、次に UET タグ トラッキング コードを編集する必要があります。

PHP ページで売上変数をリンク先 URL 形式の目標に渡す方法を説明します。以下の例では、売上変数の値を JavaScript 関数から動的に読み込みます。JavaScript 変数または HTML 要素から簡単に静的な値を送る、または読み取ることができます。

Web ページ エディターを使用してコードを PHP ページに追加する場合は、以下の UET タグ トラッキング コードのサンプルを参照してください。

<script>
 (function(w,d,t,r,u){var f,n,i;w[u]=w[u]||[] ,f=function(){var o={ti:"TAG_ID_HERE"}; o.q=w[u],w[u]=new UET(o),w[u].push("pageLoad")} ,n=d.createElement(t),n.src=r,n.async=1,n.onload=n .onreadystatechange=function() {var s=this.readyState;s &&s!=="loaded"&& s!=="complete"||(f(),n.onload=n. onreadystatechange=null)},i= d.getElementsByTagName(t)[0],i. parentNode.insertBefore(n,i)})(window,document,"script"," //bat.bing.com/bat.js","uetq");
</script>

<script> function GetRevenueValue() { return 6; }
</script>
<script>
 window.uetq = window.uetq || []; window.uetq.push('event', '', {'revenue_value': GetRevenueValue(), 'currency': 'Replace_with_Currency_Code'});
</script>

高度なオプション: イベントのコンバージョン目標のコード サンプル

リンク先 URL のコンバージョン目標で使用する UET タグ トラッキング コードの末尾に追加するコードについて説明しましたが、他にも方法があります。

イベントのコンバージョン目標

イベントのコンバージョン目標について、売上変数をレポートするために追加する必要があるコードは、他にもあります。ステップ 2 と同じ JavaScript 関数を使用する場合は、以下のようになります:

<script> window.uetq = window.uetq || []; window.uetq.push('event', 'Event action', {'event_category': 'Replace_with_Event_Category', 'event_label': 'Replace_with_Event_Label', 'event_value': 'Replace_with_Event_Value', 'revenue_value': GetRevenueValue(), 'currency': 'Replace_with_Currency_Code'}); </script>

注: 通貨コードの完全なリストは、 変換目標収益通貨でご覧いただけます。

動的リマーケティング リストを作成したら ( 動的リマーケティング リスト: 製品向けリマーケティングを参照)、次はカスタム パラメーターを UET タグ トラッキング コードに追加して動作させる必要があります。

Web サイトの各ページに次の JavaScript を追加します。

<script>
   window.uetq = window.uetq || []; 
   window.uetq.push ('event', '', {'ecomm_prodid': 'Replace_with_Product_ID', 'ecomm_pagetype': 'Replace_with_Page_Type'}); 
</script>

上の JavaScript で次のパラメーターを変更します。

• Replace_with_Product_ID : これを次の製品 ID のいずれかに置き換えます。
  • 商品を一意に表す正確な SKU ID。これは UPC (共通商品コード) とも呼ばれます。
  • 同じ商品のバリエーションを表す商品グループ ID (色やサイズのオプションなど)。

  重要

  JavaScript コード内の商品 ID は、 Microsoft マーチャント センター の商品フィードの ID と一致する必要があります。

• Replace_with_Page_Type : この JavaScript を使用するページに応じて、これを表の右列にある以下の値のいずれかと置き換えます。

  トラッキングする動的リマーケティング リスト	必須ページ タイプ
  一般訪問者	'ecomm_pagetype': 'home' 'ecomm_pagetype': 'category' 'ecomm_pagetype': 'other' 注: searchresults、product、cart、または purchase のページ タイプに含まれないユーザーは、一般訪問者のオーディエンスに含まれます。
  商品を検索したユーザー	'ecomm_pagetype': 'searchresults'
  商品を閲覧したユーザー	'ecomm_pagetype': 'product'
  ショッピング カートを放棄したユーザー	'ecomm_pagetype': 'cart'
  過去の購入者	'ecomm_pagetype': 'purchase'

  注: 商品を購入したユーザーは「過去の購入者」リストに追加され、他のリストからは削除されます (該当する商品に限る)。これが動作するように、購入確認ページの UET タグが商品 ID (ecomm_prodid) と pagetype (ecomm_pagetype) の両方を送信する必要があります。

Web ページ本文にインストールされた動的リマーケティングの UET タグ トラッキング コードの例を確認するには、 こちらの Web ページ (英語のみ) にアクセスし、右クリックしてから、ブラウザーに応じて [ ソースの表示] や [ ページ ソースの表示] を選択します。このページでは、商品 ID とページ タイプも定義できます。さらに、この動的リマーケティング リストのカスタム イベントをトリガーするボタンを選択することもできます。Fiddler などのサードパーティの監視ツールを使用している場合は、各カスタム イベントをレポートするために、bat.bing.com に HTTP 要求が生成されているのがわかります。

上のセクションで述べたように、一部の Microsoft Advertisingの機能では、JavaScript スニペットを追加して既存の UET タグに変更する必要があります。

• カスタム イベント: カスタム イベントに基づくコンバージョン目標やリマーケティング リストでは、 event action、 event category、 event label、 event value のすべて、または一部を返すように、次のスニペットを変更する必要があります。

  <script>
     window.uetq = window.uetq || []; 
     window.uetq.push ('event', 'Replace_with_Event_Action', {'event_category': 'Replace_with_Event_Category', 'event_label': 'Replace_with_Event_Label', 'event_value': 'Replace_with_Event_Value'}); 
  </script>

• 変動収益: コンバージョン目標追跡の変動収益の場合は、 収益値 と 通貨コードを返すように次のスニペットを変更する必要があります。

  <script>
     window.uetq = window.uetq || []; 
     window.uetq.push ('event', '', {'revenue_value': 'Replace_with_Revenue_Value', 'currency': 'Replace_with_Currency_Code'}); 
  </script>

• 動的リマーケティング: 動的リマーケティング リストをターゲットとする場合、 product ID と page type を返すように、次のスニペットを変更する必要があります。

  <script>
     window.uetq = window.uetq || []; 
     window.uetq.push ('event', '', {'ecomm_prodid': 'Replace_with_Product_ID', 'ecomm_pagetype': 'Replace_with_Page_Type'}); 
  </script>

複数の機能を実装する場合、次の 2 点に注意する必要があります。

• 各機能の JavaScript スニペットは、Web ページのコード内で別々に保持することをお勧めします。 (つまり、別々の <script > </script > セクションで) 各スニペットが 1 つのイベントを送信するためです。
• 特に、同一 Web ページ内で次の両方を 1 つの JavaScript スニペットでトラッキングすることは できません。
  • リンク先 URL のコンバージョン目標に使用する売上変数
  • コンバージョン目標またはリマーケティング リストに基づくカスタム イベント

  この場合、Web ページ内に 2 つの独立したスニペットを実装する必要があります。

  • リンク先 URL コンバージョン目標の変動収益のスニペット 1 —:

    <script>
       window.uetq = window.uetq || []; 
       window.uetq.push ('event', '', {'revenue_value': 'Replace_with_Revenue_Value', 'currency': 'Replace_with_Currency_Code'}); 
    </script>

  • スニペット 2 — コンバージョン目標またはリマーケティング リストに基づくカスタム イベント用。ただし、カスタム イベントのコンバージョン目標に使用する売上変数をトラッキングする場合 (リンク先 URL のコンバージョン目標では ありません)、カスタム イベントのコード スニペットにこれを含めます:

    <script>
       window.uetq = window.uetq || []; 
       window.uetq.push ('event', 'Replace_with_Event_Action', {'event_category': 'Replace_with_Event_Category', 'event_label': 'Replace_with_Event_Label', 'event_value': 'Replace_with_Event_Value', 'revenue_value': 'Replace_with_Revenue_Value', 'currency': 'Replace_with_Currency_Code'}); 
    </script>