La fonctionnalité d'Export de Données Brutes vous permet d'exporter des données brutes de Contentsquare au niveau des pages vues ou des sessions, pour les utiliser dans d'autres outils. Vous pouvez créer, planifier, gérer et exécuter des jobs en utilisant la console.
En utilisant cette fonctionnalité, vous pouvez exporter les données suivantes :
Voir la documentation complète de référence des champs ici.
-
project_id, user_id
-
Session (temps, durée, lien de révision, transactions,...)
-
Page (URL, requête, temps, interaction)
-
Technologie (OS, device, navigateur, écran)
-
Géo (langue, Ville, Pays)
-
Performance (Temps de chargement, temps DOM)
-
Événements (clic, appuyer, scroll, survoler, custom,...)
- Erreurs (erreurs JS, erreurs d'API, erreurs custom)
Utilisez l'Export de Données Brutes pour :
-
Planifier des exports de tables de données brutes (pages vues, sessions, utilisateurs, segments…)
-
Accéder à l'export directement depuis votre console Contentsquare
-
Alimenter vos bases de données et accumuler des données au-delà de la période de rétention de Contentsquare.
Exemples de cas d'utilisation :
Analytics | Croisez les données brutes de Contentsquare avec des données provenant d'autres sources pour unifier les points de contact des utilisateurs finaux sur toutes les plateformes (Adobe, Google). |
Marketing | Exploitez les données des segments dans les systèmes de marketing (Salesforce, Adobe Oracle, Sap Hybris, Marketo, Insider,...) pour offrir des expériences hyper-personnalisées et agréables, de l'engagement, des conversions et de la fidélité. |
UX/UI | Exploitez les données des segments pour améliorer l'expérience utilisateur final (frustration/attrition) |
Business Insights | Exploitez les données dans vos outils de BI (Tableau, Power BI, Qlikview, Looker,..) pour une analyse et une visualisation plus approfondies. |
Data Analytics | Poussez les données CS vers votre entrepôt de données pour effectuer des analyses et alimenter des algorithmes d'apprentissage automatique. |
Data Retention | Fidélisez les données CS au-delà de la période de rétention des données CS contractualisée. |
Accéder à la fonctionnalité d'Exportation des Données Brutes
1. Cliquez sur l'icône de Paramètres > Console > accédez à l'Exportation des Données onglet.
2. Il y a deux sections dans l'onglet Exportation des Données :
- Exportations de données (par défaut) : planifiez de nouvelles exportations et consultez, modifiez, activez, désactivez ou supprimez les exportations que vous avez déjà planifiées.
- Exportations récentes : consultez l'historique de vos exportations de données.
Créer un travail d'exportation de données
1. Cliquez sur “+ Ajouter une exportation de données” et choisissez si vous souhaitez créer un travail unique ou un travail récurrent (vous aurez l'option de choisir entre des travaux quotidiens ou horaires plus tard dans le processus).
-
Travail ponctuel : est exécuté dès que vous validez le formulaire.
- Vous pouvez extraire des données pour la plage de dates spécifiée (maximum 7 jours, et limité à votre durée de conservation des données contractuelles)
- Vous ne pouvez interroger que les jours complétés (ce qui signifie que vous ne pouvez pas interroger le jour actuel)
- Planifier une exportation récurrente : soit quotidiennement (pour extraire des données brutes pendant 1 jour, chaque jour) ou toutes les heures (pour extraire des données brutes pendant 1 heure, chaque heure).
2. Nommez votre export, sélectionnez les options de planification, le type d'entité (pages vues ou niveau de session), et le format de fichier.
CSV avec en-tête | CSV avec les noms de champs comme première ligne |
CSV sans en-tête | CSV sans noms de champs |
JSON | Chaque ligne consiste en son propre objet JSON |
3. Sélectionnez les champs et segments à exporter.
- Les champs extractibles dépendront du type d'entité sélectionné (pages vues ou session).
4. Sélectionnez le device pour lequel vous souhaitez extraire les données et cliquez sur 'Créer' pour finaliser. L'exportation de données créée apparaîtra alors dans la liste 'Exportations de données'.
- “Tous les visiteurs” est le segment par défaut sélectionné, ce qui extraira chaque session.
- Si vous sélectionnez plusieurs segments, toutes les sessions appartenant à au moins 1 des segments sélectionnés seront exportées. Toutes les sessions qui n'appartiennent à aucun des segments sélectionnés seront filtrées et ne seront pas exportées.
- Dans les données, vous obtiendrez une colonne par segment sélectionné, avec soit 1 soit 0 comme valeur selon que la session appartient au segment (1) ou non (0).
- Vous pouvez remarquer un écart de 4 heures, qui résulte d'un travail récurrent programmé pour s'exécuter toutes les 4 heures. Ce paramètre par défaut optimise la collecte de données et garantit que les rapports capturent toutes les informations pertinentes.
Gérer les exportations
‘Exportations de données’ affiche une liste des exportations qui ont été configurées et planifiées. Vous pouvez visualiser, modifier, supprimer, dupliquer et suspendre/activer les exportations planifiées.
- Cliquez sur le bouton ‘...’ pour chaque ligne afin d'accéder à ces options dans le menu déroulant
Télécharger les fichiers exportés
Il existe deux méthodes pour télécharger vos exports :
Pour télécharger les fichiers exportés manuellement, cliquez sur le bouton de téléchargement pour l'export.
Pour télécharger des fichiers par programme, utilisez l'API des Données Brutes
- Récupérer les fichiers par programme peut être utile, par exemple, pour obtenir tous les nouveaux fichiers générés par un travail récurrent chaque jour (et alimenter tout type d'application client, entrepôts de données & outils BI, etc.)
FAQ
Qui peut gérer les exports ?
Seules les fonctions d'administrateur de Contentsquare peuvent créer et gérer des travaux d'exportation depuis la console.
Combien de temps Contentsquare conserve-t-il l'export ?
Les exports et les fichiers associés peuvent être accédés pendant 7 jours après leur création, vous laissant le temps de les stocker dans votre outil préféré.
Combien de travaux peuvent être exécutés en même temps ?
Un maximum de 10 travaux récurrents (avec 1 segment par travail) peut être actif en même temps. Vous devrez peut-être suspendre ou supprimer un travail quotidien avant de pouvoir en créer un nouveau. Un maximum de 1 travail unique peut être en cours de calcul à tout moment. Mais vous pouvez mettre jusqu'à 9 autres travaux uniques en attente. Les travaux en attente seront déclenchés les uns après les autres, attendant que le travail de calcul actuel soit complété.
Combien de travaux puis-je avoir au total ?
Vous ne pouvez pas avoir plus de 100 travaux (tous statuts confondus) listés dans l'interface. Si vous atteignez la limite, vous devrez supprimer certains de vos travaux avant de pouvoir en créer de nouveaux.
Combien de jours de données puis-je exporter ?
Pour les travaux uniques, vous pouvez exporter des données sur une période maximale de 7 jours.
Comment un jour de données est-il défini ?
Un jour s'étend de minuit à minuit en UTC. L'exportation est indépendante du fuseau horaire (qui est spécifique à l'utilisateur sur la plateforme). Toutes nos dates et heures sont en UTC, que vous pouvez toujours convertir à tout fuseau horaire souhaité dans votre propre application.
Quand un travail d'exportation est-il déclenché ?
Un travail d'exportation commence 4 heures après la fin de la période exportée pour garantir une collecte de données complète.
Par exemple :
• Les exportations quotidiennes sont déclenchées à 04h00 UTC.
• Pour les exportations horaires, si vous exportez des données de 06h00 à 07h00, le travail commencera à 11h00.
Pour les exportations uniques, vous ne pouvez exporter des données que du dernier jour complet ; le jour actuel ne peut pas être exporté.
Quelle est la fraîcheur des données ?
Pour une exportation unique et une exportation quotidienne, vous pourrez exporter jusqu'au dernier jour complet de données. Pour les travaux horaires, à tout moment donné, vous aurez jusqu'à la dernière heure terminée moins 4 heures.
Que faire si mon exportation ne se télécharge pas comme prévu ?
Les Erreurs qui peuvent survenir avec l'Exportation de Données Brutes ne s'affichent pas clairement dans l'IU. Si vos fichiers attendus ne sont pas disponibles dans l'interface d'exportation récente, cela signifie qu'une erreur s'est produite et vous devriez réessayer.
Qu'en est-il des événements mobiles ?
Les événements mobiles ne sont pas encore exportables car ils sont trop complexes et lourds pour être stockés dans des fichiers.
Comment cibler des éléments précis dans mon analyse ?
Les chemins cibles sont traduits et stockés en tant que Cibles CS basées sur la structure DOM. Si vous devez cibler un élément précis, vous devrez identifier des chemins uniques ou vous fier à vos attributs id HTML.
Pourquoi ne puis-je pas accéder à un lien de replay de session disponible dans mon export ?
Le lien peut être en dehors du domaine de la période de rétention de replay de session de votre contrat et n'est donc plus accessible.
Comment puis-je trouver la clé primaire pour cet ensemble de données ?
Pour les exportations de session, la clé est session_id
Pour l'exportation de vues, la clé est une combinaison des champs session_id + view_number
Pourquoi y a-t-il un écart de temps lorsque un travail d'exportation est configuré pour être à une base horaire ?
Les tâches récurrentes sont configurées pour s'exécuter toutes les quatre heures, un paramètre par défaut optimisé pour une collecte de données et un traitement efficaces. Cet intervalle de quatre heures garantit que les données capturées sont à la fois complètes et actuelles tout en maintenant la performance du système. L'écart de temps de 4 heures entre la Date de Création et la plage de dates du rapport est dû à cette configuration par défaut. Chaque rapport reflète les données traitées jusqu'à quatre heures après la plage de dates initiale, garantissant que toutes les informations pertinentes sont incluses.