Archivo biConfig.xml de ejemplo para IBM Digital Analytics

El siguiente archivo biConfig.xml de ejemplo representa la versión predeterminada incluida en .

El archivo biConfig.xml de ejemplo predeterminado que HCL Commerce proporciona está en el siguiente directorio:

workspace_dir\crs-web\WebContent\WEB-INF\xml\config\bi

El archivo biConfig.xml actualizado debe desplegarse en el siguiente directorio para que IBM Digital Analytics pueda hacer referencia al mismo: workspace_dir\WC\xml\config\bi

HCL Commerce DeveloperCuando actualice el archivo biConfig.xml en el entorno de desarrollo, puede utilizar un archivo de recarga para ayudarle a probar rápidamente los cambios de configuración. Al utilizar este archivo de recarga, no es necesario reiniciar continuamente el servidor para aplicar los cambios de configuración desde el archivo biConfig.xml.

Para obtener más información sobre cómo configurar los valores del archivo biConfig.xml para utilizarlo con IBM Digital Analytics, consulte Configuración de la tienda para comunicarse con IBM Digital Analytics(biConfig.xml).

El siguiente archivo de ejemplo incluye los elementos y el atributo en el archivo biConfig.xml que puede actualizar con la información específica del sitio. Los valores en negrita son valores de ejemplo, que debe sustituir por valores específicos para la tienda o el sitio.
<?xml version="1.0" encoding="UTF-8"?>

<!--
 =================================================================
  Licensed Materials - Property of IBM

  HCL Commerce

  (C) Copyright IBM Corp. 2010, 2013 All Rights Reserved.

  US Government Users Restricted Rights - Use, duplication or
  disclosure restricted by GSA ADP Schedule Contract with
  IBM Corp.
 =================================================================
-->
<BIConfiguration>
1  <ssoKey></ssoKey>
2  <biproviders>
3    <biprovider name="coremetrics">
      <options><attribute name="useDDX" value="false"/></options>
      <header>
        <![CDATA[<script type="text/JavaScript">
        <!--
        ]]>
      </header>
      <footer>
        <![CDATA[
        //-->
        </script>]]>
      </footer>
    </biprovider>
  </biproviders>
  
4  <stores>
5    <store storeId="10101" 
      biprovider="coremetrics" enabled="true" debug="true" 
      marketingCenterEnabled="true"
      useHostedCMHLibraries="true" useEmailForCustomerId="false" 
      segmentExportMode="append" >
      <useCookies>true</useCookies>
      <clientid>69999999</clientid>
      <url>https://welcome.coremetrics.com/analyticswebapp/analytics.jsp</url>
      <marketingCenterUrl>https://mc.coremetrics.com/mcwebapp/welcome.do</marketingCenterUrl>
      <includeShipAdjustInProductPrice>true</includeShipAdjustInProductPrice>
      <options><attribute name="useDDX" value="false"/></options>
      <output section="header">
        <![CDATA[
        <script type="text/javascript" src="//libs.coremetrics.com/eluminate.js"></script> 
        <script type="text/javascript"> 
        cmSetupNormalization("krypto-_-krypto");
        
        // send data to production system 
        //cmSetClientID("99999999",true,"data.coremetrics.com","thesite.com"); 
        
        // send data to test system 
        cmSetClientID("69999999",false,"testdata.coremetrics.com","thesite.com"); 
        </script> 				
        ]]>
      </output>
    </store>
  </stores>
</BIConfiguration>
Donde

1 Identifica una clave secreta para el inicio de sesión único en el proveedor de análisis para los usuarios del Centro de gestión. El inicio de sesión único solo está habilitado para una integración entre IBM Digital Analytics y el Centro de gestión.

2 Inicia la sección de configuración del proveedor de análisis. Dentro de este elemento, puede incluir varios elementos <biprovider>. Cada elemento <biprovider> incluye los valores de configuración para un proveedor de análisis individual.

3 Incluye los valores de configuración para un proveedor de análisis específico. En este archivo de ejemplo, se incluye un solo elemento <biprovider> para configurar los valores para una integración con IBM Digital Analytics. El elemento <biprovider> puede incluir los elementos y atributos siguientes:
name
El nombre del proveedor de análisis. El valor Coremetrics identifica el proveedor de análisis como IBM Digital Analytics.
opciones
Este elemento y el nombre de atributo useDDX indican la tienda que está integrada con IBM Digital Data Exchange (DDX).
header
Este elemento incluye cualquier función o sentencia JavaScript que se deba colocar en páginas de tienda junto con las funciones de etiquetado.
pie de página
Este elemento incluye cualquier función o sentencia JavaScript que se deba colocar en páginas de tienda junto con las funciones de etiquetado.

Dentro del elemento <biprovider>, se pueden establecer valores predeterminados para cada valor de configuración. Estos valores se aplican a cada tienda que está asociada con el proveedor de análisis identificado. Para obtener más información, consulte Configuración de valores predeterminados para un proveedor de análisis.

4 Empieza la sección de configuración de nivel de tienda. Dentro de este elemento, puede incluir varios elementos <store>. Cada elemento <store> puede incluir los valores de configuración para una o más tiendas.

5 Incluye los valores de configuración para una o más tiendas. En este archivo de ejemplo, se incluye un elemento <store> para configurar los valores para que una tienda utilice IBM Digital Analytics como proveedor de análisis para cada tienda. El elemento <store> puede incluir los elementos y atributos siguientes:
storeId
El storeId de la tienda o tiendas que desea habilitar para el proveedor de análisis configurado, como por ejemplo IBM Digital Analytics. Los valores de ID de tienda se pueden establecer en los formatos siguientes:
  1. Un único valor storeId.
  2. Una lista de valores storeId separados por comas. Por ejemplo, storeId="10000, 10001" habilita IBM Digital Analytics para dos tiendas utilizando el mismo ID de cliente de IBM Digital Analytics y la biblioteca de etiquetas que se ha definido en la configuración.
  3. Un rango de valores storeId. Por ejemplo, storeId="10000-10200" habilita IBM Digital Analytics para todas las tiendas que tengan valores storeId que estén dentro del rango que incluya los límites superior o inferior especificados. Las tiendas que se especifican en el rango deben compartir el ID de cliente de IBM Digital Analytics y la biblioteca de etiquetas que se han definido en la configuración.
biprovider
El proveedor de análisis. El valor Coremetrics identifica el proveedor de análisis como IBM Digital Analytics.
habilitado
Indica si el seguimiento está habilitado, lo que significa que se envían datos de análisis a IBM Digital Analytics. Los valores son true o false.
debug
Indica si el modo de depuración está habilitado. Los mensajes de depuración se visualizan en la página web donde se encuentra la etiqueta, generalmente al final de la página. Los valores son true o false.
marketingCenterEnabled
El distintivo habilitado para integrar el Centro de gestión con IBM Marketing Center. Para más información, consulte Integración de.
useHostedCMHLibraries
Indica si la tienda usa la biblioteca IBM Digital Analytics estándar. Los valores son true para la biblioteca IBM Digital Analytics estándar o false para la biblioteca IBM Digital Analytics personalizada. Deje este valor establecido en true.
useEmailForCustomerId
Indica si se debe utilizar una dirección de correo electrónico en lugar de un ID de miembro de HCL Commerce para identificar clientes en IBM Digital Analytics Los valores válidos son:
true
Utilice la dirección de correo electrónico del cliente como ID de cliente de IBM Digital Analytics.
false
Utilice el ID de miembro de HCL Commerce como ID de cliente de IBM Digital Analytics. Este valor es el valor predeterminado.

Cuando el valor es true, una tienda requiere que los clientes proporcionen su dirección de correo electrónico cuando se registran y cuando formalizan un pedido como comprador invitado. Utilizar la dirección de correo electrónico del cliente como ID de cliente es útil solo si la dirección de correo electrónico puede recopilarse de forma coherente cuando los clientes definen una nueva cuenta, se suscriben para recibir un boletín o rellenan algún otro formulario de identificación. Por ejemplo, si utiliza la dirección de correo electrónico puede correlacionar un cliente que rellena un formulario de consulta sobre producto en un sitio externo con el mismo cliente que se registra con una tienda de HCL Commerce. La utilización de la dirección de correo electrónico también puede ayudarle a realizar un seguimiento de varios pedidos formalizados por el mismo comprador invitado. Cuando un cliente formaliza un pedido, a un comprador invitado se le asigna un ID de miembro exclusivo distinto cada vez; sin embargo, la dirección de correo electrónico del comprador invitado probablemente será la misma.

El parámetro de ID de cliente se pasa a IBM Digital Analytics en la etiqueta de datos cmCreateRegistrationTag (que es generada por la etiqueta <cm:registration />) y en las etiquetas de datos cmCreateShopAction9 y cmCreateOrderTag (ambas generadas por la etiqueta <cm:order />).

segmentExportMode
Indica la modalidad de exportación que se debe utilizar al actualizar segmentos de clientes basados en IBM Digital Analytics. Consulte ../tasks/tmtconfigsegbiconfig.html.
useCookies
Indica si la información de categoría se almacena en cookies. Para obtener más información, consulte Almacenamiento de información de categoría en cookies para la creación de informes de análisis.
clientid
El ID de cliente del proveedor de análisis para la tienda, tal como lo proporciona el proveedor de análisis.
url
El URL para iniciar el proveedor de análisis desde el Centro de gestión.
marketingCenterUrl
Si el Centro de gestión se integra con IBM Marketing Center, se puede utilizar este elemento para alterar el URL predeterminado en IBM Marketing Center.
includeShipAdjustInProductPrice
Este distintivo controla si se aplican ajustes de envío a los precios de productos de un pedido o al coste de envío cuando se envían los datos de pedido a IBM Digital Analytics. Este valor no afecta a los detalles del pedido que un comprador ve cuando envía o revisa un pedido.
true
El valor predeterminado. Los ajustes de envío se aplican a los productos de un pedido en lugar de aplicarse al coste de envío cuando se envían los datos del pedido a IBM Digital Analytics. Por ejemplo, un producto cuesta 40€ con un cargo de envío de 10€. Si se aplica un promocion que ofrece un descuento de 5€ en el envío, el pedido total es de 45€. Cuando el distintivo includeShipAdjustInProductPrice se establece en true, las etiquetas de carro de compra y de pedido envían los datos del pedido a IBM Digital Analytics. La información que se envía indica que el pedido total era de 45€, el precio del producto 35€, no 40, y el cargo de envío 10€, no 5€.
false
Los ajustes de envío se aplican al coste de envío cuando los datos se envían a IBM Digital Analytics. Por ejemplo, si el distintivo includeShipAdjustInProductPrice es falso en el escenario anterior, la información que el pedido y las etiquetas del carro de compra envían a IBM Digital Analytics indica que el total del pedido era 45€, el precio del producto 40€ y los gastos de envío 5€.
opciones
Este elemento y el atributo useDDX con un valor de "true" indican que la tienda está integrada con IBM Digital Data Exchange (DDX).
salida
Este elemento configura los fragmentos de código JavaScript o cualquier otro contenido que desee escribir en una ubicación específica en las páginas de la tienda para realizar un seguimiento y enviar los datos de análisis. Actualice los valores de la función cmSetClientID en el elemento para establecer los valores siguientes. Hay un valor cmSetClientID para configurar el ID de cliente para el sistema de producción y el otro para el sistema de prueba.
ID de cliente
El ID de cliente proporcionado por el proveedor de análisis, como por ejemplo IBM Digital Analytics. En este archivo de ejemplo, el valor es "99999999".
Método de recopilación de datos
El método de recopilación de datos. Puede establecer uno de los siguientes valores:
true
La recopilación de datos la gestiona el proveedor de análisis, como por ejemplo IBM Digital Analytics.
false
El cliente gestiona la recopilación de datos.
Nombre de dominio del proveedor de análisis
El nombre de dominio del proveedor de análisis. En este ejemplo, el valor es "data.coremetrics.com" para IBM Digital Analytics.
Servidor de HCL Commerce
El nombre de dominio del servidor de HCL Commerce. En este archivo de ejemplo, el valor es "thesite.com".