Referenz für Katalog-Nachschlage-Tags
Übersicht
Erfahre, wie du den 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 erstellen oder Produktinformationen miteinander abgleichen möchtest. Wenn du zum Beispiel deine eigene Empfehlungs-Engine verwendest, kannst du deine eigenen Produktempfehlungen als Ereignis- oder Profildaten an Klaviyo übergeben und diese Daten dann in Vorlagen nutzen.
Bitte beachte, dass dieser Leitfaden für technisch versierte Marketer*innen oder Kund*innen entwickelt wurde, die Zugriff auf eine*n Entwickler*in haben.
Der {% catalog %}-Tag
Das {% catalog %} -Tag verwendet die folgende Syntax:
{% catalog "itemID" unpublished="cancel" %}
...
{% endcatalog %}Ersetze itemID durch die Artikel-ID, die auf der Seite mit den Produktdetails in Klaviyo angezeigt wird. Der Wert muss mit der Artikel-ID übereinstimmen, die in deinem Katalog gespeichert ist; verwende eine SKU nur, wenn sie auch die Artikel-ID im Katalog ist. Lass Anführungszeichen um eine literal ID stehen. Wenn du eine Ereignis- oder Profilvariable verwendest, lass die Variable ohne Anführungszeichen, wie in den Beispielen unten gezeigt.
Wenn du unpublished="cancel" einfügst, wird die Nachricht nicht gesendet, wenn das referenzierte Element in deinem Klaviyo-Katalog nicht veröffentlicht ist. Dieses Argument ist optional. Ohne dieses Argument kann ein nicht veröffentlichtes Element trotzdem in der Nachricht erscheinen.
- Wenn eine Suche mit unpublished=„cancel“ zum Zeitpunkt der Suche ein nicht veröffentlichtes Element findet, wird die gesamte Nachricht für diese*n Empfänger*in übersprungen.
- Öffne für eine Flow-Nachricht die Analysen und wähle Empfängeraktivität > Übersprungen aus. Wähle im Dropdown-Menü Typ Übersprungen: Katalogartikel nicht verfügbar aus. Diese Liste enthält Profile, deren Nachrichten übersprungen wurden, weil ein referenzierter Artikel nicht gefunden werden konnte oder weil ein unveröffentlichter Artikel mit
unpublished="cancel"nachgeschlagen wurde. Ein Artikel kann unveröffentlicht sein, weil er nicht auf Lager ist oder aus anderen Gründen in deinem Katalog nicht verfügbar ist.
Wenn du diese Funktionen verwendest, kannst du zwischen den öffnenden und schließenden Katalog-Tags spezifische Daten aus dem Artikel referenzieren, der in deinem Klaviyo Produktkatalog mit der itemID verknüpft ist.
Die folgenden Daten sind verfügbar und können in einem {% catalog %} -Block referenziert werden.
Vorlagen-Tag | Name | Beschreibung |
|---|---|---|
| Beschreibung | Die Beschreibung des Artikels. |
| URL | Die URL für den Zugriff auf den Artikel in deinem Shop. |
| Title | Der Titel des Elements. |
| Preis | Der Preis eines Artikels, formatiert anhand der Währungseinstellungen für die Vorlage oder das Konto. Dieser Tag formatiert den Wert; er konvertiert den Preis nicht in eine andere Währung. |
| Währungssymbol | Das grafische Symbol, das zur Kennzeichnung einer Währungseinheit verwendet wird |
| Währungscode | Der alphabetische Code zur Kennzeichnung einer Währung |
| Vollbild | Die URL für das vollständige Bild des Artikels. Verwende dies innerhalb eines Bildblocks oder eines <img> -Tags. |
| Thumbnail | Die URL für das Thumbnail-Bild des Artikels. Verwende dies in einem <img> -Tag in benutzerdefiniertem HTML, oder verwende es als dynamische Bild-Platzhalter-URL, die von den öffnenden und schließenden {% catalog %}-Tags umgeben ist. |
| ID | Die Produkt-ID des Artikels. |
Es sind möglicherweise zusätzliche Datenfelder verfügbar, die als Metadaten gelten. Um auf eine dieser zusätzlichen Artikeleigenschaften zu verweisen, kann die Variablensyntax verwendet werden: {{ catalog_item.metadata.color }}. In diesem Fall zieht die Variable den Wert „color“ ein, der dem in den Metadaten des Artikels gespeicherten Artikel zugeordnet ist.
Um eine Vorschau aller verfügbaren Details zu erhalten, die auf einem Artikel gespeichert sind – einschließlich aller Metadaten –, füge den folgenden Snippet zu einem Textblock in einer Testvorlage hinzu, und aktualisiere itemID mit der Artikel-ID eines der aktuellen Produkte in deinem Katalog.
{% catalog "itemID" %}
{{ catalog_item }}
{% endcatalog %}Zeige dann eine Vorschau der Nachricht an. Diese Vorschau zeigt eine Rohversion aller für deine Produkte verfügbaren Daten.
Filtern nach Katalog-ID
Wenn du mehrere Kataloge hast, verwende das Argument catalog_id im öffnenden Tag {% catalog %}, um einen Katalog anzugeben. Du musst außerdem integration einfügen, mit beiden Werten in Anführungszeichen. Zum Beispiel könntest du einen Katalog haben, der über eine Klaviyo-Integrationen wie Shopify synchronisiert wird, einen Katalog, der über die API synchronisiert wird, oder einen benutzerdefinierten Katalog-Feed. Der Wert für Integrationen muss mit der Katalogquelle übereinstimmen. Im folgenden Beispiel wird integration="api" verwendet, um eine Produktbeschreibung aus einem API-Katalog abzurufen.
Finde zuerst die Katalog-ID:
- Navigiere in Klaviyo zu Inhalt > Produkte.
- Verwende den Filter Katalogoptionen, um den Katalog auszuwählen, den du verwenden möchtest. Die Standardeinstellung ist Alle Kataloge.
- Kopiere die Katalog-ID aus der URL.
Suche dann die Artikel-ID:
- Nach dem Auswählen des Katalogs das Produkt auswählen, das du aus dem Katalog verwenden möchtest.
- Auf der Seite mit den Produktdetails siehst du die Artikel-ID.
Für das obige Beispiel würde der Code so aussehen:
{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935"%} {{ catalog_item.description }}{% endcatalog %}Ersetze die Beispiel-Artikel-ID und die Katalog-ID durch deine eigenen Werte, sieh dir dann die Vorschau der Nachricht an und überprüfe, dass sie die erwarteten Produktdetails anzeigt. Wenn die Suche im von dir angegebenen Katalog keine Übereinstimmung finden kann, kann sie auf einen anderen Katalog in deinem Konto zurückgreifen.
Filtern nach Gebietsschema
Wenn dein Katalog lokalisierte Produktdaten enthält, z. B. einen Shopify-Katalog mit lokalisierten Daten, die mit Klaviyo synchronisiert wurden, kannst du ein Produkt nach Locale suchen. Gib sowohl Sprache als auch Region an und verwende dafür jeweils 2-stellige Sprach- und Ländercodes aus ISO 639 bzw. ISO 3166. Beispielsweise fordern language='fr' und region='CA' französische Produktdaten für Kanada an. Wenn kein lokalisiertes Produkt gefunden werden kann, werden die Standard-Produktinformationen verwendet.
{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935" language='fr' region='CA' %} {{ catalog_item.description }}{% endcatalog %}Eine mit einem Ereignis übergebene Artikel-ID nachschlagen
Eine Katalogsuche mit einem Ereignis wird meist in den folgenden Szenarien verwendet:
- Wenn du eine benutzerdefinierte Integrationen verwendest, bei der Produktempfehlungen zusammen mit einem Ereignis übergeben werden, damit sie in der Nachricht angezeigt werden. Zum Beispiel eine Browse Abandonment-Nachricht, bei der eindeutige Empfehlungen basierend auf angesehenen Artikeln generiert werden. Anstatt den einzelnen Artikel, den Kund*innen in der Nachricht angesehen haben, einzufügen, kannst du eine Reihe empfohlener Artikel basierend auf diesem 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 nicht alle Produktdetails senden möchtest, die in einer Nachricht enthalten sein müssen. Zum Beispiel: Bei einer Warenkorbabbruch-Nachricht sendest du nur die Produkt-IDs aller abgebrochenen Artikel und Klaviyo kann jedes Produkt nachschlagen, um alle relevanten Details abzurufen. Nicht jedes Ereignis muss Produktname, Preis, Bild usw. enthalten, da all das ausgefüllt werden kann, indem du nur die Produkt-ID an Klaviyo übergibst und die Informationen dann in deinem Klaviyo-Produktkatalog nachschlägst.
Wenn du ein {% catalog %} -Tag mit einem Ereignis verwendest, basiert die Suche auf der Artikel-ID des Katalogartikels (das ist je nach Integration entweder die Produkt-ID oder die SKU).
Bei einem Ereignis, bei dem der übergebene identifizierende Wert die Artikel-ID ist, werden die Lookup-Tags so angezeigt:
{% catalog event.ItemID %}
...
{% endcatalog %}Füge in diesem {% catalog %} -Block Vorlagen-Tags für die Daten hinzu, die du für jedes Element einfügen möchtest (z. B. Titel oder Bild).
Wenn wir zum Beispiel die Beispiel-Katalogartikeldaten unten verwenden, können wir einen {% catalog %} -Block erstellen, der auf wichtige Produktinformationen verweist:
Katalogartikeldaten:
{
"description": "Standard issue for all Klaviyos. This t-shirt has the Klaviyo logo on the front and mark diagram on the back.",
"url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
"title": "Classic 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"
}
}Vorlagenblock-Syntax:
Das folgende HTML-Beispiel zieht das Artikelbild, den Titel und die Beschreibung für jeden Artikel in event.Items. Es setzt voraus, dass jeder Artikel einen Wert für SKU hat, der mit der Artikel-ID in deinem Klaviyo-Katalog übereinstimmt. Wenn dein Ereignis eine andere Eigenschaft für die Katalogartikel-ID verwendet, ersetze item.SKU durch diese Eigenschaft. Verwende die HTML-Beispiele in einer E-Mail; für SMS oder Push verwende die Katalog-Tags mit Textfeldern statt HTML-Markup.
{% 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 den gesuchten Artikel nicht finden kann, wird die Nachricht übersprungen und nicht gesendet.
Eine Artikel-ID als benutzerdefinierte Eigenschaft nachschlagen
Wenn du deine eigene Empfehlungs-Engine verwendest, kannst du empfohlene Artikel-IDs als benutzerdefinierte Profileigenschaften an Profile in Klaviyo übergeben. Mit einem {% catalog %} -Tag kannst du beim Versand von Nachrichten an diese*n Kund*in auf Informationen aus jedem dieser Produkte verweisen.
Wenn die Suche den gesuchten Artikel nicht finden kann, wird die Nachricht übersprungen und nicht gesendet.
Syntax für mehrere Artikel-IDs, die in einer einzigen Eigenschaft gespeichert sind
Speichere Recommended Products als Liste von Artikel-IDs, zum Beispiel ["KLAVIYO-TSHIRT", "KLAVIYO-HAT"]. Ersetze diese Beispiel-IDs durch IDs aus deinem Katalog und ersetze den Property-Namen im Code, falls deiner anders ist.
{% 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 Element-ID in einer Profileigenschaft
Speichere eine einzelne Artikel-ID als Textwert in Recommended Products, zum Beispiel KLAVIYO-TSHIRT. Verwende den Eigenschaftsnamen und die Artikel-ID aus deinem eigenen Konto.
{% 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
Verwende das has_category -Tag, um festzustellen, ob ein Artikel in deinem Katalog Teil einer bestimmten Kategorie ist. Es muss innerhalb eines Katalog-Lookup-Tags für einen bestimmten Artikel verwendet werden.
Verwende den Beispielcode unten, um diesen Tag zu verwenden, und ersetze itemID durch eine Produkt-ID aus deinem Katalog und category_name durch den vollständigen oder einen Teil eines Kategorienamens.
{% catalog "itemID" %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
I am on sale!
{% else %}
{% endif %}
{% endcatalog %}Dieses Beispiel zeigt den Produkttitel an und prüft dann, ob sich das Produkt in einer Kategorie befindet, category_name. Wenn dies als true ausgewertet wird, wird die Nachricht „Ich bin im Angebot!“ im Anschluss an den Produkttitel angezeigt.
Der Tag has_category sucht nach vollständigen und partiellen Übereinstimmungen mit dem von dir festgelegten Kategorienamen. Wenn du zum Beispiel „sale“ als Kategorienamen verwendest und ein Produkt den Tag „on-sale“ hat, wird der Tag has_category für dieses Produkt als true ausgewertet.
Weitere Ressourcen
- So nutzt du Produkt-Feeds und -Empfehlungen
Erfahre, wie du in Klaviyo einen Produkt-Feed erstellst, um Produktempfehlungen in deinen Nachrichten zu verwenden. Produkt-Feeds übernehmen Daten aus deinem Produktkatalog und dem Verhalten von Kund*innen (z. B. die Produkte, die sie in der Vergangenheit angesehen oder gekauft haben) und verwenden diese Informationen, um benutzerdefinierte Produktempfehlungen für deine Abonnent*innen bereitzustellen.