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

Placement de balises dans les pages de magasin

Incluez la balise <cm:pageview /> dans toutes les pages que les clients peuvent afficher. Cette balise n'est pas nécessaire sur les fragments JSP ou d'autres ressources de fichiers inclus. La balise d'affichage de page doit être la dernière balise au sein de l'élément <body> d'un fichier JSP donné.

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" %>

Les données que la balise <cm:pageview /> génère sont différentes selon le type de bibliothèque de balises IBM Digital Analytics utilisé par votre magasin. Pour voir des exemples, accédez à l'une des sections suivantes dans la rubrique suivante :

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:pageview /> 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.page={attributes:{exploreAttributes:'', extraFields:''}, category:{primaryCategory:''},
  pageInfo:{onsiteSearchResults:'', onsiteSearchTerm:'', pageID:document.title}};
digitalData.pageInstanceID='wcs-standardpage';

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

Exemples d'utilisation de balise : pour la bibliothèque IBM Digital Analytics personnalisée

La balise <cm:pageview /> génère la balise de données IBM Digital Analytics suivante :
cmCreatePageviewTag(pageID, categoryID, searchString, searchResults, storeId, attributes)

Exemple 1 :

Pour transmettre les données d'affichage de page de base à IBM Digital Analytics :

Incluez une balise dans votre page de magasin avec le code suivant : 
<cm:pageview />
Exemple de balise de données Digital Analytics générée : 
cmCreatePageviewTag(document.title, null, null, null, 10101);

Exemple 2 :

Pour transmettre les données de base de l'affichage de page avec les détails de la catégorie de page à IBM Digital Analytics :

Incluez une balise dans votre page de magasin avec le code suivant : 
<cm:pageview  category="FURNITURE"/>
Exemple de balise de données Digital Analytics générée : 
cmCreatePageviewTag(document.title, "FURNITURE", null, null, 10101);

Exemple 3 :

Sur une page de résultats de recherche, pour envoyer des données de recherche à IBM Digital Analytics :

Incluez une balise dans votre page de magasin avec le code suivant :
  • Si votre magasin utilise com.ibm.commerce.search.beans.CatEntrySearchListDataBean, utilisez le paramètre databean :
    
<cm:pageview databean="${catEntSearchListBean}" />
  • Si votre magasin n'utilise pas CatEntrySearchListDataBean, ou si vous n'obtenez pas d'instance de CatEntrySearchListDataBean dans votre page de résultats de recherche, utilisez les paramètres srchKeyword et srchResults suivants :
    
<cm:pageview srchKeyword="${srchKeyword}" srchResults="${srchResults}"/>
Exemple de balise de données Digital Analytics générée : 
cmCreatePageviewTag(document.title, null, "Coffee", "15", 10101);

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.