Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Opt-in und Opt-out

Die Handhabung von WhatsApp-Opt-ins und -Opt-outs ist entscheidend, da WhatsApp Ihre Qualitätsbewertung der Telefonnummer überwacht und niedrige Bewertungen dazu führen können, dass Ihre Nachrichtenlimits reduziert werden.

Eine Möglichkeit, eine hohe Qualitätsbewertung aufzubauen, besteht darin, zu verhindern, dass Nutzer:innen Ihr Unternehmen blockieren oder melden. Dies kann erreicht werden, indem Sie qualitativ hochwertige Nachrichten bereitstellen (z. B. Mehrwert für Ihre Nutzer:innen), die Nachrichtenhäufigkeit kontrollieren und Kund:innen die Möglichkeit geben, den Empfang zukünftiger Kommunikation abzulehnen.

Diese Seite beschreibt, wie Sie Opt-ins und Opt-outs einrichten und welche Unterschiede zwischen den Modifikatoren „Regex“ und „is“ bestehen.

Opt-ins können aus externen Quellen oder über Braze-Methoden wie SMS oder In-App- und In-Browser-Nachrichten stammen. Opt-outs können über in Braze festgelegte Schlüsselwörter und WhatsApp-Marketing-Buttons verarbeitet werden. Nutzen Sie die folgenden Methoden als Leitfaden für die Einrichtung von Opt-ins und Opt-outs.

Opt-in-Methoden

Externe Opt-in-Methoden außerhalb von Braze
Braze-gestützte Opt-in-Methoden

Opt-ins für Ihren Braze-WhatsApp-Kanal einrichten

Für WhatsApp-Opt-ins müssen Sie die Anforderungen von WhatsApp einhalten. Außerdem müssen Sie Braze die folgenden Informationen bereitstellen:

Eine external_id, eine Telefonnummer und einen aktualisierten Abo-Status für jede:n Nutzer:in. Dies kann über das SDK oder den /users/track-Endpunkt erfolgen, um die Telefonnummer und den Abo-Status zu aktualisieren.

Hinweis

Braze hat eine Verbesserung des /users/track-Endpunkts veröffentlicht, die Aktualisierungen des Abo-Status ermöglicht. Mehr dazu erfahren Sie unter Abo-Gruppen. Wenn Sie jedoch bereits Opt-in-Protokolle über den /v2/subscription/status/set-Endpunkt erstellt haben, können Sie diese weiterhin dort verwenden.

Externe Opt-in-Methoden außerhalb von Braze

Ihre App oder Website (Kontoregistrierung, Checkout-Seite, Kontoeinstellungen, Kreditkartenterminal) an Braze.

Überall dort, wo Sie bereits eine Marketingeinwilligung für E-Mail oder SMS haben, fügen Sie einen zusätzlichen Abschnitt für WhatsApp hinzu. Nachdem sich ein:e Nutzer:in angemeldet hat, benötigt er/sie eine external_id, eine Telefonnummer und einen aktualisierten Abo-Status. Nutzen Sie dazu, je nach Ihrer Braze-Installation, entweder den /subscription/status/set-Endpunkt oder das SDK.

Extern erstellte Opt-in-Liste

Wenn Sie WhatsApp bereits zuvor verwendet haben, haben Sie möglicherweise schon eine Nutzerliste mit Opt-ins gemäß den WhatsApp-Anforderungen erstellt. Laden Sie in diesem Fall eine CSV-Datei hoch oder verwenden Sie die API mit den folgenden Informationen in Braze.

Ausgehende Nachricht im Kundensupport-WhatsApp-Kanal

Senden Sie in Ihrem Kundensupport-Kanal nach gelösten Anfragen eine automatische Nachricht, in der gefragt wird, ob die Kund:innen Marketing-Nachrichten erhalten möchten. Die Funktionalität hängt hier von den verfügbaren Features in Ihrem gewählten Kundensupport-Tool ab und davon, wo Sie Nutzerinformationen speichern.

Stellen Sie einen Nachrichtenlink von Ihrer WhatsApp-Business-Telefonnummer bereit.
Stellen Sie Schnellantwort-Aktionen bereit, bei denen die Kund:innen mit „Ja“ antworten, um das Opt-in zu bestätigen.
Richten Sie einen benutzerdefinierten Schlüsselwort-Trigger ein.
Für beide Ansätze müssen Sie den Pfad wahrscheinlich wie folgt abschließen:
- Rufen Sie den /users/track-Endpunkt auf, um eine:n Nutzer:in zu aktualisieren oder zu erstellen.
- Nutzen Sie den /subscription/status/set-Endpunkt oder verwenden Sie das SDK.

Eingehende WhatsApp-Nachricht

Lassen Sie Kund:innen eine eingehende Nachricht an die WhatsApp-Nummer senden.

Dies kann als Canvas oder Campaign eingerichtet werden, je nachdem, ob die Nutzer:innen eine Bestätigungsnachricht auf dem neuen Kanal erhalten sollen.

Erstellen Sie eine Campaign mit dem aktionsbasierten Zustellungstrigger einer eingehenden Nachricht.
Erstellen Sie eine Webhook-Campaign. Ein Beispiel-Webhook finden Sie unter Abo-Gruppen.

Tipp

Beachten Sie, dass Sie eine URL oder einen QR-Code zum Beitritt zu einem WhatsApp-Kanal im WhatsApp-Manager unter Phone Number > Message Links erstellen können.

Braze-gestützte Opt-in-Methoden

SMS-Nachricht

Richten Sie in Canvas eine Campaign ein, die Kund:innen fragt, ob sie WhatsApp-Nachrichten erhalten möchten, indem Sie eine der folgenden Methoden verwenden:

Kundensegment: abonnierte Marketinggruppe außerhalb der USA
Benutzerdefinierter Schlüsselwort-Trigger

Erfahren Sie mehr über die Aktualisierung des Abo-Status von Nutzerprofilen unter Abo-Gruppen.

In-App- oder In-Browser-Nachricht

Erstellen Sie eine In-App-Nachricht oder ein In-Browser-Pop-up, das Kund:innen auffordert, sich für die WhatsApp-Nutzung anzumelden.

Verwenden Sie eine HTML-In-App-Nachricht mit JavaScript-„Bridge“, um mit dem Braze SDK zu kommunizieren. Stellen Sie sicher, dass Sie die WhatsApp-Abo-Gruppen-ID verwenden.

Telefonnummer-Erfassungsformular

Verwenden Sie das Telefonnummer-Erfassungsformular-Template im Drag-and-Drop-Editor für In-App-Nachrichten, um Telefonnummern von Nutzer:innen zu erfassen und Ihre WhatsApp-Abo-Gruppen zu erweitern.

Opt-outs für Ihren Braze-WhatsApp-Kanal einrichten

WhatsApp-Schalter „Angebote und Ankündigungen“

WhatsApp bietet in den App-Einstellungen einen Schalter „Angebote und Ankündigungen“, mit dem Nutzer:innen Marketing-Nachrichten ablehnen können. Dieser Schalter funktioniert unabhängig von Braze-Abo-Gruppen:

Braze-Abo-Gruppen werden über Ihre Braze-Integration (API, Präferenzzentrum oder SDK) verwaltet und steuern, welche Nutzer:innen Sie für Nachrichten ansprechen.
Der native WhatsApp-Schalter wird von Meta gesteuert und auf Plattformebene durchgesetzt, außerhalb von Braze.

Diese beiden Ebenen synchronisieren sich nicht automatisch. Wenn ein:e Nutzer:in den Schalter „Angebote und Ankündigungen“ in WhatsApp deaktiviert, blockiert Meta die Zustellung von Marketing-Nachrichten auf Plattformebene, selbst wenn der Braze-Abo-Status der Nutzer:innen als „Abonniert“ angezeigt wird. Die Präferenz der Nutzer:innen wird zum Zeitpunkt der Zustellung berücksichtigt.

Hinweis

Da Braze kein Opt-out-Signal erhält, bis ein Sendeversuch unternommen wird und Meta einen Fehler zurückgibt, spiegeln die Abo-Zahlen in Braze möglicherweise nicht die Nutzer:innen wider, die sich über den WhatsApp-Schalter abgemeldet haben, bis eine Nachricht versucht wird. Das bedeutet, dass Reichweitenschätzungen leicht überhöht sein können, bis diese Rückkopplungsschleife stattfindet.

Allgemeine Opt-out-Schlüsselwörter

Sie können eine Campaign oder ein Canvas einrichten, das Nutzer:innen, die bestimmte Wörter senden, von zukünftigen Nachrichten abmeldet. Canvases können besonders vorteilhaft sein, da sie Ihnen ermöglichen, eine Folgenachricht einzufügen, die das erfolgreiche Opt-out bestätigt.

1. Schritt: Canvas mit dem Trigger „Eingehende WhatsApp-Nachricht“ erstellen

Wenn Sie Schlüsselwort-Trigger auswählen, fügen Sie Wörter wie „Stop“ oder „Keine Nachrichten“ hinzu. Wenn Sie diese Methode wählen, stellen Sie sicher, dass Ihre Kund:innen Ihre Opt-out-Wörter kennen. Fügen Sie beispielsweise nach dem ersten Opt-in eine Folgeantwort hinzu wie: „Um sich von diesen Nachrichten abzumelden, senden Sie jederzeit „Stop“.”

2. Schritt: Nutzerprofil aktualisieren

Aktualisieren Sie das Nutzerprofil mit einer der unter Abo-Gruppen beschriebenen Methoden.

Marketing-Opt-out-Auswahl

Innerhalb des WhatsApp-Nachrichtentemplate-Erstellers können Sie die Option „Marketing-Opt-out“ einfügen. Wenn Sie diese Option verwenden, stellen Sie sicher, dass das Template in einem Canvas mit einem nachfolgenden Schritt für eine Abo-Gruppenänderung verwendet wird.

Erstellen Sie ein Nachrichtentemplate mit der Schnellantwort „Marketing-Opt-out“.
Erstellen Sie ein Canvas, das dieses Nachrichtentemplate verwendet.
Folgen Sie den Schritten im vorherigen Beispiel, aber mit dem Triggertext „STOP PROMOTIONS“.
Aktualisieren Sie den Abo-Status der Nutzer:innen mit einer der unter Abo-Gruppen beschriebenen Methoden.

Opt-in- und Opt-out-Workflows einrichten

Sie können „START“- und „STOP“-Schlüsselwort-Antwort-Workflows für WhatsApp mit diesen beiden Methoden konfigurieren:

Nutzeraktualisierungsschritt
Webhook-Campaign zum Auslösen einer zweiten WhatsApp-Campaign

Nutzeraktualisierungsschritt

Der Nutzeraktualisierungsschritt kann die Telefonnummer der Nutzer:innen zur WhatsApp-Abo-Gruppe hinzufügen, wenn sie ein Schlüsselwort an die Telefonnummer der Abo-Gruppe senden.

Der Nutzeraktualisierungsschritt vermeidet Race-Conditions, da die Nutzer:innen nicht zum nächsten Schritt im Canvas weitergeleitet werden, bevor ihre Telefonnummer zur Abo-Gruppe hinzugefügt wurde. Er erfordert außerdem weniger Einrichtungsschritte als die anderen Methoden, weshalb Braze diese Methode generell empfiehlt.

Erstellen Sie ein Canvas mit dem aktionsbasierten Schritt Send a WhatsApp Inbound Message. Wählen Sie Where the message body und geben Sie „START“ für Is ein.

Wichtig

Für „STOP“-Nachrichten kehren Sie den Nachrichtenschritt zur Bestätigung des Opt-outs und den Nutzeraktualisierungsschritt um. Andernfalls werden die Nutzer:innen zuerst aus der Abo-Gruppe entfernt und sind dann nicht mehr berechtigt, die Bestätigungsnachricht zu erhalten.

Erstellen Sie im Canvas einen Schritt Set Up User Update und wählen Sie für Action die Option Advanced JSON Editor.
Füllen Sie das User Update object mit dem folgenden JSON-Payload aus und ersetzen Sie XXXXXXXXXXX durch Ihre Abo-Gruppen-ID:

{
    "attributes": [
        {
            "subscription_groups": [
                {
                    "subscription_group_id": "XXXXXXXXXXX",
                    "subscription_state": "subscribed"
                }
            ]
        }
    ]
}

Fügen Sie einen nachfolgenden WhatsApp-Nachrichtenschritt hinzu.

Hinweise

Das Update kann mit unterschiedlicher Geschwindigkeit abgeschlossen werden, da Braze die Anfragen des Nutzeraktualisierungsschritts bündelt.

Webhook-Campaign zum Auslösen einer zweiten WhatsApp-Campaign

Eine Webhook-Campaign kann den Eintritt in eine zweite Campaign auslösen, nachdem die Telefonnummer der Nutzer:innen zur WhatsApp-Abo-Gruppe hinzugefügt wurde, wenn sie ein Schlüsselwort an die Telefonnummer der Abo-Gruppe senden.

Wichtig

Sie müssen diese Methode nicht für STOP-Nachrichten verwenden. Die Bestätigungsnachricht wird gesendet, bevor die Nutzer:innen aus der Abo-Gruppe entfernt werden, sodass Sie einen der beiden anderen Schritte verwenden können.

Erstellen Sie eine Campaign oder ein Canvas mit einem aktionsbasierten Schritt Send a WhatsApp Inbound Message. Wählen Sie Where the message body und geben Sie „START“ für Is ein.

Erstellen Sie in der Campaign oder im Canvas einen Webhook-Nachrichtenschritt und ändern Sie den Request Body auf Raw Text.

Geben Sie die Endpunkt-URL der Kund:innen in die Webhook URL ein, gefolgt vom Endpunkt-Link campaigns/trigger/send. Zum Beispiel https://dashboard-02.braze.eu/campaigns/trigger/send.

Geben Sie im Rohtext den folgenden JSON-Payload ein und ersetzen Sie XXXXXXXXXXX durch Ihre Abo-Gruppen-ID. Sie müssen die campaign_id ersetzen, nachdem Sie Ihre zweite Campaign erstellt haben.

{
    "campaign_id": "XXXXXXXXXXX",
    "recipients": [
        {
            "external_user_id": "{{${user_id}}}",
            "attributes": {
                "subscription_groups": [
                    {
                        "subscription_group_id": "XXXXXXXXXXX",
                        "subscription_state": "subscribed"
                    }
                ]
            }
        }
    ]
}

Erstellen Sie eine WhatsApp-Campaign (Ihre zweite Campaign) und setzen Sie den Trigger auf API. Stellen Sie sicher, dass Sie diese campaign_id in den JSON-Payload Ihrer ersten Campaign kopieren.

Hinweise

Attribut-Updates aus dem Canvas-API-Trigger-JSON-Payload werden noch nicht unterstützt, sodass Sie nur eine WhatsApp-Campaign für die WhatsApp-Antwortnachricht auslösen können (wie in Schritt 2).
Ein WhatsApp-Template muss genehmigt sein, um es als Antwortnachricht zu senden. Dies liegt daran, dass eine Schnellantwort erfordert, dass der Trigger für eingehende Nachrichten innerhalb derselben Campaign oder desselben Canvas liegt. Wenn Sie einen Nutzeraktualisierungsschritt verwenden, können Sie eine Schnellantwort-Nachricht ohne Meta-Genehmigung senden.

Den Unterschied zwischen den Modifikatoren „Regex“ und „is“ verstehen

In dieser Tabelle wird STOP als Beispiel-Triggerwort verwendet, um zu zeigen, wie die Modifikatoren funktionieren.

Modifikator	Triggerwort	Aktion
`Is`	`STOP`	Erfasst jede vollständige Wortverwendung von „stop“ unabhängig von der Groß-/Kleinschreibung. Dies erfasst beispielsweise „stop“, aber nicht „please stop“.
`Matches regex`	`STOP`	Erfasst jede Verwendung von „STOP“ in genau dieser Schreibweise. Dies erfasst beispielsweise „STOP“ und „PLEASE STOP“, aber nicht „stop“.
`Matches regex`	`(?i)STOP(?-i)`	Erfasst jede Verwendung von „STOP“ in beliebiger Schreibweise. Dies erfasst beispielsweise „stop“, „please stop“ und „never stop sending me messages“.

New Stuff!