Home > ja-jp > Revenue and Conversion Tracking > Revenue Integrations > How To Articles: Revenue Integrations > トラッカー非同期JavaScript統合に関するガイド

トラッカー非同期JavaScript統合に関するガイド

概要
トラッカーJavaScriptコードについて
クリックキャプチャコード
コンバージョンタイプの設定
コンバージョンキャプチャコード
1. フィールド値：
URL構造
URLビルダーとIDパーサー設定
Googleサイトリンクの設定
1. オプション1：
2. オプション2：
実装チェックリスト
使用するシナリオ

概要

このガイドでは、MarinトラッカーJavaScriptを使用してコンバージョンや収益を統合するために必要な手順を紹介します。Marinはお客様と実施する作業範囲の決定および構成プロセスで、次に関係した詳細を記録します。

コンバージョンタイプとアシスト設定
非同期JavaScriptクリックコード
非同期JavaScriptコンバージョンコード
既存URL構造とトラッキングパラメータに対応するための推奨する変更
Googleサイトリンクを扱うためのオプション
実装プロセスとチェックリスト

トラッカーJavaScriptコードについて

Marinの非同期JavaScriptクリックおよびコンバージョンのキャプチャコードスニペットは、受信トラフィックと有料検索からのコンバージョンを記録します。このコードを使用して、検索広告とその他のメディアチャンネル（アフィリエイトマーケティングやオンラインディスプレイキャンペーン、自然検索など）のコンバージョンの関連性（（パス）と呼ばれる）を明らかにすることもできます。コードが非同期の状態であるとは、背景でピクセルが構築されるため、ページの読み込み速度に影響しません。

JavaScriptはクライアントのWebサイトで配置されます。
確認ページでは、トランザクションの詳細を含めるために、サーバー側ページの生成コードに変更が要求されます。
URLは、キーワードまたはクリエイティブレベルでMarinのトラッキングパラメータとタグ付けされる必要があります。
正確性を期するため、クライアントやMarinプロフェッショナルサービスでMarinトラッキングの結果を検証します。ただし、帰属規則やページプレースメントなどに基づく様々なトラッキング手法により、結果に相違が生じることがあります。通常、90%の精度が得られれば正しいマッチングと見なされますが、何らかの正当な理由により、これよりも低い数値になる場合もあります。

クリックキャプチャコード

このコードの役割：このJavaScriptは訪問者をサイトに導いたキーワードおよびクリエイティブを、検索広告クリックのリンク先URLに埋め込まれたキーワードIDとクリエイティブID（これに限定されません）に基づいてログに記録します。このJavaScriptは参照URLとリンク先URLを取得し、ユーザーのブラウザのCookie ID（UUID）を設定して、これら3つの値をMarinに送信します。このクリックデータは、コンバージョンをキーワードやクリエイティブに帰属するために、コンバージョンデータと結合されます。まれにブラウザでJavaScriptが無効にされていることがあり、この場合<noscript>画像ピクセルは実行されますがトラッキングデータは格納されません。これは監査目的でのみ使用されます。

コードの配置場所：次のJavaScriptコードスニペットはWebサイトのすべてのリンク先ページで公開されるようにします。フッターテンプレートなどグローバルなテンプレートに配置するのが理想的です。

フィールド値：（オンボードチームから提供されます）

[CLIENT-TRACKING-ID] =（必須）静的英数字の文字列、各Marinクライアントアカウントで一意

このセクションのコードはサンプルですので、クライアントのリンク先ページに配置しないでください。

<script type="text/javascript">

var _mTrack = _mTrack || [];

_mTrack.push(['trackPage']);

(function() {

var mClientId = '[CLIENT-TRACKING-ID]';

var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');

var mHost = 'tracker.marinsm.com';

var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';

var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);

})();

</script>

</noscript>

コンバージョンタイプの設定

Marinはお客様と実施する作業範囲の決定および統合計画の策定で、次の表に示すコンバージョンタイプを定義します。

コンバージョンタイプ	コンバージョンID	コンバージョンソース	入札に使用しますか？	クリック当たり複数か1回か？	帰属する日
例：売上	売上	Marinトラッカー	○	複数	クリック/コンバージョンの日
例：リード	リード	Marinトラッカー	×	複数	クリック/コンバージョンの日

場所：

コンバージョンタイプ：Marinインターフェイスに表示するコンバージョンタイプの名前。
コンバージョンタイプID：Marinコンバージョンコードに渡すコンバージョンタイプID。
コンバージョンソース：MarinトラッカーJavaScript
入札に使用しますか？：コンバージョンタイプを入札に使用するかどうかに応じて、○またはx。
収益：コンバージョンタイプを収益に渡すかどうかに応じて、○またはx。
クリック当たり複数か1回か？：コンバージョンをどのように帰属させるかの指定。
帰属：クリックの日とコンバージョンの日。

Marin Softwareではページビュー、直帰、サイト滞在時間、その他の非トランザクションコンバージョン情報といったユーザーエンゲージメントメトリックに照らして効果的に入札することはできません。統合計画のレビューでは、コンバージョンタイプやクリック当たりのコンバージョン数、帰属の方法（クリックの日またはコンバージョンの日、あるいはその両方）をお客様に確認していただきます。

コンバージョンキャプチャコード

このコードの役割：このJavaScriptは、次に示す値をコンバージョンメトリックの配列に取り込み、クリックJavaScriptが作成したCookie ID（UUID）と併せてMarinに送信します。これによりMarinはクリックデータとコンバージョンデータを結合できるようになります。お客様の開発チームは、サーバー側のロジックを使用して、次に示すフィールドに適切なコンバージョンデータを挿入する必要があります。下記のフィールドは名前と値のペアとしてJSON配列で定義されます。フィールドの値はコードスニペットです。まれにブラウザでJavaScriptが無効にされていることがあり、この場合<noscript>画像ピクセルは実行されますがトラッキングデータは格納されません。これは監査目的でのみ使用されます。
コードの配置場所：次のJavaScriptコードスニペットをコンバージョン成功ページ（thank youページ）に配置する必要があります。1回クリックのイベントを使用してコンバージョンイベントを追跡している場合、Marinオンボードチームにご相談ください。

このセクションのコードはサンプルですので、クライアントのコンバージョンページに配置しないでください。

  <!-- BEGIN: Marin Software Tracking Script -->

  <script type="text/javascript">

     var _mTrack = _mTrack || [];

     _mTrack.push(['addTrans', {

         currency :'<ISO-CURRENCY-CODE>',

         items : [

          orderId : '<ORDER-ID>',

          convType : '<CONV-TYPE-ID>',

          product :  '<PRODUCT-SKU/NAME>',

          price :    '<PRICE>',

          category : '<CATEGORY>',

          quantity : '<QUANTITY>'

     }]);

     _mTrack.push(['processOrders']);

     (function() {

         var mClientId = '[CLIENT-TRACKING-ID]';

         var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');

         var mHost = 'tracker.marinsm.com';

         var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';

         var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);

     })();

 </script>

</noscript>

フィールド値：

フィールド名：	定義	ソース	必須
[クライアントトラッキング]	静的英数字の値、各Marinクライアントアカウントで一意、PSオンボードチームから提供	Marin	必須
<ISO-CURRENCY-CODE>	ISO通貨コードは3桁の値で、特定の国の通貨を示しています。クライアントアカウントのデフォルト通貨タイプと異なるトランザクションの場合は、ISOコードを挿入します。それ以外の場合は、プレースホルダを削除し空白にします。例：USD、JPY、GBP、AUD。 ISO通貨コードへのリンク：http://en.wikipedia.org/wiki/ISO_4217	クライアント	オプション
<ORDER-ID>	コンバージョンイベントの一意の識別子です。レポートやページの再読込時の重複排除などに使用できます。注文IDは、重複排除に使用されるため、どの時点でも再利用しないことが重要です。注文IDが利用できない場合は、プレースホルダを削除し空白にします。 <ORDER-ID>プレースホルダを置き換える場合は、すべての<order-id>プレースホルダのインスタンスを同じ値に置き換える必要があります。</order-id>	クライアント	オプション
<CONV-TYPE-ID>	コンバージョンタイプIDは、統合計画の「コンバージョンタイプ」セクションで定義され、コンバージョンイベントに相当します。このIDは大文字小文字を区別しますのでご注意ください。	Marin	必須
<PRODUCT-SKU/NAME>	このフィールドは、商品またはトランザクションに関するMarinの情報を渡すときに使用できます。それ以外の場合は、プレースホルダを削除し空白にします。注記：この値はMarinのカスタムレポートからしかアクセスできません。	クライアント	オプション
<CATEGORY>	このフィールドは、商品カテゴリーまたはその他のトランザクションに関するMarinの情報を渡すときに使用できます。それ以外の場合は、プレースホルダを削除し空白にします。注記：この値はMarinのカスタムレポートからしかアクセスできません。	クライアント	オプション
<PRICE>	アイテム/トランザクションあたりの価格 Marinで<PRICE> X <QUANTITY>の乗算が行われ、アプリ内の合計値が算出されます。収益がない場合は、プレースホルダを削除して空白にします。例：30.20（10進法の値のみ、記号は含めない）	クライアント	オプション
<QUANTITY>	このトランザクションで購入されたアイテム数例：5（整数値、空白の場合はデフォルト= 1）	クライアント	オプション

URL構造

Marinでトラッカーを使用してコンバージョン/収益を帰属させるには、一意の識別子（ID）を使用して各キーワード、クリエイティブ、プレースメントURLにタグ付けする必要があります。次のURL構造（ハイライト部分は必須のMarin変数）を推奨しています。

（Googleキーワードの例）
http://www.domain.com/path/landingPage.html?mkwid=[distribution][uniq_id]&pcrid=[creative_id]&pkw=[keyword_text]&pmt=[matchtype]&pdv=[device]

次の表では、Marin変数の挿入時に置換される値を示しています。

挿入変数	機能	Google 結果の値	Bing 結果の値	FaceBook 結果の値
[uniq_id]	8文字（一意の英数字ID）を挿入	8文字の一意のID	8文字の一意のID	8文字の一意のID
[distribution]	クリックのソースを表す動的なパブリッシャーパラメータを挿入します	{ifsearch:s}{ifcontent:c}
[device]	デバイスタイプ（c、m、t）用の単一文字を挿入	{device}
[creative_id]	クリエイティブID用の動的挿入パラメータを挿入	{creative}	{Adid}
[keyword_text]	キーワード用の動的挿入パラメータを挿入	{keyword}	{keyword}
[matchtype]	マッチタイプ用の動的挿入パラメータを挿入	{Matchtype}	{Matchtype}

次に示すリードパラメータは、表内で「X」が記載されているパブリッシャーについては含める必要があります。 {device}の値は、MKWIDパラメータまたはPDVパラメータのいずれかに配置されます。

パラメータ名	挿入変数	Google	Bing	Facebook
mkwid	[uniq_id]	〇	〇	〇
mkwid	[distribution]	〇	〇
mkwid	[device]	〇
pcrid	[creative_id]	〇	〇
pkw	[keyword_text]	〇	〇
pmt	[matchtype]	〇	〇
pdv	[device]	〇
クリエイティブURL変数		上記と同様	{param1}	上記と同様

URLビルダーとIDパーサー設定

キーワードIDのパーシングにある次の設定を、Marinアプリケーションで構成する必要があります。

パラメータ	このシーケンスの後開始	このシーケンスの後停止
トラッキングID	mkwid	&
{Creative}パラメータ	pcrid	&
キーワード	pkw	&
マッチタイプ	pmt	&

デバイスタイプは追加されていますか?	デバイス区切り文字
X	パイプ（“\|”）またはアンダースコア（“_”）

Marin URLビルダーのクライアント用に次の設定が有効になります。

パブリッシャー	入力されたキーワードレベルURL
	mkwid=[distribution][uniq_id]&pcrid=[creative_id]&pkw=[keyword_text]&pmt=[matchtype]&pdv=[device]
	mkwid=[distribution][uniq_id]&pcrid=[creative_id]&pkw=[keyword_text]&pmt=[matchtype]
	mkwid=[uniq_id]

自動URL修正の設定
自動URL修正	警告（該当する場合、最初のURLタグ付けプロセスの直後にプロフェッショナルサービスによって有効化されます)。
クリエイティブの自動URL構築	オン
プレースメントの自動URL構築	オン

Googleサイトリンクの設定

Marinでは、Googleサイトリンクのパフォーマンスのトラッキングに2つのメソッドを使用しています。どちらか選択する必要がありますのでご注意ください。

オプション1：

収益をサイトリンクをトリガしたキーワードに帰属することができます。キーワードの真のROIを知っているため、キーワードに対して適切に入札できます。マイナスな点は、どのサイトリンクがコンバージョンをトリガしたか判断できないことです。

サイトリンクからコンバージョン/収益データを誘導しているキーワードに正しく帰属させるには、各Googleサイトリンクを次の{copy}パラメータで追加します。

&{copy:mkwid}&pcrid={creative}&pkw={keyword}&pmt={matchtype}&pdv={device}

オプション2：

各サイトリンクのパフォーマンスを追跡するのに、サイトリンクを直接コンバージョンに帰属させたい場合は、正しいトラッキングのためにMarinでプレースホルダキーワードが作成されます。ただし、どのサイトリンクがコンバージョンをトリガしたか確認できても、どのキーワードがコンバージョンをトリガしたかは判断できません。また、このメソッドでは、入札に影響する可能性があるGoogleが実際のキーワードへのクリックを帰属した数だけのコンバージョンへ誘導しているようには見えません。

プレースホルダキーワードは、各Googleサイトリンク用に設定され、Marinで生成されたURLはGoogleの実際のサイトリンクにコピーされる必要があります。

実装チェックリスト

手順	タスク	オーナー	依存関係
1	統合計画のレビューとまとめ	クライアント/Marin
2	URLビルダーとパーサーの設定	Marin	1
3	JavaScriptクリックとコンバージョンキャプチャコードを実装	クライアント	1
4	コンバージョンタイプを設定		1
5	URLを構築、品質確認、パブリッシャーへのトラフィック	Marin/クライアント	2
6	コンバージョン/収益データの品質確認3日間	Marin/クライアント	3、4、5
7	クライアントサービスチームへ移譲	Marin	6

使用するシナリオ

例1：1つのコンバージョンイベント内に複数のコンバージョンタイプ

次の例では、複数のコンバージョンタイプがどのようにキャプチャされたか示しています。コンバージョンイベントは1つ以上のコンバージョンタイプを参照しているため、注文IDがコンバージョンタイプごとに一意であるか確認することが重要です。 Marinでは次の設定オプションを推奨しています（順不同）。
オプション1：コンバージョンタイプIDと注文IDが結合されるようにOrderIDフィールドを変更します。例：“[order-id]-[conv-type id]”
オプション2：オプション1を実施できない場合は、OrderIDフィールドを空白にします。

 <!-- BEGIN: Marin Software Tracking Script -->

  <script type="text/javascript">

     var _mTrack = _mTrack || [];

     _mTrack.push(['addTrans', {

         currency : 'USD',

         items : [


	ユーザーは、会費$20でメンバー登録

{

          orderId : '123456-subscription',

          convType : 'subscription',

          product : 'membership signup',

          price : '20.00',

          quantity : '1'

},


	ユーザーは、$10でゴールドレベルに会員登録をアップグレード

orderId : '123456-upgrade_gold',

          convType : 'upgrade_gold',

          product : 'membership upgrade (gold)',

          price : '10.00',

          quantity : '1'

     }]);

     _mTrack.push(['processOrders']);

     (function() {

         var mClientId = '1a2b3c4d';

         var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');

         var mHost = 'tracker.marinsm.com';

         var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';

         var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);

     })();

 </script>

</noscript>

例2：1つのコンバージョンタイプのトラッキング（リード）

次の例では、単一のコンバージョンタイプがどのようにキャプチャされたか示しています。

 <!-- BEGIN: Marin Software Tracking Script -->

  <script type="text/javascript">

     var _mTrack = _mTrack || [];

 _mTrack.push(['addTrans', {

     items : [{

       orderId : '300188403',

       convType : 'store_locator'

}]

 }]);

     _mTrack.push(['processOrders']);

     (function() {

         var mClientId = '1a2b3c4d';

         var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');

         var mHost = 'tracker.marinsm.com';

         var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';

         var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);

     })();

 </script>

</noscript>

例3：複数の項目が含まれる1つのコンバージョンタイプのトラッキング（注文バスケット）

次の例では、単一のコンバージョンタイプがどのようにキャプチャされたか示しています。

 <!-- BEGIN: Marin Software Tracking Script -->

  <script type="text/javascript">

     var _mTrack = _mTrack || [];

     _mTrack.push(['addTrans', {

         currency : 'USD',

         items : [


	アイテム1：$120のランニングシューズ X 1足 = $120.00（Marin）

orderId : '123456',

          convType : 'sale',

          product : 'mens running shoes',

          price : '120.00',

          quantity : '1'

},


	アイテム2：$10のランニングソックス X 5足 = $50.00（Marin）

orderId : '123456',

          convType : 'sale',

          product : 'mens running socks',

          price : '10.00',

          quantity : '5'

     }]);

     _mTrack.push(['processOrders']);

     (function() {

         var mClientId = '1a2b3c4d';

         var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');

         var mHost = 'tracker.marinsm.com';

         var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';

         var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);

     })();

 </script>

</noscript>

収益とコンバージョントラッキング

トラッカー非同期JavaScript統合に関するガイド

Table of contents

概要

トラッカーJavaScriptコードについて

クリックキャプチャコード

コンバージョンタイプの設定

コンバージョンキャプチャコード

フィールド値：

URL構造

URLビルダーとIDパーサー設定

Googleサイトリンクの設定

オプション1：

オプション2：

実装チェックリスト

使用するシナリオ

例1：1つのコンバージョンイベント内に複数のコンバージョンタイプ

例2：1つのコンバージョンタイプのトラッキング（リード）

例3：複数の項目が含まれる1つのコンバージョンタイプのトラッキング（注文バスケット）

Tags

Classifications

収益とコンバージョントラッキング

トラッカー非同期JavaScript統合に関するガイド

Table of contents

概要

トラッカーJavaScriptコードについて

クリックキャプチャコード

コンバージョンタイプの設定

コンバージョンキャプチャコード

フィールド値：

URL構造

URLビルダーとIDパーサー設定

Googleサイトリンクの設定

オプション1：

オプション2：

実装チェックリスト

使用するシナリオ

例1：1つのコンバージョンイベント内に複数のコンバージョンタイプ

例2：1つのコンバージョンタイプのトラッキング（リード）

例3：複数の項目が含まれる1つのコンバージョンタイプのトラッキング（注文バスケット）

Related articles

Tags

Classifications