Show Menu
TEMAS×

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

Requisitos de archivos de datos y varias fuentes de datos para cargar atributos del cliente en Experience Cloud.
Necesitará 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 un gran número de 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 es el archivo que contiene los datos de atributos 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.
After you upload the .fin file in the Customer Attributes FTP, the system retrieves data quickly (within one minute). 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:
El mismo archivo visualizado en un editor de texto:
Directrices
Elemento Descripción
Arrastrar y soltar
El archivo de arrastrar y soltar debe ser inferior a 100 megabytes.
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 Experience Cloud ID.
Para Analytics, el ID que se está almacenando en una propiedad o eVar.
Para Destinatario, el valor setCustomerID. (See Analytics & Adobe Target - synching the customer ID )
Este ID de cliente es el identificador ú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. An Alias ID is a friendly name for a data store in Audience Manager, where the alias data is stored. 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 en función de las soluciones que posea:
  • Analytics Standard : 3 en total
  • Analytics Premium : 200 por grupo de informes
  • Adobe Destinatario Standard: 5
  • Adobe Destinatario 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 de doble o comas deben estar entre comillas.
Los caracteres de comillas de Doble 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 controlarlo comprobando cuándo se ha movido el archivo anterior a la carpeta procesada o en la que se han producido errores en 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 completamente antes de enviar el siguiente.
Codificación de caracteres
Para Japón, UTF-8 es obligatorio.
Datos históricos
Los atributos del cliente están vinculados al perfil de visitante subyacente en Analytics. Como tal, los atributos del cliente están asociados con el visitante durante toda la vida de ese perfil de visitante en Analytics. Esto incluye el comportamiento que se produjo antes de que el cliente iniciara sesión por primera vez.
Si utiliza el método de relleno del almacén de datos, los datos se asocian a un post_visid_high/low basado en el ID de Analytics (AID). Si utiliza el servicio Experience Cloud ID, los datos se asocian a un post_visid_high/low basado en Experience Cloud ID (MID).
Fuentes de datos
Los atributos del cliente no están disponibles en las fuentes de datos.

Utilización de varias fuentes de datos

Al crear, modificar o eliminar fuentes de atributos del cliente, hay un retraso de aproximadamente una hora antes de que los ID comiencen 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 que aprovechan el mismo ID, deben configurarse de la siguiente manera:
En VisitorAPI.js o en la herramienta Experience Cloud ID de la administración dinámica de etiquetas:
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).
In the Experience Cloud > People > Customer Attributes :
Cree dos fuentes de atributos del cliente utilizando ID de alias exclusivos 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 de cliente.