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 タグ トラッキング コードを使用する必要があります。 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 マーチャント センターr r の商品フィードの 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>