Configuración de valores predeterminados para un proveedor de análisis

Puede configurar valores predeterminados para una configuración de proveedor de análisis para aplicar los valores predeterminados a todas las tiendas que están asociadas con el proveedor de análisis. Al establecer valores predeterminados a nivel de sitio, puede configurar rápidamente varias tiendas para utilizar los mismos valores de proveedor de análisis. También puede alterar temporalmente los valores predeterminados para una tienda individual.

Antes de empezar

Revise el archivo biConfig.xml de ejemplo .

Por qué y cuándo se efectúa esta tarea

Cuando defina los valores predeterminados para una configuración de proveedor de análisis, establezca los valores predeterminados dentro del elemento <biprovider> para el proveedor de análisis. Puede establecer valores predeterminados para las mismas opciones de configuración que están disponibles para cada tienda. Para alterar temporalmente los valores predeterminados y configurar un valor específico de una o más tiendas, puede incluir el ajuste con un valor diferente en la configuración <store> de las tiendas.

Como ejemplo, los siguientes pasos demuestran cómo configurar los valores predeterminados para una integración con IBM Digital Analytics. Si desea obtener más información sobre la integración con IBM Digital Analytics, consulte Configuración de la tienda para comunicarse con IBM Digital Analytics(biConfig.xml).

Procedimiento

Abra el archivo de configuración biConfig.xml existente en la siguiente vía de acceso: workspace_dir\crs-web\WebContent\WEB-INF\xml\config\biConfig.xml

Para actualizar la configuración del proveedor de análisis, actualice el archivo biConfig.xml en el entorno de desarrollo y, a continuación, despliegue el archivo en el archivado de empresa (EAR) HCL Commerce en su entorno de transferencia o de producción.

Cuando 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.
Dentro del elemento <biproviders>, añada o actualice la configuración de <biprovider> para el proveedor de análisis.
Por ejemplo,
```
<biprovider name = "coremetrics">
```
Dentro de la configuración del proveedor de análisis de <biprovider>, añada uno o más de los siguientes atributos o elementos y establezca el valor predeterminado.
clientid

El ID de cliente del proveedor de análisis, tal como lo proporciona el proveedor de análisis.

habilitado
Un distintivo que controla si las etiquetas de análisis de las páginas de la tienda están habilitados para enviar datos al proveedor de análisis. Puede establecer los siguientes valores para el indicador:
- true - Las etiquetas de análisis están habilitadas.
- false - Las etiquetas de análisis no están habilitadas; los datos de análisis no se envían al proveedor de análisis.
debug
Un distintivo que controla si la modalidad de depuración está habilitada para las etiquetas de análisis. Los mensajes de depuración se visualizan en la página web donde se encuentra la etiqueta, generalmente al final de la página. Puede establecer los siguientes valores para el indicador:
- true - La depuración está habilitada.
- false - La depuración no está habilitada.
instrumentation
Este elemento incluye la etiqueta que está relacionada con la integración entre una tienda y el proveedor de análisis. Puede definir la sección predeterminada CDATA dentro de este atributo. Por ejemplo, el código que incluye bibliotecas JavaScript u otras tareas relacionadas específicas para la tienda dentro del elemento, tal como se muestra en el ejemplo siguiente:
```
<instrumentation>
        <![CDATA[
           <script type="text/javascript">
            /* Instrumentation code if any */
           </script>
         ]]>
   </instrumentation>
```
marketingCenterEnabled

El distintivo habilitado para integrar el Centro de gestión con IBM Marketing Center. Para obtener más información, consulte Integración de.

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. Para obtener más información, consulte Integración de.

includeShipAdjustInProductPrice

El indicador de habilitación que controla si los ajustes de envío se aplican a los precios de los productos en un pedido o en los gastos de envío cuando los datos del pedido se envían a IBM Digital Analytics. Esta configuración no afecta a los detalles del pedido que ve un comprador cuando están enviando o revisando 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 con un atributo useDDX se utiliza para la integración de HCL Commerce con IBM Digital Data Exchange (DDX).

salida

Este elemento incluye 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 datos de análisis. Por ejemplo, puede establecer un valor predeterminado para los valores de la función cmSetClientID. Puede establecer los valores predeterminados para los siguientes valores de función cmSetClientID para la producción de tienda y los sistemas de prueba.

ID de cliente

El ID de cliente proporcionado por el proveedor de análisis. Por ejemplo, "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

La recopilación de datos la gestiona el cliente de cada tienda.

Nombre de dominio del proveedor de análisis

El nombre de dominio para el proveedor de análisis. Por ejemplo, "data.coremetrics.com".

servidor de HCL Commerce

El nombre de dominio del servidor de HCL Commerce. Por ejemplo, "thesite.com".

url

El URL para iniciar el proveedor de análisis desde el Centro de gestión.

useCookies

El indicador de habilitación para almacenar información de categoría 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.

useHostedCMHLibraries
Indica si la tienda usa la biblioteca IBM Digital Analytics estándar. Puede establecer los siguientes valores para el indicador:
- true - Se utiliza la biblioteca IBM Digital Analytics estándar.
- false - Se utiliza la biblioteca IBM Digital Analytics personalizada.
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. Puede establecer los siguientes valores para el indicador:
- 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 de producto en un sitio externo con el mismo cliente que se registra en 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. Para obtener más información, consulte tmtconfigsegbiconfig.html.
Opcional: Altere temporalmente los valores predeterminados para una tienda o tiendas individuales que necesitan utilizar valores de configuración diferentes.
1. Dentro del elemento <stores>, añada o actualice la configuración de <store> para las tiendas. Dentro de esta configuración, debe asociar la tienda con el proveedor de análisis.
  Si desea que una tienda solo utilice los valores predeterminados, debe asociar la tienda con el proveedor de análisis incluyendo la siguiente configuración del elemento <store>:
```
<store storeId="10101" biprovider="coremetrics">
...
</store>
```
  Donde
  storeId
  El ID de la tienda o tiendas que está asociando con un proveedor de análisis. Cuando esté configurando las opciones de informe de análisis para varias tiendas, puede aplicar una configuración para varias tiendas mediante una lista de valores de ID de tienda. También puede copiar la configuración de ejemplo para crear varias configuraciones y aplicar cada una a una o más tiendas. Puede especificar el valor storeId en los formatos siguientes:
  
  Un único valor storeId.
  
  Una lista de valores storeId separados por comas. Por ejemplo, especifique storeId="10000, 10001" para habilitar 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.
  
  Un rango de valores storeId. Por ejemplo, especifique storeId="10000-10200" para habilitar 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. 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 nombre del proveedor de análisis. Este nombre es el mismo que el valor de name que se especifica en el elemento <biprovider>.
2. Dentro del elemento de configuración <store>, añada o actualice cualquiera de los siguientes atributos o elementos para alterar temporalmente los valores predeterminados.
  Para el elemento <output>, puede alterar temporalmente las configuraciones individuales dentro del elemento.
  - enabled
  - debug
  - instrumentation
  - marketingCenterEnabled
  - marketingCenterUrl
  - options
  - output
  - url
  - useCookies
  - useHostedCMHLibraries
  - useEmailForCustomerId
  - segmentExportMode
3. Guarde y cierre el archivo.
  Como ejemplo, el ejemplo siguiente de biConfig.xml establece valores predeterminados para 5 tiendas e incluye alteraciones temporales para tres tiendas. Dos tiendas incluyen solo la configuración para asociar la tienda con el proveedor de análisis.
```
<BIConfiguration>
  <ssoKey></ssoKey>
  <biproviders>
    <biprovider name="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>
      <options>
        <attribute name="useDDX" value="true"/>
      </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>
      <header>
        <![CDATA[<script type="text/JavaScript">
        
        </script>]]>
      </footer>
    </biprovider>
  </biproviders>
 
  <stores>
   <store storeId="10101, 10102" 
      biprovider="coremetrics" 
      marketingCenterEnabled="false" >
      <useCookies>false</useCookies>
      <options>
        <attribute name="useDDX" value="true"/>
      </options>
    </store>
    <store storeId="10103" 
      biprovider="coremetrics" 
      marketingCenterEnabled="false"
      useEmailForCustomerId="true" >
      <options>
        <attribute name="useDDX" value="true"/>
      </options>
    </store>
    <store storeId="10104, 10105" biprovider="coremetrics" />
  </stores>
</BIConfiguration>   
```
Reinicie los servidores de prueba.