商机跟踪API
Marketo的Munchkin JavaScript允许跟踪最终用户对Marketo登陆页面和外部网页的访问次数和点击次数。 这些链接在Marketo中记录为“访问网页”和“网页上的点击链接”活动，随后可用于智能营销活动和智能列表的触发器和过滤器中。
嵌入代码
您的Marketo实例会自动提供预配置的跟踪代码片段以在外部页面上嵌入代码，这些代码可跟踪回您的Marketo实例中的活动。 嵌入代码的使用受此许可协议的约束。
提供了三种跟踪代码类型：
- 简单 — 同步加载
- 异步 — 异步加载
- 异步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，如果没有，请创建一个。
- 使用当前页面和浏览器的信息将“访问网页”事件发送到指定的Marketo实例。 这会将活动记录到Marketo中的相应记录。
- 对于在链接上发生的任何用户点击，发送“网页上的点击链接”事件。
可以使用Munchkin 配置设置修改Munchkin的行为，例如，在使用cookieAnon设置访问页面时是否为所有潜在客户创建了Cookie，或者使用clickTime设置修改点击延迟。 通过将apiOnly设置设置为true，可以禁用访问活动的发送。 从版本162（2022年8月）开始，除了http/s个链接外，还跟踪单击tel和mailto个链接。
已知和匿名潜在客户
当商机首次访问您域中的某个页面时，将在Marketo中创建一个新的匿名商机记录。 此记录的主键是在用户的浏览器中创建的Munchkin Cookie (_mkto_trk)。 将针对此匿名记录记录记录该浏览器上的所有后续Web活动。 要与Marketo中的已知记录关联，必须执行以下任一操作：
一旦满足了这些条件之一，Cookie和所有关联的Web活动就会关联到已知商机。
系统会为每个单独的浏览器创建新的匿名Web活动记录，因此，如果潜在客户首次使用新计算机和/或浏览器访问您的域，则必须再次进行此关联。
域
Munchkin会按域创建和跟踪各个Cookie，因此，为了使跨域进行已知商机跟踪，必须为每个域发生商机关联事件。 例如，如果我控制两个域marketo.com和example.com，并且潜在客户在marketo.com上填写表单，稍后导航到example.com，则他们在marketo.com上的活动在已知潜在客户记录中被跟踪，但是他们在example.com上的活动是匿名的。 但是，已知商机会在子域之间保留，因此www.example.com上的已知商机也是info.example.com上的已知商机。
如果您的顶级域由两部分组成（如.co.uk），请将domainLevel参数添加到Munchkin代码片段中，以便正确跟踪代码。 有关更多详细信息，请参阅此处。
Cookie
Munchkin Cookie使用键_mkto_trk，其值遵循此模式：
id:561\-HYG\-937&token:_mch\-marketo.com\-1374552656411\-90718
Munchkin Cookie特定于每个二级域，即example.com。 Cookie的默认有效期为2年（730天）。
Beta
要选择启用登陆页面的Munchkin测试版渠道，请转到您的管理员 — > Treasure Chest菜单，并启用“登陆页面上的Munchkin Beta”设置。 这会在 Admin ->中提供新的代码片段 Munchkin 菜单，允许您在外部网站上使用测试版。
选择禁用
通过将querystring参数“marketo_opt_out=true”添加到访客浏览器中的URL，访客可以选择完全退出Munchkin跟踪。 当Munchkin JavaScript检测到此设置时，它会尝试设置一个值为true的新Cookie“mkto_opt_out”。 删除所有其他Marketo跟踪Cookie，不设置新的Cookie，并且Munchkin在检测到此设置时不会发出任何HTTP请求。