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, chacun incluant son nom, son identifiant API de Segment et l’état d’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.

See me in Postman

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 segment doit avoir le suivi analytique activé. 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 que analytics_tracking_enabled est true pour les segments que vous souhaitez comparer en premier.
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 un maximum de 25 segments. Utilisez le paramètre page pour récupérer chaque page, puis comptez les segments pour lesquels analytics_tracking_enabled est true afin de voir combien il en reste.

Pour vérifier quelques segments ponctuellement, 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 et ne le modifie pas. 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 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 événements personnalisés, les achats et les mises à jour d’attributs sur lesquels vos segments suivis génèrent des rapports.
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 sont bien présents sur les profils.

Endpoint reference

This reference is generated from the OpenAPI specification for this endpoint. To run the endpoint, copy the generated cURL example and send it from your terminal or Postman. You can also download the raw OpenAPI spec for this page at /docs/fr/assets/api/openapi/export_segments_get_segment.yaml. Use this spec to validate that your requests include the correct parameters, fields, and structure before you send them. To learn how, see Use OpenAPI schemas for request validation.

New Stuff!