Tag-Referenz zum Nachschlagen im Katalog

Du wirst lernen

Lerne, wie du das Katalog-Tag verwendest, mit dem du in deinen E-Mails, SMS und Push-Nachrichten auf bestimmte Produktinformationen aus deinem Katalog verweisen kannst. Das ist nützlich, wenn du benutzerdefinierte Produktempfehlungen oder Querverweise auf Produktinformationen erstellen willst. Wenn du zum Beispiel deine eigene Empfehlungsmaschine verwendest, kannst du deine eigenen Produktempfehlungen als Ereignis- oder Profildaten an Klaviyo übergeben und diese Daten dann in der Vorlage verwenden.

Der {% catalog %} -Tag

Der {% catalog %}-Tag verwendet die folgende Syntax:

{% catalog itemID unpublished="cancel" %}
...
{% endcatalog %}

Ersetze itemID durch die Produkt-ID des Produkts, auf das du dich beziehst. Dies ist die Produkt-ID, die aus deinem eigenen Produktkatalog synchronisiert wurde. Beachte, dass diese Suche speziell für die Produkt-ID und nicht für die SKU ist.

Wenn du unpublished="cancel" einfügst, stellst du sicher, dass du deine Nachricht nicht versendest, wenn der Artikel, auf den du dich beziehst, nicht veröffentlicht ist. Dieses Argument ist optional. 

• Wenn ein Artikel, auf den in deiner Nachricht verwiesen wird, zum Zeitpunkt der Suche nicht in deinem Katalog veröffentlicht ist, wird die gesamte Nachricht übersprungen.
• Für eine bestimmte Flow Message kannst du zu Analytics > Recipient Activity > Other navigieren und eine Liste mit dem Titel Skipped sehen : Katalogartikel nicht verfügbar. Diese Liste enthält alle Profile, die übersprungen wurden, weil ein in der Nachricht genannter Artikel nicht vorrätig oder aus anderen Gründen nicht verfügbar war.

Wenn du diese Funktion nutzt, kannst du zwischen dem öffnenden und dem schließenden Katalog-Tag auf bestimmte Daten des Artikels verweisen, der mit der itemID in deinem Klaviyo Produktkatalog verbunden ist.

Die folgenden Daten können innerhalb eines {% catalog %} Blocks.

Es können zusätzliche Datenfelder vorhanden sein, die als Metadaten gelten. Um eine dieser zusätzlichen Elementeigenschaften zu referenzieren, kannst du die Variablen-Syntax verwenden: {{ catalog_item.metadata.color }}. In diesem Fall zieht die Variable den Wert "color" heran, der mit dem Artikel Laden in den Metadaten des Artikels verknüpft ist.

Um eine Vorschau aller verfügbaren Details zu einem Artikel zu erhalten - einschließlich aller Metadaten - füge das folgende Snippet zu einem Textblock in einer Testvorlage hinzu und aktualisiere itemID mit der Produkt-ID eines der aktuellen Produkte in deinem Katalog.

{% catalog itemID %}
{{ catalog_item }}
{% endcatalog %}

Sieh dir dann eine Vorschau der Nachricht an. Diese Vorschau bietet eine Rohfassung aller Daten, die für deine Produkte verfügbar sind.

Wenn du mehrere Kataloge hast (d.h. du synchronisierst mehrere benutzerdefinierte Kataloge mit deinem Konto), kannst du mit dem {{ catalog_id }}-Tag angeben, aus welchem Katalog du die Daten beziehen möchtest. Zum Beispiel: 

{% catalog "womens-jewelry-bundle" integration="demandware" catalog_id="catalogID"%} {{ catalog_item.internal_id }} {% endcatalog %}

Nachschlagen einer mit einem Ereignis übergebenen Artikel-ID

Die Verwendung einer Katalogsuche mit einem Ereignis wird meist in den folgenden Szenarien verwendet:

• Wenn du eine benutzerdefinierte Integration verwendest, bei der die Produktempfehlungen zusammen mit einem Ereignis in der Nachricht angezeigt werden. Zum Beispiel eine Browse Abandonment Nachricht, bei der einzigartige Empfehlungen auf Basis der angesehenen Artikel generiert werden. Anstatt den einzelnen Artikel, den ein Kunde angesehen hat, in die Nachricht einzutragen, kannst du eine Reihe von empfohlenen Artikeln basierend auf dem angesehenen Artikel generieren und einfügen. Eine Reihe von Produkt-IDs muss zusammen mit dem Ereignis an Klaviyo gesendet werden.
• Wenn du eine benutzerdefinierte Integration verwendest und es vorziehst, nicht alle Produktdetails zu senden, die in einer Nachricht enthalten sein müssen. Wenn du z.B. eine Warenkorbabbruch-Nachricht versendest, brauchst du nur die Produkt-IDs aller abgebrochenen Artikel zu senden. Klaviyo kann dann jeden einzelnen Artikel nachschlagen und alle relevanten Details einholen. Es ist nicht notwendig, dass jedes Ereignis den Produktnamen, den Preis, das Bild usw. enthält, da all diese Informationen nur durch die Übergabe der Produkt-ID an Klaviyo und die anschließende Suche in deinem Klaviyo-Produktkatalog eingegeben werden können.

Wenn du ein {% catalog %}-Tag mit einem Ereignis verwendest, basiert die Suche auf der Artikel-ID des Katalogartikels (je nach Integration ist das entweder die Produkt-ID oder die SKU).

Bei einem Ereignis, bei dem der identifizierende Wert die Artikel-ID ist, sieht der Lookup-Tag wie folgt aus:

{% catalog event.ItemID %}
...
{% endcatalog %}

Innerhalb dieses {% catalog %} Block fügst du den Vorlagen-Tag für die Daten hinzu, die du für jeden Artikel angeben möchtest (z. B. Titel, Bild, etc.)

Anhand der unten stehenden Beispiel-Katalogdaten können wir zum Beispiel einen {% catalog %}-Block erstellen, der auf wichtige Produktinformationen verweist:

Daten des Katalogartikels:

{
  "description": "Standard Problem für alle Klaviyos. Dieses T-Shirt hat das Klaviyo-Logo auf der Vorderseite und das Markierungsdiagramm auf der Rückseite.",
  "url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "title": "Klassisches Klaviyo T-Shirt",
  "featured_image": {
    "full": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-full.png"
    },
    "thumbnail": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-thumbnail.png"
    }
  },
  "id": "Klaviyo-TSHIRT",
  "metadata": {
    "Color": "Grey",
    "Design": "Standard"
  }
}

Vorlage Blocksyntax:

Die Syntax für den folgenden {% catalog %}-Block würde das Artikelbild, den Artikeltitel und die Artikelbeschreibung für jeden Artikel in der Veranstaltung aus deinem Katalog beziehen:

{% for item in event.Items %}
	{% catalog item.SKU %}
 		<img src="{{ catalog_item.featured_image.full.src }}"/>
 		{{ catalog_item.title }}
 		{{ catalog_item.description }}
 	{% endcatalog %}
{% endfor %}

Wenn die Suche das gesuchte Element nicht finden kann, wird die Nachricht übersprungen und nicht gesendet.

Suche nach einer Artikel-ID als benutzerdefinierte Eigenschaft

Wenn du deine eigene Empfehlungsmaschine verwendest, kannst du die IDs der empfohlenen Artikel in Klaviyo als benutzerdefinierte Profileigenschaft an Profil übergeben. Mit einem {% catalog %} Tag kannst du Informationen aus einem dieser Produkte referenzieren, wenn du diesen Kunden benachrichtigst.

Wenn die Suche das gesuchte Element nicht finden kann, wird die Nachricht übersprungen und nicht gesendet.

Syntax für mehrere Artikel-IDs, die in einer einzigen Eigenschaft geladen werden

{% for item in person|lookup:'Recommended Products' %}{% catalog item %} 

<img src="{{ catalog_item.featured_image.thumbnail.src }}" style="display: inline-block; border: none" width="150px" />

<p>{{ catalog_item.title }} {% endcatalog %}</p>

{% endfor %}

Syntax für eine einzelne Artikel-ID in einer Profileigenschaft

{% catalog person|lookup:"Recommended Products" %} 

<img style="display: inline-block; border: none;" src="{{ catalog_item.featured_image.thumbnail.src }}" width="150px"/>

  <p>{{ catalog_item.title }} {% endcatalog %}</p>

Über das has_category-Tag

Mit dem has_category-Tag kannst du feststellen, ob ein Artikel in deinem Katalog zu einer bestimmten Kategorie gehört. Sie muss innerhalb eines Katalogs verwendet werden, der nach einem bestimmten Artikel sucht. 

Verwende den Beispielcode unten, um dieses Tag zu verwenden. Ersetze itemID durch eine Produkt-ID aus deinem Katalog und category_name durch den ganzen oder einen Teil des Kategorienamens. 

{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
Ich bin im Angebot!
{% else %}
{% endif %}
{% endcatalog %}

In diesem Beispiel wird der Produkttitel angezeigt und dann geprüft, ob sich das Produkt in einer Kategorie befindet, category_name. Wenn dies als wahr bewertet wird, erscheint die Meldung "Ich bin im Angebot! 

Zusätzliche Ressourcen

• Wie man Produkt-Feeds und Empfehlungen nutzt
• Übersicht über den E-Mail Vorlage Editor