Recommendations

Das Objekt recommendations bietet Produktempfehlungen, die sich auf ein bestimmtes Produkt beziehen, basierend auf Daten aus Verkäufen, Produktbeschreibungen und Beziehungen zwischen Produkten und Kollektionen. Die Produktempfehlungen werden mit der Zeit immer genauer, da neue Bestellungen und Produktdaten verfügbar werden. Weitere Informationen darüber, wie Produktempfehlungen funktionieren, finden Sie unter Anzeigen von Produktempfehlungen auf Produktseiten.

Das recommendations Objekt gibt nur dann Produkte zurück, wenn es in einem Themenabschnitt verwendet wird, der durch eine HTTP-Anfrage an <base_url>?section_id=<section_id>&product_id=<product_id>. section_id ist die ID des Bereichs, in dem das Objekt recommendations verwendet wird, und product_id ist die ID des Produkts, für das Sie Produktempfehlungen anzeigen möchten. Um die base_url zu ermitteln, verwenden Sie das Attribut routes. product_recommendations_url. Die Verwendung des routes -Objekts anstelle einer fest kodierten URL stellt sicher, dass die Produktempfehlungen im richtigen Gebietsschema geladen werden.

Wie Sie das Objekt recommendations implementieren können, erfahren Sie unter Anzeigen von Produktempfehlungen mit der Antwort im Abschnitt Produktempfehlungen API.

Das Objekt recommendations hat die folgenden Attribute:

recommendations.performed

Gibt true zurück, wenn das Objekt recommendations innerhalb eines Themenabschnitts referenziert wird, der über den Endpunkt für Empfehlungen mit gültigen Parametern gerendert wird:

Parameters for recommendations.performed
Parameters	Description	Required
product_id	id of the product you want to show recommended products for	yes
section_id	id of the section where the `recommendations` object is being used	yes
limit	Limits number of results, up to a maximum of ten	no

recommendations.products_count

Gibt die Anzahl der Produktempfehlungen zurück oder gibt 0 zurück, wenn recommendations. performed false ist.

recommendations.products

Gibt Produktempfehlungen zurück. Diese Objekte sind Produkte. Keine Rückgabe von Produkten, wenn recommendations. performed false ist.

Dieses Liquid-Snippet beispielsweise schafft die Voraussetzungen für die Anzeige von Produktempfehlungen:

{% if recommendations.performed %}
  {% if recommendations.products_count > 0 %}
    {% for product in recommendations.products %}
      {{ product.title | link_to: product.url }}
    {% endfor %}
  {% endif %}
{% else %}
  
 <div class="placeholder">
  Placeholder animation
 </div>
{% endif %}

Es erzeugt die folgende Ausgabe, wenn der umschließende Abschnitt synchron gerendert wird:

Placeholder animation

Und wenn der umschließende Abschnitt vom Endpunkt aus gerendert wird, ergibt sich die folgende Ausgabe /recommendations/products?section_id=<section_id>&product_id=<product_id>:

produkt titel
Ein weiterer Produkttitel