Skip to content

Message-Extras-Liquid-Tag

Verwenden Sie den message_extras-Liquid-Tag, um Ihre Sendeereignisse mit dynamischen Daten aus Connected-Content, Katalogen, angepassten Attributen (wie Sprache, Land), Canvas-Entry-Eigenschaften oder anderen Datenquellen zu annotieren.

Der message_extras-Liquid-Tag fügt dem entsprechenden Sendeereignis in Currents und der Snowflake-Datenfreigabe Schlüssel-Wert-Paare hinzu.

Um dynamische oder zusätzliche Daten an Ihr Currents- oder Snowflake-Datenfreigabe-Sendeereignis zurückzusenden, fügen Sie den entsprechenden Liquid-Tag in Ihren Nachrichtentext ein.

Hier ist ein Beispiel für das Standard-Liquid-Tag-Format für message_extras:

1

{% message_extras :key test :value 123 %}

Sie können diese Tags nach Bedarf für Ihre Schlüssel-Wert-Paare im Nachrichtentext hinzufügen. Die Gesamtlänge aller Schlüssel und Werte sollte jedoch 1.000 Bytes (1 KB) nicht überschreiten. In Currents und der Snowflake-Datenfreigabe sehen Sie ein neues Ereignisfeld namens message_extras für Ihre Sendeereignisse. Dieses generiert einen JSON-serialisierten String in einem Feld.

Wie Nachrichtenextras-Daten mit Currents gesendet werden

Nachrichtenextras sind Schlüssel-Wert-Paare, die zum Sendezeitpunkt angehängt werden. Die Konfiguration hängt vom Kanal ab. Bei E-Mails werden sie über Header hinzugefügt. Bei iOS-Push werden sie in die Push-Payload aufgenommen. Alle unterstützten Sendeereignisse stellen dasselbe message_extras-Feld in Currents (und Snowflake) bereit, sobald die Nachricht gesendet wurde.

Unterstützte Kanäle

Der message_extras-Tag wird für alle Nachrichtentypen mit einem Sendeereignis sowie für In-App-Nachricht-Impression-Ereignisse unterstützt. Die Verwendung von message_extras mit In-App Messages erfordert bestimmte SDK-Mindestversionen.

So verwenden Sie den message_extras-Tag

  1. Geben Sie im Nachrichtentext für den Kanal den message_extras-Liquid-Tag ein. Alternativ können Sie das Modal Add Personalization verwenden und Message Extras als Personalisierungstyp auswählen.

Das Modal „Add Personalization“ mit „Message Extras“ als ausgewähltem Personalisierungstyp.

  1. Geben Sie das Schlüssel-Wert-Paar für jeden message_extras-Tag ein.

Ein Beispiel für Schlüssel-Wert-Paare für den Message-Extras-Tag. Das Titelfeld lautet „Your New Favorites“. Die Nachricht enthält Schlüssel-Wert-Paare für den Message-Extras-Tag und den folgenden Satz: „We're excited to bring you a side selection of fresh and exciting products that are sure to become your new go-to favorites“

  1. Nachdem Ihre Campaign oder Ihr Canvas gesendet wurde, hängt Braze die dynamischen Daten zum Sendezeitpunkt an das Feld message_extras in Currents- oder Snowflake-Data-Sharing-Sendeereignissen an.

Syntax überprüfen

Alle anderen Eingaben, die nicht dem zuvor in diesem Abschnitt beschriebenen Tag-Standard entsprechen, werden möglicherweise nicht an Currents oder Snowflake übergeben. Stellen Sie sicher, dass Ihre Syntax oder Formatierung keines der folgenden Probleme enthält:

  • Nicht vorhandene, leere oder falsch eingegebene Trennzeichen
  • Doppelte Schlüssel (Braze sendet standardmäßig das zuerst gefundene Schlüssel-Wert-Paar)
  • Zusätzlicher Text, bevor Schlüssel oder Werte definiert werden
  • Schlüssel und Werte in falscher Reihenfolge
    • Zum Beispiel: {% message_extras :value 123 :key test %}

Senden von Aktionscode-Informationen an 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}} %}

Hinweise

  • Schlüssel-Wert-Paare, die 1.000 Bytes (1 KB) überschreiten, werden abgeschnitten.
  • Leerzeichen zählen zur Zeichenanzahl. Beachten Sie, dass Braze führende und abschließende Leerzeichen entfernt.
  • Die resultierenden JSON-Ausgaben enthalten ausschließlich String-Werte.
  • Sie können Liquid-Variablen als Schlüssel oder Wert verwenden, jedoch keine zusätzlichen Liquid-Tags innerhalb von message_extras verschachteln.
    • Beispielsweise können Sie folgendes Liquid verwenden: {% assign value = '123' %} {% assign key = 'test' %} {% message_extras :key {{key}} :value {{value}} %}

Häufig gestellte Fragen

Wie kann ich das Feld message_extras in den Sendeereignissen mit meinen Engagement-Ereignissen wie Öffnungen und Klicks verknüpfen?

Eine dispatch_id wird generiert und in Ihren Sendeereignissen bereitgestellt. Sie können diese als eindeutigen Bezeichner verwenden, um sie bestimmten Klick-, Öffnungs- oder Zustellungsereignissen zuzuordnen. Fragen Sie dieses Feld in Currents oder Snowflake ab. Weitere Informationen finden Sie unter Dispatch-ID-Verhalten.

Kann ich message_extras mit In-App-Nachrichten verwenden?

Ja, Sie können message_extras in Ihren In-App-Nachrichten verwenden, sofern die Geräte Ihrer Nutzer:innen die folgenden Mindest-SDK-Versionen aufweisen:
New Stuff!