Nutzeraktualisierung

Mit der Komponente Nutzeraktualisierung können Sie Attribute, Events und Käufe von Nutzer:innen in einem JSON-Editor aktualisieren, sodass keine sensiblen Informationen wie API-Schlüssel angegeben werden müssen.

Funktionsweise dieser Komponente

Wenn Sie diese Komponente in Ihrem Canvas verwenden, werden die Updates nicht auf Ihr Rate-Limit für /users/track-Anfragen pro Minute angerechnet. Stattdessen werden diese Updates gebündelt, damit Braze sie effizienter verarbeiten kann als bei einem Braze-zu-Braze-Webhook. Beachten Sie, dass diese Komponente keine Datenpunkte protokolliert, wenn sie zum Aktualisieren nicht abrechnungsrelevanter Datenpunkte verwendet wird (z. B. Abo-Gruppen).

Nachdem Nutzer:innen den Nutzer:innen-Update-Schritt durchlaufen haben und die Verarbeitung abgeschlossen ist, werden sie zum nächsten Schritt weitergeleitet. Das bedeutet, dass alle nachfolgenden Nachrichten, die auf diesen Nutzer:innen-Updates basieren, beim Ausführen des nächsten Schritts auf dem neuesten Stand sind.

Ein Nutzer:innen-Update erstellen

Ziehen Sie die Komponente per Drag-and-drop aus der Seitenleiste oder wählen Sie den Plus-Button am unteren Rand der Variante oder des Schritts und wählen Sie User Update aus.

Es gibt drei Optionen, mit denen Sie bestehende Nutzerprofilinformationen aktualisieren, neue Informationen hinzufügen oder Nutzerprofilinformationen entfernen können. Insgesamt können die User-Update-Schritte in einem Workspace bis zu 200.000 Nutzerprofile pro Minute aktualisieren.

Tipp

Sie können die mit dieser Komponente vorgenommenen Änderungen auch testen, indem Sie nach einer/einem Nutzer:in suchen und die Änderung auf sie/ihn anwenden. Dadurch wird das Nutzerprofil aktualisiert.

Angepasste Attribute aktualisieren

Um ein angepasstes Attribut zu aktualisieren oder zu entfernen, wählen Sie einen Attributnamen aus Ihrer Liste der Attribute aus und geben Sie den Wert ein.

Angepasste Attribute entfernen

Um ein angepasstes Attribut zu entfernen, wählen Sie einen Attributnamen über das Dropdown-Menü aus. Sie können zum erweiterten JSON-Editor wechseln, um weitere Bearbeitungen vorzunehmen.

Werte erhöhen und verringern

Der Nutzer:innen-Update-Schritt kann einen Attributwert erhöhen oder verringern. Wählen Sie das Attribut aus, wählen Sie Increment By oder Decrement By und geben Sie eine Zahl ein.

Wöchentlichen Fortschritt verfolgen

Durch das Inkrementieren eines angepassten Attributs, das ein Event verfolgt, können Sie die Anzahl der Kurse nachverfolgen, die eine Nutzer:in in einer Woche besucht hat. Mit dieser Komponente kann der Kurszähler zu Wochenbeginn zurückgesetzt werden und das Tracking beginnt von vorne.

Ein Array von Objekten aktualisieren

Ein Array von Objekten ist ein datenreiches angepasstes Attribut, das im Profil einer Nutzer:in gespeichert wird. Sie können es verwenden, um einen Verlauf der Interaktionen der Nutzer:in mit Ihrer Marke zu erstellen und Segmente auf Basis eines berechneten Felds zu bilden, z. B. Kaufhistorie oder gesamter Lifetime-Value.

Mit der Option Advanced JSON Editor können Sie JSON einfügen, um Elemente zu diesem Array von Objekten hinzuzufügen oder daraus zu entfernen.

Anwendungsfall: Wunschliste einer Nutzer:in aktualisieren

Verfolgen Sie die Wunschliste einer Nutzer:in, damit Sie auf Basis der gespeicherten Artikel segmentieren oder personalisieren können.

1. Erstellen Sie ein angepasstes Attribut, das ein Array von Objekten ist, zum Beispiel wishlist. Jedes Objekt kann Felder wie product_id, product_name und added_at enthalten.
2. Wählen Sie im Nutzer:innen-Update-Schritt Advanced JSON Editor aus. Verwenden Sie dann im Abschnitt Compose die Operation $add, um ein Element hinzuzufügen, oder die Operation $remove, um ein Element nach Wert zu entfernen.

Das folgende Beispiel zeigt das Hinzufügen eines Elements zur Wunschliste:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
  "attributes": [
    {
      "wishlist": {
        "$add": [
          {
            "product_id": "SKU-123",
            "product_name": "Wireless Headphones",
            "added_at": "{{'now' | date: '%Y-%m-%dT%H:%M:%S%z'}}"
          }
        ]
      }
    }
  ]
}

Um ein Element zu entfernen, verwenden Sie "wishlist": { "$remove": [ { "product_id": "SKU-123", ... } ] } mit der gleichen Objektstruktur, damit Braze den Eintrag zuordnen und entfernen kann.

Anwendungsfall: Warenkorb-Gesamtwert berechnen

Verfolgen Sie, wann Nutzer:innen Artikel im Warenkorb haben, wann sie neue Artikel hinzufügen oder entfernen und wie hoch der Gesamtwert des Warenkorbs ist.

1. Erstellen Sie ein angepasstes Array von Objekten mit dem Namen shopping_cart. Das folgende Beispiel zeigt, wie dieses Attribut aussehen kann. Jeder Artikel hat eine eindeutige product_id, die zusätzliche Daten in einem eigenen verschachtelten Array von Objekten enthält, darunter price.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

{
  "attributes": [
    {
      "shopping_cart": [
       {
         "total_cart_value": number,
         "shipping": number,
         "items_in_cart": number,
         "product_id": array,
         "gift": boolean,
         "discount_code": "enum",
         "timestamp": {"$time" : "{{'now' | date: '%Y-%m-%dT%H:%M:%S%z'}}"}
       }
      ]
    }
  ]
}

2. Erstellen Sie ein angepasstes Event mit dem Namen add_item_to_cart, das protokolliert wird, wenn eine Nutzer:in einen Artikel in den Warenkorb legt.
3. Erstellen Sie ein Canvas, das auf Nutzer:innen abzielt, die dieses angepasste Event ausführen. Wenn eine Nutzer:in jetzt einen Artikel in den Warenkorb legt, wird dieses Canvas ausgelöst. Sie können dann Nachrichten direkt an diese Nutzer:in richten und zum Beispiel Gutscheincodes anbieten, wenn ein bestimmter Betrag erreicht wurde, der Warenkorb für eine bestimmte Zeit verlassen wurde oder andere Szenarien, die zu Ihrem Anwendungsfall passen.

Das Attribut shopping_cart fasst die Summe vieler angepasster Events zusammen: die Gesamtkosten aller Artikel, die Gesamtanzahl der Artikel im Warenkorb, ob der Warenkorb ein Geschenk enthält, und so weiter. Das kann in etwa wie folgt aussehen:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

{
  "attributes": [
    {
      "shopping_cart": [
       {
         "total_cart_value": 22.99,
         "shipping": 4.99,
         "items_in_cart": 2,
         "product_id": ["1001", "1002"],
         "gift": true,
         "discount_code": "flashsale1000",
         "timestamp": {"$time" : "{{'now' | date: '%Y-%m-%dT%H:%M:%S%z'}}"}
       }
      ]
    }
  ]
}

Canvas-Entry-Eigenschaft als Attribut festlegen

Sie können den Schritt „Nutzer:innen-Update“ verwenden, um eine canvas_entry_property dauerhaft zu speichern. Angenommen, Sie haben ein Event, das ausgelöst wird, wenn ein Artikel in den Warenkorb gelegt wird. Sie können die ID des zuletzt hinzugefügten Artikels speichern und diese für eine Remarketing-Campaign verwenden. Nutzen Sie das Personalisierungs-Feature, um eine Canvas-Entry-Eigenschaft abzurufen und in einem Attribut zu speichern.

Personalisierung

Um die Eigenschaft des Trigger-Events für ein Canvas als Attribut zu speichern, verwenden Sie das Personalisierungs-Modal, um die Canvas-Entry-Eigenschaft zu extrahieren und zu speichern. Das Nutzer:innen-Update unterstützt außerdem die folgenden Personalisierungs-Features:

• Connected Content
• Content Blocks
• Entry-Eigenschaften
• Liquid-Logik (einschließlich Abbruch von Nachrichten)
• Mehrere Attribut- oder Event-Updates pro Objekt

Warnung

Wir empfehlen, Connected-Content-Liquid-Personalisierung in Schritten vom Typ „Nutzer:innen-Update“ mit Bedacht einzusetzen, da dieser Schritttyp ein Rate-Limit von 200.000 Anfragen pro Minute hat. Dieses Rate-Limit überschreibt das Canvas-Rate-Limit.

Erweiterter JSON-Editor

Fügen Sie dem JSON-Editor ein Attribut-, Event- oder Kauf-JSON-Objekt mit bis zu 65.536 Zeichen hinzu. Der globale Abo-Status und der Status der Abo-Gruppe eines Nutzers bzw. einer Nutzerin können ebenfalls festgelegt werden.

Mit dem JSON-Editor können Sie auch in der Vorschau testen, ob das Nutzerprofil mit Ihren Änderungen aktualisiert wird – im Tab Preview and test. Sie können entweder zufällige Nutzer:innen auswählen oder nach bestimmten Nutzer:innen suchen. Nachdem Sie einen Test an Nutzer:innen gesendet haben, können Sie das Nutzerprofil über den generierten Link aufrufen.

Hinweise

Sie müssen bei der Verwendung des JSON-Editors keine sensiblen Daten wie Ihren API-Schlüssel angeben, da diese automatisch von der Plattform bereitgestellt werden. Die folgenden Felder sollten nicht im JSON-Editor enthalten sein:

• Externe Nutzer-ID
• API-Schlüssel
• Braze-Cluster-URL
• Felder im Zusammenhang mit Push-Token-Importen

Wichtig

Canvas-Eigenschaften (wie die Liquid-Tags canvas_id, canvas_name und canvas_variant_name) werden in Nutzer-Update-Schritten nicht unterstützt.

Angepasste Events protokollieren

Mit dem JSON-Editor können Sie auch angepasste Events protokollieren. Beachten Sie, dass hierfür ein Zeitstempel im ISO-Format erforderlich ist. Daher muss zunächst ein Datum und eine Uhrzeit mit Liquid zugewiesen werden. Betrachten Sie dieses Beispiel, das ein Event mit einem Zeitstempel protokolliert.

1
2
3
4
5
6
7
8
9

{% assign timestamp = 'now' | date: "%Y-%m-%dT%H:%M:%SZ" %}
{
  "events": [
    {
      "name": "logged_user_event",
      "time": "{{timestamp}}"
    }
  ]
}

Das nächste Beispiel verknüpft ein Event mit einer bestimmten App, indem ein angepasstes Event mit optionalen Eigenschaften und der app_id verwendet wird.

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

{% assign timestamp = 'now' | date: "%Y-%m-%dT%H:%M:%SZ" %}
{
  "events": [
    {
      "app_id": "insert_app_id",
      "name": "rented_movie",
      "time": "{{timestamp}}",
      "properties": {
        "release": {
          "studio": "FilmStudio",
          "year": "2022"
        },
        "cast": [
          {
            "name": "Actor1"
          },
          {
            "name": "Actor2"
          }
        ]
      }
    }
  ]
}

Abo-Status bearbeiten

Im JSON-Editor können Sie auch den Abo-Status von Nutzer:innen bearbeiten. Das folgende Beispiel zeigt, wie der Abo-Status auf opted_in aktualisiert wird.

1
2
3
4
5
6
7

{
  "attributes": [
    {
      "email_subscribe": "opted_in"
    }
  ]
}

Abo-Gruppen aktualisieren

Sie können mit diesem Canvas-Schritt auch Abo-Gruppen aktualisieren. Das folgende Beispiel zeigt, wie Sie eine oder mehrere Abo-Gruppen aktualisieren.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

{
  "attributes": [
    {
      "subscription_groups": [
        {
          "subscription_group_id": "subscription_group_identifier_1",
          "subscription_state": "subscribed"
        },
        {
          "subscription_group_id": "subscription_group_identifier_2",
          "subscription_state": "subscribed"
        },
        {
          "subscription_group_id": "subscription_group_identifier_3",
          "subscription_state": "subscribed"
        }
      ]
    }
  ]
}