Cette API permet d'extraire des données brutes, par opposition aux données agrégées. Vous pouvez extraire des données brutes au niveau des pages vues ou des sessions. Les travaux d'exportation peuvent être créés, exécutés et téléchargés de manière programmatique en utilisant cette API de données brutes ou téléchargés manuellement en utilisant la fonctionnalité d'exportation de données brutes.
Si vous devez récupérer les données agrégées de vos fonctionnalités d'analyse Contentsquare, vous devez utiliser l' API des métriques.
Cas d'utilisation
- Propriété des données et flexibilité : charger et historiser les données Contentsquare dans votre entrepôt de données, mettre en œuvre vos propres calculs et rapports personnalisés
- Analyses multi-appareils : réconcilier les données de vos projets Web et Applications
- Analyses centrées sur l'utilisateur : comprendre comment les utilisateurs se comportent à travers plusieurs sessions dans leur parcours
- (Ré)activation : exporter des segments comportementaux et les utiliser dans votre pile marketing
- Science des données : exploiter les données granulaires de Contentsquare et ajouter des dimensions comportementales à vos modèles
Bonnes pratiques
- Limitez votre exportation à ce qui est nécessaire pour le filtrage des champs et des lignes, segment et appareil.
- Identifiez les Cvars / Dvars (jusqu'à 10) qui peuvent être exportés dans des colonnes séparées (plus facile à traiter en aval).
- Préférez une exportation en JSON lorsque les données incluent des champs dont les valeurs sont des tableaux (liste de valeurs) => facile à analyser en JSON, plus complexe en CSV.
- Utilisez le nouvel endpoint POST pour automatiser la création de travaux et construire un historique complet des données.
Étape 1 : Créer des identifiants API
Suivez ces instructions pour générer des identifiants.
Étape 2 : Interroger l'API
Maintenant que vous avez créé les exports de données que vous souhaitez avoir régulièrement et que vous avez créé vos identifiants API, il est temps de récupérer les données via l'API.
Pour une documentation détaillée sur le fonctionnement de l'API et comment vous pouvez la requêter, continuez à lire notre documentation de l'API des données brutes.
FAQ
Les requêtes comptent-elles pour ma limite de requêtes mensuelles ?
Non. Les requêtes sur les points de terminaison de l'API des données brutes ne contribueront pas à votre limite de requêtes mensuelles pour l'Open API (cette limite ne peut être atteinte que via des requêtes sur les points de terminaison de l'API des métriques).
Que faire si mon export ne se télécharge pas comme prévu ?
Les Erreurs qui peuvent survenir avec l'API des 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. Pour vérifier les erreurs, vous pouvez passer par l'API pour lister les exécutions de travaux : les exécutions de travaux qui ont échoué auront l'état 'ÉCHEC'.
Que faire si je change mes définitions de segment ?
Un changement dans la définition du segment peut nécessiter de réexporter les données historiques pour ce segment.