API de rastreamento de lead
O Munchkin JavaScript da Marketo permite rastrear as visitas da página do usuário final e os cliques nas páginas de aterrissagem do Marketo e páginas da Web externas. Elas são registradas no Marketo como atividades "Visitar página da Web" e "Link clicado na página da Web", que podem ser usadas em acionadores e filtros para Campanhas inteligentes e Smart Lists.
Incorporação do código
A instância do Marketo fornece automaticamente trechos de código de rastreamento pré-configurados para incorporar o código nas páginas externas que rastreiam a atividade de volta para a instância do Marketo. O uso do código de inserção é regido por este contrato de licença.
Há três tipos de código de rastreamento disponíveis:
- Simples - Carrega de forma síncrona
- Assíncrono - Carrega de forma assíncrona
- jQuery assíncrono - carrega de forma assíncrona e requer que o jQuery seja carregado antecipadamente
É altamente recomendável que o código de rastreamento assíncrono seja usado para incorporar o Munchkin em páginas externas. Para garantir a maior taxa de sucesso possível para execução, incorpore o código de rastreamento assíncrono em <head> de cada página.
Alguns sistemas de gerenciamento de conteúdo podem ter restrições ou métodos específicos ao incorporar scripts arbitrários.
Para referência, sua página final deve incluir código semelhante a este em <head> do seu 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 do Munchkin
O comportamento padrão do Marketo Munchkin é fazer o seguinte no carregamento da página:
- Verifique se o navegador atual tem um cookie Munchkin e crie um se ele não estiver lá.
- Envie um evento "Visitar página da Web" para a instância do Marketo designada usando as informações da página atual e do navegador. Isso registra uma atividade no registro correspondente no Marketo.
- Envie o evento "Link clicado na página da Web" para qualquer clique do usuário que ocorra em links.
O comportamento do Munchkin pode ser modificado por meio das Configurações do Munchkin, como a criação de um cookie para todos os clientes potenciais ao visitar a página com a configuração cookieAnon ou a modificação do atraso de clique com a configuração clickTime. O envio da atividade Visit pode ser desabilitado ao definir a configuração apiOnly como true. A partir da versão 162 (agosto de 2022), os links de cliques tel e mailto serão rastreados além dos links http/s.
Clientes potenciais conhecidos e anônimos
Na primeira visita de um lead a uma página em seu domínio, um novo registro de lead anônimo é criado no Marketo. A chave primária para este registro é o cookie Munchkin (_mkto_trk) criado no navegador do usuário. Toda atividade subsequente da Web nesse navegador é registrada em relação a esse registro anônimo. Para ser associado a um registro conhecido no Marketo, uma das seguintes situações deve ocorrer:
- O cliente potencial deve visitar uma página rastreada pelo Munchkin com um parâmetro
mkt_tokna sequência de consulta de um link de email do Marketo rastreado. - O cliente em potencial deve preencher um formulário do Marketo.
- Uma chamada SOAP syncLead ou REST Associar Lead deve ser enviada.
Quando uma dessas condições é atendida, o cookie e todas as atividades da Web associadas são associados ao lead conhecido.
Um novo registro anônimo de atividade na Web é criado para cada navegador individual; portanto, se um cliente potencial visitar seu domínio pela primeira vez usando um novo computador e/ou navegador, essa associação deverá ocorrer novamente.
Domínios
O Munchkin cria e rastreia cookies individuais por domínio, de modo que para que o rastreamento de lead conhecido ocorra entre domínios, um evento de associação de lead deve ocorrer para cada domínio. Por exemplo, se eu controlar dois domínios, marketo.com e example.com, e um cliente potencial preencher um formulário em marketo.com, depois navegar para example.com, sua atividade em marketo.com será rastreada em um registro de cliente potencial conhecido, mas sua atividade em example.com será anônima. Os clientes em potencial conhecidos persistem entre subdomínios, portanto, um cliente em potencial conhecido em www.example.com também é um cliente em potencial conhecido em info.example.com.
No caso de seu domínio de nível superior ter duas partes, como .co.uk, adicione um parâmetro domainLevel ao seu trecho Munchkin para que o código seja rastreado corretamente. Consulte aqui para obter mais detalhes.
Cookie
O cookie Munchkin usa a chave _mkto_trk e tem um valor seguindo este padrão:
id:561\-HYG\-937&token:_mch\-marketo.com\-1374552656411\-90718
Os cookies do Munchkin são específicos para cada domínio de segundo nível, ou seja, example.com. A duração padrão do cookie é de 2 anos (730 dias).
Beta
Para participar do canal beta do Munchkin para suas páginas de aterrissagem, acesse o menu Admin -> Treasure Chest e ative a configuração "Munchkin Beta on Landing Pages". Isso fornece novos trechos de código no Administrador -> Menu Munchkin para permitir que você use a versão beta em sites externos.
Recusar
Os visitantes podem recusar totalmente o rastreamento do Munchkin adicionando o parâmetro querystring "marketo_opt_out=true" ao URL no navegador. Quando o Munchkin JavaScript detecta essa configuração, ele tenta definir um novo cookie "mkto_opt_out" com um valor de true. Todos os outros cookies de rastreamento do Marketo são excluídos, nenhum cookie novo é definido e nenhuma solicitação HTTP é feita pelo Munchkin quando essa configuração é detectada.