---
title: Segmente
description: Filterbasierte oder manuelle Gruppen von Kontakten als Zielgruppen für Newsletter-Versände, optional an eine Absenderdomain gebunden.
seo:
  title: E-Mail-Segmente
ai:
  exclude: true
---

Ein Segment ist eine gespeicherte Gruppe von Kontakten, an die Sie einen [Newsletter-Versand](/docs/de/concepts/broadcasts) senden können. Legen Sie Segmente im Dashboard unter **Kontakte → Segmente** an oder über die API.

Es gibt zwei Arten:

- **Filter-Segment.** Es speichert einen Filter, keine Liste von Personen. Ein Kontakt, der den Filter zu erfüllen beginnt, gehört sofort zum Segment, und die Kontaktzahl wird beim Lesen berechnet.
- **Manuelles Segment.** Ohne Filter angelegt. Sie fügen Kontakte selbst hinzu und entfernen sie, im Dashboard oder mit `POST /contacts/{id}/segments/{segmentId}` und `DELETE /contacts/{id}/segments/{segmentId}`.

Ein Filter kann E-Mail-Adresse, Name, Abo-Status und Erstellungsdatum eines Kontakts sowie jede [eigene Eigenschaft](/docs/de/concepts/contacts) prüfen. Zu den Operatoren gehören „ist gleich“, „enthält“, „ist gesetzt“, „ist nicht gesetzt“ und Datumsvergleiche, und Bedingungen lassen sich mit „und“ bzw. „oder“ verknüpfen.

## Ein Segment verwenden

- **Newsletter-Versände.** Wählen Sie ein Segment als Zielgruppe. Wer die E-Mail erhält, wird beim Senden berechnet, mit demselben Filter wie die Zahl, die Sie vorher gesehen haben. Kontakte, die teamweit abgemeldet sind oder sich von der Absenderdomain des Newsletter-Versands abgemeldet haben, werden immer ausgelassen.
- **Kontaktansicht.** Filtern Sie die Liste nach Segment. Der CSV-Export folgt demselben Filter.

```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}` enthält die aktuelle `contact_count`, und `GET /segments/{id}/contacts` listet die Mitglieder auf. Ein ungültiger Filter liefert `422` und wird nie gespeichert.

## Ein Segment pro Marke

Wenn jede Ihrer Domains eine eigene Marke ist, binden Sie ein Segment an die Domain, zu der es gehört, indem Sie `domain_id` setzen, beim Anlegen oder später mit `PATCH /segments/{id}`, oder indem Sie die Domain im Dashboard auswählen.

- Ein Newsletter-Versand an ein gebundenes Segment muss von dieser Domain aus gesendet werden. Von jeder anderen Domain liefern die Aufrufe für Newsletter-Versände `422`.
- Ein Segment ohne Domain funktioniert mit jeder Domain. `"domain_id": null` macht ein gebundenes Segment wieder teamweit.
- Eine Domain lässt sich nicht löschen, solange Segmente an sie gebunden sind (`409`).

[Themen](/docs/de/concepts/topics) lassen sich auf dieselbe Weise binden. Zusammen halten sie Zielgruppe, Themen und Abmeldungen jeder Marke getrennt; siehe [Abmeldungen](/docs/de/concepts/unsubscribes).

## API-Schlüssel, die auf eine Domain beschränkt sind

Ein auf eine Domain beschränkter API-Schlüssel kann nur Segmente anlegen, die an diese Domain gebunden sind, und kann keines teamweit machen.
