SMS-, MMS- und RCS-Abo-Gruppen

Abo-Gruppen bilden die Grundlage für den Versand von SMS-, MMS- und RCS-Nachrichten über Braze. Eine Abo-Gruppe ist eine Sammlung von Sendeentitäten (wie RCS-verifizierte Absender, SMS-Shortcodes, SMS-Langcodes oder alphanumerische SMS-Absender-IDs), die für einen bestimmten Nachrichtenzweck verwendet werden. Wenn eine Marke beispielsweise sowohl transaktionale als auch werbliche SMS-Nachrichten versenden möchte, müssen zwei Abo-Gruppen mit separaten Pools von Sendetelefonnummern in Ihrem Braze-Dashboard eingerichtet werden.

Hinweis

Sie können bis zu 350 Abo-Gruppen pro Workspace hinzufügen.

Abo-Gruppenstatus

Es gibt zwei Abo-Status für SMS- und RCS-Nutzer:innen: subscribed und unsubscribed. Der Abo-Status einer Nutzer:in befindet sich auf Ebene der Abo-Gruppe und wird nicht über Abo-Gruppen hinweg geteilt. Das bedeutet, dass eine Nutzer:in bei einer transaktionalen Abo-Gruppe subscribed sein kann, aber bei einer werblichen Abo-Gruppe unsubscribed. Für Marken stellt diese Trennung der Status sicher, dass sie weiterhin relevante SMS- und RCS-Nachrichten an ihre Nutzer:innen senden können.

Status einer Nutzer:in festlegen

Wenn eine Telefonnummer in einem Nutzerprofil aktualisiert wird, erbt die neue Telefonnummer den Abo-Gruppenstatus der Nutzer:in. Wenn die Telefonnummer auf eine Nummer aktualisiert wird, die bereits in Braze existiert, wird der Abo-Status dieser bestehenden Telefonnummer übernommen.

Wenn beispielsweise Nutzer:in A eine Telefonnummer hat, die bei mehreren Abo-Gruppen abonniert ist, und diese Telefonnummer dann zu Nutzer:in B hinzugefügt wird, wird Nutzer:in B bei denselben Abo-Gruppen abonniert. Um zu verhindern, dass eine Nutzer:in die bestehenden Abos erbt, können Sie die Abo-Gruppen der alten Nummer über die Braze REST API zurücksetzen, wenn eine Nutzer:in ihre Nummer ändert. Wenn mehrere Nutzer:innen diese Telefonnummer teilen, werden alle abgemeldet.

Um den Abo-Gruppenstatus einer Nutzer:in festzulegen, verwenden Sie eine der folgenden Methoden:

• REST API: Nutzerprofile können programmatisch über den /subscription/status/set-Endpunkt mithilfe der Braze REST API festgelegt werden.
• SDK-Integration: Nutzer:innen können einer E-Mail- oder SMS- und RCS-Abo-Gruppe mit der Methode addToSubscriptionGroup für Android, iOS oder Web hinzugefügt werden.
• Telefonnummern-Erfassungsformular für In-App-Nachrichten: Telefonnummern von Nutzer:innen können über das Telefonnummern-Erfassungs-Template im Drag-and-Drop-Editor für In-App-Nachrichten erfasst werden.
• Automatische Verarbeitung bei Opt-in/Opt-out: Wenn Nutzer:innen ein Standard-Opt-in- oder Opt-out-Schlüsselwort senden, setzt und aktualisiert Braze den Abo-Status der Nutzer:innen automatisch.
• Nutzerimport: Nutzer:innen können über Import Users in E-Mail- oder SMS- und RCS-Abo-Gruppen hinzugefügt werden. Beim Aktualisieren des Abo-Gruppenstatus müssen diese zwei Spalten in Ihrer CSV vorhanden sein: subscription_group_id und subscription_state. Weitere Informationen finden Sie unter Nutzerimport.
• Braze-Dashboard: Öffnen Sie unter Nutzersuche das Profil einer Nutzer:in und aktualisieren Sie SMS- oder RCS-Abo-Gruppen unter Contact Settings im Tab Engagement.
• Cloud Data Ingestion (CDI): Fügen Sie subscription_group_id und subscription_state in synchronisierte Zeilen ein. Siehe Cloud Data Ingestion – Tabelleneinrichtung.
• User-Update-Schritt: Aktualisieren Sie den Abo-Status in einem Canvas mit einem User-Update-Schritt. Siehe Status einer Nutzer:in in einem Canvas aktualisieren für Hinweise zum Timing.

Status einer Nutzer:in in einem Canvas aktualisieren

Wenn Sie den Abo-Gruppenstatus einer Nutzer:in als Teil eines Canvas-Flows aktualisieren, verwenden Sie einen User-Update-Schritt anstelle eines Webhooks. Der User-Update-Schritt wartet, bis die Verarbeitung abgeschlossen ist, bevor die Nutzer:in zum nächsten Schritt weitergeleitet wird, sodass nachfolgende Messaging-Schritte den aktualisierten Abo-Status verwenden.

Wenn Sie einen Webhook zum Aktualisieren von Abo-Gruppen verwenden, wird die Nutzer:in weitergeleitet, sobald der Webhook gesendet wurde – nicht wenn die Abo-Änderung fertig verarbeitet ist. Dies kann eine Race-Condition verursachen, bei der ein nachfolgender SMS-Schritt ausgeführt wird, bevor die Nutzer:in abonniert ist, was dazu führt, dass die Nachricht bei einem Teil der Nutzer:innen fehlschlägt. Wenn Sie einen Webhook verwenden müssen, fügen Sie einen Verzögerungsschritt von mindestens 1 Minute vor dem nächsten Messaging-Schritt hinzu.

Wie Braze verwaiste Abo-Status behandelt

Ein verwaister Abo-Status ist ein Abo-Status, der für eine Telefonnummer oder E-Mail-Adresse gespeichert ist, die keinem Nutzerprofil zugeordnet ist. Für SMS, E-Mail, WhatsApp und LINE behandelt Braze verwaiste Abo-Status wie folgt:

• Wenn ein:e Nutzer:in gelöscht wird und die einzige Person ist, die mit einer bestimmten Telefonnummer oder E-Mail-Adresse verknüpft ist, wird der Abo-Status für diese Telefonnummer oder E-Mail-Adresse sofort gelöscht.
• Wenn Sie /subscription/status/set oder /v2/subscription/status/set mit einer Telefonnummer oder E-Mail-Adresse aufrufen, die derzeit keinem Nutzerprofil zugeordnet ist, speichert Braze diesen Abo-Status bis zu 30 Tage lang, danach wird er automatisch gelöscht.
  • Wenn use_double_opt_in_logic auf true gesetzt ist und kein Nutzerprofil mit der angegebenen Telefonnummer verknüpft ist, wird der Abo-Status nicht aktualisiert; ein:e Nutzer:in muss existieren, um den Double-Opt-in-Workflow zu durchlaufen.
• Wenn ein neues Nutzerprofil mit einer Telefonnummer oder E-Mail-Adresse erstellt wird, für die ein verwaister Abo-Status gespeichert ist, übernimmt diese:r Nutzer:in den gespeicherten Abo-Status – allerdings nur innerhalb des 30-Tage-Fensters. Diese 30-tägige Übergangsfrist ist beabsichtigt und dient dazu, Race-Conditions zu behandeln, wenn das Erstellen eines Nutzerprofils und das Setzen des Abo-Status für den Kanal-Bezeichner in separaten API-Aufrufen erfolgen. Ein Beispiel für diese Race-Condition ist, wenn eine /subscription/status/set-Anfrage für eine Telefonnummer verarbeitet wird, bevor die /users/track-Anfrage zur Erstellung des entsprechenden Nutzerprofils verarbeitet wird.

Gruppe einer Nutzer:in prüfen

Um die Abo-Gruppe einer Nutzer:in zu prüfen, verwenden Sie eine der folgenden Methoden:

• Nutzerprofil: Auf einzelne Nutzerprofile kann über das Braze-Dashboard zugegriffen werden, indem Sie Nutzersuche in der Seitenleiste auswählen. Hier können Sie Nutzerprofile nach E-Mail-Adresse, Telefonnummer oder externer Nutzer-ID suchen. Innerhalb eines Nutzerprofils können Sie unter dem Tab „Engagement“ die SMS- und RCS-Abo-Gruppen einer Nutzer:in einsehen.
• REST API: Die Abo-Gruppe einzelner Nutzerprofile kann über den Endpunkt „Abo-Gruppen von Nutzer:innen auflisten“ oder den Endpunkt „Abo-Gruppenstatus von Nutzer:innen auflisten“ mithilfe der Braze REST API eingesehen werden.

Nachrichten mit einer Abo-Gruppe senden

Um eine SMS- oder RCS-Campaign über Braze zu starten, wählen Sie eine Abo-Gruppe aus dem Dropdown SMS/MMS/RCS Variants aus. Nach der Auswahl wird automatisch ein Zielgruppenfilter zu Ihrer Campaign oder Ihrem Canvas hinzugefügt, sodass nur Nutzer:innen, die bei der ausgewählten Abo-Gruppe subscribed sind, zur Zielgruppe gehören.

Bevor Nutzer:innen Nachrichten von einer Campaign oder einem Canvas erhalten können, müssen sie bei der ausgewählten Abo-Gruppe abonniert sein. Wenn Sendungen für ansonsten gültige Nutzer:innen fehlschlagen, bestätigen Sie deren Abo-Status mit einer der Methoden unter Status von Nutzer:innen festlegen. Informationen zu Double-Opt-in-Anforderungen finden Sie unter Abo-Gruppenstatus.

Wichtig

In Übereinstimmung mit internationalen Telekommunikationsvorschriften und -richtlinien sendet Braze niemals SMS oder RCS an Nutzer:innen, die nicht bei der ausgewählten Abo-Gruppe abonniert sind.

Best Practices für SMS-Abo-Gruppen

Erstellen Sie separate SMS-Abo-Gruppen für jeden Nachrichtenzweck (z. B. transaktional versus Marketing) und für jeden Workspace. Wenn Sie in mehreren Ländern tätig sind, sollten Sie separate Gruppen nach Region einrichten, um lokale Compliance-Regeln zu unterstützen – beispielsweise die Einschränkungen Brasiliens für Zeitfenster bei Werbenachrichten.

Abo-Gruppen aktivieren

Um Abo-Gruppen für SMS, MMS oder RCS zu aktivieren, beachten Sie Folgendes:

• sms
• mms
• rcs

Natürlichsprachliche Opt-outs in der Agent Console verarbeiten

Für ein umfassendes Abo-Management können Sie Abmeldeabsichten erfassen, die außerhalb von Standard- oder angepassten Keywords liegen (z. B. „Bitte schreib mir nicht mehr“). Durch die Erstellung eines KI-Agenten können Sie Sentimentanalyse nutzen, um diese Anfragen automatisch zu erkennen und darauf zu reagieren.

Einrichtung

1. Erstellen Sie in der Agent Console einen „SMS Sentiment Analysis Agent“.

Tipp

Verwenden Sie Operator, um bei der anfänglichen Agentenkonfiguration zu unterstützen.

2. Erstellen Sie ein aktionsbasiertes Canvas, das durch Send an SMS inbound message innerhalb der Keyword-Kategorie Other getriggert wird.
3. Fügen Sie den Agent-Schritt zum Canvas hinzu, um die Abmeldeabsicht zu erkennen.
4. Fügen Sie einen nachfolgenden SMS-Nachrichtenschritt hinzu, um die Anfrage zu bestätigen: „Es sieht so aus, als möchten Sie sich von SMS abmelden, daher werden wir Sie abmelden. Falls dies ein Fehler war, senden Sie START, um sich wieder anzumelden.“
5. Fügen Sie einen Nutzer:innen-Update-Schritt hinzu, um den Status der Nutzer:in in der jeweiligen SMS-Abo-Gruppe auf „Unsubscribed“ zu ändern.

Hinweis

Die Nutzung der Agent Console verbraucht Message- oder Action-Credits.

SMS-Datenverkehr zu RCS migrieren

Wenn Sie separate SMS- und RCS-Abo-Gruppen haben, können Sie Nutzer:innen mithilfe eines einstufigen Canvas von SMS zu RCS migrieren.

Braze empfiehlt, zunächst RCS-Nachrichten an kleinere Nutzergruppen zu testen und im Laufe der Zeit mehr Nutzer:innen in die RCS-Abo-Gruppe zu migrieren. Wenn Sie beispielsweise 1.000.000 Nutzer:innen haben, die eine SMS-Abo-Gruppe abonniert haben, könnte dies so aussehen, dass Sie zunächst alle Nutzer:innen in die neue Abo-Gruppe migrieren und dann ein kleineres Segment von 50.000 bis 100.000 (5–10 %) auswählen, um die RCS-Nachrichten zu testen.

Schritt 1: Canvas erstellen und den Eintrittszeitplan ausfüllen

Erstellen Sie ein Canvas und geben Sie ihm einen leicht erkennbaren Namen (z. B. „SMS-RCS Abo-Gruppen-Nutzertransfer“). Planen Sie die Campaign dann zu einem für Sie passenden Zeitpunkt.

Schritt 2: Zielgruppe definieren

Definieren Sie Ihre Zielgruppe mit einer der folgenden Methoden. Gehen Sie anschließend zum Schritt Sendeeinstellungen und wählen Sie Nutzer:innen, die abonniert oder angemeldet sind aus.

Schritt 3: Einen Nutzeraktualisierungsschritt konfigurieren

Fügen Sie Ihrem Canvas einen Nutzeraktualisierungsschritt hinzu. Öffnen Sie im Schritt den Advanced JSON Editor und geben Sie Folgendes ein (für das Feld zur eindeutigen Nutzeridentifikation empfehlen wir die Verwendung des Felds braze_id):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "attributes": [
    {
      "braze_id": "{{${braze_id}}}",
      "subscription_groups": [
        {
          "subscription_group_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
          "subscription_state": "subscribed",
          "use_double_opt_in_logic": true
        }
      ]
    }
  ]
}

Schritt 4: Canvas testen

Wir empfehlen dringend, Ihr Canvas zu testen, um sicherzustellen, dass es wie erwartet funktioniert, bevor Sie es an Ihre breitere Zielgruppe senden.

Schritt 5: Canvas starten

Nachdem Sie Ihr Canvas erfolgreich getestet haben, starten Sie es für Ihre Teilmenge von Nutzer:innen!

Um zu bestätigen, dass Ihre Nutzer:innen erfolgreich migriert wurden, empfehlen wir, einige einzelne Nutzerprofile zu überprüfen, die aktualisiert wurden. Suchen Sie im Tab Engagement nach Kontakteinstellungen und scrollen Sie, um die Abo-Gruppen anzuzeigen, die die Nutzer:in abonniert hat. Der Schalter für die RCS-Abo-Gruppe sollte jetzt aktiviert sein.

Informationen zur Einrichtung von RCS-Sendern und Abo-Gruppen finden Sie auch unter RCS einrichten.

Best Practices

Separate Abo-Gruppen einrichten

• Nachrichtentyp: Erstellen Sie separate Abo-Gruppen für jeden Nachrichtentyp, z. B. Transaktional und Marketing.
• Workspace: Erstellen Sie separate Abo-Gruppen für jeden Workspace, um Klarheit und Übersichtlichkeit zu gewährleisten.

Betrachten Sie das folgende Beispiel mit vier Abo-Gruppen in zwei Workspaces:

• Produktions-Workspace
  • Marketing - PROD für SMS
  • Transaktional - PROD für SMS
• Entwicklungs-Workspace (zum Testen)
  • Marketing - DEV für SMS
  • Transaktional - DEV für SMS

Klare Namenskonventionen verwenden

Wählen Sie aussagekräftige und klare Namen für Abo-Gruppen, damit beim Erstellen von SMS-Campaigns die richtige Gruppe ausgewählt wird.

Gruppen nach Land trennen

SMS-Vorschriften variieren je nach Land. Wir empfehlen, SMS-Abo-Gruppen nach Land zu trennen. So können Sie die Compliance-Standards in allen Regionen einhalten, in die Sie Nachrichten senden.

Für jede Abo-Gruppe können Sie außerdem unter Geographic Permissions eine Länder-Allowlist konfigurieren, sodass SMS, MMS und RCS nur an genehmigte Regionen gesendet werden. Weitere Informationen finden Sie unter Geografische Berechtigungen.

In Brasilien ist es beispielsweise verboten, Marketing-Nachrichten außerhalb der Zeiten von 9:00 bis 21:00 Uhr Ortszeit zu versenden, und das Land erstreckt sich über drei Zeitzonen. Um diese Vorschriften einzuhalten, könnten Sie separate Gruppen für den Versand von Nachrichten nach Brasilien und in die USA einrichten. So wird verhindert, dass Nutzer:innen in Brasilien Marketing-Nachrichten während der verbotenen Zeiten erhalten.