Cargar miembros de segmentos de clientes por dirección de correo electrónico con el Programa de utilidad de carga de datos

Puede crear un segmento de clientes que los usuarios de negocio pueden gestionar en la herramienta Marketing cargando una lista de direcciones de correo electrónico.

Nota: Para ayudar a crear segmentos de clientes más rápidamente, puede copiar campañas y otros objetos de marketing desde una tienda o instancia en otra. Por ejemplo, para ayudar a configurar un entorno de prueba o una nueva tienda. Para más información, consulte

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

El mediador de objetos de negocio MemberGroupMemberMediator se ha mejorado para que pueda cargar un archivo de entrada CSV que incluya solamente una lista de direcciones de correo electrónico. Cargue el archivo de entrada para crear un segmentos de clientes o añadir miembros a un segmento de clientes existente. Por ejemplo, si los segmentos de clientes necesitan fusionarse, puede combinar las direcciones de correo electrónico para los clientes en los segmentos y, a continuación, cargar las direcciones de correo electrónico.

El programa de utilidad de carga de datos resuelve el ID exclusivo de miembro para miembros existentes en la base de datos comparando la dirección de correo electrónico en el archivo de entrada con las direcciones de correo electrónico para los miembros existentes. Después el programa de utilidad cargará los miembros en un segmento de clientes existente o creará un nuevo segmento de modo que incluya a los miembros.
Nota: El programa de utilidad de carga de datos resuelve los ID de miembros comparando la dirección de correo electrónico en el archivo de entrada con las direcciones de correo electrónico de clientes registrados en la tienda.

Como procedimiento recomendado, cargue los datos de miembros de segmentos de clientes en el entorno de producción para asegurarse de que los datos de miembros de la base de datos están actualizados. Cargando los datos en el entorno de producción, también puede asegurarse de que los miembros tienen un rol de cliente registrado en la organización de la tienda. Si desea copiar un segmento de clientes del entorno de producción al entorno de transición, utilice el programa de utilidad de copia de segmentos de clientes. Para obtener más información, consulte ../../coremetrics/tasks/tmtcreatingcustsegprod.html.

HCL Commerce EnterpriseSi desea cargar miembros en un segmento de clientes o crear un segmento de clientes en una tienda de sitio ampliado, asegúrese de que los miembros tienen un rol de cliente registrado en la organización de la tienda. Si desea cargar los miembros de segmentos de clientes en una tienda con elementos, asegúrese de que el usuario tiene un rol de cliente en una de las organizaciones de tienda de sitio ampliado. Cuando el programa de utilidad de carga de datos comprueba el rol de cliente registrado para una organización de tienda, el programa de utilidad comprueba todas las tiendas padre en la jerarquía de la organización.

Procedimiento

  1. Cree el archivo de entrada para cargar los datos de segmentos de clientes.
    1. Vaya al siguiente directorio, que contiene un archivo de entrada de ejemplo para cargar datos de miembros de grupos de miembros:
      • HCL Commerce DeveloperEn una línea de mandatos, vaya al directorio WCDE_installdir\samples\DataLoad\Member\CustomerSegment.
      • LinuxAbra una línea de mandatos en el contenedor Utility Docker. Vaya al directorio utilities_root/samples/DataLoad/Member/CustomerSegment.
      Para obtener información sobre cómo entrar y salir de contenedores, consulte Ejecución de programas de utilidad desde Utility server Docker container.
    2. Cree una copia de seguridad del archivo de entrada TestCustomerSegment.csv.
    3. Cambie el nombre del archivo de ejemplo de modo que el nombre del archivo sea el nombre del segmento de clientes. El programa de utilidad de carga de datos compara el nombre de archivo del archivo de entrada con los nombres de segmentos de clientes en la base de datos. Si el nombre no existe en la base de datos, el programa de utilidad de carga de datos crea el segmento de clientes. El nombre de archivo del archivo de entrada, excluyendo la extensión de archivo, se utiliza como el nombre del segmento de clientes.
    4. Abra el archivo de entrada para editarlo.
    5. Sustituya la lista de direcciones de correo electrónico por las direcciones de correo electrónico que desea añadir al segmento de clientes. Incluya una dirección de correo electrónico por línea. No añada ninguna cabecera de columna ni otras columnas en el archivo.
    6. Guarde y cierre el archivo de entrada.
  2. Cree los archivos de configuración del programa de utilidad de carga de datos que necesita para cargar los datos de miembros de grupos de miembros.
    1. Vaya al siguiente directorio que contiene los archivos de configuración de ejemplo para cargar los datos de miembros de grupos de miembros:
      • Linuxutilities_root/samples/DataLoad/Member
      • HCL Commerce DeveloperWCDE_installdir\samples\DataLoad\Member
    2. Cree una copia de seguridad del archivo de configuración de entorno wc-dataload-env.xml.
    3. En el directorio CustomerSegment cree una copia de seguridad de los siguientes archivos de configuración:
      wc-loader-customer-segment-email.xml
      El archivo de configuración de objeto de negocio.
      wc-dataload.xml
      El archivo de configuración de orden de carga de datos.
  3. Opcional: Abra el archivo de configuración de objeto de negocio (wc-loader-customer-segment-email.xml) para su edición y configure los valores para cargar los datos de segmentos de clientes.
    1. En el elemento <_config:DataReader> asegúrese de que se incluye la siguiente configuración de columna. Esta configuración indica que las direcciones de correo electrónico en el archivo de entrada CSV son los valores para la columna "email". 
      <_config:DataReader 
 className="com.ibm.commerce.foundation.dataload.datareader.CSVReader" 
 firstLineIsHeader="false" useHeaderAsColumnName="false" >
  ...
  <_config:Data>
    <_config:column number="1" name="email" />
  </_config:Data>
</_config:DataReader>
    2. En el elemento <_config:BusinessObjectBuilder>, asegúrese de que el valor del atributo packageName es com.ibm.commerce.member.facade.datatypes.MemberPackage y que el valor del atributo dataObjectType es MemberGroupType.
    3. En el elemento <_config:BusinessObjectMediator>, asegúrese de que el valor del atributo className es com.ibm.commerce.member.dataload.mediator.MemberGroupMemberMediator y que el valor del atributo componentId es com.ibm.commerce.member.
    4. En la configuración para correlacionar el ID exclusivo de los usuarios que desea incluir en el segmento de clientes, configure el manejador de valores MemberGroupMemberValueHandler. Asegúrese de que el manejador de valores está configurado para dar soporte al uso de direcciones de correo electrónico para resolver el ID exclusivo
      La configuración del manejador de valor MemberGroupMemberValueHandler debe incluir el siguiente parámetro configurable para habilitar este soporte: 
      <_config:Parameter name="email" value="email" />
      Este parámetro email indica que el programa de utilidad de carga de datos va a recuperar y utilizar las direcciones de correo electrónico del archivo de entrada para resolver los valores de ID exclusivos para los usuarios. El valor para este parámetro configurable, email debe coincidir con el nombre de columna que ha configurado en la configuración del lector de datos. Con esta configuración, el programa de utilidad de carga de datos pasa las direcciones de correo electrónico en el SQL para resolver el ID exclusivo. El parámetro está soportado para utilizarlo solamente con el manejador de valores MemberGroupMemberValueHandler.
      También puede incluir o configurar el siguiente parámetro configurable opcional, que controla cómo utiliza el programa de utilidad de carga de datos las direcciones de correo electrónico para resolver el ID exclusivo.
      emailCaseSensitive
      Opcional. Indica si la dirección de correo electrónico es sensible a las mayúsculas y minúsculas. El parámetro está soportado para utilizarlo solamente con el manejador de valores MemberGroupMemberValueHandler. Puede establecer los siguientes valores para esta propiedad:
      true
      El programa de utilidad de carga de datos no convierte la dirección de correo electrónico en caracteres en minúscula. Si establece este valor para el parámetro, el SQL para resolver el ID exclusivo puede terminar más rápido pero no podrá resolver algunos valores de ID correctamente para miembros de grupos de miembros existentes. Si sabe que las direcciones de correo electrónico del archivo de entrada que también existen en la base de datos se han escrito exactamente igual (coincidencia de mayúsculas y minúsculas), establezca este valor para mejorar el rendimiento.
      false
      El programa de utilidad de carga de datos utiliza el entorno local inglés, en_US, para convertir la dirección de correo electrónico en caracteres en minúscula. Una vez que el programa de utilidad ha convertido la dirección de correo electrónico, el programa de utilidad pasa la dirección de correo electrónico al SQL para que se utilice para resolver el ID exclusivo. El valor predeterminado.

      Es posible que el programa de utilidad de carga de datos no compare satisfactoriamente direcciones de correo electrónico entre el archivo de entrada y la base se datos cuando las direcciones de correo electrónico incluyan caracteres no ASCII que tienen distintas mayúsculas y minúsculas.

      checkEmailFlag
      Opcional. Indica si el programa de utilidad de carga de datos compara las direcciones de correo electrónico en el archivo de entrada con únicamente la dirección de correo electrónico primaria para los miembros de grupos de miembros. El parámetro está soportado para utilizarlo solamente con el manejador de valores MemberGroupMemberValueHandler. Puede establecer los siguientes valores para esta propiedad:
      0
      El programa de utilidad de carga de datos compara las direcciones de correo electrónico del archivo de entrada con solamente la dirección de correo electrónico primaria de un usuario para resolver el ID exclusivo. El valor predeterminado.
      -1
      El programa de utilidad compara la dirección de correo electrónico en el archivo de entrada con todas las direcciones de correo electrónico de la libreta de direcciones para un miembro del grupo de miembros. Si un miembro tiene una dirección de correo electrónico que coincida con la dirección en el archivo de entrada, se devuelve el ID para el miembro para que los datos del miembro se puedan actualizar o eliminar.
      De forma predeterminada, el archivo de configuración de ejemplo incluye estos parámetros opcionales con el parámetro email para controlar cómo utiliza el programa de utilidad las direcciones de correo electrónico para resolver el ID exclusivo. 
      <_config:mapping xpath="IncludedPerson[0]/UniqueID" value="uniqueId" >
  <_config:ValueHandler className="com.ibm.commerce.member.dataload.config.MemberGroupMemberValueHandler">
    <_config:Parameter name="email" value="email" />
    ...	
    <_config:Parameter name="checkEmailFlag" value="0" valueFrom="Fixed" />
    <_config:Parameter name="emailCaseSensitive" value="true" valueFrom="Fixed" />
  </_config:ValueHandler>
</_config:mapping>
    5. En la configuración de correlación de datos para el archivo, asegúrese de incluir la correlación de configuración para el uso de grupos de miembros.
      De forma predeterminada, el archivo de configuración de ejemplo configura el uso del grupo de miembros para que sea "GeneralPurpose", lo que indica que el grupo es un segmento de clientes.
      <_config:mapping xpath="Usage[0]" value="GeneralPurpose" valueFrom="Fixed"/>
    6. Añada todas las propiedades configurables que desea utilizar para controlar cómo carga el programa de utilidad de carga de datos los datos de segmentos de clientes.
      Por ejemplo, puede incluir una o varias de las siguientes propiedades, que están pensadas para cargar miembros de segmentos de clientes.
      replaceAllExistingMembers
      Indica si el programa de utilidad de carga de datos sustituye los usuarios existentes en el segmento de clientes por los usuarios del archivo de entrada. Esta propiedad solo está soportada para utilizarla con el mediador de objetos de negocio MemberGroupMemberMediator. Puede establecer los siguientes valores para esta propiedad:
      true
      El programa de utilidad de carga de datos suprime todos los usuarios existentes del segmento de clientes antes de que el programa de utilidad cargue nuevos usuarios.
      false
      El programa de utilidad de carga de datos no sustituye usuarios existentes. El valor predeterminado.
      ignoreNonExistUsers
      Indica cómo el programa de utilidad de carga de datos va a manejar la carga de direcciones de correo electrónico cuando no se puede resolver o crear un ID de usuario para la dirección. Esta propiedad solo está soportada para utilizarla con el mediador de objetos de negocio MemberGroupMemberMediator. Puede establecer los siguientes valores para esta propiedad:
      true
      Cuando la dirección de correo electrónico no se puede resolver en un ID de usuario, el programa de utilidad de carga de datos ignora el error y no carga la dirección de correo electrónico. El programa de utilidad continuará con la operación de carga. Cuando la carga finaliza, el programa de utilidad incluye la lista de direcciones de correo electrónico que no se han podido resolver.
      Nota: Si activa el rastreo -Dcom.ibm.commerce.member.dataload.level=FINE, todas las direcciones de correo electrónico no resueltas se registran dentro del archivo wc-dataload.log.
      false
      Cuando la dirección de correo electrónico no se puede resolver en un ID de usuario, el programa de utilidad de carga de datos genera una excepción. El valor predeterminado.
      customerSegmentNameIsFileName
      Indica si el nombre de archivo del archivo de entrada, excluyendo la extensión de archivo, también es el nombre de un segmento de clientes existente. Esta propiedad solo está soportada para utilizarla con el mediador de objetos de negocio MemberGroupMemberMediator. Puede establecer los siguientes valores para esta propiedad:
      true
      El programa de utilidad de carga de datos utiliza el nombre de archivo para el segmento de clientes. Si el nombre del segmento de clientes existe en la base de daos, el programa de utilidad podrá añadir o sustituir miembros para el segmento de clientes. Si el segmento de clientes no existe, el programa de utilidad crea el grupo de miembros del segmento de clientes. El segmento creado incluye el nombre de archivo como el nombre de segmento y descripción. Si está cargando un archivo que incluye únicamente direcciones de correo electrónico, debe establecer el valor en true.
      false
      El nombre de archivo debe ser un nombre de segmento de clientes existente. Si el segmento de clientes no existe, el programa de utilidad no crea el grupo de miembros de segmentos de clientes.

      Si establece el valor en false y el segmento de clientes no existe, el programa de utilidad de carga de datos genera un error durante el proceso de carga indicando que el grupo de miembros del segmento de clientes no se ha especificado. El valor predeterminado.

      Por ejemplo, el siguiente fragmento de código configura la habilitación de las propiedades anteriores:
      <_config:BusinessObjectMediator 
 className="com.ibm.commerce.member.dataload.mediator.MemberGroupMemberMediator" 
 componentId="com.ibm.commerce.member" >
  <_config:property name="replaceAllExistingMembers" value="true" />
  <_config:property name="ignoreNonExistUsers" value="true" />
  <_config:property name="customerSegmentNameIsFileName" value="true" />
</_config:BusinessObjectMediator>
    7. Guarde y cierre el archivo de configuración.
  4. Abra el archivo de configuración de entorno de carga de datos (wc-dataload-env.xml) para editarlo y actualice los valores configurados de modo que coincidan con los valores del entorno.
  5. Abra el archivo de configuración de orden de carga de datos (wc-dataload.xml) para editarlo y configure los valores para cargar los datos de segmento de clientes.
    1. En el elemento <_config:DataLoadEnvironment>, asegúrese de que el valor del atributo configFile identifica el archivo de configuración de entorno. Si el archivo no está en el mismo directorio que el archivo de configuración de orden de carga de datos, incluya la vía de acceso relativa al archivo.
    2. En el elemento <_config:LoadItem>, asegúrese de que el valor para el atributo name es CustomerSegmentEmail y que el valor para el atributo businessObjectConfigFile identifica el archivo de configuración de objeto de negocio. Si el archivo no está en el mismo directorio que el archivo de configuración de orden de carga de datos, incluya la vía de acceso relativa al archivo.
    3. En el elemento <_config:DataSourceLocation> asegúrese de que el valor del atributo location identifica el archivo XML de entrada que está cargando. Si el archivo no está en el mismo directorio que el archivo de configuración de orden de carga de datos, incluya la vía de acceso relativa al archivo.
    4. Guarde y cierre el archivo de configuración.
  6. Ejecute el programa de utilidad de carga de datos.
  7. Verifique que los datos del segmento de clientes se han cargado revisando el informe de resumen de carga de datos.
    Para obtener más información sobre la ubicación y el contenido de este informe de resumen, consulte Verificar los resultados de la carga de datos.
    • También puede verificar que los datos de segmentos de clientes se hayan cargado comparando el contenido del archivo de entrada con los datos de segmentos de clientes en la base de datos de HCL Commerce. Asegúrese de que los datos del archivo de entrada existen en las tablas de base de datos adecuadas.
    • Si ha creado un segmento de cliente, verifique que puede ver el segmento de clientes recién cargado en la herramienta Marketing.