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

Les événements de conversion pour Target peuvent être suivis à l’aide du SDK web de Platform comme avec at.js. Les événements de conversion sont généralement classés dans les catégories suivantes :

  • Événements suivis automatiquement qui ne nécessitent aucune configuration
  • Achat d’événements de conversion à ajuster pour une implémentation de SDK web de Platform conforme aux bonnes pratiques
  • Événements de conversion hors achat qui nécessitent des mises à jour de code

Comparaison du suivi des objectifs

Le tableau suivant compare la manière dont at.js et Platform Web SDK 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 requête at.js.
Suivi automatiquement. En fonction de la valeur de xdm.web.webPageDetails.URL dans la payload sendEvent
Conversion > Mbox affichée
Suivi par la demande d’emplacement de mbox d’affichage ou de notification à l’aide de trackEvent() ou sendNotifications() avec une valeur type de display.
Suivi à l’aide d’un appel de sendEvent Platform Web SDK avec le eventType de decisioning.propositionDisplay.
Conversion > Clic sur un élément
Suivi automatique pour les activités basées sur le VEC. S’affiche sous la forme d’un appel réseau at.js avec un objet notifications dans la payload de la requête et une valeur type de click.
Suivi automatique pour les activités basées sur le VEC. Apparaît comme un appel de sendEvent Platform Web SDK avec la eventType de decisioning.propositionInteract.
Engagement > Pages vues
Suivi automatique
Suivi automatique
Engagement > Temps passé sur le site
Suivi automatique
Suivi automatique

Événements suivis automatiquement

Les objectifs de conversion suivants ne nécessitent aucun ajustement spécifique à votre implémentation :

  • Conversion > A affiché une page
  • Conversion > Clic sur un élément
  • Engagement > Pages vues
  • Engagement > Temps passé sur le site
NOTE
Platform Web SDK permet de mieux contrôler les valeurs transmises dans la payload de requête. Pour que les fonctionnalités de Target telles que les URL d’assurance qualité et les objectifs de conversion « A affiché une page » fonctionnent correctement, vérifiez que la valeur xdm.web.webPageDetails.URL contient l’URL de page complète avec la casse de caractères appropriée.

Événements suivis sur mesure

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 basées sur les formulaires, pour signifier une conversion dans un flux ou pour transmettre des paramètres sans demander de nouveau contenu.

Le tableau ci-dessous décrit l’approche at.js et l’équivalent de Platform Web SDK pour quelques cas d’utilisation courants du suivi des conversions.

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
Effectuez le suivi d’un événement de conversion personnalisé qui peut également inclure des données supplémentaires, telles que les 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 des impressions pour des portées spécifiques, il doit également être utilisé comme remplacement direct des trackEvent() at.js . La fonction trackEvent() est définie par défaut sur un type de display si elle n’est pas spécifiée. Vérifiez votre mise en œuvre pour vous assurer d’utiliser le type d’événement correct pour toutes les conversions personnalisées que vous avez définies.

Reportez-vous à la documentation at.js dédiée pour plus d’informations sur l’utilisation de trackEvent() et de sendNotifications() pour le suivi des événements Target.

Exemple d’utilisation d’at.js avec 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 de Platform Web SDK, vous pouvez effectuer le suivi des événements et des actions des utilisateurs et utilisatrices en appelant la commande sendEvent, en renseignant le groupe de champs XDM _experience.decisioning.propositions et en définissant la eventType sur l’une des deux valeurs suivantes :

  • decisioning.propositionDisplay : signale le rendu de l’activité Target.
  • decisioning.propositionInteract : signale 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
                  }
                }
              }
            });
          });
        }
      }
    }
  }
});

Découvrez ensuite comment activer le partage d’identifiants entre domaines pour des profils de visiteurs cohérents.

NOTE
Nous nous engageons à vous aider à réussir la migration de Target d’at.js vers Web SDK. Si vous rencontrez des obstacles avec votre migration ou si vous pensez qu'il manque des informations essentielles dans ce guide, veuillez nous le faire savoir en postant dans cette discussion communautaire.
recommendation-more-help
platform-learn-help-tutorial-migrate-target-websdk