Skip to content

API-E-Mail-Präferenzzentrum

Die Einrichtung eines Präferenzzentrums bietet Ihren Nutzer:innen eine zentrale Anlaufstelle, um ihre Benachrichtigungspräferenzen für Ihr E-Mail-Messaging zu bearbeiten und zu verwalten. Dieser Artikel enthält Schritte zum Erstellen eines API-generierten Präferenzzentrums, aber Sie können ein Präferenzzentrum auch mit dem Drag-and-Drop-Editor erstellen.

Gehen Sie im Braze-Dashboard zu Audience > Email Preference Centers.

Hier können Sie jede Abo-Gruppe verwalten und anzeigen. Jede von Ihnen erstellte Abo-Gruppe wird dieser Präferenzzentrum-Liste hinzugefügt. Sie können mehrere Präferenzzentren erstellen.

Einstellungscenter mit API erstellen

Mithilfe der Braze-Endpunkte für das Einstellungscenter können Sie ein Einstellungscenter erstellen – eine von Braze gehostete Website, die den Abo-Status und die Abo-Gruppenstatusangaben Ihrer Nutzer:innen anzeigen kann. Mithilfe von HTML und CSS kann Ihr Entwickler:innen-Team das Einstellungscenter so gestalten, dass das Seitendesign Ihren Markenrichtlinien entspricht.

Durch die Verwendung von Liquid können Sie die Namen Ihrer Abo-Gruppen und den Status jeder Nutzerin und jedes Nutzers abrufen. Auf diese Weise speichert und ruft Braze diese Daten ab, wenn die Seite geladen wird.

Voraussetzungen

Anforderung Beschreibung
Aktiviertes Einstellungscenter Ihr Braze-Dashboard verfügt über die Berechtigungen zur Nutzung des Einstellungscenter-Features.
Gültiger Workspace mit einer E-Mail-, SMS- oder WhatsApp-Abo-Gruppe Ein funktionierender Workspace mit gültigen Nutzer:innen und einer E-Mail-, SMS- oder WhatsApp-Abo-Gruppe.
Gültige:r Nutzer:in Eine Nutzerin oder ein Nutzer mit einer E-Mail-Adresse und einer externen ID.
Generierter API-Schlüssel mit Einstellungscenter-Berechtigungen Gehen Sie im Braze-Dashboard zu Einstellungen > API-Schlüssel, um zu bestätigen, dass Sie Zugriff auf einen API-Schlüssel mit Einstellungscenter-Berechtigungen haben.

Schritt 1: Den Endpunkt „Einstellungscenter erstellen“ verwenden

Beginnen wir mit dem Aufbau eines Einstellungscenters mithilfe des Endpunkts „Einstellungscenter erstellen“. Um Ihr Einstellungscenter anzupassen, können Sie HTML, das zu Ihrem Branding passt, in das Feld preference_center_page_html und das Feld confirmation_page_html einfügen.

Der Endpunkt „Einstellungscenter-URL generieren“ ermöglicht es Ihnen, die Einstellungscenter-URL für eine:n bestimmte:n Nutzer:in außerhalb einer über Braze gesendeten E-Mail abzurufen.

Schritt 2: In Ihre E-Mail-Campaign einbinden

Um einen Link zum Einstellungscenter in Ihren E-Mails zu platzieren, verwenden Sie den folgenden Liquid-Tag an der gewünschten Stelle in Ihrer E-Mail, ähnlich wie Sie Abmelde-URLs einfügen würden.

1

{{preference_center.${kitchenerie_preference_center_example}}}

Sie können auch eine Kombination aus HTML mit Liquid verwenden. Zum Beispiel können Sie Folgendes als URL entweder im HTML-Editor oder im Drag-and-Drop-Editor einfügen. Dies zeigt das grundlegende Einstellungscenter-Layout, das automatisch alle E-Mail-Abo-Gruppen auflistet. Wenn Sie Link Aliasing verwenden, fügen Sie nach dem Liquid-Tag ein nachgestelltes Fragezeichen (?) hinzu, damit Braze Tracking-Parameter anhängen kann.

1

<a href="{{preference_center.${kitchenerie_preference_center_example}}}?">Edit your preferences</a>

Das Einstellungscenter verfügt über ein Kontrollkästchen, mit dem sich Ihre Nutzer:innen von allen E-Mails abmelden können.

Einstellungscenter testen

Links zum Einstellungscenter werden für jede Nutzer:in zum Sendezeitpunkt generiert und sind an einen aktiven Campaign- oder Canvas-Versand gebunden. Testversand und Editor-Vorschauen unterstützen das Speichern von Abo-Änderungen nicht. Dies ist das erwartete Verhalten.

Was Sie sehen werden

  • Testversand: Liquid-Tags des Einstellungscenters werden möglicherweise nicht zu einem gültigen Link aufgelöst. Wenn die Seite geladen wird, ist der Button Save Preferences deaktiviert, und Abo-Änderungen werden nicht gespeichert.
  • Tab „Vorschau“ im Drag-and-Drop-Editor: Sie können Layout und Styling in der Vorschau anzeigen, aber Sie können das Speichern von Einstellungen nicht über den Editor testen.

End-to-End testen

Um zu überprüfen, ob Links und Buttons des Einstellungscenters vor einem vollständigen Start funktionieren:

  1. Erstellen Sie eine Campaign oder einen Canvas-E-Mail-Schritt, der Ihren Liquid-Tag für das Einstellungscenter enthält.
  2. Richten Sie den Versand nur an Ihre Testnutzer:innen oder ein kleines internes Segment.
  3. Starten Sie die Nachricht und öffnen Sie die E-Mail aus einem echten Posteingang (nicht über Test senden).
  4. Wählen Sie den Link zum Einstellungscenter aus, aktualisieren Sie die Abo-Gruppen und wählen Sie Save Preferences.
  5. Bestätigen Sie die Änderungen im Profil der Nutzer:in im Braze-Dashboard.

Als Alternative für API-basierte Einstellungscenter können Sie den Endpunkt „Generate preference center URL“ verwenden, um eine funktionierende URL für eine bestimmte Nutzer:in außerhalb eines Testversands abzurufen.

Weitere Einschränkungen beim Testversand finden Sie unter Testnachrichten senden.

Vorschau, Testversand und Live-Versand

Methode Layout-Vorschau Abo-Änderungen speichern
Tab Vorschau im Drag-and-Drop-Editor Ja Nein
Campaign oder Canvas Test senden Teilweise (E-Mail wird zugestellt) Nein
Live-Versand an Testnutzer:innen oder ein Segment Ja Ja
API Generate preference center URL Ja Ja

Ein Einstellungscenter bearbeiten

Sie können Ihr Einstellungscenter mithilfe des Endpunkts „Einstellungscenter aktualisieren“ bearbeiten und aktualisieren.

Einstellungscenter und Details identifizieren

Um Ihre Einstellungscenter zu identifizieren, verwenden Sie den Endpunkt „Details für Einstellungscenter anzeigen“, um zugehörige Informationen wie den Zeitstempel der letzten Aktualisierung, die Einstellungscenter-ID und mehr abzurufen.

Ein Präferenzcenter anpassen

Braze verwaltet die Aktualisierungen des Abo-Status über das Präferenzcenter, wodurch das Präferenzcenter synchron gehalten wird. Sie können jedoch auch Ihr eigenes Präferenzcenter erstellen und hosten, indem Sie die Abo-Gruppen-APIs mit den folgenden Optionen verwenden.

Verwenden Sie Abfragestring-Feld-Wert-Paare im Body der URL, um die Nutzer:innen-ID und die E-Mail-Kategorie an die Seite zu übergeben, sodass Nutzer:innen nur ihre Abmeldeentscheidung bestätigen müssen. Diese Option eignet sich für diejenigen, die einen Nutzer:innen-Bezeichner in einem gehashten Format speichern und noch kein Abo-Center haben.

Für diese Option benötigt jede E-Mail-Kategorie ihren eigenen spezifischen Abmeldelink:
http://mycompany.com/query-string-form-fill?field_id=Alex&field_category=offers

Option 2: Authentifizierung mit JSON Web Token

Verwenden Sie ein JSON Web Token, um Nutzer:innen für einen Bereich Ihres Webservers zu authentifizieren (zum Beispiel Kontoeinstellungen), der normalerweise hinter einer Authentifizierungsschicht wie Nutzername und Passwort geschützt ist.

Dieser Ansatz erfordert keine in die URL eingebetteten Abfragestring-Wert-Paare, da diese im Payload des JSON Web Tokens übergeben werden können, zum Beispiel:

1
2
3
4
5

{
    "user_id": "1234567890",
    "name": "Alex Smith",
    "category": "offers"
}

Häufig gestellte Fragen

Warum funktioniert mein Preference Center nicht bei einem Testversand?

Links zum Preference Center erfordern einen Live-Versandkontext. Testversände erzeugen keine gültigen Preference-Center-URLs, und der Button Einstellungen speichern ist deaktiviert, wenn die Seite geladen wird. Dies ist das erwartete Verhalten. Um End-to-End zu testen, starten Sie eine Campaign oder einen Canvas-Schritt an eine:n Testnutzer:in oder ein kleines internes Segment, oder verwenden Sie den Endpunkt „Preference-Center-URL generieren“. Weitere Informationen finden Sie unter Preference Center testen.

Ich habe kein Preference Center erstellt. Warum wird „PreferenceCenterBrazeDefault“ in meinem Dashboard angezeigt?

Dieses wird verwendet, um das Preference Center zu rendern, wenn das Legacy-Liquid ${preference_center_url} genutzt wird. Das bedeutet, dass Canvas-Schritte oder Templates, die entweder ${preference_center_url} oder preference_center.${PreferenceCenterBrazeDefault} referenzieren, nicht funktionieren. Dies gilt auch für zuvor gesendete Nachrichten, die das Legacy-Liquid oder „PreferenceCenterBrazeDefault“ als Teil der Nachricht enthielten.

Wenn Sie ${preference_center_url} erneut in einer neuen Nachricht referenzieren, wird ein Preference Center mit dem Namen „PreferenceCenterBrazeDefault“ erneut erstellt.

Unterstützen Preference Center mehrere Sprachen?

Nein. Sie können jedoch Liquid nutzen, wenn Sie den HTML-Code für benutzerdefinierte Opt-in- und Opt-out-Seiten schreiben. Wenn Sie dynamische Links zur Verwaltung von Abmeldungen verwenden, handelt es sich um einen einzelnen Link.

Wenn Sie beispielsweise die Abmelderate für spanischsprachige Nutzer:innen verfolgen möchten, müssten Sie entweder separate Campaigns verwenden oder Analytics rund um Currents nutzen (z. B. prüfen, wann sich Nutzer:innen abmelden, und die bevorzugte Sprache dieser Nutzer:innen überprüfen).

Als weiteres Beispiel könnten Sie zur Verfolgung der Abmelderaten für spanischsprachige Nutzer:innen einen Query-Parameter-String wie ?Spanish=true an die Abmelde-URL anhängen, wenn die Sprache der Nutzer:innen Spanisch ist, und andernfalls einen regulären Abmeldelink verwenden:

1
2
3
4

{% if ${language} == 'spanish' %} "${unsubscribe_url}?spanish=true"
{% else %}
${unsubscribe_url}
{% endif %}

Anschließend könnten Sie über Currents ermitteln, welche Nutzer:innen Spanisch sprechen und wie viele Klick-Ereignisse es für diesen Abmeldelink gab.

Nein. Wenn beim Erstellen einer E-Mail-Campaign die Meldung „Your Email Body does not include an unsubscribe link“ angezeigt wird, ist diese Warnung zu erwarten, wenn sich Ihr Abmeldelink in einem Content-Block befindet.

Wie aktualisiere ich das Standard-Browsersymbol?

Standardmäßig verwendet das Symbol neben dem Browser-Tab-Namen (Favicon) das Braze-Logo. Um ein benutzerdefiniertes Favicon hinzuzufügen, legen Sie es über das Attribut links-tags in Ihrem API-Aufruf zum Erstellen oder Aktualisieren des Preference Center fest. Braze speist dann den <link rel="icon" ...>-Tag in die gehostete Seite für Sie ein.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

{
  "name": "MyPreferenceCenter",
  "preference_center_title": "Email Preferences",
  "preference_center_page_html": "<!doctype html> ...",
  "confirmation_page_html": "<!doctype html> ...",
  "state": "active",
  "options": {
    "links-tags": [
      {
        "rel": "icon",
        "type": "image/png",
        "sizes": "32x32",
        "href": "https://yourcdn.com/path/to/favicon-32x32.png"
      },
      {
        "rel": "shortcut icon",
        "type": "image/x-icon",
        "href": "https://yourcdn.com/path/to/favicon.ico"
      },
      {
        "rel": "apple-touch-icon",
        "sizes": "180x180",
        "href": "https://yourcdn.com/path/to/apple-touch-icon.png"
      }
    ]
  }
}
New Stuff!