ℹ️ | En este artículo se explica cómo preparar un fichero “contacts” para importarlo con Splio.
Encontrarás un ejemplo de un fichero para este alcance al final del artículo.
⚠️ | Todos los ejemplos utilizados en este articulo son ficticios.
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 la tabla “contacts” en el fichero de configuración
Preparación de un fichero de contactos
Edita el fichero de importación con tu editor de texto preferido. Si es necesario, utiliza un software de hoja de cálculo con el que te sientas cómodo para controlar el número y la posición de las columnas.
💡| 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 fichero, 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 el Datahub no procesará el fichero si encuentra un nombre de columna que no reconoce o si el fichero no contiene las columnas obligatorias.
Para el fichero “contacts”, están disponibles las siguientes columnas:
Columna |
Obligatorio |
Tipo |
Descripción |
|
* |
Texto (máx. 100 caracteres) |
Email del contacto. Este campo es la clave única de la bdd por defecto (véase más abajo). El correo electrónico debe estar en minúsculas. |
customer_key |
* |
Texto (máx. 100 caracteres) |
En el caso la clave única de la bdd sea un campo personalizado y no el email, ese atributo tendrá que ponerse con su nombre o id en esta columna del fichero (véase «Ejemplo 2» a continuación). |
lastname |
No |
Texto (máx. 255 caracteres) |
Apellidos del contacto. |
firstname |
No |
Texto (máx. 255 caracteres) |
Nombre del contacto. |
language |
No |
Código de idioma (2 letras) |
Código del idioma asignado al contacto (los códigos se escriben en minúscula). La lista de códigos que aceptamos: ar, br, ca, cz, de, en, es, fr, gr, it, ja, kr, nl, pl, ru, tr, zh. |
cellphone |
No |
Texto (máx. 30 caracteres) |
Número de teléfono móvil del contacto. Por defecto, el indicativo será el correspondiente al idioma del universo. |
dateOfCreation |
No |
YYYY-MM-DD HH:MM:SS |
Es el valor que se pondrá como fecha de creación del contacto en la bdd de Splio (véase a continuación). |
subscriptions |
Sí |
(especial) |
Id(s) de las listas a las cuales se quiere dar de alta o quitar los contactos (véase “subscriptions” más abajo). |
c0 |
No |
|
Una o más columnas correspondientes a los campos personalizados de contacto en tu universo. Puedes incluir hasta 180 columnas denominadas o por l’id del campo (de “c0” a “c179”) o per el nombre del campo. |
📗 | Ten en cuenta que los nombres de la columna son case sensitive, p. ej. “cellphone” y “CellPhone” son dos campos diferentes.
📗 | Cada nombre de columna debe aparecere solo una vez en la cabecera.
💡 | Según cual sea la clave única de tu universo en Splio, o la columna “email” o la columna “customer_key” son obligatorias. Consulta la sección «Clave única» a continuación para saber más.
Clave única
Splio utiliza un solo campo para reconocer contactos únicos en la base de datos. Normalmente se denomina clave única porque permite identificar de forma únivoca cada contacto de tu bdd en Splio. Por esta razón, la columnas “customer_key” o “email” siempre son obligatorias.
Por defecto, en Splio, el campo “email” es la clave única. Este caso se presenta en el « Ejemplo 1».
Tu universo Splio se puede configurar para tener un campo personalizado en vez de “email” para identificar los contactos. Si es así, este atributo sustituye “email” como clave única y se vuelve obligatorio en el fichero (columna “customer_key)”.
⚠️ | Recuerda que Splio normalmente no distingue entre contactos según números de teléfono, ni comprueba números de teléfono duplicados (a menos que el campo “cellphone” sea la clave única). Tú decides deduplicar los números de teléfono móvil cuando sea necesario.
Ejemplo 1: Clave única por defecto
Este ejemplo muestra el caso por defecto cuando el email del contacto es la clave única. Utiliza “email” en la cabecera para identificarlo.
email;cellphone;firstname;lastname;language;subscriptions
"misterspots@examplemail.org";"2235334599";"Spotty";"Spots";"fr";"+2"
"lady@examplemail.org";"+4499884472525";"Monica";"Jameson";"en";"+2"
"8sk5k7g87@examplemail.org";"+48502553311";"Lukas";"Syndyk";"pl";"+2"
📗 | Hay 6 columnas en el ejemplo. Las direcciones de email se buscarán en la base de datos para ver si cada registro existe ya. Los nuevos registros se añadirán y los existentes se actualizarán, según los ajustes de tu Fichero de configuración.
💡 | Ten en cuenta que el número de teléfono de la primera línea debajo de la cabecera no tiene código de país. En este caso, se añadirá el prefijo definido por defecto en el fichero de configuración,
La última columna ordena a Splio suscribir todos los contactos a la lista 2 (véase «Suscripción a lista(s)» más adelante).
Ejemplo 2: Campo personalizado como clave única
Este ejemplo presenta un fichero de importación para un universo Splio que utiliza un campo personalizado como clave única de los contactos.
En este universo, el campo “c0” se configuró como clave única. El nombre que se decidió para este campo es “Externalld”. Recomendamos utilizar el nombre del campo y no el id en el fichero para que sea más claro.
"ExternalId";email;cellphone;firstname;lastname;language;subscriptions
"PPL000000045732";"jinx@examplemail.org";"+332235334599";"Mister";"Jinx";"fr";"+1,+2,-11"
"PPL000000107463";"lady@examplemail.org";"+4499884472525";"Monica";"Jameson";"en";"+1,+2,-11"
"PPL000000084232";"ijon.tichy@examplemail.org";"+420257537371";"Ijon";"Tichy";"cz";"+1,+3,-11"
📗 | Se pueden ver siete columnas, la primera es la columna personalizada “customer_key” que contiene la clave única. Splio utilizará estos valores para comprobar cuáles registros son nuevos y cuáles ya existen.
La columna “email” sigue siendo utilizada para importar direcciones de email de los contactos, pero no es obligatorio que todos los contactos tengan este campo rellenado.
Nombre del fichero
Guarda tu archivo con un nombre compuesto por el nombre del universo, la tabla/alcance («contacts»), la subsecuencia y la fecha actual. Por ejemplo:
myuniverse_contacts_business_20180410.csv
Este nombre de fichero pertenece al universo “myuniverse”, subsecuencia “business” definido para contactos y su fecha es el 10 de abril de 2018.
Si deseas más información, consulta la guía Nomenclatura y clasificación de archivos.
Ahora puedes subir el fichero al SFTP/FTPS.
Aclaraciones
Esta sección contiene explicaciones adicionales que pueden ser útiles al trabajar con ficheros de contactos.
Suscripciones a lista(s)
Los contactos en Splio pueden pertenecer a listas numeradas y las importaciones te permiten crear batch suscribiendo y dando de baja a través de la columna “subscriptions”.
La columna contiene una lista de números con signo separados por coma (“,”). Cada número debe estar precedido por el signo más (“+”) para suscribir (p. ej., “+3”) o por el signo menos (“-”) para dar de baja (p. ej. , “-6”). La lista completa debe estar entre comillas, como “+3,-6”.
En el siguiente ejemplo, el contacto se suscribe a las listas 1 y 7 y se da de baja de las listas 2 y 4.
email;subscriptions
"subscriber33@examplemail.org";“+1,-2,-4,+7”
Presta atención al editar los ficheros que contengan la columna de suscripción con un software de hoja de cálculo. Se puede malinterpretar la lista y romperla, especialmente si quieres utilizar la coma (“,”) como separador.
Fechas
Las fechas del campo «dateOfCreation» 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
Recuerda que si dejas vacío el valor en el campo dateOfCreation, Splio insertará la fecha y hora de la importación en la ficha del contacto.
⚠️ | 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 franja horaria CEST.
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.