API för lead-spårning
Marketo Munchkin JavaScript gör det möjligt att spåra besök och klickningar på Marketo landningssidor och externa webbsidor. Dessa spelas in i Marketo som aktiviteter av typen"Besök webbsida" och"Länka på webbsida" som du klickat på", som sedan kan användas i utlösare och filter för smarta kampanjer och smarta listor.
Bädda in koden
Din Marketo-instans innehåller automatiskt förkonfigurerade spårningskod för att bädda in kod på dina externa sidor som spårar aktiviteten tillbaka till din Marketo-instans. Användning av inbäddningskoden regleras av det här licensavtalet.
Det finns tre typer av spårningskod:
- Enkel - läser in synkront
- Asynkron - läser in asynkront
- Asynkron jQuery - laddar asynkront och kräver att jQuery läses in i förväg
Vi rekommenderar starkt att den asynkrona spårningskoden används för att bädda in Munchkin på externa sidor. För att säkerställa högsta möjliga lyckade hastighet för körning bäddar du in den asynkrona spårningskoden i <head> på varje sida.
Vissa innehållshanteringssystem kan ha specifika metoder eller begränsningar när du bäddar in godtyckliga skript.
Som referens bör den sista sidan innehålla kod som liknar den här i <head> i ditt HTML-dokument:
<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>
Munchkins beteende
Marketo Munchkins standardbeteende är att göra följande vid sidinläsning:
- Kontrollera om webbläsaren har en Munchkin-cookie och skapa en om den inte finns där.
- Skicka en"Besök webbsida"-händelse till den angivna Marketo-instansen med hjälp av informationen från den aktuella sidan och webbläsaren. Detta registrerar en aktivitet till motsvarande post i Marketo.
- Skicka händelsen"Klicka på Länk på webbsida" för alla användarklick som inträffar på länkar.
Munchkins beteende kan ändras med konfigurationsinställningarnaför Munchkin, till exempel om en cookie skapas för alla leads när du besöker sidan med inställningen cookieAnon eller om klickfördröjningen ändras med inställningen clickTime . Det går inte att skicka besöksaktiviteten genom att ange inställningen apiOnly till true. Från och med version 162 (augusti 2022) spåras både länkar för tel och mailto förutom länkar för http/s.
Kända och anonyma leads
På en leads första besök på en sida på din domän skapas en ny anonym lead-post i Marketo. Primärnyckeln för den här posten är Munchkin-cookien (_mkto_trk) som skapas i användarens webbläsare. Alla efterföljande webbaktiviteter i den webbläsaren registreras mot den här anonyma posten. För att kunna kopplas till en känd post i Marketo måste något av följande inträffa:
- Ledningen måste besöka en Munchkin-spårad sida med en
mkt_tok-parameter i frågesträngen från en spårad e-postlänk från Marketo. - Lead-blanketten måste fylla i ett Marketo-formulär.
- SOAP syncLead eller REST Associate Lead måste skickas.
När ett av dessa villkor är uppfyllt kopplas cookien och all tillhörande webbaktivitet till det kända leadet.
En ny anonym webbaktivitetspost skapas för varje enskild webbläsare, så om en lead besöker din domän för första gången med en ny dator och/eller webbläsare måste den här associationen göras igen.
Domäner
Munchkin skapar och spårar enskilda cookies per domän, så för att kända leads ska kunna spåras över domäner måste en lead-associationshändelse inträffa för varje domän. Om jag till exempel kontrollerar två domäner, marketo.com, och example.com, och en lead fyller i ett formulär på marketo.com, navigerar sedan till example.com, spåras deras aktivitet på marketo.com på en känd lead-post, men deras aktivitet på example.com är anonym. Kända leads finns dock över underdomäner, så ett känt lead på www.example.com är också ett känt lead på info.example.com.
Om din toppnivådomän är två delar, till exempel .co.uk, lägger du sedan till en domainLevel-parameter i Munchkin-fragmentet för att koden ska kunna spåras korrekt. Mer information finns här.
Cookie
Munchkin-cookien använder nyckeln _mkto_trk och har ett värde som följer det här mönstret:
id:561\-HYG\-937&token:_mch\-marketo.com\-1374552656411\-90718
Munchkin-cookies är specifika för varje sekundärdomän, det vill säga example.com. Kakans standardlivscykel är 2 år (730 dagar).
Beta
Gå till menyn Admin -> Treasure Chest och aktivera inställningen "Munchkin Beta on Landing Pages" för att välja betakanalen för dina landningssidor i Munchkin. Detta innehåller nya kodfragment i Admin -> Munchkin -menyn så att du kan använda betaversionen på externa platser.
Avanmäl dig
Besökare kan välja bort helt Munchkin-spårning genom att lägga till parametern querystring "marketo_opt_out=true" i URL:en i webbläsaren. När Munchkin JavaScript identifierar den här inställningen försöker den att ange en ny cookie med värdet true. Alla andra Marketo-spårningscookies tas bort, inga nya cookies anges och inga HTTP-begäranden görs av Munchkin när den här inställningen identifieras.