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 Produkt-ID des Produkts, auf das du dich beziehst. Das ist die Produkt-ID, wie sie aus deinem eigenen Produktkatalog synchronisiert wurde. Hinweis: Diese Suche gilt speziell für die Produkt-ID und nicht für die SKU.
Wenn du unpublished=„cancel“ angibst, wird sichergestellt, dass du deine Nachricht nicht sendest, falls das referenzierte Element unveröffentlicht ist. Dieses Argument ist optional.
- Wenn ein Artikel, auf den in deiner Nachricht verwiesen wird, zum Zeitpunkt der Abfrage in deinem Katalog nicht veröffentlicht ist, wird die gesamte Nachricht übersprungen.
- Für eine bestimmte Flow-Nachricht kannst du zu Analytics > Empfänger*innenaktivität > Andere navigieren und eine Liste mit der Bezeichnung Übersprungen: Katalogartikel nicht verfügbar sehen. Diese Liste enthält alle Profile, die übersprungen wurden, weil ein in der Nachricht enthaltenes Element nicht vorrätig oder anderweitig nicht verfügbar war.
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 das Element in deinem Shop. |
| Title | Der Titel des Elements. |
| Preis | Der Preis eines Artikels. Dieses Tag formatiert den Artikelpreis mit dem richtigen Währungspräfix. |
| 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 das in einem Bildblock oder einem <img> -Tag. |
| Thumbnail | Die URL für das vollständige Bild des Artikels. Verwende diese in einem <img> -Tag in benutzerdefiniertem HTML, oder verwende sie als dynamische Bild-Platzhalter-URL, umgeben von den öffnenden und schließenden {% catalog %}-Tags |
| ID | Die Produkt-ID des Artikels. |
| Katalog-ID | Die ID des Katalogs, damit du festlegen kannst, aus welchem Katalog Daten abgerufen werden sollen, wenn du mehrere hast. |
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 auf eine Vorschau aller verfügbaren Details zuzugreifen, die für ein Element gespeichert sind – einschließlich aller Metadaten –, füge den folgenden 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 %}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, kannst du mit dem Tag {{catalog id}} angeben, aus welchem Katalog du Daten abrufen möchtest. Du könntest zum Beispiel 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. Die Tag-Details können je nach Integrationen variieren. Im folgenden Beispiel werden mehrere Kataloge mit demselben Klaviyo-Konto synchronisiert, und wir möchten eine Produktbeschreibung aus einem bestimmten Produkt abrufen, das in einem API-Katalog enthalten ist.
Finde zuerst die Katalog-ID:
- Navigiere in Klaviyo zu Inhalt > Produkte.
- Wähle den Katalog aus, den du verwenden möchtest, aus dem Drop-down-Menü Alle Kataloge aus.
- 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 %}Filtern nach Gebietsschema
Regionsabhängige Kataloge wie der Shopify-Katalog in Klaviyo können nach Region durchsucht werden. Sprache und Region des Gebietsschemas können mit einem zweistelligen Länder- und Sprachcode gemäß den Standards ISO 3166 und 639 referenziert werden. 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 Integrationen verwendest und es vorziehst, nicht alle Produktdetails zu senden, die in eine Nachricht eingefügt werden müssen. Wenn du zum Beispiel eine Nachricht zum Warenkorbabbruch sendest, sende nur die Produkt-IDs aller abgebrochenen Artikel, und Klaviyo kann jeden Artikel nachschlagen, um alle relevanten Details einzufügen. 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 dann die Informationen 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 innerhalb dieses {% catalog %} -Blocks Vorlagen-Tags für die Daten hinzu, die du für jeden Artikel ausfüllen möchtest (z. B. Titel, Bild usw.)
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:
Die Syntax für den folgenden {% catalog %} -Block würde für jedes Element im Ereignis das Elementbild, den Elementtitel und die Elementbeschreibung aus deinem Katalog abrufen:
{% 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
{% 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
{% 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.