takt

Segments sauvegardés

Un segment est une combinaison de filtres que tu enregistres sous un nom pour la réappliquer en un clic. Plutôt que de reconstruire à chaque visite la même restriction (par exemple navigateur = Firefox et pays ≠ France), tu la sauvegardes une fois et tu la rappelles depuis n’importe quel rapport du site.

Un segment ne crée aucune nouvelle donnée : il réutilise exactement la grammaire de filtres déjà disponible sur le tableau de bord. Enregistrer un segment, c’est mémoriser un jeu de filtres ; l’appliquer, c’est repeupler la barre de filtres vivante avec ce jeu.

Anatomie d’un segment

Un segment est une liste ordonnée de prédicats (de 1 à 20). Chaque prédicat porte :

ChampValeursRôle
dimune dimension connue (ex. browser, country, path)sur quoi porte le filtre
opis (=) ou not (≠)inclusion ou exclusion
valla valeur comparéela valeur attendue
joinand ou orliaison avec le prédicat précédent

La liaison join ne s’applique qu’à partir du deuxième prédicat. Par défaut, deux filtres sur la même dimension sont liés par or (Firefox ou Chrome), et deux filtres sur des dimensions différentes par and (Firefox et France). Tu peux forcer l’une ou l’autre liaison.

Portée et partage

Un segment est attaché à un site et partagé à l’échelle de l’organisation : tous les membres qui voient le site voient ses segments. Le champ created_by retient à titre indicatif l’auteur (vide quand le segment est créé via une clé API).

Les noms de segments sont uniques par site. Tenter d'enregistrer un segment sous un nom déjà pris renvoie une erreur ; mets plutôt le segment existant à jour, ou choisis un autre nom.

Gérer ses segments

Le panneau Segments sauvegardés vit dans les options avancées d’un site.

  1. Construis ta combinaison de filtres dans la barre de filtres.
  2. Clique sur Enregistrer, donne un nom, valide.
  3. Pour réappliquer un segment, sélectionne-le dans la liste : la barre de filtres se repeuple.
  4. Si tu modifies les filtres d’un segment chargé, le panneau détecte l’écart : tu peux mettre à jour le segment en place, ou l’enregistrer comme nouveau.
  5. Supprimer retire le segment pour toute l’organisation.

La création, la mise à jour et la suppression sont réservées aux rôles de gestion du site (owner/admin). Tout membre pouvant lire les statistiques peut appliquer un segment existant.

API

Les segments sont pilotables via l’API REST. Les opérations réclament une clé API portant le scope adéquat — segments:read en lecture, segments:write en écriture.

MéthodeRouteScope
GET/orgs/{org}/sites/{domain}/segmentssegments:read
POST/orgs/{org}/sites/{domain}/segmentssegments:write
PATCH/orgs/{org}/sites/{domain}/segments/{id}segments:write
DELETE/orgs/{org}/sites/{domain}/segments/{id}segments:write

Le corps d’un POST/PATCH porte un name et une definition — la liste de prédicats décrite plus haut. Une définition vide est refusée.

Et ensuite