„Wieder verfügbar“-Benachrichtigungen

Erfahren Sie, wie Sie mit Hilfe Ihres Katalogs und angepasster Events „Wieder verfügbar“-Benachrichtigungen einrichten, damit Kund:innen automatisch benachrichtigt werden, wenn ein Artikel wieder vorrätig ist. Beachten Sie, dass dies nur für Nutzer:innen gilt, die sich bereits für Benachrichtigungen entschieden haben.

Funktionsweise

Sie können ein angepasstes Event als Abo-Event einrichten, z. B. ein product_clicked-Event. Dieses Event muss eine Eigenschaft mit der Artikel-ID (Katalog-Artikel-IDs) enthalten. Wir empfehlen, einen Katalognamen anzugeben, aber dies ist nicht erforderlich. Außerdem geben Sie den Namen eines Feldes für die Bestandsmenge an, das den Datentyp Nummer haben muss.

Beachten Sie, dass der Bestand eines Katalogartikels bei null liegen muss, damit sich Nutzer:innen erfolgreich dafür anmelden können. Wenn ein Artikel eine Bestandsmenge größer als null hat, sucht Braze alle Nutzer:innen, die diesen Artikel abonniert haben, und sendet ein angepasstes Event, das Sie zum Triggern einer Campaign oder eines Canvas verwenden können.

Die Event-Eigenschaften werden zusammen mit Ihren Nutzer:innen gesendet, sodass Sie die Artikeldetails per Template in die Campaign oder das Canvas einfügen können, das den Versand auslöst.

Wieder-auf-Lager-Benachrichtigungen einrichten

Befolgen Sie diese Schritte, um Wieder-auf-Lager-Benachrichtigungen in einem bestimmten Katalog einzurichten.

1. Gehen Sie zu Ihrem Katalog und wählen Sie den Tab Einstellungen aus.
2. Aktivieren Sie den Wieder auf Lager-Umschalter.
3. Wenn die globalen Wieder-auf-Lager-Einstellungen noch nicht konfiguriert wurden, werden Sie aufgefordert, die angepassten Events und Eigenschaften einzurichten, die zum Triggern von Wieder-auf-Lager-Benachrichtigungen verwendet werden:
   
   • Fallback-Katalog Dies ist der Katalog, der für das Wieder-auf-Lager-Abo verwendet wird, wenn keine catalog_name-Eigenschaft im angepassten Event vorhanden ist.
   • Angepasstes Event für Abos ist das angepasste Braze-Event, das verwendet wird, um eine Nutzerin oder einen Nutzer für Wieder-auf-Lager-Benachrichtigungen anzumelden. Wenn dieses Event auftritt, wird die Person, die das Event ausgeführt hat, angemeldet.
   • Angepasstes Event zum Abmelden ist das angepasste Braze-Event, das verwendet wird, um eine Nutzerin oder einen Nutzer von Wieder-auf-Lager-Benachrichtigungen abzumelden. Dieses Event ist optional. Wenn die Person dieses Event nicht ausführt, wird sie nach 90 Tagen oder wenn das Wieder-auf-Lager-Event ausgelöst wird, automatisch abgemeldet – je nachdem, was zuerst eintritt.

   • Artikel-ID-Event-Eigenschaft ist die Eigenschaft des weiter oben in diesem Abschnitt beschriebenen angepassten Events, die verwendet wird, um den Artikel für ein Wieder-auf-Lager-Abo oder eine Abmeldung zu bestimmen. Diese Eigenschaft des angepassten Events sollte eine Artikel-ID (id) enthalten, die in einem Katalog vorhanden ist. Die Artikel-ID muss als String gesendet werden, damit sie dem im Zielkatalog gespeicherten id-Datentyp entspricht. Das angepasste Event sollte außerdem eine catalog_name-Eigenschaft enthalten, um anzugeben, in welchem Katalog sich dieser Artikel befindet.

   • Ein Beispiel für ein angepasstes Event sieht wie folgt aus:

• rest api
• web sdk
• android sdk
• ios sdk

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

{
    "events": [
        {
            "external_id": "<external_id>",
            "name": "subscription",
            "time": "2024-04-15T19:22:28Z",
            "properties": {
                "id": "shirt-xl",
                "catalog_name": "on_sale_products",
                "type": ["back_in_stock"]
            }
        }
    ]
}

1
2
3
4
5

braze.logCustomEvent("subscription", {
  id: "shirt-xl",
  catalog_name: "on_sale_products",
  type: ["back_in_stock"]
});

1
2
3
4
5
6
7
8
9
10

// Kotlin
Braze.getInstance(context).logCustomEvent(
  "subscription",
  BrazeProperties(
    JSONObject()
      .put("id", "shirt-xl")
      .put("catalog_name", "on_sale_products")
      .put("type", JSONArray().put("back_in_stock"))
  )
)

1
2
3
4
5
6
7
8
9

// Java
Braze.getInstance(context).logCustomEvent(
  "subscription",
  new BrazeProperties(new JSONObject()
    .put("id", "shirt-xl")
    .put("catalog_name", "on_sale_products")
    .put("type", new JSONArray().put("back_in_stock"))
  )
);

1
2
3
4
5
6
7
8
9

// Swift
AppDelegate.braze?.logCustomEvent(
  name: "subscription",
  properties: [
    "id": "shirt-xl",
    "catalog_name": "on_sale_products",
    "type": ["back_in_stock"]
  ]
)

1
2
3
4
5
6
7

// Objective-C
[AppDelegate.braze logCustomEvent:@"subscription"
                       properties:@{
  @"id": @"shirt-xl",
  @"catalog_name": @"on_sale_products",
  @"type": @[@"back_in_stock"]
}];

Hinweis

Wieder-auf-Lager- und Preissenkung-Trigger verwenden dasselbe Event, um Nutzer:innen für die Benachrichtigung anzumelden. Sie können daher die type-Eigenschaft verwenden, um sowohl Preissenkung- als auch Wieder-auf-Lager-Benachrichtigungen im selben Event festzulegen. Beachten Sie, dass die type-Eigenschaft ein Array sein muss.

4. Wählen Sie Speichern und fahren Sie mit der Einstellungen-Seite des Katalogs fort.
5. Legen Sie Ihre Benachrichtigungsregel fest. Es gibt zwei Optionen:
   • Alle angemeldeten Nutzer:innen benachrichtigen benachrichtigt alle Kund:innen, die warten, sobald der Artikel wieder auf Lager ist.
   • Benachrichtigungslimits festlegen benachrichtigt eine festgelegte Anzahl von Kund:innen alle 10 Minuten. Braze benachrichtigt die angegebene Anzahl von Kund:innen in Schritten, bis keine weiteren Kund:innen mehr zu benachrichtigen sind oder der Artikel nicht mehr vorrätig ist. Ihre Benachrichtigungsrate darf 10.000 Nutzer:innen pro Minute nicht überschreiten.
6. Legen Sie das Bestandsfeld im Katalog fest. Dieses Katalogfeld wird verwendet, um zu bestimmen, ob der Artikel nicht vorrätig ist. Das Feld muss vom Typ „Zahl“ sein.
7. Wählen Sie Einstellungen speichern.

Wichtig

Benachrichtigungsregeln in diesen Einstellungen ersetzen nicht die Canvas-Benachrichtigungseinstellungen, wie z. B. Ruhezeiten.

Verwendung von Wieder-auf-Lager-Benachrichtigungen in einem Canvas

Nachdem Sie das Wieder-auf-Lager-Feature in einem Katalog eingerichtet haben, führen Sie die folgenden Schritte aus, um es mit Canvas zu verwenden.

1. Richten Sie einen aktionsbasierten Canvas ein.
2. Wählen Sie Wieder auf Lager als Trigger aus.
3. Wählen Sie den Namen des Katalogs mit den Wieder-auf-Lager-Benachrichtigungen aus.
4. Fahren Sie mit der Einrichtung Ihres Canvas wie gewohnt fort.

Jetzt können Ihre Kund:innen benachrichtigt werden, wenn ein Artikel wieder auf Lager ist.

Verwendung von Liquid

Um Details über den wieder auf Lager befindlichen Katalogartikel in ein Template einzufügen, können Sie den context-Liquid-Tag verwenden, um auf die item_id zuzugreifen.

Mit {{context.${catalog_update}.item_id}} wird die ID des Artikels zurückgegeben, der wieder auf Lager ist. {{context.${catalog_update}.previous_value}} gibt den Bestandswert des Artikels vor dem Update zurück, und {{context.${catalog_update}.new_value}} gibt den neuen Bestandswert nach dem Update zurück.

Verwenden Sie den Liquid-Tag {% catalog_items <name_of_your_catalog> {{context.${catalog_update}.item_id}} %} am Anfang Ihrer Nachricht und dann {{ items[0].<field_name> }}, um in der gesamten Nachricht auf Daten zu diesem Artikel zuzugreifen.

Wichtig

Canvas-Entry-Eigenschaften sind Teil der Canvas-Kontextvariablen. Das bedeutet, dass canvas_entry_properties als context referenziert wird. Jede context-Variable enthält einen Namen, einen Datentyp und einen Wert, der Liquid enthalten kann. Derzeit sind canvas_entry_properties abwärtskompatibel. Weitere Informationen finden Sie unter Kontext und Canvas-Kontextobjekt.

Tipp

Um Bilder für Katalog-Trigger-Artikel abzurufen, muss Ihr Katalog ein Feld mit dem Namen image_url enthalten. Sie können es dann mit {{ items[0].image_url }} referenzieren.

Hinweise

• Nutzer:innen sind nur 90 Tage lang abonniert. Wenn der Artikel nicht innerhalb von 90 Tagen wieder auf Lager ist, wird die Nutzerin bzw. der Nutzer abgemeldet.
• Bei Verwendung der Benachrichtigungsregel Notify all subscribed users benachrichtigt Braze 100.000 Nutzer:innen innerhalb von 10 Minuten.
• Braze unterstützt täglich bis zu 50.000 aktualisierte Artikel, die für das Auslösen von Wieder-auf-Lager-Benachrichtigungen infrage kommen. Sie können zu jedem Zeitpunkt bis zu 100 Millionen aktive Abos haben, wobei jedes Abo ein Nutzerprofil darstellt, das einen Katalogartikel beobachtet.
• Wenn Sie abonnierte Nutzer:innen aus Ihren Katalogeinstellungen exportieren, enthält die CSV-Datei bis zu 10.000 Abos, auch wenn der Katalog mehr aktive Abos hat.