Datahub – Évènements (events)

Aperçu

Cet article présente un nouveau scope DataHub appelée « events ». Il vous permettra d'importer les types d'événements suivants :

• Événements sociaux - sélectionnés à partir d'une liste d'événements préconfigurée à l'échelle du système ;
• Événements personnalisés - à partir d'une liste d'événements spécifiques à l'univers et définis par vous.

/!\ Gardez à l'esprit qu'avec l'import, vous ne pouvez créer que de nouveaux événements. Si vous essayez d'importer un événement qui existe déjà, il sera ignoré.

Pré-requis

• Connaissance du format CSV et de la procédure d'import.
• Un éditeur de texte compatible UTF-8 peut être pratique, mais vous exporterez très probablement les données d'un autre logiciel (tableur, ETL, POS, etc.).
• Tous les événements personnalisés doivent être définis dans votre univers Splio avant l'import.

Comment préparer un fichier pour importer des événements

La structure des fichiers utilisés pour importer des événements sociaux et personnalisés est la même.

Pour importer un événement social, vous devrez choisir l'une des combinaisons de valeurs de «platform», «event» et «source type» fournies par Splio.

Pour importer un événement qui n'est pas présent dans la liste ci-dessous, vous devez d'abord définir un événement personnalisé dans la plateforme Splio. Une fois défini, vous pouvez utiliser toutes les combinaisons de « platform », « d’event » de type de source qui répondent à vos besoins.

Colonnes CSV

Tous les fichiers d'import sont des fichiers CSV. Vous n'êtes pas obligé d'utiliser des guillemets, même si tous les champs des fichiers d'import « events » sont traités comme des chaînes de caractères. Consultez les sous-sections ci-dessous pour trouver les champs utilisés dans les fichiers d'import.

/!\ Les champs «ext_id» et «provider» sont utilisés pour identifier de manière unique chaque événement dans la plateforme Splio. Chaque combinaison de ces deux valeurs doit être unique, sinon Splio rejettera une ligne en tant qu'événement existant.

Données d'événement

• «ext_id» - obligatoire, identifiant d'événement dans le système client
• «provider» - facultatif, nom du fournisseur d'événements, ext_id associé au fournisseur doit être unique dans le référentiel d'événement client
• «event» - obligatoire, nom de l'événement
• «event_date» - obligatoire, date, format SQL (AAAA-MM-JJ HH: MM: SS), sur lequel l'événement a eu lieu
• «channel» - obligatoire, canal sur lequel l'événement a été généré
• "channel_details_id" - facultatif, un identifiant plus spécifique au canal
• "channel_details_name" - facultatif, un nom plus spécifique au canal

Données d'origine

• “individual_id” — obligatoire

Ce champ a deux significations différentes. Pour les événements WeChat, il doit contenir un WeChat OpenId valide de l'auteur de l'événement. Pour tous les autres événements, sa valeur doit être une clé client unique de l'univers (e-mail ou champ personnalisé).

Données source

• «source_type» - facultatif, code de la source qui a déclenché l'événement (différent pour les événements sociaux et personnalisés, voir ci-dessous)
• «source_id» - identifiant de source facultatif dans le canal
• «source_date» - facultatif, une [date au format SQL] (AAAA-MM-JJ HH: MM: SS), sur laquelle la source a eu lieu

/!\ N'oubliez pas que la valeur «source_type» pour les événements sociaux doit être l'une des combinaisons valides présentées ci-dessous. Pour les événements personnalisés, il doit correspondre aux paramètres d'un événement personnalisé qui a été défini dans la plateforme Splio.

Exemples

Exemple de fichier 1: import d'événement WeChat

Le champ «individual_id» contient un 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"

Exemple de fichier 2 : import d'événements sociaux non WeChat

Dans ce cas, le champ "individual_id" contient l'adresse e-mail, qui est la clé unique pour les contacts dans l'univers.

"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"

Exemple de fichier 3 : import d'un événement personnalisé

Les plates-formes d'événements "mail", "skyblog", et leurs événements associés "target" et "like", trouvés dans cet exemple, doivent être créés avant tout import.

De plus, le champ «individual_id» contient les valeurs du champ personnalisé c0 utilisé pour identifier l'émetteur d'événement.

"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"

Nommez le fichier d'import

Splio requiert que vous nommiez vos fichiers d'import d'une manière spécifique. Chaque nom de fichier doit contenir le nom de l'univers, le scope (« events »), la sous-section (vous devriez l'avoir obtenu auprès de votre Project Manager) et la date. L'ordre dans lequel les fichiers sont traités dépend des scopes et des dates.

Le schéma de dénomination est univers_scope_subsection_YYYYMMDD.csv. Cela signifie que le nom correct d'un fichier d'import dans un univers «myunivers», un scope «events» et une sous-section «daily», daté du 14 février 2019, est : "myuniverse_events_daily_20190214".

Combinaisons de sources valides pour les événements sociaux

Chaîne valide par événement

Type de sources valides par canal