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.

Carga a granel

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.

Autorización

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.

Preparación de datos 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.

Identificadores de usuario de carga a granel

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.

Campo	Descripción
login_id	Identificación de inicio de sesión del comprador. En algunos casos, es lo mismo que el valor email_address.
email_address	Dirección de correo electrónico completa del comprador. Por ejemplo, shopper1@somewhere.com.

Ejemplo de datos de carga a granel

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

login_id	email_address	género	colores	brand_list
comprador1	comprador1@algunlugar.com	masculino	naranja\|amarillo	marcaA\|marcaB
comprador2	comprador2@algunlugar.com	femenino	azul\|negro	marcaD
comprador3	comprador3@algunlugar.com	femenino	rojo\|negro\|violeta	marcaB\|marcaE

Limitaciones del punto de conexión de carga a granel del comprador

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.

Carga de datos a granel de perfil de comprador a Einstein

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.

Seguimiento de actividad en tiempo real

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.

Para evitar actividad potencialmente maliciosa, los parámetros identificadores de usuarios no deben ser secuenciales. Los parámetros no deben incluir secuencias, patrones, direcciones IP, direcciones de correo electrónico, nombres ni nada vinculado a una persona específica. Todos los parámetros identificadores de usuarios deben cumplir con el Reglamento general de protección de datos (GDPR) a través de la función hash u otros métodos.

Note