API voor bijhouden van leads
Met Marketo Munchkin JavaScript kunt u bezoeken aan eindgebruikerspagina's bijhouden en op Marketo-bestemmingspagina's en externe webpagina's klikken. Deze worden geregistreerd in Marketo als "Bezoek Web-pagina"en "Geklikte Verbinding op Web-pagina"activiteiten, die dan in trekkers en filters voor Slimme Campagnes en Slimme Lijsten kunnen worden gebruikt.
De code insluiten
Uw Marketo-instantie beschikt automatisch over vooraf geconfigureerde codefragmenten voor het bijhouden van code om code in te sluiten op uw externe pagina's die de activiteit naar uw Marketo-exemplaar traceren. Het gebruik van de insluitcode wordt door deze licentieovereenkomst.
Er zijn drie typen trackingcode beschikbaar:
- Eenvoudig - Wordt synchroon geladen
- Asynchroon - Wordt asynchroon geladen
- Asynchrone jQuery - Wordt asynchroon geladen en vereist dat jQuery vooraf wordt geladen
Het wordt ten zeerste aanbevolen de asynchrone trackingcode te gebruiken voor het insluiten van Munchkin op externe pagina's. Sluit de asynchrone trackingcode in om ervoor te zorgen dat de uitvoering met de hoogst mogelijke successnelheid verloopt <head> van elke pagina.
Bepaalde systemen voor inhoudsbeheer hebben mogelijk specifieke methoden of beperkingen bij het insluiten van willekeurige scripts.
Ter referentie moet de laatste pagina code bevatten die hierop lijkt <head> van uw HTML-document:
<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-gedrag
Marketo Munchkin functioneert standaard als volgt bij het laden van pagina's:
- Controleer of de huidige browser een Munchkin-cookie heeft en maak er een als deze er niet is.
- Verzend een "Bezoek Web-pagina"gebeurtenis aan de aangewezen instantie van Marketo gebruikend de informatie van de huidige pagina en browser. Hiermee wordt een activiteit vastgelegd in de corresponderende record in Marketo.
- Verzend de gebeurtenis "Geplikte Verbinding op Web-pagina"voor om het even welke gebruiker klikt die op verbindingen voorkomen.
Het gedrag van Munchkin kan worden gewijzigd door het gebruik van Munchkin Configuratie-instellingen, bijvoorbeeld of een cookie is gemaakt voor alle leads bij het bezoeken van de pagina met de cookieAnon instellen of de klikvertraging wijzigen met clickTime instellen. Het verzenden van de activiteit van het Bezoek kan worden onbruikbaar gemaakt door apiOnly te plaatsen die aan waar plaatst. Vanaf versie 162 (augustus 2022) klikt u op tel en mailto koppelingen worden naast http/s koppelingen.
Bekende en anonieme leads
Bij het eerste bezoek van een lead aan een pagina op uw domein wordt een nieuwe anonieme lead record gemaakt in Marketo. De primaire sleutel voor deze record is het Munchkin-cookie (_mkto_trk) wordt gemaakt in de browser van de gebruiker. Alle volgende webactiviteiten in die browser worden opgenomen op basis van deze anonieme record. Om aan een bekend record in Marketo te kunnen worden gekoppeld, moet een van de volgende dingen plaatsvinden:
- De lead moet naar een pagina gaan die door Munchkin wordt bijgehouden en die een
mkt_tokparameter in de queryreeks van een bijgehouden Marketo-e-mailkoppeling. - De lead moet een Marketo-formulier invullen.
- A SOAP syncLead of REST Associate Lead de vraag moet worden verzonden.
Wanneer aan een van deze voorwaarden is voldaan, worden het cookie en alle bijbehorende webactiviteit gekoppeld aan de bekende lead.
Voor elke afzonderlijke browser wordt een nieuwe anonieme webactiviteitenrecord gemaakt. Als een lead uw domein dus voor het eerst bezoekt met een nieuwe computer en/of browser, moet deze koppeling opnieuw plaatsvinden.
Domeinen
Munchkin maakt en volgt afzonderlijke cookies per domein. Voor bekende 'lead tracking' in verschillende domeinen moet dus voor elk domein een 'lead association'-gebeurtenis plaatsvinden. Als ik bijvoorbeeld twee domeinen bestel, marketo.com, en example.comen een lead een formulier invult op marketo.com, navigeert vervolgens naar example.com later, dan hun activiteit op marketo.com wordt getraceerd op een bekende loodrecord, maar hun activiteit wordt example.com is anoniem. Bekende leads blijven echter bestaan over subdomeinen, dus een bekende lead op www.example.com is ook bekend dat info.example.com.
In het geval dat uw bovenste domein twee delen is, zoals .co.ukvoegt u vervolgens een domainLevel-parameter toe aan uw Munchkin-fragment, zodat de code correct wordt bijgehouden. Zie hier voor meer informatie .
Cookie
Het Munchkin-cookie gebruikt de toets _mkto_trken heeft een waarde die volgt op dit patroon:
id:561\-HYG\-937&token:_mch\-marketo.com\-1374552656411\-90718
Munchkin-cookies zijn specifiek voor elk domein op het tweede niveau, dat wil zeggen: example.com. De standaardlevensduur van de cookie is 2 jaar (730 dagen).
Beta
Ga naar uw Admin -> Treasure Chest en schakelt u de instelling "Munchkin Beta on Landing Pages" in. Dit levert nieuwe codefragmenten in Admin -> Munchkin gebruiken op externe sites.
Uitschakelen
Bezoekers kunnen Munchkin-tracking volledig uitschakelen door de querystring parameter "marketo_opt_out=true" aan de URL in hun browser. Wanneer de JavaScript-code voor Munchkin deze instelling detecteert, wordt geprobeerd een nieuwe cookie "mkto_opt_out" in te stellen met de waarde true. Alle andere volgcookies van Marketo worden verwijderd, er worden geen nieuwe cookies ingesteld en er worden geen HTTP-aanvragen ingediend door Munchkin wanneer deze instelling wordt gedetecteerd.