Panoramica
Questo articolo descrive un ambito del DataHub, denominato "eventi" (events), tramite il quale potrai importare i tipi di eventi illustrati a continuazione:
- eventi social — selezionati da una lista di eventi preconfigurata a livello di sistema;
- eventi personalizzati — selezionati da una lista di eventi da un universo specifico, definiti dall'utente.
Troverai un esempio di un file per questo ambito alla fine di questo articolo.
/!\ Considera che, tramite la funzionalità di import, puoi creare soltanto nuovi eventi. Se provi ad importare un evento già esistente, quest'ultimo sarà ignorato.
Prerequisiti
- Conoscenza del formato CSV e della procedura di import.
- Un editor di testo compatibile con la codifica UTF-8 può essere utile, ma verosimilmente esporterai i dati da un altro software (foglio di calcolo, ETL, POS, ecc.).
- Tutti gli eventi personalizzati dovranno essere definiti nel tuo universo Splio prima dell'import.
Preparazione di un file per l'import di eventi
La struttura dei file utilizzata per importare sia gli eventi social sia gli eventi personalizzati è la stessa.
Per importare un evento social, dovrai scegliere una delle combinazioni di valori di "piattaforma", "evento" e "tipo di fonte" forniti da Splio.
Per importare un evento che non è presente nella lista sottostante, prima devi creare un evento personalizzato in piattaforma e, successivamente, utilizzare tutte le combinazioni di piattaforma, evento e tipo di fonte che corrispondono alle tue esigenze.
⚠️| Per favore, limita le dimensioni del file a 100K.
Colonne CSV
Tutti i file di import sono file CSV. Non è necessario utilizzare le virgolette, sebbene tutti i campi nei file di import "events" siano elaborati come stringhe di caratteri. Consulta le sottosezioni a continuazione per identificare i campi utilizzati nei file di import.
/!\ I campi "ext_id" e "provider" sono utilizzati per identificare in modo unico ogni evento in piattaforma. Ogni combinazione di questi due valori deve essere unica, altrimenti Splio rifiuterà una linea come evento esistente.
Dati dell'evento
- "ext_id" — obbligatorio, ID dell'evento nel sistema cliente, deve essere unico
- "event" — obbligatorio, nome dell'evento
- "event_date" — obbligatorio, data, formato SQL (YYYY-MM-DD HH:mm:ss) in cui l'evento avrà luogo
- "channel" — obbligatorio, canale sul quale è stato generato l'evento
- "channel_details_id" — facoltativo, altri ID più specifici del canale
- "channel_details_name" — facoltativo, altri nomi più specifici del canale
- "provider" — facoltativo, nome del fornitore dell'evento, l'associazione ext_id con provider deve essere unica nel repository dell'evento del cliente
Dati iniziali
- "individual_id" — obbligatorio
Questo campo ha due diversi significati. Per gli eventi WeChat, deve contenere un OpenId WeChat valido per generare l'evento. Per tutti gli altri eventi, il suo valore deve essere una chiave cliente unica dell'universo (email oppure campo personalizzato).
Dati d'origine
- "source_type" — facoltativo, codice della fonte che attiva l'evento (diverso per eventi social e personalizzati, vedi qui di seguito)
- "source_id" — facoltativo, ID della fonte nel canale
- "source_date" — facoltativo, una data [in formato SQL] (YYYY-MM-DD HH:mm:ss), nella quale la fonte ha avuto luogo (
/!\ Ricorda che il valore "source_type" per gli eventi social deve essere una delle combinazioni valide illustrate a continuazione. Per gli eventi personalizzati, deve corrispondere ai parametri di un evento personalizzato che è stato definito in piattaforma.
Esempi
File di esempio 1: import dell'evento social
In questo caso il campo "individual_id" contiene l'indirizzo email che è la chiave unica per i contatti nell'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"
File di esempio 2: import di un evento personalizzato
All'interno della piattaforma, gli eventi "mail", "skyblog", "target" e "like", che si trovano in questo esempio, devono essere generati prima di qualsiasi import.
Inoltre, il campo "individual_id" contiene i valori del campo personalizzato c0 utilizzato per identificare chi ha pubblicato l'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"
Assegnare un nome al file di import
Splio richiede che i file di import siano denominati in modo specifico. Ogni nome file deve contenere il nome dell'universo, l'ambito ("events"), la sotto-sezione (generata dal tuo Project Manager) e la data. L'ordine in cui i file sono elaborati dipende dagli ambiti e dalle date.
Lo schema per denominare un file è: universe_scope_subsection_YYYYMMDD.csv. Ciò significa che il nome per un file di import in un universo "myuniverse", ambito "events" e sottosezione "daily", datato 14 febbraio 2019 sarà: "myuniverse_events_daily_20190214".
Combinazioni di fonti valide per gli eventi social
Canale valido per evento
evento |
canale valido |
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 |
Fonti valide per tipo di canale
canale |
tipi di fonte |
|
“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” |