Puedes importar eventos de producto en Positive User desde un archivo CSV o XLSX para añadir varios registros de forma más rápida y eficiente. Esto te permite evitar la configuración manual y facilita la incorporación de data estructurada de eventos a la plataforma. En este artículo descubrirás cómo preparar tu archivo e importar los eventos de producto correctamente.
Antes de comenzar, asegúrate de que tu archivo esté estructurado correctamente y de que entiendas cómo se almacena la data en Positive User. La plataforma utiliza tanto atributos estándar (campos integrados como la dirección de email o el número de teléfono) como atributos personalizados (campos que creas tú mismo).
Origen de los productos: define una estrategia de gestión de productos: cómo se deben crear los nuevos productos en la aplicación, cómo quieres actualizarlos y enviar nuevas ocurrencias de eventos de producto.
Tipos de eventos de producto: consulta la lista de tipos de eventos de producto disponibles en este artículo. No se pueden importar otros tipos al workspace.
Coincidir atributos estándar: si las columnas de tu hoja de cálculo coinciden con los atributos estándar, puedes importar el archivo inmediatamente.
Crear atributos personalizados: si quieres incluir información adicional que no se admite de forma predeterminada, primero tendrás que crear los atributos personalizados correspondientes. Sigue los pasos de «Cómo crear un atributo personalizado».
Verificar los tipos de data: asegúrate de que cada columna tenga el tipo de valor de atributo correcto. Por ejemplo, si quieres importar «Scoring», comprueba que tu atributo sea un número entero. Si quieres importar una «Fecha», configura el atributo como datetime. Consulta «Qué es un atributo» para más detalles sobre tipos de data específicos.
Antes de subirlo, asegúrate de que tu archivo tenga el formato correcto. Si no estás seguro de cómo debería verse tu archivo, puedes descargar una plantilla lista para usar directamente desde la aplicación haciendo clic en el botón «xlsx» o «csv» en la sección «Data» → «Importar».
Para encontrar más consejos sobre el formato de la data, consulta nuestro artículo dedicado.
Campos obligatorios
Importar eventos de producto significa que subes ocurrencias específicas de eventos de producto a dos timelines: el del contacto que las realizó y el del producto con el que se produjo la interacción (por ejemplo, el historial de compras de un producto concreto). Por eso es obligatorio conectar cada ocurrencia a un contacto específico y a un producto específico. Esto se puede hacer mediante «user_id»/«email» del contacto y «product_id» del producto.
El campo «product_id» nunca debe ser un simple número entero. Recomendamos encarecidamente codificarlo.
El archivo debe incluir las siguientes columnas:
product_id (ID personalizado del producto en tu base de datos)
user_id / email (identificador del contacto que realizó la acción)
timestamp (marca temporal de las ocurrencias del evento en formato ISO 8601, por ejemplo 2017-07-25T14:14:08.612Z)
event_type (el de la lista)
Incluir el nombre del producto es opcional. Si no lo incluyes y el producto aún no existe, se creará el producto sin nombre.
Encabezados de columna
Incluye siempre los encabezados de columna en la primera fila de tu archivo. Intenta dar a las columnas exactamente los mismos nombres que tienen los atributos existentes en Positive User. Si el nombre de la columna es idéntico al del atributo, el sistema los emparejará automáticamente durante la importación.
Codificación
¿Qué es la codificación? La codificación indica al ordenador cómo interpretar los caracteres de texto de tu archivo. El formato predeterminado y más recomendado es UTF-8. Elegir UTF-8 garantiza que los caracteres especiales, acentos y símbolos se importen correctamente sin convertirse en símbolos aleatorios.
Separador
¿Qué es un separador? En los archivos CSV (Comma Separated Values), un separador es el signo de puntuación utilizado para dividir el texto en columnas de la hoja de cálculo. Los separadores más comunes son las comas (,) o los puntos y comas (;).
Comprueba cómo ha exportado el archivo tu software de hoja de cálculo y asegúrate de saber qué carácter divide tu data.
Campos con múltiples valores
Si una columna contiene varios valores (por ejemplo, un atributo de tipo elección fija con varios valores permitidos), sepáralos usando el carácter de barra vertical: «|»
Ejemplo: valor1|valor2|valor3
Si estás exportando desde Excel, asegúrate de establecer los formatos de data correctos para cada celda.
Ve a «Data» → «Importadores» y elige «Importar eventos de producto».
Sube o arrastra y suelta el archivo con drag&drop.
Elige la codificación adecuada para tu archivo. (UTF-8 es la predeterminada)
Elige el separador utilizado en tu archivo.
Este paso consiste en asignar los encabezados de columna de tu archivo a los atributos existentes en Positive User.
Coincidencia automática: si el nombre de la columna en tu archivo es exactamente el mismo que el del atributo en el sistema, se emparejarán automáticamente.
Coincidencia manual: para las columnas sin coincidencia, simplemente selecciona el atributo existente correcto en el menú desplegable para conectarlas.
¡Asegúrate de conectar todos los encabezados de columna con los atributos! ¡Las columnas sin coincidencia no se importarán!
Una vez que todas las columnas de tu archivo estén emparejadas con los atributos, haz clic en «Siguiente». Se te redirigirá al paso «Confirmación».
En el paso «Confirmación» revisas el resumen de la importación y confirmas el proceso. Tras la confirmación, el sistema empieza a procesar tu archivo.
Puedes supervisar el proceso de importación y comprobar los resultados finales en la sección «Resultados de la importación», a la que se te redirige automáticamente.
Puedes visitar esta sección en cualquier momento mediante la ruta «Data» → «Importadores» → «Resultados de la importación».
Aquí verás:
Estado de la importación (Iniciada/Pendiente/Completada/Archivada)
Fecha de creación
Completada el
Tipo (qué tipo de data se importó)
Creada por (usuario que subió el archivo)
Nombre del archivo
Total de filas (de tu archivo)
Correctas (número final de filas importadas)
Fallidas (muestra el número de errores)
Si algo va mal durante la importación, haz clic en el nombre del archivo para ver un informe de errores detallado.
Personaliza los datos de tus productos añadiendo atributos que se ajusten a las necesidades de tu negocio, lo que permite un seguimiento y análisis más precisos.
Positive User no almacena valores históricos de los atributos de los eventos de producto (excepto event_type). Cada nuevo evento de producto actualiza los valores actuales de los atributos en el perfil del producto. Esto significa que los valores anteriores se sobrescriben.
