IMG タグを使ったユニバーサルイベントトラッキング (UET)

JavasScript ベースの UET タグが使えない場合、JavaScript ベースでないバージョンを使うことができます。IMG タグを使うのは 1 つの方法です。

重要

可能であれば、JavaScript 版の UET タグを使用することをお勧めします。JavaScript UET タグの詳細については、こちらをご覧ください。

ユニバーサルイベントトラッキング (UET)

ユニバーサルイベントトラッキング (UET) とは、Microsoft Web サイト上のユーザーエンゲージメントデータを取得し、コンバージョントラッキング (購入やリードなど)、オーディエンスターゲティング (リマーケティングなど)、自動入札、Microsoft Advertisingコマースなどの機能を可能にするフレームワークです。UET について、またコンバージョントラッキングやリマーケティングになぜ UET が重要なのかについては、Microsoft Advertisingで詳しく説明しています。

UET タグは JavaScript バージョンを使用し、Web サイトのすべてのページに付けることをお勧めします。JavaScript UET タグは、コンバージョントラッキングやリマーケティングのために、より豊富なデータを取得します。ただし、JavaScript ベースのタグ付けができない場合は、非 JavaScript ベースのバージョンを使用できます。その方法の 1 つが、<img> タグを使用する方法です。

UET イベントフレームワーク

UET フレームワークは、複数のイベントを定義します:

ページの読み込み:すべてのページ訪問時に発生します。
カスタムイベント:特定のイベントやページタイプで発生し、より豊富なデータを取得します。

複数の UET イベントを同じページ訪問時に発生させることができます。は MID パラメーターを使用して、同じページで発生した異なるイベントを接続します。

スクリプトを用いない UET の実装は次のようになります:

msclkid を Web サイトのファーストパーティの Cookie に取り込んで保存します。これはすべての pageLoad イベントとカスタムイベントで共有されます。
pageLoad イベントの定義を理解し、すべてのページビューでこれを発生させます。
カスタムイベントの定義を理解し、必要なパラメーターを指定して特定のページでイベントを発生させます。それぞれのページビューは 1 つの pageLoad イベントのみを持ちますが、複数のカスタムイベントを持つことができます。
カスタムイベントの中には、ページがロードされたときではなく、ユーザーがアクションを起こしたときに発生させる必要があるものがあります。例えば、ユーザーが商品をカートに入れた際に、ページが更新されない場合があります。そこで、ユーザーが [カートに入れる] ボタンを選択した後に、イベントの詳細を取得する必要があります。この UET イベントを発生させるには、適切なメカニズムを使用します。

API エンドポイント

UET はイベントが発生した場合に、このエンドポイントを発生させます: https://bat.bing.com/action/0?
予想される応答は:204

キャプチャされるパラメーター

MSCLKID

MSCLKID はコンバージョンアトリビューションで使用され、広告のクリック時に生成されます。この ID は、Microsoftクリック ID の自動タグ設定が有効な場合に、ランディングページの URL に追加されます。これを Web サイト上のファーストパーティの Cookie に保存し、UET 呼び出しとともに送信する必要があります。

MSCLKIDとは GUID で、"cdd4afcccb1c9a4cad9544dd7e5006d5" のようなものです。

お勧めの Cookie 名: _uetmsclkid

Cookie の有効期限:90 日間

こちらが例です:

<script>
    function setCookie(name, value, days) {
        var date = new Date();
        date.setTime(date.getTime() + days * 864e5);
        var expires = "; expires=" + date.toGMTString();
        document.cookie = name + "=" + value + expires;
    }
    function getParam(p) {
        var match = RegExp("[?&]" + p + "=([^&]*)").exec(window.location.search);
        return match && decodeURIComponent(match[1].replace(/\+/g, " "));
    }
    var msclkid = getParam("_uetmsclkid ");
    if (msclkid) {
        setCookie("_uetmsclkid", msclkid, 90);
    }
</script>

MID

Mid により、pageLoad やカスタムイベントなど、同じページからの異なるイベントを結合できます。次は、MID を生成するために使用するコードの例です:

<script>
    this._S4 = function () {
        return Math.floor((1 + Math.random()) * 0x10000)
        .toString(16)
        .substring(1);
    };
    this.getGuid = function () {
        var guid =
            this._S4() +
            this._S4() +
            "-" +
            this._S4() +
            "-" +
            this._S4() +
            "-" +
            this._S4() +
            "-" +
            this._S4() +
            this._S4() +
            this._S4();
        return guid;
    };
</script>

pageLoad またはカスタムイベントで取得できるパラメーターの一覧は、こちらの表をご覧ください。

アイテム

アイテムは、商品 ID、数量、価格など、商品の詳細を取得します。例えば、[カートに入れる] のイベントやカートページの訪問など、複数の商品を含むページビューやイベントで取得されます。

複数の商品を追加する場合は、次の手順で行います:

キャプチャするさまざまなアイテムのために、カンマで区切ったリストを作成します。例えば、製品 ID が 12345 と 23456 の場合: id=prod12345 &quantity=2&price=25.1,id=prod23456&quantity=1& price=121.1 となります。
文字列全体を URL エンコードする: id%3Dprod12345%26quantity%3D2%26price%3D25.1%2Cid%3Dprod23456%26quantity%3D1%26price%3D121.1
[items] パラメーターの値として追加する: items=id%3Dprod12345%26quantity%3D2%26price%3D25.1%2Cid%3Dprod23456%2 6quantity%3D1%26price%3D121.1

異なるイベント/ページに対する API コールの例

ページ読み込みイベント

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
evt=pageLoad&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
p=https%3A%2F%2Fwww.contoso.com%2Fsearch%3Fq%3Dwall%2Bclock&
r=https%3A%2F%2Fwww.bing.com%2F&
tl=Wall%20Clocks&
kw=clocks,homedecor

小売業特有の状況に対応したカスタムイベント
ホームページ

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=home

カテゴリ参照ページ

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=category&
ecomm_category=cat123&
prodid=pid1,pid2,pid3,pid4,pid5,pid6,pid7,pid8,pid9,pid10

検索結果ページ

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=searchresults&
search_term=wall%20clocks&
prodid=pid1,pid2,pid3,pid4,pid5,pid6,pid7,pid8,pid9,pid10

商品掲載ページ

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=product&
prodid=pid1

カートイベントに追加
次の例では、商品掲載ページで発生したカートへの追加イベントの詳細をキャプチャしています。他のページタイプでカートに入れるイベントが発生した場合は、そのページタイプを使用します。

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
ea=add_to_cart&
pagetype=product&
prodid=pid12345&
items=id%3Dprod12345%26quantity%3D2%26price%3D25.1&
gv=50.2&
gc=usd

カートページ

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
pagetype=cart&
prodid=prod12345,prod2345&
items=id%3Dprod12345%26quantity%3D2%26price%3D25.1%2Cid%3Dprod2345%26quantity%3D1%26price%3D121.1&
gv=171.3&
gc=usd

購入確認ページ

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
ea=purchase&
pagetype=purchase&
prodid=prod12345,prod2345&
items=id%3Dprod12345%26quantity%3D2%26price%3D25.1%2Cid%3Dprod2345%26q uantity%3D1%26price%3D121.1&
gv=171.3&
gc=usd

広告主が定義したラベルを使用するカスタムイベント
ea、ec、ev、el などのカスタムラベルを使用して、カスタムのリマーケティングリストやコンバージョンイベントを定義できます。

https://bat.bing.com/action/0? 
ti=1234567&
ver=2.3&
mid=d34f6979-ecfc-ecac-745d-e40447afd9b2&
uid=3966616149922&
vid=a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
evt=custom&
ea=add_to_cart&
ec=shoes&
el=recommendations&
ev=23.99

IMG タグの実装についての詳細

Microsoft Advertising UET タグは、0 サイズの画像ピクセルとすることができます。

UET タグは、ページ上の任意の場所に追加できます。例として、見出しタグ内での実装を次に示します:

<head>
<title>UET IMG based example</title>
<meta charset="utf-8" />
<!--BEGIN: Microsoft Advertising UET tag.-->
<img src="//bat.bing.com/action/0?ti=1234567&
ver=2.3&
evt=pageLoad&
mid=d34f6979-ecfc-ecac745d-e40447afd9b2&
uid=3966616149922&
vid= a5ia770-97ac68-cd211&
msclkid=292049a17e2413e3a4081719e839afe6-0&
rn=692799&
p= ttps%3A%2F%2Fwww.contoso.com%2Fsearch%3Fq%3Dwall%2Bclock&
r=https%3A%2F%2Fwww.bing.com%2F&
tl= Wall%20Clocks&
kw=clocks,homedecor" height="0" width="0" style="display:none; visibility: hidden;" />
<!--END: Microsoft Advertising UET tag-->
<link href="StyleSheet/styles.css" rel="stylesheet">
</head>

ページが読み込まれると UET タグが起動し、その結果 HTTPS リクエストが発生します。このリクエストはドメイン "bat.bing.com" に対するものです。URL には、Microsoft Advertisingに必要なパラメーターが含まれています。

IMG タグを使ったユニバーサル イベント トラッキング (UET)

IMG タグを使ったユニバーサル イベント トラッキング (UET)

重要

ユニバーサル イベント トラッキング (UET)

UET イベント フレームワーク

API エンドポイント

キャプチャされるパラメーター

アイテム

異なるイベント/ページに対する API コールの例

IMG タグの実装についての詳細

IMG タグを使ったユニバーサルイベントトラッキング (UET)

IMG タグを使ったユニバーサルイベントトラッキング (UET)

ユニバーサルイベントトラッキング (UET)

UET イベントフレームワーク