Nutzer:innen Produkte empfehlen

Nutzen Sie die Braze REST API zusammen mit Katalogen oder Connected-Content, um personalisierte Produktempfehlungen in Ihren Nachrichten anzuzeigen. Mit diesem Ansatz können Sie Ihr eigenes Empfehlungssystem in das Braze-Messaging-Ökosystem einbinden, sodass nicht-technische Nutzer:innen den Inhalt und die Nachrichten rund um jede Empfehlung eigenständig verwalten können.

Mit diesem Ansatz können Sie:

• Produktempfehlungen aus Ihrem Backend über die REST API in Nutzerprofilen speichern.
• Produkt-Metadaten zum Sendezeitpunkt über Kataloge oder Connected-Content abrufen.
• Personalisierte Empfehlungen über jeden Messaging-Kanal anzeigen, einschließlich E-Mail, Push, In-App-Nachrichten und mehr.

Voraussetzungen

Um diese Anleitung abzuschließen, benötigen Sie:

Schritt 1: Empfehlungen in Nutzerprofilen speichern

Speichern Sie zunächst die von Ihrem Empfehlungssystem generierten Produktempfehlungen als angepasste Attribute in Braze-Nutzerprofilen. So können Sie bei der Nachrichtenzustellung auf die empfohlenen Produkte der einzelnen Nutzer:innen zugreifen.

1. Legen Sie fest, welche Empfehlungsdaten gespeichert werden sollen, z. B. Produkt-IDs oder bevorzugte Kategorien.
2. Verwenden Sie den Endpunkt /users/track, um die Empfehlung als angepasstes Attribut im Kundenprofil zu speichern.

Beispielanfrage

1
2
3
POST YOUR_REST_ENDPOINT/users/track
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

Ersetzen Sie YOUR_REST_ENDPOINT durch die REST-Endpunkt-URL für Ihren Workspace.

1
2
3
4
5
6
7
8
{
  "attributes": [
    {
      "external_id": "user123",
      "recommended_product_id": "1001"
    }
  ]
}

Verwenden Sie aussagekräftige Attributnamen (wie recommended_product_id), damit Sie später in Liquid-Templates leicht darauf verweisen können. Halten Sie die Empfehlungen aktuell, indem Sie sie regelmäßig aktualisieren, sobald Ihr Empfehlungssystem neue Ergebnisse liefert.

Schritt 2: Produktmetadaten abrufen

Nachdem Sie einen Empfehlungsbezeichner in jedem Kundenprofil gespeichert haben, müssen Sie die vollständigen Produktmetadaten (Name, Preis, Bild usw.) abrufen, um sie in Ihre Nachricht einzubinden. Dafür stehen Ihnen zwei Optionen zur Verfügung:

• Option A: Braze-Kataloge — Produktinformationen direkt in Braze speichern, um schnelle, integrierte Abfragen zu ermöglichen.
• Option B: Connected Content — Produktinformationen zum Sendezeitpunkt von einer externen API abrufen.

Option A: Braze-Kataloge

Wenn Sie einen Katalog mit Ihrem Produktbestand erstellt haben, können Sie Artikel direkt in Ihrer Nachricht per Liquid nachschlagen. Eine vollständige Anleitung finden Sie unter Kataloge verwenden.

Einen bestimmten Katalogartikel empfehlen

Um ein bestimmtes Produkt anhand seiner ID zu referenzieren, verwenden Sie den Liquid-Tag catalog_items. Um beispielsweise das Produkt 1001 aus einem Katalog mit dem Namen retail_products zu empfehlen:

1
2
3
4
5
6
{% catalog_items retail_products 1001 %}

We have a new item we think you'll like:
Category: {{ items[0].category }}
Name: {{ items[0].name }}
Price: ${{ items[0].price }}

Mehrere Katalogartikel empfehlen

Sie können auch mehrere Artikel in einem einzigen Tag referenzieren. Um beispielsweise drei Produkte hervorzuheben:

1
2
3
4
5
6
7
8
{% catalog_items retail_products 1001 1003 1005 %}

New items added in:
- {{ items[0].category }}
- {{ items[1].category }}
- {{ items[2].category }}

Visit our store to learn more!

Artikel mithilfe der Empfehlung einer Nutzerin oder eines Nutzers als Template verwenden

Kombinieren Sie das angepasste Attribut aus Schritt 1 mit einer Katalogabfrage, um die Empfehlung für jede Nutzerin und jeden Nutzer zu personalisieren:

1
2
3
4
{% catalog_items retail_products {{custom_attribute.${recommended_product_id}}} %}

Hi {{${first_name}}}, check out our pick for you:
{{ items[0].name }} — ${{ items[0].price }}

Option B: Connected Content

Wenn Ihre Produktmetadaten in einem externen Dienst statt in einem Braze-Katalog gespeichert sind, verwenden Sie Connected Content, um die Daten zum Sendezeitpunkt abzurufen.

Wenn Ihre interne API beispielsweise Produktdetails anhand der ID zurückgibt:

1
2
3
4
{% connected_content https://api.yourcompany.com/products/{{custom_attribute.${recommended_product_id}}} :save product %}

Hi {{${first_name}}}, we think you'll love:
{{ product.name }} — ${{ product.price }}

Weitere Informationen zum Durchführen von API-Aufrufen aus Ihren Nachrichten finden Sie unter Einen API-Aufruf durchführen.

Warnung

Vermeiden Sie es, Connected Content zu verwenden, um eine große Liste von Produkten abzurufen und diese dann zum Sendezeitpunkt in Liquid zu durchlaufen. Große Antwort-Payloads erhöhen die Sendelatenz und können bei hohem Volumen zu Nachrichten-Timeouts oder Zustellungsfehlern führen. Speichern Sie stattdessen nur die spezifischen Produkt-IDs, die Nutzer:innen benötigen, in ihrem Profil (siehe Schritt 1) und rufen Sie die Metadaten für diese einzelnen Artikel ab, oder verwenden Sie Kataloge, die für schnelle Abfragen optimiert sind.

Schritt 3: Überprüfen Sie Ihre Integration

Überprüfen Sie nach Abschluss der Einrichtung Ihre Integration:

1. Verwenden Sie den Endpunkt /users/track, um eine Testempfehlung in Ihr eigenes Kundenprofil zu schreiben.
2. Senden Sie eine Testnachricht, die auf das empfohlene Produkt verweist – entweder über Catalogs oder Connected-Content.
3. Bestätigen Sie, dass die Produktdetails in der zugestellten Nachricht korrekt dargestellt werden.
4. Gehen Sie im Braze-Dashboard zur Ergebnisseite der Campaign oder des Canvas und bestätigen Sie, dass der Versand aufgezeichnet wurde.

Überlegungen

• Halten Sie die Empfehlungsdaten aktuell, indem Sie angepasste Attribute regelmäßig aktualisieren, sobald Ihr Empfehlungssystem neue Ergebnisse liefert.
• Nutzen Sie die Personalisierungs-Features von Braze, um Nachrichten weiter anzupassen, z. B. durch die Einbindung nutzerspezifischer Daten neben Produktdetails.
• Erwägen Sie die Verwendung von API-gesteuerter Zustellung, um Nachrichten über Ihr Backend mithilfe von im Braze-Dashboard definierten Templates zu triggern.