Documentation Marketo Guide du développeur

API de suivi des pistes

Last update: Thu Jun 27 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Javascript

Créé pour :

Administration

Le code JavaScript Munchkin de Marketo permet le suivi des visites et des clics des pages des utilisateurs finaux vers vos pages Web externes et vos pages de destination Marketo. Elles sont enregistrées dans Marketo en tant qu’activités "Page web de visite" et "Lien cliqué sur la page web", qui peuvent ensuite être utilisées dans les déclencheurs et les filtres pour les campagnes dynamiques et les listes dynamiques.

Incorporation du code

Votre instance Marketo fournit automatiquement des fragments de code de suivi préconfigurés pour incorporer du code sur vos pages externes qui effectuent le suivi de l’activité vers votre instance Marketo. L’utilisation du code incorporé est régie par cette règle contrat de licence.

Trois types de code de suivi sont disponibles :

Simple : charge de manière synchrone
Asynchrone - Chargements asynchrones
jQuery asynchrone : charge de manière asynchrone et nécessite que jQuery soit chargé au préalable.

Il est vivement recommandé d’utiliser le code de suivi asynchrone pour incorporer Munchkin dans des pages externes. Pour garantir un taux de réussite maximal possible pour l’exécution, incorporez le code de suivi asynchrone dans <head> de chaque page.

Certains systèmes de gestion de contenu peuvent avoir des méthodes ou des restrictions spécifiques lors de l’incorporation de scripts arbitraires.

À titre de référence, votre dernière page doit inclure un code similaire à celui-ci dans <head> de votre document d’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>

Comportement de Munchkin

Le comportement par défaut de Marketo Munchkin consiste à effectuer les opérations suivantes au chargement de la page :

Vérifiez si le navigateur actuel comporte un cookie Munchkin et créez-en un s’il n’y est pas.
Envoyez un événement "Visite de page web" à l’instance Marketo désignée à l’aide des informations de la page et du navigateur actifs. Cette opération enregistre une activité sur l’enregistrement correspondant dans Marketo.
Envoyez l’événement "Lien cliqué sur la page web" pour tout clic de l’utilisateur sur les liens.

Le comportement de Munchkin peut être modifié par l'utilisation de Munchkin Paramètres de configuration, par exemple si un cookie est créé pour tous les prospects lors de leur visite sur la page avec la variable cookieAnon paramètre ou modification du délai de clic avec clickTime . L’envoi de l’activité Visite peut être désactivé en définissant le paramètre apiOnly sur true. Depuis la version 162 (août 2022), les clics tel et mailto Le suivi des liens s’ajoute aux http/s liens.

Pistes connues et anonymes

Lors de la première visite d’une piste sur une page de votre domaine, un nouvel enregistrement de piste anonyme est créé dans Marketo. La clé primaire de cet enregistrement est le cookie Munchkin (_mkto_trk) qui est créé dans le navigateur de l’utilisateur. Toutes les activités web suivantes sur ce navigateur sont enregistrées pour cet enregistrement anonyme. Pour être associé à un enregistrement connu dans Marketo, l’un des événements suivants doit se produire :

Le prospect doit consulter une page suivie par Munchkin avec une mkt_tok dans la chaîne de requête à partir d’un lien de courrier électronique Marketo suivi.
Le prospect doit remplir un formulaire Marketo.
SOAP syncLead ou REST Associer le prospect doit être envoyé.

Une fois l’une de ces conditions remplie, le cookie et toutes les activités Web associées sont associés au prospect connu.

Un nouvel enregistrement anonyme d’activité web est créé pour chaque navigateur. Ainsi, si une piste se rend pour la première fois sur votre domaine à l’aide d’un nouvel ordinateur et/ou d’un nouveau navigateur, cette association doit se reproduire.

Domaines

Munchkin crée et suit des cookies individuels sur une base par domaine. Par conséquent, pour que le suivi des pistes connues se produise sur plusieurs domaines, un événement d’association de pistes doit se produire pour chaque domaine. Par exemple, si je contrôle deux domaines, marketo.com, et example.com, et un prospect remplit un formulaire sur marketo.com, puis accède à example.com par la suite, puis leur activité sur marketo.com est suivi sur un enregistrement de piste connu, mais son activité sur example.com est anonyme. Toutefois, les pistes connues persistent dans les sous-domaines, de sorte qu’une piste connue sur www.example.com est également un prospect connu sous info.example.com.

Si votre domaine de niveau supérieur est composé de deux parties, telles que .co.uk, puis ajoutez un paramètre domainLevel à votre fragment de code Munchkin pour que le code soit correctement suivi. Voir here pour plus d’informations.

Le cookie Munchkin utilise la clé _mkto_trket a une valeur qui suit ce modèle :

id:561\-HYG\-937&token:_mch\-marketo.com\-1374552656411\-90718

Les cookies Munchkin sont spécifiques à chaque domaine de second niveau, c’est-à-dire : example.com. La durée de vie par défaut du cookie est de 2 ans (730 jours).

Bêta

Pour vous inscrire au canal bêta Munchkin pour vos landing pages, accédez à Admin -> Poitrine au trésor et activez le paramètre "Munchkin Beta on Landing Pages". De nouveaux fragments de code sont alors proposés dans la section Administration -> Munchkin pour vous permettre d’utiliser la version bêta sur des sites externes.

Exclusion

Les visiteurs peuvent exclure le suivi Munchkin entièrement en ajoutant la variable querystring le paramètre "marketo_opt_out=true" à l’URL dans leur navigateur. Lorsque le code JavaScript Munchkin détecte ce paramètre, il tente de définir un nouveau cookie "mkto_opt_out" avec la valeur true. Tous les autres cookies de suivi Marketo sont supprimés, aucun nouveau cookie n’est défini et aucune requête HTTP n’est effectuée par Munchkin lorsque ce paramètre est détecté.

recommendation-more-help

bb269a6d-047a-4bf7-9acd-23ad9a63dc59