Información general
Este artículo presenta un alcance Datahub llamado “events”, también llamado Interactions en la interfaz. Te permitirá importar los siguientes tipos de eventos:
- eventos social — seleccionados de una lista de eventos global y preconfigurada;
- eventos personalizados — de una lista de eventos definida por el usuario en un universo específico.
Encontrarás un ejemplo de un fichero para este alcance al final del artículo.
⚠️| Ten en cuenta que, con la importación, solo puedes crear nuevos eventos. Si intentas importar un evento que ya existe, se descartará. No puedes actualizar ni eliminar una interaction con Datahub.
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 “events” en el fichero de configuración
- Definición previa de todos los eventos personalizados en tu universo Splio
Preparación de un fichero de importación de eventos
La estructura de los ficheros utilizados para importar tanto eventos social, como personalizados es la misma.
Para importar un evento social, deberás elegir una de las combinaciones de valores “platform”, “event” y “source_type” proporcionados por Splio.
Para importar un evento que no se encuentre en la siguiente lista, deberás definir un evento personalizado en la plataforma de Splio primero. Una vez definido, puedes utilizar todas las combinaciones de la plataforma, evento y tipo de fuente adecuados para ti.
⚠️| Por favor, limita el tamaño del archivo a 100K.
Columnas CSV
Todos los ficheros de importación son archivos CSV. No es obligatorio que utilices comillas, aunque todos los campos de los ficheros de importación “events” son procesados como string de caracteres. Consulta los apartados más abajo para descubrir los campos utilizados en los ficheros de importación.
/!\ Los campos “ext_id” y “provider” se utilizan para identificar de forma única cada evento de la plataforma Splio. Cada combinación de estos dos valores debe ser única; de lo contrario, Splio rechazará una línea como evento existente.
Datos del evento
Columna |
Obligatorio |
Tipo de datos / Longitud máxima |
Descripción |
ext_id | sí | cadena de caracteres | identificador de evento en el sistema del cliente, necesita ser único |
event | sí | cadena de caracteres (64 caracteres) | nombre del evento, no distingue entre mayúsculas y minúsculas |
event_date | sí | data | fecha obligatoria en formato SQL (YYYY-MM-DD HH MM SS), en la que tuvo lugar el evento |
channel | sí | cadena de caracteres | canal en el que se ha generado el evento |
channel_details_id | no | cadena de caracteres | id más específica del canal |
channel_details_name | no | cadena de caracteres | nombre más específico del canal |
provider | no | cadena de caracteres | nombre del proveedor del evento, la ext_id asociada al proveedor debe ser única en el referencial del evento del cliente |
individual_id | sí | cadena de caracteres | su valor debe ser la clave única del contacto (email o campo personalizado). Para que la importación funcione, este cliente debe existir en la base de datos |
source_type | no | cadena de caracteres | código de fuente que desencadenó el evento (distinta para eventos sociales y personalizados, véase a continuación) |
source_id | no | cadena de caracteres | identificador de fuente en el canal |
source_date | no | date | fecha en formato SQL (YYYY-MM-DD HH MM SS), en la que tuvo lugar el evento |
/!\ Recuerda que el valor "source_type" para eventos social debe ser una de las combinaciones válidas que se presentan a continuación. Para eventos personalizados, debes combinar los parámetros de un evento personalizado que haya sido definido en la plataforma Splio.
Ejemplos
Ejemplo fichero 1: Importación de evento social
En este caso, el campo “individual_id” contiene la dirección de email, que es la clave única de contactos en el universo.
"ext_id";"individual_id";"channel_details_name";"channel_details_id";"contact_id";"contact_type";"platform";"event";"event_date";"source_type";"source_id";"source_date"00012;"someone@splio.com";;;;;instagram;view;"2019-03-27 12:22:00";story;"mybrand";"2019-03-27 12:10:00"
"00013";"someone@splio.com";;;;;"facebook";"like";"2019-03-27 19:42:00";"other";"4534345";"2019-03-27 09:21:30"
"00014";"someone@splio.com";;;;;"twitter";"scan";"2019-03-27 19:42:00";"tweet";"453234";"2019-04-02 19:25:30"
Ejemplo fichero 2: importación de un evento personalizado
Las plataformas de evento "mail", "skyblog", y sus eventos relacionados "target" y "like", encontradas en este ejemplo, deben crearse antes de cualquier importación.
Además, el campo "individual_id” contiene los valores del campo personalizado c0 utilizado para identificar al creador del evento.
"ext_id";"channel_details_name";"channel_details_id";"individual_id";"platform";"event";"event_date";"source_type";"source_id";"source_date"
"1";;;"73698946815";"mail";"target";"2019-03-27 12:22:00";"flyer";"12344";"2019-03-27 12:10:00"
"2";;;"834121212";"skyblog";"like";"2019-03-27 19:42:00";"a";"4534345";"2019-03-27 09:21:30"
"3";;;;"AB21435456";"skyblog";"like";"2019-03-27 19:42:00";"b";"453234";"2019-04-02 19:25:30"
Nomenclatura del fichero
Splio requiere que designes tus ficheros de importación de una forma específica. Cada nombre de fichero debe contener el nombre del universo, alcance ("events"), subsecuencia (deberías haberlo obtenido de tu Project Manager), y fecha. El orden en que los archivos se procesan depende de los alcances y fechas.
El esquema de designación es universo_alcance_subsecuencia_YYYYMMDD.csv. Esto quiere decir que el nombre propio de un archivo de importación en un universo "myuniverse", alcance "events", y subsecuencia "daily", con fecha de 14 de febrero de 2019, sería myuniverse_events_daily_20190214.
Combinaciones de fuentes válidas para eventos sociales
Canal válido por evento
Evento |
Canal válido |
booking |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
chatbot_usage |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
check_in |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
click |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
comment |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
complete_survey |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
favorite |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
follow |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
geoloc_authorization |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
like |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
login |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
mention |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
message |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
open |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
optin |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
optout |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
reaction |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
read |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
read_more |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
scan |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
share |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
unfollow |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
view |
facebook,instagram,twitter,wechat_mp,wechat_oa,x_channel |
Tipos de fuentes válidas por canal
Canal |
Tipos de fuente |
|
“post”, “event”, “survey”, “story”, “link”, “other” |
|
“post”, “message”, “story”, “link”, “other” |
|
“tweet”, “dm”, “link”, “other” |
wechat_mp |
“mini_program”, “mp_page”, “other” |
wechat_oa |
“wechat_action”, “page”, “post”, “event”, “survey”, “store”, “qr_code”, “link” |