Aktionscodes verwenden
Erfahren Sie, wie Sie Aktionscodes verwenden und die Nutzung für Ihre Kampagnen und Canvases einsehen können.
Voraussetzungen
Bevor Sie Aktionscodes verwenden können, müssen Sie eine Aktionscode-Liste erstellen.
Aktionscodes verwenden
Um einen Aktionscode in einer Nachricht zu senden, wählen Sie Snippet kopieren neben der Aktionscode-Liste, die Sie zuvor erstellt haben.

Fügen Sie die Code-Snippets in eine Ihrer Nachrichten in Braze ein und verwenden Sie dann Liquid, um einen der eindeutigen Aktionscodes aus Ihrer Liste einzufügen. Dieser Code wird als gesendet markiert, sodass keine andere Nachricht denselben Code sendet.

Über Canvas-Schritte hinweg
Wenn ein Code-Snippet in einer Kampagne oder einem Canvas mit Multichannel-Nachrichten verwendet wird, erhält jede:r Nutzer:in einen eindeutigen Code. In einem Canvas mit mehreren Schritten, die auf Aktionscodes verweisen, erhält ein:e Nutzer:in für jeden Schritt, den sie/er betritt, einen neuen Code.
Um einen Aktionscode in einem Canvas zuzuweisen und über Schritte hinweg wiederzuverwenden:
- Weisen Sie den Aktionscode im ersten Schritt (Nutzeraktualisierung) als angepasstes Attribut zu.
- Verwenden Sie Liquid in späteren Schritten, um auf dieses angepasste Attribut zu verweisen, anstatt einen neuen Code zu generieren.
Wenn ein:e Nutzer:in sich über mehrere Kanäle für einen Code qualifiziert, erhält sie/er in jedem Kanal denselben Code. Wenn sie/er beispielsweise Nachrichten per E-Mail und Push erhält, wird derselbe Code an beide gesendet. Das Reporting spiegelt ebenfalls einen einzelnen Code wider.

Wenn keine Aktionscodes verfügbar sind, werden Test- oder Live-Nachrichten, die auf Codes angewiesen sind, nicht gesendet.
In-App-Nachricht-Kampagnen
Nachdem Sie eine In-App-Nachricht-Kampagne erstellt haben, können Sie ein Aktionscode-Listen-Snippet in den Nachrichtentext Ihrer In-App-Nachricht einfügen. Aktionscodes in In-App-Nachrichten werden erst abgezogen und verwendet, wenn ein:e Nutzer:in die Anzeige der In-App-Nachricht auslöst.
Testnachrichten
Testversendungen und Seed-Gruppen-E-Mail-Versendungen verbrauchen Aktionscodes, sofern nicht anders angefordert. Kontaktieren Sie Ihren Braze Account Manager, um dieses Feature-Verhalten zu aktualisieren, damit Aktionscodes bei Testversendungen und Seed-Gruppen-E-Mail-Versendungen nicht verwendet werden.
Mit Message Extras für Currents
Sie können message_extras mit Aktionscodes kombinieren, um Informationen zu Aktionscodes an Currents zu senden. Verwenden Sie den capture-Tag, um den Aktionscode in einer Variablen zu speichern, und referenzieren Sie diese Variable dann in message_extras:
1
2
3
4
5
{% capture code %}
{% promotion('puttshacktest2') %}
{% endcapture %}
Use {{code}} for an exclusive discount!
{% message_extras :key cardscode :value {{code}} %}
Aktionscodes in Nutzerprofilen speichern
Um denselben Aktionscode in nachfolgenden Nachrichten zu referenzieren, muss der Code als angepasstes Attribut im Nutzerprofil gespeichert werden. Dies kann über einen Nutzeraktualisierungs-Schritt erfolgen, der den Rabattcode einem angepassten Attribut wie „Aktionscode” direkt vor einem Nachrichten-Schritt zuweist.
Wählen Sie zunächst Folgendes für jedes Feld im Nutzeraktualisierungs-Schritt aus:
- Attributname: Aktionscode
- Aktion: Update
- Schlüsselwert: Das Liquid-Code-Snippet des Aktionscodes, z. B.
{% promotion('spring25') %}
Fügen Sie anschließend das angepasste Attribut (in diesem Beispiel {{custom_attribute.${Promo Code}}}) zu einer Nachricht hinzu. Der Rabattcode wird dann als Template eingefügt.
Aktionscode-Nutzung einsehen
Sie finden die verbleibende Code-Anzahl in der Spalte Verbleibend der Aktionscode-Liste auf der Seite Aktionscodes.

Diese Code-Anzahl kann auch beim erneuten Aufrufen einer bestehenden Aktionscode-Listenseite eingesehen werden. Sie können nicht verwendete Codes auch als CSV-Datei exportieren.

Multichannel- und Einzelkanal-Versendungen
Bei Multichannel- und Einzelversand-Kampagnen und Canvases werden alle Aktionscodes, die im Liquid einer Nachricht referenziert werden, vor dem Senden der Nachricht abgezogen, um Folgendes sicherzustellen:
- Dieselben Aktionscodes werden kanalübergreifend in einer Multichannel-Nachricht verwendet.
- Zusätzliche Aktionscodes werden nicht verbraucht, wenn eine Nachricht fehlschlägt oder abgebrochen wird.
Wenn ein:e Nutzer:in zwei Aktionscode-Listen hat, die in einer Nachricht referenziert werden, die durch ein Liquid-Tag mit bedingter Logik aufgeteilt wird, werden alle Aktionscodes trotzdem abgezogen – unabhängig davon, welchem bedingten Pfad die/der Nutzer:in folgt.
Wenn ein:e Nutzer:in einen neuen Canvas-Schritt betritt oder erneut in einen Canvas eintritt und das Aktionscode-Liquid-Snippet erneut für eine Nachricht an diese:n Nutzer:in angewendet wird, wird ein neuer Aktionscode verwendet.
Beispiel
Im folgenden Beispiel werden beide Aktionscode-Listen vip-deal und regular-deal abgezogen. Hier ist das Liquid:
1
2
3
4
5
{% if user.is_vip %}
{% promotion('vip-deal') %}
{% else %}
{% promotion('regular-deal') %}
{% endif %}
Braze empfiehlt, mehr Aktionscodes hochzuladen, als Sie voraussichtlich benötigen. Wenn eine Aktionscode-Liste abläuft oder keine Aktionscodes mehr vorhanden sind, werden die nachfolgenden Nachrichten abgebrochen.

Hier ist eine Analogie dafür, wie Aktionscodes in Braze verbraucht werden.
Stellen Sie sich vor, das Senden Ihrer Nachricht ist wie das Aufgeben eines Briefes bei der Post. Sie geben den Brief einem Postangestellten, und dieser sieht, dass Ihr Brief einen Coupon enthalten soll. Der Angestellte zieht den ersten Coupon vom Stapel und legt ihn in den Umschlag. Der Angestellte sendet den Brief, aber aus irgendeinem Grund geht der Brief auf dem Postweg verloren (und der Coupon ist nun ebenfalls verloren).
In diesem Szenario ist Braze der Postangestellte und Ihr Aktionscode ist der Coupon. Wir können ihn nicht zurückholen, nachdem er vom Stapel der Aktionscodes gezogen wurde – unabhängig vom Webhook-Ergebnis.