Datahub – Évènements (events)

Aperçu

Cet article présente un scope DataHub appelée « events », également appelée Interactions dans l'interface. 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.

Vous trouverez un exemple de fichier pour ce scope à la fin de l'article.

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é. Vous ne pouvez pas supprimer ni mettre à jour une interaction avec Datahub.

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.

⚠️ | Veuillez limiter la taille de votre fichier à 100K lignes.

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

/!\ 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énements sociaux

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