Riferimento API di Munchkin

Ultimo aggiornamento: 22 novembre 2024

Creato per:

  • Amministratore

Munchkin fornisce diverse funzioni che possono essere richiamate manualmente tramite JavaScript. Questi possono consentire il tracciamento personalizzato degli eventi del browser, come la riproduzione di video, o i clic su elementi non collegati.

Funzioni

L'API Munchkin è composta dalle seguenti funzioni: init, createTrackingCookie, munchkinFunction.

Munchkin.init()

Munchkin.init() deve essere chiamato prima di qualsiasi altra funzione. Imposta Munchkin sulla pagina corrente per inviare attività a un’istanza specifica e genera un’attività "Pagina web visite" per la pagina corrente.

Nome parametroFacoltativo/ObbligatorioTipoDescrizione
ID MunchkinObbligatorioStringaL’ID account Munchkin si trova nel menu Amministrazione > Integrazione > Munchkin. Imposta l'istanza di destinazione a cui inviare le attività.
Impostazioni di configurazioneFacoltativoOggettoAbilita impostazioni di comportamento alternative per Munchkin.
Munchkin.init('299-BYM-827');

Munchkin.createTrackingCookie()

Quando viene chiamato, questo controlla che nel browser esista un cookie _mkto_trk e, in caso contrario, ne crea uno. Questa opzione è utile per tenere traccia degli utenti durante azioni specifiche, ad esempio la registrazione o il download di una risorsa, se cookieAnon è impostato su false.

Nome parametroFacoltativo/ObbligatorioTipoDescrizione
forceCreateObbligatorioBooleanoCrea cookie anche se cookieAnon è impostato su false.
Munchkin.createTrackingCookie(true);

Munchkin.munchkinFunction()

Utilizzato per generare comportamenti di tracciamento personalizzati, come riproduzioni e pause del lettore video, o visite alle pagine per navigazione non standard, come i codici hash.

Nome parametroFacoltativo/ObbligatorioTipoDescrizione
Tipo di funzioneObbligatorioStringaDetermina l’attività da registrare. Valori consentiti: visitWebPage, clickLink, associateLead
DatiObbligatorioOggettoContiene i dati per l’attività da registrare.

visitWebPage

La chiamata a munchkinFunction() con visitWebPage invia un'attività 'visita' per l'utente corrente a Marketo. È possibile personalizzare l'URL e querystring inviati con l'oggetto dati nel secondo argomento.

Nome proprietà datiFacoltativo/ObbligatorioTipoDescrizione
urlObbligatorioStringaPercorso del file URL utilizzato per registrare una visita di pagina. Questo valore viene aggiunto al nome di dominio corrente per creare il nome di pagina completo. Ad esempio, se l'URL è /index.html e il nome di dominio è www.example.com, la pagina visitata viene registrata come www.example.com/index.html.
parametriFacoltativoStringaStringa di query dei parametri desiderati da registrare.

Ad esempio, foo=bar&biz=baz.

Munchkin.munchkinFunction('visitWebPage', {
        'url': '/Football/Team/Seahawks',
        'params': 'defense=legion_of_boom&qb=wilson'
    }
);

La chiamata a munchkinFunction() con clickLink invia un'attività di clic per l'utente corrente a Marketo. È possibile personalizzare l'URL di clic con la proprietà href nell'oggetto dati.

Nome proprietà datiFacoltativo/ObbligatorioTipoDescrizione
hrefObbligatorioStringaPercorso del file URL utilizzato per registrare il clic su un collegamento. Questo valore viene aggiunto al nome di dominio corrente per creare un collegamento completo.

Ad esempio, se href è /index.html e il nome di dominio è www.example.com, il clic sul collegamento verrà registrato come www.example.com/index.html.

Munchkin.munchkinFunction('clickLink', {
        'href': '/Football/Team/Seahawks'
    }
);