Segments
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.
Un segment est un groupe enregistré de contacts auquel vous pouvez envoyer une campagne. 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}etDELETE /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. 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.
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": nullrend 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 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.
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.