Verwendung von Katalogen

Nachdem Sie einen Katalog erstellt haben, können Sie in Ihren Braze-Campaigns über Liquid auf Nicht-Nutzerdaten verweisen. Sie können Kataloge in allen Ihren Messaging-Kanälen verwenden, auch überall dort, wo Liquid im Drag-and-Drop-Editor unterstützt wird.

Kataloge in einer Nachricht verwenden

Das folgende Video zeigt Ihnen, wie Sie Kataloge in einer Nachricht verwenden.

1. Schritt: Personalisierungsart hinzufügen

Wählen Sie im Nachrichten-Editor Ihrer Wahl das Add Personalization und wählen Sie Catalog Items als Personalization type aus. Wählen Sie anschließend den Namen Ihres Katalogs aus. In unserem vorherigen Beispiel wählen wir den Katalog „Games“.

Wir können sofort die folgende Liquid-Vorschau sehen:

1
{% catalog_items Games %}

2. Schritt: Katalogartikel auswählen

Als Nächstes fügen Sie Ihre Katalogartikel hinzu! Wählen Sie über die Dropdown-Liste die Katalogartikel und die anzuzeigenden Informationen aus. Diese Informationen entsprechen den Spalten in Ihrer hochgeladenen CSV-Datei, die Sie zur Erstellung Ihres Katalogs verwendet haben.

Um beispielsweise den Titel und den Preis unseres Tales-Spiels zu referenzieren, könnten wir die id für Tales (1234) als Katalogartikel auswählen und title und price für die angezeigten Informationen anfordern.

1
2
3
{% catalog_items Games 1234 %}

Get {{ items[0].title }} for just {{ items[0].price }}!

Dies wird folgendermaßen gerendert:

Get Tales for just 7.49!

Kataloge exportieren

Es gibt zwei Möglichkeiten, Kataloge aus dem Dashboard zu exportieren:

• Bewegen Sie den Mauszeiger über die Katalogzeile im Abschnitt Catalogs. Wählen Sie dann den Button Export catalog aus.
• Wählen Sie Ihren Katalog aus. Wählen Sie dann den Button Export catalog auf dem Tab Preview des Katalogs aus.

Sie erhalten eine E-Mail zum Herunterladen der CSV-Datei, nachdem Sie den Export gestartet haben. Sie haben bis zu vier Stunden Zeit, diese Datei abzurufen.

Zusätzliche Anwendungsfälle

Mehrere Artikel

Sie sind nicht auf einen Artikel pro Nachricht beschränkt. Verwenden Sie das Modal Add Personalization, um bis zu drei Katalogartikel gleichzeitig hinzuzufügen. Um weitere hinzuzufügen, wählen Sie im Editor erneut Add Personalization und wählen Sie zusätzliche Katalogartikel und anzuzeigende Informationen aus.

Sehen Sie sich dieses Beispiel an, in dem wir die id von drei Spielen – Tales, Teslagrad und Acaratus – für Catalog Items hinzufügen und title für Information to Display auswählen.

Wir können unsere Nachricht weiter personalisieren, indem wir etwas Text um unser Liquid herum hinzufügen:

1
2
Get the ultimate trio {% catalog_items Games 1234 1235 1236 %}
{{ items[0].title }}, {{ items[1].title }}, and {{ items[2].title }} today!

Das Ergebnis sieht folgendermaßen aus:

Get the ultimate trio Tales, Teslagrad, and Acaratus today!

Tipp

Check out selections to create groups of data for more personalized messaging!

Using Liquid if statements

You can use catalog items to create conditional statements. For example, you can trigger a certain message to display when a specific item is selected in your campaign. You must declare the catalog (and, if applicable, the selection) before referencing items in an if statement.

With catalog items

1
2
3
4
5
6
{% catalog_items Games 1234 %}
{% if items[0].on_sale == true %}
  {{ items[0].title }} is on sale! Get it for {{ items[0].price }}.
{% else %}
  Check out {{ items[0].title }} at full price.
{% endif %}

In diesem Beispiel ruft der catalog_items-Tag den Artikel 1234 aus dem Games-Katalog ab, und die if-Anweisung prüft das Feld on_sale, um unterschiedliche Nachrichten anzuzeigen.

Mit Katalogauswahlen

1
2
3
4
5
6
7
8
{% catalog_selection_items item-list selections %}
{% if items[0].venue_name.size > 10 %}
Message if the venue name's size is more than 10 characters.
{% elsif items[0].venue_name.size <= 10 %}
Message if the venue name's size is 10 characters or fewer.
{% else %}
{% abort_message('no venue_name') %}
{% endif %}

In diesem Beispiel werden je nachdem, ob das Feld venue_name mehr oder weniger als 10 Zeichen hat, unterschiedliche Nachrichten angezeigt. Wenn venue_name leer ist, wird die Nachricht abgebrochen.

Um auszugeben, wie viele Artikel eine Auswahl zurückgibt, verwenden Sie den Liquid-Filter size auf dem items-Array nach dem Tag, nicht auf einem einzelnen Feld:

1
{% catalog_selection_items item-list selections %}{{ items | size }}

Tipp

Um Liquid-Syntaxfehler zu vermeiden, wählen Sie den + Plus-Button im Nachrichten-Editor, um Katalog-Liquid-Tags automatisch einzufügen.

Bilder verwenden

Sie können auch Bilder aus dem Katalog referenzieren, um sie in Ihrem Messaging zu verwenden. Verwenden Sie dazu den catalogs-Tag und das item-Objekt im Liquid-Feld für Bilder.

Wenn Sie z. B. den image_link aus unserem Games-Katalog zu unserer Aktionsnachricht für Tales hinzufügen möchten, wählen Sie die id für das Feld Catalog Items und image_link für das Feld Information to Display. Dadurch werden die folgenden Liquid-Tags zu unserem Bildfeld hinzugefügt:

1
2
3
{% catalog_items Games 1234 %}

{{ items[0].image_link }}

So sieht das aus, wenn das Liquid gerendert wird:

Wichtig

Vermeiden Sie in HTML-Kanälen wie E-Mail zusätzliche Leerzeichen oder Zeilenumbrüche zwischen dem schließenden {% catalog_items ... %}-Tag und dem Liquid, das die Bild-URL ausgibt (z. B. {{ items[0].image_link }}). Zusätzliche Leerzeichen im Template können verhindern, dass die Bild-URL in der gerenderten Nachricht korrekt aufgelöst wird. Halten Sie den URL-Ausdruck direkt neben dem Katalog-Tag, wie in: <img src="{% catalog_items Games 1234 %}{{ items[0].image_link }}">.

Templates für Katalogartikel

Sie können auch Templates verwenden, um Katalogartikel auf der Grundlage angepasster Attribute dynamisch abzurufen. Nehmen wir zum Beispiel an, eine Nutzerin oder ein Nutzer hat das angepasste Attribut wishlist, das ein Array von Spiele-IDs aus Ihrem Katalog enthält.

1
2
3
4
5
6
7
8
{
    "attributes": [
        {
            "external_id": "user_id",
            "wishlist": ["1234", "1235"]
        }
    ]
}

Hinweis

JSON-Objekte in Katalogen werden nur über die API aufgenommen. Sie können ein JSON-Objekt nicht über eine CSV-Datei hochladen.

Mit Liquid-Templates können Sie die Wunschlisten-IDs dynamisch abrufen und sie dann in Ihrer Nachricht verwenden. Dazu weisen Sie Ihrem angepassten Attribut eine Variable zu und verwenden dann das Modal Add Personalization, um einen bestimmten Artikel aus dem Array abzurufen. Variablen, die als ID eines Katalogartikels referenziert werden, müssen in geschweifte Klammern eingeschlossen werden, um korrekt referenziert zu werden, z. B. ``.

Tipp

Denken Sie daran, dass Arrays bei 0 beginnen, nicht bei 1.

Um beispielsweise eine Nutzerin oder einen Nutzer darüber zu informieren, dass Tales (ein Artikel aus unserem Katalog, der auf der Wunschliste steht) im Angebot ist, können wir unserem Nachrichten-Editor Folgendes hinzufügen:

1
2
3
4
{% assign wishlist = {{custom_attribute.${wishlist}}}%}
{% catalog_items Games {{ wishlist[0] }} %}

Get {{ items[0].title }} now for {{ items[0].price }}!

Dies wird wie folgt angezeigt:

Get Tales now for just 7.49!

Mit Templates können Sie für jede Nutzerin und jeden Nutzer einen anderen Katalogartikel rendern, der auf den individuellen angepassten Attributen, Event-Eigenschaften oder einem anderen in Templates verwendbaren Feld basiert.

Hochladen einer CSV-Datei

Sie können eine CSV-Datei mit neuen Katalogartikeln zum Hinzufügen oder mit zu aktualisierenden Katalogartikeln hochladen. Um eine Liste von Artikeln zu löschen, können Sie eine CSV-Datei mit den Artikel-IDs hochladen, um sie zu löschen.

Liquid verwenden

Sie können Kataloge auch manuell mit Liquid-Logik zusammenstellen. Beachten Sie jedoch, dass Braze, wenn Sie eine ID eingeben, die nicht existiert, trotzdem ein Artikel-Array ohne Objekte zurückgibt. Wir empfehlen Ihnen, eine Fehlerbehandlung einzubauen, wie z. B. die Überprüfung der Größe des Arrays und die Verwendung einer if-Anweisung, um den Fall eines leeren Arrays zu berücksichtigen.

Templates für Katalogartikel einschließlich Liquid

Ähnlich wie bei Connected-Content müssen Sie das :rerender-Flag in einem Liquid-Tag verwenden, um den Liquid-Inhalt eines Katalogartikels zu rendern. Beachten Sie, dass das :rerender-Flag nur eine Ebene tief wirkt, d. h. es gilt nicht für verschachtelte Liquid-Tag-Aufrufe.

Wenn ein Katalogartikel Nutzerprofil-Felder enthält (innerhalb eines Liquid-Personalisierungs-Tags), müssen diese Werte in Liquid zu einem früheren Zeitpunkt in der Nachricht und vor dem Templating definiert werden, damit das Liquid ordnungsgemäß gerendert werden kann. Wenn das :rerender-Flag nicht angegeben wird, wird der rohe Liquid-Inhalt ausgegeben.

Wenn zum Beispiel ein Katalog mit dem Namen „Messages“ einen Artikel mit diesem Liquid enthält:

Um den folgenden Liquid-Inhalt zu rendern:

1
2
3
4
Hi ${first_name},

{% catalog_items Messages greet_msg :rerender %}
{{ items[0].Welcome_Message }}

Dies wird wie folgt angezeigt:

1
2
3
Hi Peter,

Welcome to our store, Peter!

Hinweis

Katalog-Liquid-Tags können innerhalb von Katalogen nicht rekursiv verwendet werden.

Fehlerbehebung bei der Katalogpersonalisierung

Wenn Katalog- oder Auswahl-Liquid in einer Nachricht oder einem Canvas-Schritt nicht wie erwartet angezeigt wird, überprüfen Sie Folgendes:

Allgemeine Informationen zum Liquid-Verhalten finden Sie unter Liquid-Anwendungsfälle und Liquid verwenden.

Strukturierung Ihrer Katalogdaten

Wenn Sie planen, wie Sie Ihre Katalogdaten strukturieren, beginnen Sie mit Ihrem beabsichtigten Anwendungsfall und gestalten Sie den Katalog entsprechend. Jede Zeile im Katalog stellt einen Artikel dar (mit einer eindeutigen id). Die Spalten sollten die Attribute für diesen Artikel enthalten, wie z. B. URLs, Beschreibungstexte, Bild-URLs, Preis, Bewertung, Größe oder Farbe.

Wann Sie Standard-Katalogaufrufe verwenden sollten

Bei Standard-Katalogaufrufen gleichen Sie einen Wert mit der id-Spalte ab. Indem Sie ein angepasstes Attribut oder eine Event-Eigenschaft (als ID-String) in den Katalog-Liquid-Tag einfügen, können Sie mehrere Attribute für einen einzelnen Artikel in Ihre Nachricht einbinden. Häufige Anwendungsfälle sind:

• Zuletzt angesehenes Produkt oder zuletzt angesehener Dienst
• Wunschlisten-Artikel
• Angebote nach Standort
• Gekauftes Produkt
• Inhalte zur Lifecycle-Phase
• Zuletzt gesuchtes Produkt oder zuletzt gesuchter Dienst

Wann Sie Katalogauswahlen verwenden sollten

Katalogauswahlen ermöglichen es Ihnen, über jede Spalte in Ihrem Katalog zu filtern und bis zu 50 übereinstimmende Artikel zurückzugeben. Indem Sie angepasste Attribute oder Event-Eigenschaften in die Auswahlfilter einfügen, werden die Ergebnisse für jede Nutzerin und jeden Nutzer personalisiert. Häufige Anwendungsfälle sind:

• Artikel, deren Kategorie den Präferenzen einer Nutzerin oder eines Nutzers entspricht
• Artikel, die zur bevorzugten Marke, Küche oder Größe einer Nutzerin oder eines Nutzers passen
• Inhalte zum Abo-Typ oder zur Treuestufe
• Produkte innerhalb des durchschnittlichen Bestellwerts einer Nutzerin oder eines Nutzers

Der wesentliche Unterschied besteht darin, dass Standard-Katalogaufrufe einen einzelnen bekannten Artikel anhand der id nachschlagen, während Katalogauswahlen den gesamten Katalog abfragen und mehrere Artikel zurückgeben, die Ihren Filterkriterien entsprechen.