Suivi des événements de conversion Target à l’aide du SDK Web Platform
Créé pour :
- Intermédiaire
- Expérimenté
- Développeur
Il est possible d’effectuer le suivi des événements de conversion pour Target avec le SDK Web Platform, comme pour at.js. Les événements de conversion se répartissent généralement dans les catégories suivantes :
- Suivi automatique des événements qui ne nécessitent aucune configuration
- Événements de conversion d’achat qui doivent être ajustés en fonction d’une mise en oeuvre recommandée du SDK Web Platform
- Événements de conversion hors achat nécessitant des mises à jour du code
Comparaison des objectifs
Le tableau suivant compare la manière dont at.js et le SDK Web Platform effectuent le suivi des événements de conversion.
| Objectif de l’activité | Target at.js 2.x | SDK Web de Platform |
|---|---|---|
| Conversion > A affiché une page | Suivi automatiquement. En fonction de la valeur de context.address.url dans le payload de la requête at.js. | Suivi automatiquement. Basé sur la valeur de xdm.web.webPageDetails.URL dans la payload sendEvent |
| Conversion > A affiché une mbox | Suivi avec la requête d’emplacement de mbox d’affichage ou de notification utilisant trackEvent() ou sendNotifications() avec une valeur type de display. | Suivi avec un appel du SDK Web Platform sendEvent avec le eventType de decisioning.propositionDisplay. |
| Conversion > Cliqué sur un élément | Suivi automatiquement pour les activités basées sur le compositeur d’expérience visuelle. S’affiche sous la forme d’un appel réseau at.js avec un objet notifications dans le payload de la requête et une valeur type de click. | Suivi automatiquement pour les activités basées sur le compositeur d’expérience visuelle. Apparaît comme un appel du SDK Web Platform sendEvent avec le eventType de decisioning.propositionInteract. |
| Engagement > Pages vues | Suivi automatiquement | Suivi automatiquement |
| Engagement > Durée du site | Suivi automatiquement | Suivi automatiquement |
Événements automatiquement suivis
Les objectifs de conversion suivants ne nécessitent aucun ajustement spécifique à votre mise en oeuvre :
- Conversion > A affiché une page
- Conversion > Cliqué sur un élément
- Engagement > Pages vues
- Engagement > Durée du site
NOTExdm.web.webPageDetails.URL contient l’URL de la page entière avec la casse de caractères appropriée.Événements suivis personnalisés
Les implémentations de Target utilisent généralement des événements de conversion personnalisés pour effectuer le suivi des clics pour les activités d’après les formulaires, indiquer une conversion dans un flux ou transmettre des paramètres sans demander de nouveau contenu.
Le tableau ci-dessous décrit l’approche d’at.js et l’équivalent du SDK Web Platform pour quelques cas d’utilisation de suivi de conversion courants.
trackEvent() ou sendNotifications() avec une valeur type de click pour un emplacement de mbox spécifique.sendEvent avec un type d’événement decisioning.propositionInteracttrackEvent() ou sendNotifications() avec une valeur type de display pour un emplacement de mbox spécifique.sendEvent avec un type d’événement decisioning.propositionDisplayNOTEdecisioning.propositionDisplay soit le plus souvent utilisé pour incrémenter les impressions pour des portées spécifiques, il doit également être utilisé comme remplacement direct pour at.js trackEvent() en général. La fonction trackEvent() est définie par défaut sur un type display s’il n’est pas spécifié. Vérifiez votre mise en oeuvre pour vous assurer d’utiliser le type d’événement correct pour toutes les conversions personnalisées que vous avez définies.Pour plus d’informations sur l’utilisation de trackEvent() et de sendNotifications() pour le suivi des événements Target, reportez-vous à la documentation at.js dédiée.
Exemple d’at.js utilisant trackEvent() pour effectuer le suivi d’un clic sur un emplacement de mbox :
adobe.target.trackEvent({
"type": "click",
"mbox": "homepage_hero"
});
Avec une implémentation du SDK Web Platform, vous pouvez effectuer le suivi des événements et des actions de l’utilisateur en appelant la commande sendEvent, en renseignant le groupe de champs XDM _experience.decisioning.propositions et en définissant eventType sur l’une des deux valeurs suivantes :
decisioning.propositionDisplay: Indique le rendu de l’activité Target.decisioning.propositionInteract: indique une interaction de l’utilisateur avec l’activité, comme un clic de souris.
Le groupe de champs XDM _experience.decisioning.propositions est un tableau d’objets. Les propriétés de chaque objet sont dérivées de la result.propositions renvoyée dans la commande sendEvent : { id, scope, scopeDetails }
alloy("sendEvent", {
xdm: { ...},
decisionScopes: ["hero-banner"]
}).then(function (result) {
var propositions = result.propositions;
if (propositions) {
// Find the discount proposition, if it exists.
for (var i = 0; i < propositions.length; i++) {
var proposition = propositions[i];
for (var j = 0; j < proposition.items; j++) {
var item = proposition.items[j];
if (item.schema === "https://ns.adobe.com/personalization/measurement") {
// add metric to the DOM element
const button = document.getElementById("form-based-click-metric");
button.addEventListener("click", event => {
const executedPropositions = [
{
id: proposition.id,
scope: proposition.scope,
scopeDetails: proposition.scopeDetails
}
];
// send the click track event
alloy("sendEvent", {
"xdm": {
"eventType": "decisioning.propositionInteract",
"_experience": {
"decisioning": {
"propositions": executedPropositions
}
}
}
});
});
}
}
}
}
});
Apprenez ensuite à activer le partage d’ID inter-domaines pour des profils de visiteurs cohérents.
NOTE