Utilisation de la balise d'élément 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:element /> que fournit HCL Commerce. La balise <cm:element /> génère la balise IBM Digital Analytics suivante : cmCreateElementTag.

Placement de balises dans les pages de magasin

Incluez la balise <cm:element /> dans la page qui se charge à la suite de l'interaction du client avec l'élément de page. Dans cette page, placez <cm:element /> avant la balise <cm:pageview />.

Vous devez également inclure la bibliothèque de balises dans le fichier JSP de la page avant le contenu de la page principale. Utilisez le code suivant :


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

En règle générale, la balise <cm:element /> est destinée à suivre les interactions avec les clients avec des parties d'une page, plutôt que les interactions qui entraînent le chargement complet d'une page. Par exemple, cette balise est utilisée dans les magasins type HCL Commerce pour suivre les interactions des clients avec la recherche rapide de produits. Dans ce cas, vous pouvez utiliser la balise <cm:element /> avec le paramètre returnAsJSON défini sur true pour obtenir les données d'élément au format JSON. Ensuite, vous devez écrire une logique pour appeler la fonction IBM Digital Analytics cmCreateElementTag pour envoyer les données au format JSON à IBM Digital Analytics. Pour plus d'informations, voir Digital Analytics intégration avec les magasins type Web 2.0.

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:element /> 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.component=new Array();
digitalData.component[0]={};
digitalData.component[0]={attributes:{exploreAttributes:''}, 
       category:{primaryCategory:''}, 
       componentInfo:{componentID:'Product Fast Finder'}};

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

Exemples d'utilisation de balise

La balise <cm:element /> génère la balise de données IBM Digital Analytics suivante :

cmCreateElementTag(elementID, elementCategory, attributes)

Exemple 1 :

Pour transmettre des données de base sur l'interaction d'un client avec un élément de page à IBM Digital Analytics :


Incluez une balise dans votre page de magasin avec le code suivant :	`<cm:element elementId="Product Fast Finder" category="Product Tools" />`
Exemple de balise de données IBM Digital Analytics générée :	`cmCreateElementTag ("Product Fast Finder", "Product Tools")`

Exemple 2 :

Pour transmettre des attributs Explore avec la balise d'élément à IBM Digital Analytics, utilisez le paramètre extraparms (première position) :


Incluez une balise dans votre page de magasin avec le code suivant :	`<cm:element elementId="Product Fast Finder" category="Product Tools" extraparms="attr1-_-attr2-_-attr3"/>`
Exemple de balise de données IBM Digital Analytics générée :	`cmCreateElementTag ("Product Fast Finder", "Product Tools", "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.