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

Themen

Abo-Kategorien: Empfänger bestellen eine Art von E-Mails ab und bleiben für den Rest angemeldet. Ein Thema lässt sich an eine Absenderdomain binden.

Ein Thema ist eine Kategorie von E-Mails, etwa „Produkt-Updates“, „Newsletter“ oder „Aktionen“. Empfänger können ein Thema verlassen und für den Rest angemeldet bleiben. Verwalten Sie Themen im Dashboard unter Kontakte → Themen oder über die API.

Jedes Thema hat eine default_subscription, die Sie beim Anlegen festlegen und später nicht mehr ändern können:

  • opt_in: Jeder Kontakt ist angemeldet, solange er sich nicht abmeldet.
  • opt_out: Ein Kontakt ist erst angemeldet, nachdem er sich selbst angemeldet hat.

Ein Thema hat außerdem eine visibility. Ein public-Thema steht auf der Abmeldeseite, ein private-Thema erscheint nur über seinen eigenen Link.

Wie Themen wirken

  • Newsletter-Versände. Ein Newsletter-Versand kann ein Thema ansprechen. Er geht an die Kontakte, die dieses Thema abonniert haben (durch eigene Wahl oder per Standard des Themas). Kontakte, die teamweit abgemeldet sind oder sich von der Absenderdomain abgemeldet haben, werden immer ausgelassen.
  • Einzelne E-Mails. Senden Sie eine E-Mail mit einer topic_id, und sie respektiert dieses Thema. Hat jede to-Adresse das Thema abbestellt, liefert der Versand 422 all_recipients_suppressed.
  • Abmeldeseite. Die Seite listet die öffentlichen Themen auf, sodass ein Empfänger eines ausschalten oder alle Marketing-E-Mails dieser Domain abbestellen kann. E-Mails, die ohne topic_id und außerhalb eines Newsletter-Versands gesendet werden, sind nie betroffen. Siehe Abmeldungen.

Ein Thema, das ein Newsletter-Versand nutzt oder das eine noch wartende E-Mail genutzt hat, lässt sich nicht löschen: Der Aufruf liefert 409 conflict, bis diese hinausgegangen oder abgebrochen sind.

curl -X POST "https://api.billionsend.com/topics" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Product updates", "default_subscription": "opt_in" }'

Die Auswahl eines Kontakts setzen Sie mit PATCH /contacts/{id}/topics und übergeben Einträge wie { "id": "<topic-id>", "subscription": "opt_in" }. GET /contacts/{id}/topics listet jedes Thema mit der subscription des Kontakts und einem Flag explicit auf (false, wenn es der Standard des Themas ist).

Ein Thema pro Marke

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

  • Ein gebundenes Thema steht nur auf der Abmeldeseite dieser Domain. Die Seite keiner anderen Domain zeigt seinen Namen.
  • Ein Versand mit dieser topic_id muss von dieser Domain kommen. Von jeder anderen liefern POST /emails und die Aufrufe für Newsletter-Versände 422.
  • Ein Thema ohne Domain steht auf der Seite jeder Domain und lässt sich von jeder Domain aus senden. "domain_id": null macht ein gebundenes Thema wieder teamweit.
  • Eine Domain lässt sich nicht löschen, solange Themen an sie gebunden sind (409).

Segmente lassen sich auf dieselbe Weise binden.

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

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

War diese Seite hilfreich?