Suivi des événements de conversion Target à l’aide du SDK Web Platform

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
NOTE
Le SDK Web Platform permet un meilleur contrôle des valeurs transmises dans le payload de requête. Pour vous assurer que les fonctionnalités Target telles que les URL AQ et les objectifs de conversion "A affiché une page" fonctionnent correctement, vérifiez que la valeur xdm.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.

Cas d’utilisation
Target at.js 2.x
SDK Web de Platform
Suivi d’un événement de conversion de clics pour un emplacement de mbox (portée)
Exécutez trackEvent() ou sendNotifications() avec une valeur type de click pour un emplacement de mbox spécifique.
Exécutez une commande sendEvent avec un type d’événement decisioning.propositionInteract
Suivi d’un événement de conversion personnalisé qui peut également inclure des données supplémentaires, telles que des paramètres de profil Target
Exécutez trackEvent() ou sendNotifications() avec une valeur type de display pour un emplacement de mbox spécifique.
Exécutez une commande sendEvent avec un type d’événement decisioning.propositionDisplay
NOTE
Bien que decisioning.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
Nous nous engageons à vous aider à réussir la migration de Target d’at.js vers le SDK Web. Si vous rencontrez des obstacles lors de votre migration ou si vous pensez qu’il manque des informations essentielles dans ce guide, faites-le-nous savoir en publiant sur cette discussion communautaire.
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110