Verschachtelte Objekte in angepassten Events

Auf dieser Seite erfahren Sie, wie Sie verschachtelte JSON-Daten als Eigenschaften von angepassten Events und Käufen senden und wie Sie diese verschachtelten Objekte in Ihrem Messaging verwenden können.

Sie können verschachtelte Objekte – also Objekte innerhalb eines anderen Objekts – verwenden, um verschachtelte JSON-Daten als Eigenschaften von angepassten Events und Käufen zu senden. Diese verschachtelten Daten können für die Personalisierung von Nachrichten per Template, das Triggern von Nachrichtenversand und die Segmentierung von Nutzer:innen verwendet werden.

Hinweise

• Verschachtelte Daten werden sowohl für angepasste Events als auch für Kauf-Events unterstützt, jedoch nicht für andere Event-Typen.
• Event-Eigenschafts-Objekte, die Array- oder Objektwerte enthalten, können eine Event-Eigenschafts-Payload von bis zu 100 KB haben.
• Event-Eigenschafts-Schemas können nicht für Kauf-Events generiert werden.
• Event-Eigenschafts-Schemas werden durch Sampling angepasster Events der letzten 24 Stunden generiert.

Mindest-SDK-Versionen

Die folgenden SDK-Versionen unterstützen verschachtelte Objekte:

1. Schritt: Schema generieren

Sie können auf die verschachtelten Daten in Ihrem angepassten Event zugreifen, indem Sie für jedes Event mit verschachtelten Event-Eigenschaften ein Schema generieren. So generieren Sie ein Schema:

1. Gehen Sie zu Dateneinstellungen > Angepasste Events.
2. Wählen Sie Eigenschaften verwalten für die Events mit verschachtelten Eigenschaften.
3. Wählen Sie den Button, um das Schema zu generieren. Um das Schema anzuzeigen, wählen Sie den Plus-Button.

Wenn in Zukunft neue Eigenschaften gesendet werden, sind diese erst nach einer erneuten Generierung im Schema enthalten. Schemas können alle 24 Stunden neu generiert werden.

2. Schritt: Das verschachtelte Objekt verwenden

Sie können die verschachtelten Daten bei der Segmentierung und Personalisierung referenzieren. Beachten Sie, dass kein Schema erforderlich ist. In den folgenden Abschnitten finden Sie Anwendungsbeispiele:

• API-Anfragekörper
• Liquid-Templating
• Nachrichten-Triggering
• Segmentierung
• Personalisierung

API-Anfragekörper

• music example
• restaurant example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
...
"properties": {
  "songs": [
    {
      "title": "Smells Like Teen Spirit",
      "artist": "Nirvana",
      "album": {
        "name": "Nevermind",
        "yearReleased": "1991"
      }
    },
    {
      "title": "While My Guitar Gently Weeps",
      "artist": "the Beatles",
      "album": {
        "name": "The Beatles",
        "yearReleased": "1968"
      }
    }
  ]
}
...

1
2
3
4
5
6
7
8
9
10
11
12
...
"properties": {
  "r_details": {
    "name": "SandwichEmperor",
    "identifier": "12345678",
    "location" : {
      "city": "Montclair",
      "state": "NJ"
    }
  }
}
...

Hinweis

Bei verschachtelten angepassten Event-Eigenschaften speichert Braze keine Werte, wenn das Jahr kleiner als 0 oder größer als 3000 ist.

Liquid-Templating

Das Folgende zeigt, wie Sie ein Liquid-Template erstellen, das die verschachtelten Eigenschaften aus der vorherigen API-Anfrage referenziert.

• music example
• restaurant example

Nachrichten-Triggering

Um diese Eigenschaften zum Triggern einer Campaign zu verwenden, wählen Sie Ihr angepasstes Event oder Ihren Kauf aus und fügen Sie dann einen Filter für verschachtelte Eigenschaften hinzu. Beachten Sie, dass das Nachrichten-Triggering für In-App-Nachrichten noch nicht unterstützt wird, aber verschachtelte Eigenschaften in der Liquid-Personalisierung in den Nachrichten werden trotzdem angezeigt.

• music example
• restaurant example

Triggern einer Campaign mit verschachtelten Eigenschaften aus dem Event „Created Playlist“:

Die Trigger-Bedingung songs[].album.yearReleased „ist“ „1968“ trifft auf ein Event zu, bei dem einer der Songs ein Album hat, das 1968 veröffentlicht wurde. Wir verwenden die Klammer-Notation [] zum Durchlaufen von Arrays und matchen, wenn ein beliebiges Element im durchlaufenen Array mit der Event-Eigenschaft übereinstimmt.

Wichtig

Der Filter ist nicht gleich matcht nur, wenn keine der Eigenschaften in Ihrem Array dem angegebenen Wert entspricht.

Nehmen wir zum Beispiel an, Canvas A hat den aktionsbasierten Filter für verschachtelte angepasste Event-Eigenschaften ist gleich „smartwatch“, und Canvas B hat den aktionsbasierten Filter für verschachtelte angepasste Event-Eigenschaften ist nicht gleich „simphone“. Wenn Sie „smartwatch“ und „simphone“ in Ihren Eigenschaften haben, werden beide Canvases getriggert. Wenn Sie jedoch „simphone“ oder „sim only“ in einer beliebigen Eigenschaft haben, wird keines der beiden Canvases getriggert.

Triggern einer Campaign mit verschachtelten Eigenschaften aus dem Event „Ordered“:

r_details.name: “SandwichEmperor”
r_details.location.city: “Montclair”

Hinweis

Wenn Ihre Event-Eigenschaft die Zeichen [] oder . enthält, escapen Sie diese, indem Sie den entsprechenden Teil in doppelte Anführungszeichen setzen. Zum Beispiel wird "songs[].album".yearReleased ein Event mit der literalen Eigenschaft "songs[].album" matchen.

Segmentierung

Um Nutzer:innen basierend auf verschachtelten Event-Eigenschaften zu segmentieren, müssen Sie Segmenterweiterungen verwenden. Nachdem Sie ein Schema generiert haben, wird der Explorer für verschachtelte Objekte im Segmentierungsbereich angezeigt.

Die Segmentierung verwendet die gleiche Notation wie das Triggering (siehe Nachrichten-Triggering).

Um Segmenterweiterungen zu bearbeiten oder zu erstellen, benötigen Sie die Berechtigung „Segments bearbeiten“.

Personalisierung

Wählen Sie im Modal Personalisierung hinzufügen die Option Erweiterte Event-Eigenschaften als Personalisierungstyp aus. Dies ermöglicht es, verschachtelte Event-Eigenschaften hinzuzufügen, nachdem ein Schema generiert wurde.

Verschachtelte Objekte in Nachrichten testen

Das Dashboard-Tool Vorschau & Test unterstützt nicht das Hinzufügen von Mock-Daten für verschachtelte Objekte oder verschachtelte angepasste Attribute. Um Nachrichten zu testen, die über Liquid auf verschachtelte Daten verweisen, können Sie Nachrichten mit verschachtelten Attributen als bestehende:r Nutzer:in mit diesem verschachtelten Attribut in der Vorschau anzeigen oder Nachrichten mit angepassten Event-Eigenschaften testen, indem Sie eine Live-Campaign an Testnutzer:innen starten.

Verschachtelte angepasste Attribute

1. Importieren Sie die verschachtelten Attribute über die API in das Testnutzer:innen-Profil.
2. Gehen Sie in Ihrer Campaign oder Ihrem Canvas zu Vorschau & Test.
3. Wählen Sie Vorschau als Nutzer:in und suchen Sie nach der/dem Testnutzer:in. Das Liquid wird mit den tatsächlichen verschachtelten Attributen im Profil dieser/dieses Nutzer:in aufgelöst.

Verschachtelte Event-Eigenschaften

Verschachtelte Event-Eigenschaften können im Dashboard nicht in der Vorschau angezeigt werden, da sie einen Live-Event-Trigger erfordern. So testen Sie:

1. Erstellen Sie eine Campaign oder einen Canvas-Schritt, der nur Ihre Testnutzer:innen anspricht und durch das angepasste Event mit verschachtelten Eigenschaften getriggert wird (oder darauf verweist).
2. Starten Sie die Campaign für Ihre Testzielgruppe.
3. Loggen Sie das angepasste Event mit der verschachtelten Objekt-Payload im Profil Ihrer/Ihres Testnutzer:in (über die API oder das SDK).
4. Überprüfen Sie, ob die Nachricht mit den verschachtelten Eigenschaftswerten korrekt gerendert wird.

Häufig gestellte Fragen

Werden durch die Verwendung verschachtelter Objekte zusätzliche Datenpunkte protokolliert?

Es gibt keine Änderung bei der Protokollierung von Datenpunkten durch das Hinzufügen dieser Funktion. Die Segmentierung basierend auf verschachtelten Objekten verwendet Segmenterweiterungen, die keine zusätzlichen Datenpunkte verbrauchen.

Wie viele verschachtelte Daten können gesendet werden?

Wenn eine oder mehrere Eigenschaften des Events verschachtelte Daten enthalten, beträgt die maximale Payload für alle kombinierten Eigenschaften eines Events 100 KB. Jede Anfrage, die dieses Größenlimit überschreitet, wird abgelehnt.