Datahub - Eventos

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.

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

/!\ 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

Tipos de fuentes válidas por canal