Lead Tracking API
MarketoとMunchkin JavaScriptを使用すれば、Marketoのランディングページと外部web ページにおけるページ訪問とリンククリックを追跡できます。 Marketoは、これらのインタラクションを「Web ページにアクセス」および「Web ページ上のクリック済みリンク」アクティビティとして記録します。
スマートキャンペーンとスマートリストのトリガーとフィルターでアクティビティを使用します。
コードの埋め込み
Marketo インスタンスには、外部ページのアクティビティをトラッキングするための事前設定済みのコードスニペットが用意されています。 埋め込みコードの使用は、このライセンス契約の規定に従います。
使用可能なトラッキングコードのタイプは次の 3 つです。
- シンプル – 同期して読み込みます。
- 非同期：非同期で読み込みます。
- 非同期jQuery：非同期で読み込み、最初に読み込むにはjQueryが必要です。
非同期トラッキングコードを使用して、外部ページにMunchkinを埋め込みます。 可能な限り高い実行成功率を得るには、各ページの<head>要素にコードを配置します。
一部のコンテンツ管理システムでは、任意のスクリプトを埋め込む際に特定の方法や制限が適用される場合があります。
最後のページでは、HTML ドキュメントの<head>要素に次のようなコードを含める必要があります。
<head>
<script type="text/javascript">
(function() {
var didInit = false;
function initMunchkin() {
if(didInit === false) {
didInit = true;
Munchkin.init('CHANGE-ME');
}
}
var s = document.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = '//munchkin.marketo.net/munchkin.js';
s.onreadystatechange = function() {
if (this.readyState == 'complete' || this.readyState == 'loaded') {
initMunchkin();
}
};
s.onload = initMunchkin;
document.getElementsByTagName('head')[0].appendChild(s);
})();
</script>
...
</head>
Munchkin の動作
デフォルトでは、ページが読み込まれると、Marketo Munchkinは次のアクションを実行します。
- 現在のブラウザーにMunchkin Cookieがあるかどうかを確認し、必要に応じてCookieを作成します。
- 現在のページとブラウザーの情報を使用して、指定されたMarketo インスタンスに「Web ページにアクセス」イベントを送信します。 このイベントは、対応するMarketo レコードにアクティビティを記録します。
- ユーザーがリンクを選択すると、「Web ページでクリックしたリンク」イベントを送信します。
Munchkin Configuration settingsを使用して、この動作を変更します。 例えば、cookieAnonを使用して、ページにアクセスするすべてのリードに対してMunchkinがCookieを作成するかどうかを制御するか、clickTimeを使用してクリック遅延を変更します。
訪問アクティビティを無効にするには、apiOnlyをtrueに設定します。 バージョン 162 （2022年8月）時点で、Munchkinはhttp/s個のリンクに加えてtel個とmailto個のリンクのクリックを追跡します。
既知および匿名のリード
リードが最初にドメインのページにアクセスすると、Marketoは匿名のリードレコードを作成します。 このレコードの主キーは、ユーザーのブラウザーで作成されたMunchkin Cookie （_mkto_trk）です。
Marketoは、そのブラウザーのその後のweb アクティビティを匿名レコードに記録します。 アクティビティを既知のMarketo レコードに関連付けるには、次のいずれかのイベントが発生する必要があります。
- リードは、トラッキング対象の Marketo メールリンクからクエリ文字列に
mkt_tokパラメーターを含む Munchkin トラッキング対象ページを訪問する必要があります。 - リードは、Marketo フォームに入力する必要があります。
- REST のリードを関連付け呼び出しを送信する必要があります。
これらのイベントのいずれかが発生すると、MarketoはCookieとすべての関連するweb アクティビティを既知のリードに関連付けます。
Marketoは、ブラウザーごとに匿名のweb アクティビティレコードを作成します。 リードが新しいコンピューターまたはブラウザーからドメインにアクセスした場合、関連付けを再度行う必要があります。
ドメイン
Munchkinは、ドメインごとにCookieを作成および追跡します。 ドメイン間で既知のリードを追跡するには、各ドメインでリードの関連付けイベントが発生する必要があります。
例えば、marketo.comとexample.comを制御するとします。 リードはmarketo.comにフォームを送信し、後でexample.comに送信します。 marketo.comのアクティビティは既知のリードに関連付けられていますが、example.comのアクティビティは匿名です。
既知のリードはサブドメイン間で保持されます。 www.example.comの既知のリードはinfo.example.comの既知のリードでもあります。
トップレベルドメインに.co.ukなどの2つの部分がある場合は、domainLevel パラメーターをMunchkin スニペットに追加します。 詳しくは、設定を参照してください。
cookie
Munchkin Cookieは、キー_mkto_trkと、次のいずれかのパターンに従う値を使用します。
id:561-HYG-937&token:_mch-marketo.com-1374552656411-90718
Or
id:561-HYG-937&token:_mch-marketo.com-97bf4361ef4433921a6da262e8df45a
MunchkinのCookieは、example.comなどの各セカンドレベルのドメインに固有です。 デフォルトのCookieの有効期間は2年（730日）です。
ベータ版
ランディングページのMunchkin ベータ版チャネルにオプトインするには、管理者/ トレジャーチェスト に移動し、「ランディングページでMunchkin Beta」設定を有効にします。
この設定により、管理者 -> Munchkin メニューにコードスニペットが追加されます。 これらのスニペットを使用して、外部サイトでベータ版を実行します。
オプトアウト
訪問者は、ブラウザーのURLにquerystring パラメーター「marketo_opt_out=true」を追加することで、Munchkin トラッキングをオプトアウトできます。 Munchkin JavaScriptがこの設定を検出すると、値trueの新しい「mkto_opt_out」 Cookieを設定しようとします。
その後、Munchkinは他のすべてのMarketo トラッキング Cookieを削除し、新しいCookieを設定せず、HTTP リクエストも行いません。