Acerca del archivo de datos y las fuentes de datos para los Atributos del cliente

Requisitos de archivos de datos y varios orígenes de datos para cargar atributos del cliente en Experience Cloud.

Necesita acceso a CRM o datos similares de su empresa. Los datos que cargue en Experience Cloud deben estar en un archivo .csv. Si carga a través de un FTP o sFTP, también debe subir un archivo .fin.

Los Atributos del cliente están diseñados para gestionar algunos archivos cada día. Para reducir el problema de la demora en el procesamiento de muchos archivos pequeños, los archivos enviados en los 30 minutos siguientes a un lote anterior desde la misma organización se redirigirán a una cola de prioridad inferior.

Tipos de archivos permitidos y requisitos de nombre

Tipo de archivo Descripción

.csv

Archivo de valores separados por coma (como uno creado en Excel). Este archivo contiene los datos del atributo del cliente.

Requisitos de nomenclatura: Asegúrese de que las extensiones de nombre de archivo no contienen espacios en blanco.

.fin

(Obligatorio) El archivo .fin indica al sistema que la carga de datos ha finalizado. El nombre del archivo .fin debe concordar con el nombre del archivo .csv.

Adobe recomienda la creación de un archivo de texto vacío con una extensión .fin. Un archivo vacío ahorra espacio y tiempo de carga.

Nota: No se permite cambiar el nombre de un archivo .fin una vez cargado. El archivo .fin debe cargarse de forma independiente y no puede ser un archivo anteriormente cargado con un nombre diferente.

Después de cargar el archivo .fin en el FTP de Atributos del cliente, el sistema recupera los datos con rapidez (en un minuto). Eso es distinto con respecto a otros sistemas basados en FTP de Adobe, que toman datos con menos frecuencia (alrededor de una vez por hora).

El archivo .fin no es necesario cuando se utiliza el método de carga de arrastrar y soltar.

.gz o .zip

.gz (gzip) o .zip: para archivos comprimidos. Un archivo .zip no puede contener más de un archivo en el archivo.

Requisitos de nomenclatura: el nombre del .zip o del .gz debe concordar con el nombre del .csv. Por ejemplo, si su archivo .csv es crm_small.csv, el archivo .zip debería ser crm_small.csv.zip.

El archivo .fin debe concordar con el .csv.

Requisitos para los archivos de datos de atributos

CSV de ejemplo

El archivo CSV debe cumplir el siguiente formato:

Requisitos para los archivos de datos de atributos

El mismo archivo visualizado en un editor de texto:

Requisitos para los archivos de datos de atributos

Directrices

Elemento Descripción

Arrastrar y soltar

El archivo de arrastrar y soltar debe ser inferior a 100 MB.

El archivo .fin no es necesario cuando se utiliza el método de carga de arrastrar y soltar.

Columna ID del cliente

La primera columna debe ser un ID de cliente único. El ID utilizado debe corresponder al ID que se pasa al Servicio de Experience Cloud ID.

Para Analytics, el ID que se está almacenando en una propiedad o eVar.

Para Target, el valor setCustomerID. (Consulte Analytics y Adobe Target: Sincronización del ID de cliente)

Este ID de cliente es el ID único que utiliza su CRM para cada persona de la base de datos. Las columnas restantes son atributos que provienen de su CRM. Elija cuántos atributos desea cargar.

Se recomiendan nombres sencillos y legibles para los encabezados de columna, pero no obligatorios. Cuando valide el esquema después de la carga, puede asignar nombres descriptivos a las filas y columnas cargadas.

Acerca de los ID de cliente

Normalmente, una empresa utiliza un ID de cliente de un sistema CRM. Este ID se establece utilizando la llamada de setCustomerIDs cuando una persona inicia sesión. Este ID también se utiliza como clave en el archivo CRM que se carga en Experience Cloud. El ID de alias es un nombre descriptivo para un almacén de datos en Audience Manager, en el que se almacenan los datos de alias. El sistema envía alias a este almacén de datos (mediante setCustomerIDs). El archivo CRM se aplica a los datos de ese almacén de datos.

Para obtener información sobre setCustomerIDs, consulte ID de cliente y estados de autenticación.

Encabezados y columnas posteriores

Los encabezados posteriores deben representar el nombre de cada atributo.

Estas columnas deben contener Atributos del cliente procedentes de CRM.

Límites de atributos

En Experience Cloud, puede cargar cientos de columnas .csv en el servicio de atributos del cliente. Sin embargo, al configurar suscripciones y seleccionar atributos, se aplican los límites siguientes según las aplicaciones que tenga:

  • Analytics Standard: 3 en total
  • Analytics Premium: 200 por grupo de informes
  • Adobe Target Standard: 5
  • Adobe Target Premium: 200

Límites de fila

No hay límite conocido en el número de filas.

Límites de columna

Para que sea práctico, limite el número de columnas a alrededor de 200.

Límites de caracteres

Al crear una suscripción de Analytics, las longitudes de campo de los archivos cargados se truncan a 255.

Directrices de FTP y limitaciones de tamaño

  • El límite en el tamaño máximo de un archivo para FTP es de 4 GB por carga.
  • El límite en el tamaño mínimo de un archivo es de 10 MB por carga.
  • Puede cargar un archivo cada media hora.
  • Debe soltar su archivo .csv (y el .fin) en la carpeta raíz del sitio FTP.

Importante: El espacio total permitido para la cuenta de FTP es 40 GB. Es responsabilidad suya eliminar los archivos procesados.

Requisitos de archivo

Cada origen de atributo debe contener el mismo número de campos separados por comas.

Los campos que contienen un salto de línea, comillas dobles o comas deben estar entre comillas.

Los caracteres de comillas dobles de un campo deben tener un carácter de escape mediante una barra invertida (\).

Las columnas en blanco se almacenan como null.

Varios archivos

Al cargar datos de atributos del cliente, si tiene varios archivos que desea cargar en sucesión con rapidez, asegúrese de que el archivo anterior se haya procesado antes de cargar el siguiente archivo, especialmente si dichos archivos son grandes. Puede monitorizar esto si comprueba cuándo se movió el archivo anterior a la carpeta procesada o de error de la cuenta FTP de Atributos del cliente.

Dividir un archivo grande en otros más pequeños y enviarlos en sucesión rápida puede ralentizar el procesamiento, a menos que se asegure de que cada archivo se procese antes de enviar el siguiente.

Codificación de caracteres

Para Japón, UTF-8 es obligatoria.

Datos históricos

Los atributos del cliente están vinculados al perfil del visitante subyacente en Analytics. Como tal, los Atributos del cliente se asocian con el visitante durante toda la vida de ese perfil del visitante en Analytics. Este perfil incluye el comportamiento que se produjo antes de que el cliente iniciara sesión por primera vez.

Si utiliza el método de relleno de Data Warehouse, los datos se asocian a un post_visid_high/low basado en el ID de Analytics (AID). Si utiliza el Servicio de Experience Cloud ID, los datos se asocian a un post_visid_high/low basado en Experience Cloud ID (MID).

Tenga en cuenta que el método de relleno de Data Warehouse dejará de estar disponible a partir de octubre de 2022.

Fuentes de datos

Los atributos del cliente no están disponibles en las fuentes de datos.

Uso de varias fuentes de datos

Al crear, modificar o eliminar orígenes de atributos del cliente, se produce un retraso de cerca de una hora antes de que los identificadores empiecen a sincronizarse con la nueva fuente de datos.

El ID de alias de cada origen de atributos del cliente debe ser único. Si tiene varias fuentes de datos con el mismo ID, pueden configurarse de la siguiente manera:

En VisitorAPI.js o en la herramienta Experience Cloud ID de Dynamic Tag Management:

Establezca dos ID de cliente que se correspondan con las fuentes de datos apropiadas:

Visitor.setCustomerIDs({
     "ds_id1":"123456",
     "ds_id2":"123456"
});

(Consulte ID de cliente y estados de autenticación para obtener más información).

En Experience Cloud > People > Atributos del cliente:

Cree dos fuentes de Atributos del cliente utilizando ID con alias únicos que correspondan a los ID de cliente anteriores. El uso de este método permite enviar el mismo ID de referencia a varios orígenes de atributos del cliente.

En esta página