Documentation Marketo Guide du développeur

API de suivi des pistes

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Javascript

Créé pour :

Administration

Marketo JavaScript Munchkin 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 ce 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 le taux de réussite le plus élevé 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é en utilisant les paramètres de configuration de Munchkin, par exemple si un cookie est créé pour tous les prospects lors de leur visite sur la page avec le paramètre cookieAnon ou en modifiant le délai de clics avec le paramètre 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 sur les liens tel et mailto sont suivis en plus des liens http/s.

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 un paramètre 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.
Un appel SOAP syncLead ou REST Associate Lead 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 qu’une piste remplit un formulaire sur marketo.com, puis accède à example.com plus tard, son activité sur marketo.com est suivie sur un enregistrement de piste connu, mais son activité sur example.com est anonyme. Cependant, les pistes connues persistent dans les sous-domaines. Par conséquent, une piste connue sur www.example.com est également une piste connue sur info.example.com.

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

Le cookie Munchkin utilise la clé _mkto_trk et a une valeur suivant 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 activer le canal bêta Munchkin pour vos landing pages, accédez au menu Admin -> Treasure Chest et activez le paramètre "Munchkin Beta on Landing Pages". Ceci fournit de nouveaux fragments de code dans le Admin -> Le menu Munchkin vous permet d’utiliser la version bêta sur des sites externes.

Exclusion

Les visiteurs peuvent exclure entièrement le suivi Munchkin en ajoutant le paramètre querystring "marketo_opt_out=true" à l’URL dans leur navigateur. Lorsque le 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