Utilisation de la balise d'événement de conversion avec IBM Digital Analytics

Si votre site est intégré à IBM Digital Analytics, vous pouvez utiliser l'implémentation par défaut de la balise <cm:conversion /> que fournit HCL Commerce. La balise <cm:conversion /> génère la balise IBM Digital Analytics suivante : cmCreateConversionEventTag.

Placement de balises dans les pages de magasin

Un événement de conversion peut être un client qui s'abonne à un bulletin d'information ou ajoute un élément à une liste de souhaits. Incluez la balise <cm:conversion /> dans la page qui se charge lorsqu'un client déclenche l'événement de conversion spécifique. Par exemple :
  • Vous pouvez avoir un bouton S'abonner sur une page de magasin sur lequel les clients peuvent cliquer pour s'abonner à une newsletter. Pour suivre cet événement de conversion, placez la balise <cm:conversion /> dans la page qui se charge lorsque le client clique sur le bouton.
  • Pour suivre les clients qui ajoutent des éléments à une liste de souhaits, placez la balise <cm:conversion /> dans la page qui se charge immédiatement après que l'utilisateur a ajouté un élément à la liste de souhaits.
Cette balise n'est pas nécessaire sur les fragments JSP ou d'autres ressources de fichiers inclus.

Vous devez également inclure la bibliothèque de balises dans le fichier JSP avant le contenu de la page principale à l'aide du code suivant :


<%@ taglib uri="http://commerce.ibm.com/coremetrics" prefix="cm" %>

Exemple d'utilisation et de sortie de balise pour IBM Digital Data Exchange (DDX)

Si votre magasin HCL Commerce est intégré avec DDX pour simplifier la collecte de données d'analyse, la balise <cm:conversion /> génère des données dans l'objet JavaScript digitalData qui est envoyé à DDX. DDX peut ensuite relayer les données à IBM Digital Analytics. Les données générées dans cet objet JavaScript, peuvent ressembler à la sortie suivante :
digitalData = { pageInstanceID:'wcs-standardpage_wcs-productdetail', 
  event:[{eventInfo:{eventName: 'AddToWishlist', 
  eventAction: '2', eventPoints: '10'}, category:{primaryCategory: 'WISHLIST'}, 
  attributes:{exploreAttributes: '', extraFields: ''}}]}

Pour plus d'informations sur l'intégration à DDX, voir Intégration à IBM Digital Data Exchange.

Exemples d'utilisation de balise

La balise <cm:conversion /> génère la balise de données IBM Digital Analytics suivante :
cmCreateConversionEventTag(eventID, actionType, eventCategoryId, points, attributes, extraFields)

Exemple 1 :

Pour transmettre les données d'événements de conversion de base à IBM Digital Analytics :

Incluez une balise dans votre page de magasin avec le code suivant :
<cm:conversion eventId="AddToWishlist" category="WISHLIST" actionType="2" points="10"/>
Exemple de balise de données IBM Digital Analytics générée :
cmCreateConversionEventTag ("AddToWishlist", "2", "WISHLIST", "10")

Exemple 2 :

Pour transmettre les attributs Explore avec la balise d'événement de conversion à IBM Digital Analytics, utilisez le paramètre extraparms (première position) :

Incluez une balise dans votre page de magasin avec le code suivant :
<cm:conversion eventId="AddToWishlist" category="WISHLIST" actionType="2" points="10" 
extraparms="attr1-_-attr2-_-attr3"/>.
Exemple de balise de données IBM Digital Analytics générée :
cmCreateConversionEventTag ("AddToWishlist", "2", "WISHLIST", "10", 
"attr1-_-attr2-_-attr3")

Pour plus d'informations sur chaque paramètre de la balise de données IBM Digital Analytics, consultez la documentation fournie par IBM Digital Analytics.