Traduit de l'anglais à l'aide de l'IA
Veuillez noter que cet article a été traduit à l'aide de la technologie IA. Bien que nous travaillions à maintenir l'exactitude, certains détails peuvent ne pas refléter parfaitement le texte original. Si vous avez des doutes sur une information, veuillez vous référer à la version anglaise.
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 de la page vue ou de la session. Des travaux d'exportation peuvent être créés, exécutés et téléchargés de manière programmatique à l'aide de cette API de données brutes ou téléchargés manuellement à l'aide de la fonction 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 inter-appareils : concilier les données de vos projets Web et Apps
- 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
Meilleures pratiques
- Limitez votre exportation à ce qui est nécessaire pour le filtrage des champs et des lignes, le segment et l'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 l'interroger, continuez à lire notre documentation de l'API de données brutes.
FAQ
Les requêtes comptent-elles pour ma limite de demandes mensuelles ?
Non. Les requêtes sur les points de terminaison de l'API de données brutes ne contribueront pas à votre limite de demandes 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 de données brutes ne s'affichent pas clairement dans l'interface utilisateur. 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 se passe-t-il 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.