Datahub - Eventos

Información general

Este artículo presenta un nuevo alcance Datahub llamado “events”. 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á.

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

• "ext_id" — obligatorio, identificador de evento en el sistema del cliente, necesita ser único
• "event" — obligatorio, nombre del evento
• "event_date" — fecha obligatoria en formato SQL (YYYY-MM-DD HH MM SS), en la que tuvo lugar el evento
• "channel" — obligatorio, canal en el que se ha generado el evento
• "channel_details_id" — opcional, id más  específica del canal
• "channel_details_name" — opcional, nombre más específico del canal
• "provider" — opcional, nombre del proveedor del evento, la ext_id asociada al proveedor debe ser única en el referencial del evento del cliente

Creador del evento

• "individual_id" — obligatorio

Este campo tiene dos significados diferentes. Para eventos WeChat, debe contener un WeChat OpenId válido del autor del evento. Para todos los demás eventos, su valor debe ser la clave única del contacto (email o campo personalizado).

Fuente del evento

• "source_type" — opcional, código de fuente que desencadenó el evento (distinta para eventos sociales y personalizados, véase a continuación)
• "source_id" — opcional, identificador de fuente en el canal
• “source_date” — opcional, 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 WeChat

El campo “individual_id” contiene una WeChat OpenId.

"ext_id";"channel_details_name";"channel_details_id";"individual_id";"channel";"event";"event_date";"source_type";"source_id";"source_date"
"wmpan2345";"news";2354;"b80b3a0379af3533aa3680fc426f";"wechat_mp";"scan";"2019-03-27 12:22:00";"mp_page";"abacde";"2019-03-27 12:10:00"
"woaAsxa3";;;"d97b43aead3b65e888d1e2d0c1916736dac7f9b5";"wechat_oa";"booking";"2019-03-27 09:42:00";"qr_code";"4534345";"2019-03-27 09:21:30"

Ejemplo fichero 2: Importación de evento social (no WeChat)

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 3: 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