Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

Segmente

Filterbasierte oder manuelle Gruppen von Kontakten als Zielgruppen für Newsletter-Versände, optional an eine Absenderdomain gebunden.

Ein Segment ist eine gespeicherte Gruppe von Kontakten, an die Sie einen Newsletter-Versand 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 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.
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 lassen sich auf dieselbe Weise binden. Zusammen halten sie Zielgruppe, Themen und Abmeldungen jeder Marke getrennt; siehe Abmeldungen.

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.

War diese Seite hilfreich?