Enviar datos de perfil

Los desarrolladores pueden establecer dos maneras para que los clientes envíen atributos de perfil de comprados a Einstein: carga a granel y seguimiento de actividad en tiempo real. Puede usar cualquiera de los métodos (o ambos) para enviar datos de perfil de comprador a Einstein.

Al enviar datos a Einstein, debe recordar lo siguiente:

• Salesforce recomienda encarecidamente que no envíe información de identificación personal (PII) a Einstein que no sean los identificadores de usuario recomendados y especificados.
• Todos los datos recopilados se almacenan internamente por hasta un año. Al cumplirse el año, los datos caducan y se eliminan de todas las bases de datos de Einstein. Para seguir usando estos datos de perfil, debe volver a enviarlos a Einstein.
• Cuando Einstein recibe valores más nuevos para los atributos de perfil de comprador existentes, los valores más nuevos se adjuntan a los valores existentes.
• Einstein usa todos los datos de perfil proporcionados. Los datos nuevos no son valorados de forma distinta que los datos existentes.

Salesforce ofrece un punto de conexión de carga a granel seguro para que los clientes carguen todos los datos de perfil de comprador históricos que hayan recopilado.

La opción de carga a granel está pensada para lo siguiente:

• Todos los datos relacionados con el perfil de comprador que haya registrado y recopilado.
• Todos los datos de terceros de confianza que usted quiera que Einstein use para una mayor personalización del comprador.

La carga de datos a granel puede tener un gran impacto en los datos de Einstein. Por este motivo, permitimos que solo los usuarios autorizados carguen grandes cantidades de datos. Además, cada llamada de API de carga debe pasar un token de acceso a encabezado (portador) de autorización obligatorio obtenido en Account Manager.

Nota: Para reducir la carga en el servidor de Account Manager, evite generar tokens nuevos hasta que no caduquen los tokens vigentes. Consulte Especificación de API para obtener más información sobre las llamadas de API de carga a granel.

Para preparar datos de carga a granel para Einstein, asegúrese de lo siguiente:

• El archivo a granel es un archivo de valores separados por tabulaciones (TSV) comprimido mediante gzip.
• El archivo TSV tiene el formato adecuado y está guardado con la codificación de caracteres UTF-8.
• El tipo de mime del archivo está establecido correctamente para ser usado por la aplicación de compresión gzip.
• La fila del encabezado debe contener el campo de identificación login_id, el campo de identificación email_address o ambos.
• Puede agregar columnas adicionales para cada atributo de perfil de comprador que desee enviar.
• Los valores son cadenas o listas de cadenas. Para una lista de cadenas, asegúrese de separar los valores usando el separador de barra vertical (|). Por ejemplo, orange|yellow.
• Las columnas vacías son ignoradas. Cuando Einstein encuentra una columna vacía, la omite y continúa procesando los datos de atributos de usuario restantes.

Para ayudar a generar recomendaciones de productos relevantes para cada comprador, la API de Profile Connector necesita alguno de estos identificadores de usuarios para la identificación de compradores en la carga a granel.

Este es un ejemplo de datos TSV de carga a granel de perfil de comprador con nombres de columnas aleatorios:

Al realizar una carga a granel de perfil de comprador, tenga en cuenta las siguientes limitaciones de punto de conexión:

• Solo puede cargar un archivo a la vez. Sin embargo, puede cargar varios archivos, uno después de otro.
• El tamaño máximo permitido del archivo es de 2 GB.

Después de preparar los archivos de datos a granel de perfil de comprador, comprima con gzip cada archivo individual y cárguelo en el punto de conexión de carga a granel de perfil de comprador de Einstein. Para obtener más información, consulte Enviar punto de conexión de perfil a granel.

Use la actividad punto de conexión de seguimiento updateProfile de una actividad para llamar y enviar actualizaciones y preferencias de datos de perfil de comprador en tiempo real. La captura de información que brinda un comprador en su storefront en tiempo real permite que las recomendaciones reflejen estos cambios de inmediato.

La opción de seguimiento de actividad en tiempo real está pensada para lo siguiente:

• Capturar las actividades de preferencia del comprador en tiempo real.
• Hacer actualizaciones al perfil de comprador en tiempo real.

Para ayudar a generar recomendaciones de productos relevantes para cada comprador, la API de Profile Connector brinda dos identificadores de usuarios para la identificación de compradores en el seguimiento en tiempo real.

• cookieId (obligatoria): identificador único de un comprador anónimo. Generalmente, cookieID es el valor de una cookie de primera persona.
  • Al hacer solicitudes de API desde un storefront tradicional de Commerce Cloud, pase el valor de la cookie cqcid para que coincida con el seguimiento de actividad automática en el storefront tradicional. Para obtener más información, consulte Almacenamiento de datos local basado en el navegador.
  • Al usar OCAPI o la API de Salesforce Commerce, use el valor visit_id de la respuesta de inicio de sesión de invitados para hacer coincidir las actividades automáticas. Para obtener más información, consulte el Documento de cliente de OCAPI.
• userId (recomendado): identificador único de un comprador que inició sesión. Este parámetro le permite a Einstein vincular al mismo usuario que inició sesión en múltiples dispositivos.
  • Al hacer solicitudes de API desde un storefront tradicional de Commerce Cloud, use el valor de la cookie cquid para que coincida con el seguimiento de actividad automática en el storefront tradicional. Para obtener más información, consulte Almacenamiento de datos local basado en el navegador.
  • Al usar OCAPI o la API de Salesforce Commerce, use el valor hashed_login de la respuesta de inicio de sesión registrada para hacer coincidir las actividades automáticas. Para obtener más información, consulte el Documento de cliente de OCAPI.