En este artículo se explica cómo preparar un fichero “abandonedcarts” para importarlo con Splio.
Los archivos del alcance “abandonedcarts” son muy similares a los de “orders”, ya que los carritos abandonados representan los recibos que nunca se llegaron a completar. Además, al igual que en el caso de los pedidos, si hay algún artículo en los carritos, deberás importarlos con el fichero de “ordersitems”.
Los datos de los carritos abandonados son normalmente recopilados por tiendas online, las cuales almacenan la selección de artículos que un usuario identificado pone en un carrito de compra virtual y definiden cuando lo pueden considerar como abandonado.
Encontrarás un ejemplo de un fichero para este alcance al final del artículo.
Ten en cuenta que “abandonedcarts” es uno de los alcances que se puede actualizar. Los datos existentes se pueden cambiar en futuras importaciones.
Splio rechazará todos los registros "orderitem" si el pedido correspondiente aún no se ha creado.
⚠️ | Ten en cuenta que el Datahub comienza a procesar un fichero del alcance “abandonedcarts” eliminando en primer lugar todos los “ordersitems” para cada “order_id” encontrado en el archivo.
Requisitos previos
- Conocimiento básico del formato CSV y la codificación UTF-8
- Un editor de texto UTF-8
- Un software de hoja de cálculo
- Creación de la subsecuencia para el alcance “abandonedcarts” en el fichero de configuración
Preparación de un fichero de carritos abandonados
Edita el fichero de importación con tu editor de texto de UTF-8 preferido. Si es necesario, controla el número y posición de las columnas con un software de hoja de cálculo que te guste. Es la mejor herramienta para eliminar cualquier columna que no desees importar.
💡 | Recuerda guardar siempre utilizando la codificación UTF-8 sin BOM.
⚠️| Por favor, limita el tamaño del archivo a 200K.
Cabecera y columnas
La primera línea del archivo, llamada cabecera, se utiliza para determinar el contenido de las líneas siguientes. Por lo tanto, debería contener únicamente los nombres de los campos (uno por cada columna).
⚠️ | Recuerda que, si el Datahub encuentra un nombre de columna que no reconoce, no procesará el archivo.
Para el fichero “abandonedcarts”, están disponibles las siguientes columnas:
|
Columna |
Obligatorio |
Tipo de dato / Longitud máxima |
Descripción |
|
order_id |
Sí |
Texto (máx. 50 caracteres) |
El identificador externo del carrito abandonado importado. Este valor debe ser único para cada carrito. |
|
customer_key |
Sí |
Texto |
Clave única del contacto al cual está relacionado el carrito. |
|
card_code |
No |
Texto |
Código de una tarjeta loyalty, crea un vínculo entre el pedido y la tarjeta loyalty. Consulta «Recibos Loyalty» en Datahub - Recibos. |
|
store_id |
Sí |
Texto (máx. 50 caracteres) |
Id externo de la tienda donde se creó y abandonó el carrito, vincula “abandonedcarts” y “stores”. Los valores de esta columna deben referirse a tiendas ya importadas. |
|
order_date |
No |
Fecha |
Fecha asociada al carrito abandonado. Consulta «Fechas» a continuación para más información sobre el formato.⚠️ | Para evitar errores, rellena siempre las horas, minutos y segundos. |
|
shipping_amount |
No |
Decimal |
Los gastos de envío del posible pedido con el mismo contenido del carrito. |
|
discount_amount |
No |
Decimal |
El descuento total aplicado al carrito. |
|
tax_amount |
No |
Decimal |
Las tasas totales (IVA, tasas de ventas) aplicadas al carrito. |
|
total_amount |
No |
Decimal |
El importe total pagado por los productos del carrito (y envío), menos el descuento. |
|
currency |
No |
Texto (máx. 3 caracteres) |
El código de 3 letras para la divisa del carrito abandonado; se aplica a todos los valores de importe. Si no aparece ninguna divisa, Splio asumirá la divisa por defecto del universo. |
|
salesperson |
No |
Texto (máx. 120 caracteres) |
El vendedor asociado al carrito. |
|
c0 |
No |
|
Una o más columnas correspondientes a los campos personalizados de recibo en tu universo. Puedes incluir hasta 32 columnas denominadas “c0” a “c31”. |
📗 | Ten en cuenta que todos los nombres de campos de sistema se escriben siempre en minúscula y que los nombres de los campos son case sensitive.
💡| La columna customer_key identifica los contactos en la base de datos a través de su clave única del universo Splio. Consulta Datahub - Contactos para obtener más información sobre cómo funciona.
⚠️ | Las columnas “order_id”, “customer_key” y “store_id” son obligatorias. Si el Datahub no las detecta, la importación fallará.
Ejemplo 1: Clave única por defecto
Las primeras líneas de un fichero de importación “abandonedcarts” que utiliza la clave única por defecto (email de contacto) pueden aparecer así:
order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bMhtt-1531745300";"misterspots@examplemail.org";"Internet";"2018-06-22 11:30:00;173.00";"EUR"
"70x1byTRJ-1531778200";"lady@examplemail.org";"Internet";"2018-06-21 12:10:00";"244.99";"EUR"
"70xb1KLio-1531723300";"8sk5k7g87@examplemail.org";"Internet";"2018-06-20 17:33:00";"25.50";"EUR"
📗| Cada línea está compuesta por 6 columnas exactamente. La de “order_id” se utiliza para distinguir entre pedidos, mientra que la de “customer_key” vincula el recibo con el contacto que lo compró.
Ejemplo 2: Campo personalizado como clave única
Esto es un ejemplo de fichero de importación que utilice un campo personalizado como clave única:
order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bKkUt-1531738300";"PPL000000045732";"MGZOO";"2018-06-27 12:17:27";"225.00";"EUR"
"70x1bKooY-1531738300";"PPL000000007633";"MGZOO";"2018-06-27 12:19:23;17.00";"EUR"
"70x1bu9Gt-1531756600";"PPL000000045661";"MGZOO";"2018-06-27 12:22:07";"112.50";"EUR"
📗 | Esta importación es muy similar a la del Ejemplo 1: la principal diferencia es el tipo de valores de la columna “customer_key”. Debes utilizar siempre el mismo tipo de clave única como se define en tu universo Splio.
Designa tu archivo
Para guardar tu archivo, utiliza un nombre compuesto por el nombre del universo, alcance («abandonedcarts»), subsecuencia y fecha actual. Por ejemplo:
myuniverse_abandonedcarts_zoo_20210226.csv
Este nombre de archivo pertenece al universo «myuniverse», subsecuencia «zoo» definido para carritos abandonados y su fecha es el 26 de febrero de 2021.
Si deseas más información, consulta la sección «Normas para designar archivos» en el Documento de información general.
Ahora puedes subir el archivo a SFTP/FTPS.
Nombre del fichero
Para guardar tu archivo, utiliza un nombre compuesto por el nombre del universo, el alcance (“abandonedcarts”), la subsecuencia y la fecha actual. Por ejemplo:
myuniverse_abandonedcarts_zoo_20210225.csv
Este nombre de archivo pertenece al universo “myuniverse”, subsecuencia “zoo” definido para carritos y su fecha es el 25 de febrero de 2021.
Si deseas más información, consulta la sección «Reglas de nomenclatura de ficheros» en el articulo Datahub - Información general.
Ahora puedes subir el fichero al SFTP/FTPS.
Fechas
Todas las fechas de los ficheros de importación de tienda están compuestas por 4 dígitos para el año, 2 para el mes, y 2 para el día, seguido de las horas, minutos y segundos, 2 dígitos cada uno. Una fecha correcta para el 11 de marzo de 2021, 1:17 p.m. tiene el siguiente formato:
2021-03-11 13:17:00
El día y hora están separados por un espacio en blanco. Puedes omitir la parte de la hora y utilizar solo la fecha. Si lo haces de esta forma, Splio asumirá la hora más temprana posible del día (medianoche). Por lo tanto,
2021-03-07
será tratada exactamente como si introdujeras
2021-03-07 0:00:00
⚠️ | Usar fechas sin hora no es una opción muy recomendada: 00:00:00 es medianoche y Splio intentará procesar la fecha como tal. Esto puede causar errores y algunos triggers relacionados con las fechas fallarán.
📗| Un beneficio adicional de utilizar fechas completas es que podrás buscar y filtrar por fecha con una precisión mucho mayor.
⚠️ | Al importar fechas con hora, asegúrate de que siempre utilizas la misma franja horaria (es decir, GMT+1 para clientes fuera de China, y GMT+8 para clientes chinos).
Explicación: NULL y valores de borrado
NULL es un valor especial que informa a la base de datos de que el campo que lo contiene está vacío.
Tu universo Splio puede configurarse para interpretar los valores NULL como instrucciones para vaciar campos. Puedes utilizarlo para borrar valores almacenados en la base de datos. Para ello, asegúrate de que el valor importado es exactamente NULL. Debes evitar espacios delante o detrás: “ NULL” o “NULL ” se reconocerán como valores string.
Si esta opción no está configurada, Splio retendrá los valores para los campos en los que el valor importado sea NULL.
Diferencia entre NULL y campo vacío
“”es un string vacío. En la mayoría de los casos, tanto NULL como “” serán importados como un valor vacío.
Ten presente que el string vacío “” no es considerado como un valor NULL, por lo que no provocará el borrado del valor existente en un campo.