Utilización de la etiqueta de registro con IBM Digital Analytics

Si el sitio está integrado con IBM Digital Analytics, puede utilizar la implementación predeterminada de la etiqueta <cm:registration /> que proporciona HCL Commerce. La etiqueta <cm:registration /> genera la siguiente etiqueta IBM Digital Analytics: cmCreateRegistrationTag.

Colocación de etiquetas en páginas de la tienda

Incluya la etiqueta <cm:registration /> en la página JSP de visualización de cuenta de cliente. En la página, coloque la etiqueta <cm:registration /> antes de la etiqueta <cm:pageview />.

Para utilizar la etiqueta <cm:registration />, también debe incluir la biblioteca de etiquetas en el archivo JSP antes del contenido de la página principal. Utilice el siguiente código para incluir la biblioteca de etiquetas:


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

Los datos que genera la etiqueta <cm:registration /> son distintos en función de la versión de la biblioteca de IBM Digital Analytics que la tienda utiliza.

Ejemplo de uso y salida de etiquetas para IBM Digital Data Exchange (DDX)

Si la tienda de HCL Commerce está integrada con DDX para simplificar la recopilación de datos de análisis, la etiqueta <cm:registration /> genera datos en el objeto JavaScript de digitalData que se envía a DDX. DDX puede retransmitir los datos a IBM Digital Analytics. Los datos generados que en este objeto de JavaScript pueden tener un aspecto similar a la siguiente salida:
digitalData.user=new Array();
digitalData.user[0]={};
digitalData.user[0].profile=new Array();
digitalData.user[0].profile[0]={};
digitalData.user[0].profile[0]={address:{city:'City', country:'US', postalcode:'90210', state_province:'CA'}, 
  profileInfo:{exploreAttributes:'-_--_--_--_--_--_--_-', 
  profileEmail:'johnsmith@example.com', profileID:'-1000'}};
En esta salida, el formato user[0].profile[0] se utiliza para incluir los datos de usuario. Este formato es el único formato compatible con HCL Commerce y IBM Digital Analytics.

Para obtener más información sobre la integración con DDX, consulte Integración de IBM Digital Data Exchange.

Ejemplos del uso de etiquetas: para la biblioteca personalizada de IBM Digital Analytics

La etiqueta <cm:registration /> genera la siguiente etiqueta de datos de IBM Digital Analytics:
cmCreateRegistrationTag(customerId, customerEmail, customerCity, 
customerState, customerZip, __nl, __sd, store_id, 
customer_country, age, gender, marital_status, 
num_children, num_in_household, company_name, hobbies, 
income, attributes)

Ejemplo 1:

Para pasar datos de registro básicos a IBM Digital Analytics:

Incluya la etiqueta en la página de tienda de con el siguiente código: Si la tienda utiliza beans de datos y los mandatos de URL para las funciones de ejecución de registro, puede incluir el código sin ningún parámetro:
<cm:registration />

Si la tienda utiliza servicios web para las funciones de ejecución de registro, utilice el parámetro personType:

<cm:registration personType="${personType}"/>
Ejemplo de etiqueta de datos de IBM Digital Analytics generada:
cmCreateRegistrationTag("2002", "user1@test.com", "LA", "CA", "45123", 
null, null, "10101", "US", null, "N", null, null, null, null, null, null);

Ejemplo 2:

Para pasar atributos de Explore a IBM Digital Analytics, utilice el parámetro extraparms (primera posición):

Nota: Los ejemplos de este tema utilizan la sintaxis simplificada para especificar valores extraparms. Debe especificar los valores utilizando JavaScript con escape.
Ejemplo de sintaxis simplificada
extraparms="value1-_-value2,value3-_-value4"
Ejemplo de JavaScript con escape correcto
extraparms="\"value1-_-value2\",\"value3-_-value4\""

Si alguno de estos valores extraparms son variables JavaScript, consulte las reglas de sintaxis explicadas en Sintaxis para pasar variables JavaScript como parámetros adicionales.

Incluya la etiqueta en la página de tienda de con el siguiente código:
<cm:registration personType="${personType}" 
extraparms="attr1-_-attr2-_-attr3"/>
Ejemplo de etiqueta de datos de Digital Analytics generada:
cmCreateRegistrationTag("2002", "user1@test.com", "LA", "CA", "45123", 
null, null, "10101", "US", null, "N", null, null, null, null, null, null, 
"attr1-_-attr2-_-attr3");

Para obtener detalles sobre cada parámetro en la etiqueta de datos de IBM Digital Analytics, consulte la documentación que proporciona IBM Digital Analytics.