API di tracciamento dei lead
Il JavaScript Munchkin di Marketo consente il tracciamento dei clic e delle visite degli utenti finali sulle pagine di destinazione Marketo e sulle pagine web esterne. Questi vengono registrati in Marketo come attività "Visita pagina web" e "Collegamento cliccato su pagina web", che possono quindi essere utilizzate nei trigger e nei filtri per le campagne intelligenti e gli elenchi avanzati.
Incorporazione del codice
L’istanza di Marketo fornisce automaticamente snippet di codice di tracciamento preconfigurati per incorporare nelle pagine esterne codice che tiene traccia dell’attività nell’istanza di Marketo. L'utilizzo del codice di incorporamento è disciplinato dal contratto di licenza.
Sono disponibili tre tipi di codici di tracciamento:
- Semplice: viene caricato in modo sincrono
- Asincrono - Caricamenti asincroni
- jQuery asincrona: viene caricato in modo asincrono e richiede il caricamento anticipato di jQuery.
Si consiglia vivamente di utilizzare il codice di tracciamento asincrono per incorporare Munchkin in pagine esterne. Per garantire il più alto tasso di successo possibile per l'esecuzione, incorpora il codice di tracciamento asincrono in <head> di ogni pagina.
Alcuni sistemi di gestione dei contenuti possono disporre di metodi o restrizioni specifici quando incorporano script arbitrari.
Per riferimento, la pagina finale deve includere un codice simile a questo in <head> del documento HTML:
<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>
Comportamento Munchkin
Per impostazione predefinita, Marketo Munchkin esegue le seguenti operazioni al caricamento della pagina:
- Verifica se il browser corrente dispone di un cookie Munchkin e, in caso contrario, creane uno.
- Invia un evento "Visita pagina web" all’istanza di Marketo designata utilizzando le informazioni della pagina corrente e del browser. Registra un’attività nel record corrispondente in Marketo.
- Invia l'evento "Collegamento selezionato su pagina Web" per tutti i clic dell'utente che si verificano sui collegamenti.
Il comportamento di Munchkin può essere modificato tramite l'utilizzo delle impostazioni di configurazione di Munchkin, ad esempio se viene creato un cookie per tutti i lead quando si visita la pagina con l'impostazione cookieAnon o se si modifica il ritardo di clic con l'impostazione clickTime. L’invio dell’attività Visita può essere disabilitato impostando apiOnly su true. A partire dalla versione 162 (agosto 2022), i clic tel e mailto collegamenti sono tracciati oltre a http/s collegamenti.
Lead noti e anonimi
Durante la prima visita di un lead a una pagina del tuo dominio, viene creato un nuovo record lead anonimo in Marketo. La chiave primaria per questo record è il cookie Munchkin (_mkto_trk) creato nel browser dell'utente. Tutte le successive attività web su quel browser vengono registrate su questo record anonimo. Per essere associato a un record noto in Marketo, è necessario che si verifichi una delle seguenti situazioni:
- Il lead deve visitare una pagina monitorata da Munchkin con un parametro
mkt_toknella stringa query da un collegamento e-mail di Marketo tracciato. - Il lead deve compilare un Marketo Form.
- È necessario inviare una chiamata syncLead o REST Associate Lead per SOAP.
Una volta soddisfatta una di queste condizioni, il cookie e tutte le attività web associate vengono associate al lead noto.
Viene creato un nuovo record anonimo di attività Web per ogni singolo browser, quindi se un lead visita il dominio per la prima volta utilizzando un nuovo computer e/o browser, l’associazione deve essere ripetuta.
Domini
Munchkin crea e tiene traccia di singoli cookie per ogni dominio. In questo modo, affinché il tracciamento dei lead noti venga eseguito in più domini, è necessario che si verifichi un evento di associazione dei lead per ogni dominio. Ad esempio, se controllo due domini, marketo.com e example.com, e un lead compila un modulo in marketo.com, quindi passa a example.com in un secondo momento, la loro attività in marketo.com viene tracciata su un record lead noto, ma la loro attività in example.com è anonima. Tuttavia, i lead noti persistono tra i sottodomini, pertanto un lead noto su www.example.com è anche un lead noto su info.example.com.
Nel caso in cui il dominio di primo livello sia composto da due parti, ad esempio .co.uk, aggiungere un parametro domainLevel allo snippet Munchkin affinché il codice possa essere tracciato correttamente. Vedi qui per ulteriori dettagli.
Cookie
Il cookie Munchkin utilizza la chiave _mkto_trk e ha un valore che segue questo modello:
id:561\-HYG\-937&token:_mch\-marketo.com\-1374552656411\-90718
I cookie Munchkin sono specifici di ogni dominio di secondo livello, ovvero example.com. La durata predefinita del cookie è di 2 anni (730 giorni).
Beta
Per accedere al canale beta Munchkin per le pagine di destinazione, vai al menu Amministratore -> Sfondo tesoro e abilita l'impostazione "Munchkin Beta sulle pagine di destinazione". In questo modo vengono forniti nuovi snippet di codice in Admin -> Menu Munchkin per consentire l'utilizzo della versione beta su siti esterni.
Rinuncia
I visitatori possono rinunciare completamente al tracciamento Munchkin aggiungendo il parametro querystring "marketo_opt_out=true" all'URL nel browser. Quando il JavaScript Munchkin rileva questa impostazione, tenta di impostare un nuovo cookie "mkto_opt_out" con un valore di true. Tutti gli altri cookie di tracciamento di Marketo vengono eliminati, non vengono impostati nuovi cookie e non vengono effettuate richieste HTTP da Munchkin quando viene rilevata questa impostazione.