OneTrace.pro Centro de ayuda

Importación de archivos y fuentes de datos

Si sus clientes ya están en otro sistema (un CRM, un programa contable, una hoja de cálculo), no hace falta esperar a que visiten el sitio web: cargue un archivo. La carga puntual de perfiles desde un CSV o un Excel la realiza la importación, y la carga periódica de perfiles y eventos desde un archivo por URL, S3, Google Sheets o su almacén de datos, las fuentes de datos.

Ambas herramientas están disponibles para «Propietario», «Administrador» y «Gestor».

Importación de perfiles desde CSV y Excel

Abra Datos → Importación de perfiles en el menú o pulse Importación de perfiles en la cabecera de la página Perfiles.

Requisitos del archivo

  • CSV o Excel (.xlsx, .xls — la primera hoja) con los encabezados de columna en la primera fila.
  • Separador: coma, punto y coma o tabulación; se detecta automáticamente.
  • Tamaño: CSV hasta 20 MB, Excel hasta 10 MB.
  • Al menos una columna con un identificador: id del cliente en su sistema, correo electrónico o teléfono.
  • En Excel, las celdas con formato de fecha se cargan como 2026-10-28 18:42:00 y las fórmulas, con su valor. Los archivos de Excel 95 y los protegidos con contraseña no sirven: guárdelos como .xlsx o CSV.

Ejemplo:

email;phone;first_name;city;customer_id;bonus
[email protected];+34 612 345 678;Ana;Madrid;1001;350

Cómo cargarlo

  1. Pulse Elegir un archivo y seleccione el archivo.
  2. En la tabla aparecerán las columnas del archivo, valores de ejemplo y el campo Destino. Indique para cada columna:
    • Identificador: ID de usuario, Correo electrónico, Teléfono o ID anónimo: con él se encontrará o se creará el perfil. Cada tipo se puede elegir una sola vez.
    • Atributo: una propiedad del perfil; al lado, introduzca la clave en caracteres latinos, por ejemplo city o bonus_balance.
    • Omitir: la columna no se carga.
  3. Pulse Iniciar importación.

OneTrace.pro sugiere el destino a partir de los encabezados: email se asigna al correo electrónico, phone al teléfono, customer_id y user_id al ID de usuario, y los encabezados habituales de nombre, apellido, ciudad y país en ruso y ucraniano, a los atributos first_name, last_name, city y country. Los demás encabezados se convierten en claves de atributo (con transliteración si están en cirílico). Revise las sugerencias antes de iniciar.

Importación de perfiles: correspondencia de columnas del archivo

Progreso de la importación

La importación se ejecuta en segundo plano: la página muestra una barra de progreso, el estado y el contador «procesadas N de M, errores: K». Puede cerrar la página y la importación continuará. Las filas con errores se enumeran con su número. Cuando termine la importación, el botón Abrir perfiles lleva a la lista de perfiles.

A la derecha, en el bloque Historial, están las 20 últimas importaciones: archivo, quién lo cargó y cuándo, estado («Cargado», «En cola», «Procesando», «Completado», «Error») y resultado.

Página de importación con el historial de cargas

Cómo se procesan las filas

  • Si ya existe un perfil con ese identificador, se actualiza: los atributos nuevos se añaden y los coincidentes se sobrescriben. Si en una fila aparecen identificadores de dos perfiles distintos, los perfiles se fusionan; consulte Perfiles.
  • Las celdas vacías se omiten y no borran los valores ya conocidos.
  • Los números y true/false se guardan como números y valores lógicos.
  • El correo electrónico y el teléfono del archivo se convierten tanto en identificadores como en atributos del perfil.
  • Al teléfono se le quitan espacios, paréntesis y guiones. Indíquelo con el código de país: +7 999 123-45-67. Un número como 8 999… (con el prefijo nacional en lugar del código de país) se guardará con un código incorrecto.
  • Una fila sin ningún identificador válido se omite con un error.

La importación crea un evento $identify por cada fila, por lo que los cambios de atributos pueden lanzar recorridos con un disparador de cambio de atributo. Si no lo desea, ponga esos recorridos en pausa mientras dure la importación.

Fuentes de datos

Una fuente es una importación periódica según una programación. Es útil cuando el CRM o el almacén publica cada noche una exportación actualizada: OneTrace.pro la recoge por sí mismo y actualiza los perfiles o añade eventos.

Preparación

Primero cree una conexión en la sección Integraciones (se necesita el rol «Administrador» o «Propietario»):

  • Archivo por URL: un archivo en una dirección HTTP(S). Si el archivo está protegido, indique el encabezado de autorización, por ejemplo Bearer y el token.
  • Archivo de S3: un bucket de AWS, Yandex Object Storage, MinIO u otros almacenamientos compatibles.
  • Hoja de Google Sheets: mediante la clave de una cuenta de servicio de Google. Conceda a esa cuenta acceso de lectura a la hoja.
  • PostgreSQL, ClickHouse, BigQuery o Snowflake: una tabla o una consulta en su almacén de datos; consulte Almacén de datos.

Formatos de archivo: CSV, JSON (matriz de objetos, hasta 50 MB) y JSON Lines.

Cómo crear una fuente

  1. Abra Datos → Fuentes de datos y pulse Nueva fuente.
  2. Introduzca el Nombre y elija la Conexión.
  3. Complete la configuración de la conexión: URL del archivo y Formato, Ruta del archivo en el bucket o ID de la hoja de cálculo y Rango (por ejemplo, Hoja1!A:F).
  4. Pulse Cargar columnas: OneTrace.pro leerá las primeras filas.
  5. En el campo Importar como, elija Perfiles (cada fila actualiza atributos) o Eventos (cada fila es un evento).
  6. Elija la Programación: desde cada 15 minutos hasta una vez al día.
  7. En la tabla Columnas, indique el destino de cada columna, igual que en la importación de CSV.
  8. Pulse Guardar.

Configuración de una fuente de datos con la correspondencia de columnas

Para los eventos, la tabla de columnas incluye además Nombre del evento, Propiedad del evento y Hora del evento. La columna con la hora es obligatoria. Defina un único nombre de evento para todas las filas en el campo Nombre del evento (por ejemplo, order_completed) o elija la columna en la que figura.

Para los tickets de las tiendas hay una plantilla, Tickets de tienda, con un archivo de ejemplo: rellena el evento de compra, la propiedad de compra en tienda y las sugerencias de columnas (teléfono, tarjeta de fidelidad, tienda, número de ticket, importe y productos). Consulte Tiendas y ventas en tienda.

Funcionamiento de la fuente

La tarjeta de la fuente muestra el estado («Activa», «En pausa», «Error»), la programación, la hora de la última ejecución y el resultado: filas, aceptadas, omitidas y con error.

  • Ejecutar ahora: ejecución fuera de programación. También reactiva una fuente en pausa o con error.
  • Pausar / Reanudar: detener y reanudar las ejecuciones programadas.
  • Historial: lista de ejecuciones con el inicio, cómo se ejecutó («Programada» o «Manual»), el estado y los primeros errores de filas con su número.

Fuentes de datos: tarjetas con el estado y el resultado de las ejecuciones

Qué debe saber

  • Si el archivo no ha cambiado desde la vez anterior, la ejecución termina con el estado «Sin cambios» y no se leen filas.
  • Repetir la misma fila en un plazo de 24 horas no crea duplicados.
  • Para los eventos se recuerda la hora del último evento cargado: las ejecuciones siguientes omiten las filas que no sean más recientes. Por eso basta con ir añadiendo filas al archivo con el historial.
  • Una fuente con error se vuelve a intentar según la programación; el texto del error aparece en la tarjeta.
  • Los eventos cargados cuentan para la cuota mensual del plan.
  • Al eliminar una fuente, los datos ya cargados se conservan.

Almacén de datos

Si sus perfiles y pedidos ya están reunidos en su almacén (PostgreSQL, ClickHouse, BigQuery o Snowflake), la fuente los lee directamente de allí. Cada ejecución recoge solo las filas modificadas desde la vez anterior, así que no hace falta exportar a un archivo ni siquiera una tabla grande. Los cambios llegan a los perfiles y eventos, y con ellos se activan los recorridos y se recalculan los segmentos. La dirección contraria es la exportación a almacenes de datos.

La lectura desde almacenes de datos está disponible en el plan «Empresa»; consulte Planes.

Conexión

Cree una conexión en la sección Integraciones, en el grupo Fuentes de datos. Los campos son los mismos que en la exportación a ese almacén, pero es mejor crear un usuario aparte solo de lectura:

  • PostgreSQL: el host, el puerto, la base de datos y un usuario con el permiso SELECT sobre las tablas necesarias.
  • ClickHouse: la dirección de la interfaz HTTP y un usuario con permiso de lectura.
  • BigQuery: la clave de una cuenta de servicio con los roles BigQuery Data Viewer y BigQuery Job User, el proyecto y la ubicación de los datos.
  • Snowflake: la cuenta, un usuario con par de claves, un rol con el permiso SELECT y el warehouse de cómputo. Para la lectura no se necesita un bucket de S3.

El almacén debe ser accesible desde internet: OneTrace.pro no se conecta a direcciones de redes internas.

Configuración de la fuente

Cree una fuente como se describe más arriba y elija la conexión al almacén. Su configuración:

  • Qué leer: Tabla (por ejemplo, public.customers o shop_dwh.customers) o Consulta propia, es decir, un único comando SELECT o WITH sin ;. OneTrace.pro añade a la consulta una condición, un orden y un límite de filas, por lo que no es posible modificar datos con ella.
  • Columna de cursor: la hora de modificación de la fila, por ejemplo, updated_at. Cada ejecución lee las filas en las que esa hora es posterior a la de la vez anterior. Las filas sin esa hora no se leen.
  • Clave de fila: una columna única, por ejemplo, id o customer_id. Sirve para distinguir las filas con la misma hora de modificación.
  • Columna de marca de eliminación: opcional, por ejemplo, is_deleted. Consulte Eliminación.

Fuente desde un almacén BigQuery: tabla, cursor, clave de fila y columnas

El resto es igual que con un archivo: Cargar columnas, destino de las columnas, perfiles o eventos y programación.

Cómo se leen los cambios

  • La primera ejecución lee toda la tabla; las siguientes, solo las filas modificadas después de la última leída.
  • En una ejecución se lee como máximo 1 millón de filas. Si hay más, la siguiente ejecución empieza enseguida, sin esperar a la programación. Así, la primera carga de una tabla grande se hace en varias ejecuciones seguidas.
  • Si una ejecución se interrumpe, las mismas filas se vuelven a leer: los perfiles simplemente se actualizan otra vez y los eventos repetidos no se duplican.
  • Al cambiar la tabla, la consulta, la columna de cursor o la clave, la lectura empieza desde el principio.
  • La columna con la hora de modificación debe actualizarla su almacén: OneTrace.pro no vuelve a leer una fila cuya hora no ha avanzado.
  • La consulta se ejecuta solo en modo de lectura y con un límite de tiempo: 10 minutos en PostgreSQL, ClickHouse y Snowflake, y 15 minutos en BigQuery.

Eliminación

Si en una fila de una fuente de perfiles la Columna de marca de eliminación contiene true o 1, OneTrace.pro elimina el perfil con los identificadores de esa fila, igual que con una solicitud del RGPD: junto con su historial, los perfiles fusionados y los datos en las exportaciones. La eliminación queda en el registro de auditoría, y el resultado de la ejecución muestra cuántos perfiles se eliminaron. En una fuente de eventos, las filas con la marca simplemente se omiten.

Para una migración puntual desde Mindbox y otras plataformas, con todo el historial, existe una herramienta aparte; consulte Migración desde otras plataformas.