Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Exporter la liste des segments

get

/segments/list

Utilisez cet endpoint pour exporter une liste de segments. Pour chacun, vous obtenez son nom, son identifiant API de Segment et une indication de l’activation du suivi analytique.

Les segments sont renvoyés par groupes de 100, triés par date de création (du plus ancien au plus récent par défaut). Les segments archivés ne sont pas inclus.

Quand utiliser cet endpoint

Vous envoyez des événements et des achats à Braze via l’endpoint /users/track. Pour visualiser ces données dans le temps pour un segment, le suivi analytique doit être activé pour ce segment. Le champ analytics_tracking_enabled dans la réponse de cet endpoint indique quels segments l’ont activé.

L’endpoint Exporter les détails d’un segment ne renvoie pas ce paramètre : cet endpoint est donc le moyen de le vérifier via l’API.

Utilisez cet endpoint pour effectuer les opérations suivantes :

Confirmer que le suivi est activé avant d’envoyer de nouvelles données. Braze ne remplit pas rétroactivement les données de chiffre d’affaires et d’achats antérieures à l’activation du suivi. Vérifiez d’abord que analytics_tracking_enabled est true pour les segments que vous prévoyez de comparer.
Résoudre les problèmes de rapports de segment vides. Si les rapports de sessions, de custom events ou de chiffre d’affaires d’un segment sont vides, vérifiez si analytics_tracking_enabled est false avant de déboguer votre intégration.
Compter vos segments suivis. Un espace de travail peut avoir le suivi activé pour 25 segments au maximum. Utilisez le paramètre page pour récupérer chaque page, puis comptez les segments pour lesquels analytics_tracking_enabled est true afin de savoir combien il en reste.

Pour vérifier ponctuellement quelques segments, sélectionnez le filtre Advanced Tracking Segments Only sur la page Segments. Utilisez cet endpoint lorsque vous avez besoin de la réponse dans un script ou une tâche planifiée.

Cet endpoint lit le paramètre de suivi sans le modifier. Pour activer le suivi, accédez à la section Segment Details d’un segment et activez Analytics Tracking.

Combiner cet endpoint avec d’autres endpoints

Ces endpoints couvrent le reste du flux de suivi des utilisateurs. Pour les endpoints de segment, utilisez un id issu de la réponse de cet endpoint comme segment_id.

Endpoint	Comment il contribue à votre flux de suivi des utilisateurs
Endpoint `/users/track`	Enregistre les custom events, les achats et les mises à jour d’attributs sur lesquels portent les rapports de vos segments suivis.
Endpoint Exporter les détails d’un segment	Récupère la description des filtres et les tags d’un segment pour un `segment_id` donné.
Endpoint Exporter l’analyse d’un segment	Récupère la taille estimée d’un segment dans le temps.
Endpoint `/users/export/segment`	Exporte les profils utilisateur d’un segment, afin que vous puissiez vérifier que les attributs, les custom events et les achats que vous avez envoyés figurent bien sur les profils.

Conseil

Pour obtenir de l’aide sur les exportations CSV et API, consultez la page Résolution des problèmes d’exportation.

Vous pouvez télécharger le document OpenAPI et l’utiliser pour valider des schémas. Pour savoir comment procéder, consultez Utiliser les schémas OpenAPI pour valider les requêtes.

New Stuff!