---
title: Segments
description: Des groupes de contacts par filtre ou manuels, utilisés comme audiences de campagne et, si vous le souhaitez, liés à un domaine d'envoi.
seo:
  title: Segments email
ai:
  exclude: true
---

Un segment est un groupe enregistré de contacts auquel vous pouvez envoyer une [campagne](/docs/fr/concepts/broadcasts). Créez des segments dans le tableau de bord sous **Contacts → Segments**, ou via l'API.

Il en existe deux types :

- **Segment par filtre.** Il stocke un filtre, pas une liste de personnes. Un contact qui commence à correspondre au filtre fait aussitôt partie du segment, et le nombre de contacts est calculé à la lecture.
- **Segment manuel.** Créé sans filtre. Vous ajoutez et retirez les contacts vous-même, dans le tableau de bord ou avec `POST /contacts/{id}/segments/{segmentId}` et `DELETE /contacts/{id}/segments/{segmentId}`.

Un filtre peut tester l'e-mail, le nom, l'état d'abonnement et la date de création d'un contact, ainsi que toute [propriété personnalisée](/docs/fr/concepts/contacts). Les opérateurs incluent égal à, contient, est renseigné, n'est pas renseigné et les comparaisons de dates, et les conditions se combinent avec et/ou.

## Utiliser un segment

- **Campagnes.** Choisissez un segment comme audience. Les personnes qui reçoivent l'e-mail sont déterminées à l'envoi, avec le même filtre que le nombre que vous avez vu auparavant. Les contacts désinscrits pour toute l'équipe, ou qui se sont désinscrits du domaine d'envoi de la campagne, sont toujours exclus.
- **Vue Contacts.** Filtrez la liste par segment. L'export CSV suit le même filtre.

```sh
curl -X POST "https://api.billionsend.com/segments" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Trial users",
    "filter": { "match": "all", "conditions": [{ "field": "property:plan", "op": "equals", "value": "trial" }] }
  }'
```

`GET /segments/{id}` inclut le `contact_count` en direct, et `GET /segments/{id}/contacts` liste les membres. Un filtre invalide renvoie `422` et n'est jamais enregistré.

## Un segment par marque

Si chacun de vos domaines est une marque à part, liez un segment au domaine auquel il appartient en définissant `domain_id`, à la création ou plus tard avec `PATCH /segments/{id}`, ou en choisissant le domaine dans le tableau de bord.

- Une campagne destinée à un segment lié doit être envoyée depuis ce domaine. Depuis tout autre domaine, les appels de campagne renvoient `422`.
- Un segment sans domaine fonctionne avec tous les domaines. `"domain_id": null` rend de nouveau un segment lié valable pour toute l'équipe.
- Un domaine ne peut pas être supprimé tant que des segments y sont liés (`409`).

Les [thématiques](/docs/fr/concepts/topics) peuvent être liées de la même façon. Ensemble, elles séparent l'audience, les thématiques et les désinscriptions de chaque marque ; voir [Désinscriptions](/docs/fr/concepts/unsubscribes).

## Clés API limitées à un domaine

Une clé API limitée à un seul domaine ne peut créer que des segments liés à ce domaine, et ne peut pas en rendre un valable pour toute l'équipe.
