Etiqueta de elemento

La etiqueta de elemento de HCL Commerce realiza el seguimiento de interacciones de clientes con el contenido dentro de una página o elementos de la página. En las tiendas de inicio de HCL Commerce, estos elementos incluyen el buscador rápido de productos y la navegación por facetas en las páginas de resultados de búsqueda y categoría. Otros ejemplos de elementos incluyen portlets de búsqueda y noticias, vídeos y detalles contextuales Ajax para revisiones de productos o clientes.

La etiqueta de elemento no genera ningún dato por sí misma. Para esta etiqueta deberá utilizar los parámetros de etiqueta para pasar los datos que desea recopilar. Esta etiqueta también puede pasar parámetros adicionales para la personalización de etiquetas.

Parámetros

A continuación se muestra una lista de parámetros necesarios y opcionales para la etiqueta de elemento.

Nota para IBM Digital Analytics: los siguientes parámetros son para la etiqueta HCL Commerce <cm:element />. Esta etiqueta genera la etiqueta de datos IBM Digital Analytics cmCreateElementTag.

elementId
Parámetro obligatorio que especifica un identificador del elemento con el que está interactuando un cliente. Este podría ser un nombre distinto para el elemento como, por ejemplo, Buscador rápido de productos.
category
Parámetro opcional que especifica la categoría del elemento específico.
pageId
Parámetro opcional que especifica el ID de la página donde se encuentra el elemento. De forma predeterminada, se utiliza pageId como título de la página.
pageCategory
Parámetro opcional que especifica la categoría de la página donde se encuentra el elemento.
location
Parámetro opcional que especifica la ubicación del elemento en la página, por ejemplo, top navigation o sidebar.
storeId
Parámetro opcional que es el ID de tienda de la tienda a la que pertenece la página visualizada actualmente. Si no incluye este parámetro, el valor de storeId se extrae del URL actual.
extraparms
Parámetro opcional que comunica más información al sistema de análisis externo. Este parámetro se proporciona para casos en los que podría haber negociado con el proveedor de analítica externo generar algún informe personalizado que requiera más información.

Nota para : Utilice el parámetro extraparms para pasar atributos de Explore o datos para informes personalizados de , o ambas cosas. Consulte Pasar datos adicionales a IBM Digital Analytics utilizando el parámetro extraparms.

Hay múltiples formas de pasar valores utilizando el parámetro extraparms:
Descripción: Ejemplo
Especificar valores explícitos como JavaScript con los caracteres de escape correspondientes. Para pasar más de un valor, separe los valores con una coma. extraparms="\"value1\",\"value2\""
Especificar valores explícitos sin escapar los valores. Para pasar más de un valor, separe los valores con una coma. extraparms="value1,value2"
returnAsJSON
Un parámetro opcional que está diseñado para utilizarlo al hacer el seguimiento de interacciones de cliente que no causan una renovación de página completa. Por ejemplo, en una tienda Web 2.0, el cliente podría interactuar con el mini carro de la compra, el Buscador rápido de productos o una lista de deseos. Para realizar el seguimiento de estas interacciones dentro de la página, puede utilizar este parámetro para devolver un objeto JSON en lugar de generar la etiqueta de datos de análisis. Cuando la infraestructura de etiquetado de tienda Web 2.0 detecta que este suceso de analítica se ha producido, la infraestructura de etiquetado puede utilizar el objeto JSON para llenar con datos la etiqueta de datos de analítica. Los valores válidos son:
  • true = Devolver un objeto JSON.
  • false = Generar la etiqueta de datos de análisis.
La siguiente es la estructura de datos JSON para la etiqueta de elemento: 
[{elementId:"ELEMENTID",category:"CATEGORY",pageId:"PAGEID",
pageCategory:"PGCATEGORY",location:"LOCATION"'}]

Versiones de etiquetas

HCL Commerce proporciona dos versiones de la etiqueta del elemento:

  1. Una clase de implementación de etiqueta de base abstracta: com.ibm.commerce.bi.taglib.ElementBaseTag. Los proveedores de análisis que desean proporcionar una etiqueta de elemento en su biblioteca de etiquetas JSP de análisis web para HCL Commerce pueden ampliar su clase de etiquetas base e implementar su propia lógica para generar las API de etiquetado de elementos específicas del proveedor.
  2. Una implementación predeterminada de la etiqueta de elemento (<cm:element />) para IBM Digital Analytics. Esta implementación genera de forma automática la etiqueta de datos IBM Digital Analytics cmCreateElementTag