Este artículo explica como preparar un fichero “contactos” para importarlo en Splio. Todos los ejemplos utilizados en este artículo son anónimos o ficticios.

Prerrequisitos

Conocimientos básicos del formato CSV y de la codificación UTF-8.
Un editor de texto compatible con UTF-8.
Un programa para hojas de cálculo.
La subsecuencia debe definirse en el fichero de configuración, en la sección “contactos”.

Preparar un fichero de contactos

Modifica el archivo de importación con el editor de texto compatible con UTF-8 que prefieras. Si es necesario, utiliza un programa para hojas de cálculo con el que estés familiarizado para gestionar el número y la posición de las columnas.

📘
No olvides guardar siempre con la codificación UTF-8 sin BOM

🚧
Por favor, limita el tamaño del archivo a 200K líneas.

Header y Columnas

La primera línea del fichero, denominada header, se utiliza para determinar el contenido de las líneas siguientes. Por lo tanto, solo debe construirse a partir de los nombres de las columnas.

🚧
Ten en cuenta que Splio no importará el archivo si no se puede identificar un nombre de columna o si faltan columnas obligatorias.

Estos son los campos que encontrarás en el fichero “contactos”:

Columna	Obligatorio	Tipo	Descripción
email	*	Texto (máx. 100 caracteres)	El correo electrónico, que se tiene que escribir en minúsculas. Esta columna es la clave primaria predefinida del cliente (ver más abajo)
customer_key	*	Texto (máx. 100 caracteres)	En el caso de que la clave única de la base de datos no sea el correo electrónico, sino un campo personalizado, este campo deberá asociarse a esta columna. Véase el ejemplo 2 a continuación.
lastname	No	Texto (máx. 255 caracteres)	El apellido del contacto.
firstname	No	Texto (máx. 255 caracteres)	El nombre del contacto.
language	No	Código de la lengua (2 letras)	El código de la lengua asignado al contacto (los códigos están en minúsculas). Esta es la lista de códigos aceptados: ar, br, ca, cz, de, en, es, fr, gr, it, ja, kr, nl, pl, ru, tr, zh.
cellphone	No	Texto (máx. 30 caracteres) 0033XXXXXXXXX	El número de móvil del contacto. Por defecto, el prefijo internacional corresponderá a la lengua utilizada en el universo
dateOfCreation	No	YYYY-MM-DD HH:MM:SS	Es el valor introducido como fecha de creación de un contacto en la base de datos Splio.
subscriptions	Yes	(especial)	Lista de números utilizados para suscribir y dar de baja contactos de las listas. Véase «Suscripciones» más abajo.
c0	No		Una columna personalizada definida en su universo para los contactos. Puede incluir hasta 180 columnas denominadas 'c0' a 'c179'.

📘

Es importante tener en cuenta que los nombres de columna deben respetar las diferencias entre mayúsculas y minúsculas, como 'cellphone' y 'CellPhone', ya que representan columnas distintas

Cada nombre de columna sólo puede utilizarse una vez.

Las columnas 'email' y 'customer_key' son obligatorias, pero siempre deberás utilizar sólo una de ellas, dependiendo de la configuración de tu universo Splio. Para más detalles, consulta la sección «clave de cliente» más abajo.

Clave de Cliente

Splio utiliza una sola columna para reconocer contactos únicos en la base de datos. Esta columna suele denominarse «clave de cliente» porque cada valor que contiene siempre es único y permite identificar los datos de los clientes (contactos) a partir de ella. Por esta razón, la columna de clave de cliente tiene que ser siempre obligatoria.

Por defecto, el campo «email» sirve de clave de cliente, como se muestra en el ejemplo 1.

Tu universo SCP puede estar configurado para utilizar una columna personalizada en lugar de “email” para identificar a los contactos. En este caso, esta columna sustituye a «email» como clave de cliente y pasa a ser obligatoria. Utiliza el alias de esta columna personalizada en el header del archivo de importación.

🚧
Ten en cuenta que Splio no suele distinguir entre contactos basándose en los números de teléfono, ni comprueba si hay números de teléfono duplicados a menos que el campo 'móvil' esté configurado como clave de cliente. Por lo tanto, asegúrate de eliminar los números de teléfono móvil duplicados si es necesario.

Ejemplo 1: Clave de Cliente Predefinida

Este ejemplo muestra el caso predefinido en el que la dirección de correo electrónico del contacto es la clave de cliente. Introduce “email” en el header para identificarlo:

email;cellphone;firstname;lastname;language;subscriptions 
"[email protected]";"2235334599";"Spotty";"Spots";"fr";"+2" 
"[email protected]";"+4499884472525";"Monica";"Jameson";"en";"+2" 
"[email protected]";"+48502553311";"Lukas";"Syndyk";"pl";"+2"

📘

Hay 6 columnas en el ejemplo. Las direcciones de correo electrónico se comprobarán en la base de datos en busca de datos existentes. Se añadirán nuevos datos y se actualizarán los existentes, en función de los ajustes de su archivo de configuración.

Ten en cuenta que el número de teléfono de la primera línea debajo del header no incluye el prefijo del país. En este caso, se utilizará el prefijo establecido por defecto en el archivo de configuración.

La última columna indica a Splio que suscriba todos los contactos a la lista nº 2. Véase «suscripciones a listas» más abajo.

Ejemplo 2: Columna personalizada como Clave de Cliente

Este ejemplo muestra un archivo de importación para un universo Splio que utiliza un campo personalizado para distinguir los contactos únicos.

En este universo la columna “c02” ha sido configurada para identificar los contactos. Esta columna tiene el alias “ExternalId”. Se recomienda utilizar el alias para mayor claridad.

"ExternalId";email;cellphone;firstname;lastname;language;subscriptions 
"PPL000000045732";"[email protected]";"+332235334599";"Mister";"Jinx";"fr";"+1,+2,-11" 
"PPL000000107463";"[email protected]";"+4499884472525";"Monica";"Jameson";"en";"+1,+2,-11" 
"PPL000000084232";"[email protected]";"+420257537371";"Ijon";"Tichy";"cz";"+1,+3,-11"

📘

Se pueden ver siete columnas, la primera es la columna personalizada 'customer_key' que contiene los ids externos. Splio utilizará estos valores para comprobar cuáles son los datos nuevos y cuáles son ya existentes.

La columna ''email'' se sigue utilizando para importar las direcciones de correo electrónico de los contactos.

Nombrar el archivo

Para guardar el archivo, utiliza un nombre que incluya el nombre del universo, la sección («contactos»), la subsecuencia y la fecha actual. Por ejemplo

myuniverse_contacts_business_20180410.csv

El nombre de este fichero pertenece al universo “myuniverse”, a la subsecuencia “business” establecida para los contactos, y tiene fecha de 10 de abril de 2018.

Si necesitas más información, consulta la guía sobre cómo nombrar y agrupar archivos.

Ahora puedes subir el archivo a SFTP/FTPS.

Detalles adicionales

Esta sección contiene detalles adicionales que pueden resultar útiles a la hora de gestionar archivos de contactos

Suscripciones a las listas

Los contactos en Splio pueden pertenecer a listas numeradas, y las importaciones permiten suscribirse y darse de baja por batches (lotes) utilizando la columna de suscripción.

La columna contiene una lista de números marcados separados por comas (','). Cada número debe ir acompañado de un signo más ('+') para suscribirse (por ejemplo, '+3') o de un signo menos ('-') para anularla (por ejemplo, '-6'). La lista completa debe ir entre comillas, por ejemplo «+3,-6».

En el ejemplo siguiente, el contacto está suscrito actualmente a las listas 1 y 7, mientras que se ha dado de baja de las listas 2 y 4:

email;subscriptions 
"[email protected]";"+1,-2,-4,+7"

Ten cuidado cuando trabajes con archivos que incluyan la columna de suscripción utilizando un programa de hoja de cálculo porque puede interpretar incorrectamente la lista y dañarla, especialmente si utiliza la coma (',') como separador.

Fechas

En el campo 'dateOfCreation', las fechas están formadas por 4 dígitos para el año, 2 para el mes y 2 para el día, seguidos de las horas, minutos y segundos, cada uno con 2 dígitos. Por ejemplo, el formato correcto para el 11 de marzo de 2021 a las 13:17, es el siguiente:

2021-03-11 13:17:00

La fecha y la hora están separadas por un espacio. Es posible omitir la hora e introducir solo la fecha. En tal caso, Splio considerará automáticamente la medianoche como hora de referencia. Por lo tanto,

2021-03-07 se considerará exactamente como si hubieras introducido 2021-03-07 00:00:00

Recuerda que si no especificas el campo "dateOfCreation", Splio utilizará la fecha y la hora de la importación.

🚧

Usar fechas sin la hora nunca debería ser una opción para fechas y horas: 00:00:00 es medianoche y Splio intentará procesar la fecha como tal. Esto puede causar errores y algunos triggers asociados a las fechas no funcionarán. Otra ventaja de usar fechas completas es que será posible buscar y filtrar por fecha con mucha más precisión.

Al importar fechas con hora, asegúrate de utilizar siempre la zona horaria CEST.

NULL y valores de cancelación

NULL es un valor específico que indica a la base de datos que el campo correspondiente está vacío.

Puedes configurar tu universo Splio para que interprete los valores NULL como instrucciones para vaciar los campos.

Puedes configurar tu universo Splio para que interprete los valores NULL como instrucciones para vaciar los campos. Esta función te permite borrar datos almacenados en la base de datos. Asegúrate de que el valor importado es exactamente NULL, sin espacios adicionales al principio o al final, de lo contrario " NULL" o “NULL” serán tratados como valores de cadena.

Si no se habilita esta opción, Splio conservará los valores de los campos en los que el valor importado sea 'NULL'.

Diferencia entre NULL y cadena vacía

“” es una cadena vacía. En la mayoría de los casos, tanto NULL como “” se importarán como valores vacíos.

En particular, la cadena vacía "" nunca se considera como un valor NULL, por lo que no provoca la eliminación de un valor existente.