> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Finden Sie Antworten auf häufige Fragen zu Produktempfehlungs- und Merchandising-Funktionen, einschließlich Einrichtung, Algorithmen, Feed-Konfiguration und Einschränkungen.

<AccordionGroup>
  <Accordion title="Wie aktiviere ich Produktempfehlungsfunktionen und greife darauf zu?">
    Produktempfehlungsfunktionen sind eine Premium-Funktion. Wenden Sie sich an Ihren Customer Success Manager, um sie in Ihrem Kameleoon-Konto zu aktivieren. Greifen Sie auf den Arbeitsbereich **Product recommendations** zu, indem Sie zu **Settings** > **Recommendations** navigieren.
  </Accordion>

  <Accordion title="Was ist eine Produktempfehlungsstrategie?">
    Eine Empfehlungsstrategie definiert, wie Sie die anzuzeigenden Produkte auswählen und filtern. Wenn Sie eine Strategie erstellen, geben Sie einen Namen und eine Beschreibung ein und definieren Sie die maximale Anzahl der im Block anzuzeigenden Produkte. Nachdem Sie die Strategie gespeichert haben, konfigurieren Sie ihre Regeln, Vorlagen und das Design.
  </Accordion>

  <Accordion title="Wie veröffentliche ich eine Empfehlungsstrategie auf meiner Website?">
    Klicken Sie auf **Recommendations** > **Recommendation strategy**. Klicken Sie dann auf Ihren Empfehlungsblock > **Copy code**, um das Snippet Ihres Blocks zu generieren. Fügen Sie es an der Stelle im Quellcode Ihrer Seite ein, an der der Block erscheinen soll.

    Alternativ können Sie die [Activation API](../../developer-docs/apis/activation-api-js/api-reference/api-reference#obtainrecommendedproducts) von Kameleoon verwenden, um Produktempfehlungen bereitzustellen. Die API verwendet die zuletzt gespeicherte Vorlagenversion und gibt ein JSON-Objekt zurück, das die empfohlenen Produkte und das HTML der Vorlage enthält. Die API-Antwort enthält kein CSS; Sie müssen das Styling manuell auf die Ausgabe anwenden.

    Fügen Sie bei der Implementierung des Codes Ihres Blocks den Parameter `data-recommender-code` (ID des Produktempfehlungsblocks) hinzu. Für Blöcke, die Algorithmen wie **Similar** und **They also buy this** verwenden, fügen Sie den Parameter `data-recommender-item` hinzu, um die ID des aktuellen Produkts anzugeben.
  </Accordion>

  <Accordion title="Warum ist die Anzahl der empfohlenen Produkte deutlich geringer als mein Gesamtproduktbestand?">
    Wenn Sie eine große Diskrepanz zwischen Ihrem Gesamtbestand und der Anzahl der für die Empfehlung durch die Algorithmen **Popular** oder **Trending** verfügbaren Produkte (gekennzeichnet als **Widgetable**-Produkte) bemerken, haben diese Algorithmen strenge Anforderungen an die Datenqualität.

    Damit ein Produkt widgetable und für Empfehlungen geeignet ist, müssen Sie alle vier kritischen Felder korrekt einrichten und importieren:

    * Preis
    * Name
    * URL
    * Bild (Bild-URL muss gültig und abrufbar sein)

    Wenn eines dieser wesentlichen Attribute fehlt oder falsch ist (zum Beispiel eine defekte Bild-URL), filtert Kameleoon das Produkt heraus, und es erscheint nicht in den Ergebnissen des Empfehlungsalgorithmus.

    **So beheben Sie fehlende Bilder**

    Ein häufiger Grund, warum ein Produkt nicht widgetable ist, besteht darin, dass Kameleoon das Bild während des Katalogsynchronisationsprozesses nicht herunterladen konnte.

    **Hauptgründe, warum Bilder nicht heruntergeladen werden können**

    Wenn Ihr Produkt eine gültige Bild-URL hat, aber dennoch kein Bild vorhanden ist, könnte die Serverkonfiguration Ihres Shops das Problem verursachen:

    * **Serverüberlastung:** Der Speicher oder Server Ihres Shops kann das hohe Anfragevolumen des Kameleoon-Systems nicht bewältigen. Das System lädt Bilder über **50 gleichzeitige** Threads herunter, was häufig zu Timeout-Fehlern führt.
    * **Sicherheitsblockierung:** Ihre Firewall oder Ihr Anti-DDoS-Schutz blockiert möglicherweise Anfragen basierend auf dem User Agent oder der IP-Adresse.
      * **User Agent:** Kameleoon lädt Bilder mit dem User Agent `Kameleoon Fetcher 2.0` herunter. Wenn Downloads fehlschlagen, erlauben Sie diesen User Agent in Ihren Servereinstellungen.
      * **IP-Adresse:** Setzen Sie alle Kameleoon-Cluster-IPs auf die Whitelist, um einen ununterbrochenen Zugriff zu gewährleisten. Sehen Sie sich die Liste der [IPs hier](./recommendations/import-your-product-catalog-feed#syncing-your-product-feed-using-an-xml-file) an.

    **So finden Sie problematische Produkte**

    Identifizieren Sie, welchen Produkten die erforderlichen Datenfelder fehlen, indem Sie auf Ihre **Products Database** zugreifen.

    1. Klicken Sie auf **Settings** > **Recommendations** > **Products** > **Data feed**.
    2. Wählen Sie **False** aus dem Dropdown-Menü **Widgetable**.
    3. Klicken Sie auf ein beliebiges Produkt, um seine Attribute anzuzeigen. Kameleoon hebt das Problem (zum Beispiel fehlender Preis oder fehlgeschlagener Bildabruf) in der Attributliste des Produkts hervor.

    **Erinnerung zum Algorithmus-Zeitfenster**

    Beachten Sie beim Fehlerbeheben der Ergebnisse, dass der Algorithmus **Trending** Empfehlungen ausschließlich basierend auf Verkaufsaufträgen innerhalb des von Ihnen ausgewählten Zeitfensters berechnet. Der Algorithmus schließt Verkäufe aus, die älter als diese Dauer sind.
  </Accordion>

  <Accordion title="Wie häufig wird der Produktdaten-Feed aktualisiert?">
    Passen Sie die Häufigkeit und den spezifischen Zeitpunkt der Aktualisierungen Ihres Produktdaten-Feeds in **Store settings** an.
  </Accordion>

  <Accordion title="Kann ich Produktempfehlungen in E-Mail-Kampagnen verwenden?">
    Nein. Derzeit unterstützen Produktempfehlungen nur die Kanäle **web** und **app**. Sie können dynamische Empfehlungs-Widgets nicht direkt an E-Mail-Vorlagen senden.
  </Accordion>

  <Accordion title="Gibt es einen Vorschaumodus für Empfehlungen?">
    Ja, Sie können Ihre Produktempfehlungen auf Ihrer Website mit dem **Widget Studio** in der Vorschau anzeigen und simulieren.

    Erstellen Sie dazu ein Widget, das Ihren Produktempfehlungsblock enthält, und [fügen Sie es Ihrem Experiment hinzu](./recommendations/use-a-product-recommendation-block-in-a-campaign#use-a-product-recommendation-block-in-an-experiment). Sobald es konfiguriert ist, verwenden Sie die [Simulationsfunktion](../assets/widgets/create-a-widget-with-the-widget-studio/simulate-your-widgets) im Widget Studio, um das Widget zu visualisieren. Die Simulation ermöglicht es Ihnen, sowohl das Design als auch die vom Algorithmus zurückgegebenen Produkte vor dem Start zu überprüfen.
  </Accordion>

  <Accordion title="Kann ich empfohlene Produkte sortieren?">
    Ja. Sie können Sortierkriterien auf die von einem Algorithmus zurückgegebenen Produkte anwenden. Sie können die angezeigten Ergebnisse beispielsweise nach höchstem Umsatz sortieren, um hochwertige Artikel zu priorisieren.
  </Accordion>

  <Accordion title="Kann ich reguläre Ausdrücke in Empfehlungsregeln verwenden?">
    Nein. Reguläre Ausdrücke (Regex) sind derzeit nicht verfügbar, um komplexe Abgleichslogik innerhalb von Empfehlungsregeln zu definieren.
  </Accordion>

  <Accordion title="Kann ich meinen eigenen Empfehlungsalgorithmus importieren?">
    Nein. Die Plattform unterstützt kein Bring Your Own Algorithm (BYOA). Verwenden Sie die Suite integrierter Algorithmen, die von Kameleoon bereitgestellt wird.
  </Accordion>

  <Accordion title="Gibt es eine Begrenzung für die Anzahl der Empfehlungen, die ich anzeigen kann?">
    Auch wenn Kameleoon keine strikte Begrenzung erzwingt, wirkt sich die Anforderung vieler Produkte auf die Algorithmusleistung aus und erhöht die Antwortzeiten. Zeigen Sie weniger als 50 Produkte pro Block an. Um größere Produktmengen anzuzeigen, verwenden Sie [Collections](./merchandising/activate-and-deploy-a-product-collection-on-your-website).
  </Accordion>

  <Accordion title="Funktionieren alle Algorithmen überall auf meiner Website?">
    Nein, einige Algorithmen funktionieren nur unter bestimmten Bedingungen. Beispielsweise funktionieren der Algorithmus **Similar** products, der Algorithmus **Products usually purchased with this item** und der Algorithmus **Store recommendations** nur auf Produktdetailseiten. Der Algorithmus **Products usually viewed with this product** funktioniert nur, wenn der Warenkorb Artikel enthält.
  </Accordion>

  <Accordion title="Kann ich aus Google Merchant importierte Produktgrößen in Liquid-Empfehlungsvorlagen verwenden?">
    Ja. Sie können die Produktgröße als HTML-Variable in Ihrer Vorlage verwenden, vorausgesetzt, die Größe erscheint als Parameter im Daten-Feed.
  </Accordion>

  <Accordion title="Kann ich einen benutzerdefinierten Feldnamen (wie `shop_recommend`) für den Store-Recommendations-Algorithmus verwenden?">
    Nein. Der Store-Recommendations-Algorithmus erfordert speziell das Feld `accessories` in Ihrem Daten-Feed. Er erkennt keine benutzerdefinierten Feldnamen für manuelle Produktbeziehungen.

    Um Produkte manuell zu verknüpfen (zum Beispiel, um ergänzende Artikel anzuzeigen), ordnen Sie die zugehörigen Produkt-IDs dem Feld `accessories` zu.

    Der Algorithmus zeigt nur die über das Tag `accessories` verknüpften Produkte an. Sie können diese Ergebnisse weiter einschränken, indem Sie Standardfilter auf den Empfehlungsblock anwenden (zum Beispiel, um nicht vorrätige Artikel aus der manuellen Liste auszuschließen).
  </Accordion>

  <Accordion title="Wie liefere ich Daten für den Empfehlungsalgorithmus 'Currently on wishlist'?">
    Um den Algorithmus **Currently on wishlist** zu verwenden, verfolgen Sie explizit, wenn ein Benutzer einen Artikel zu seiner Wunschliste hinzufügt. Die Empfehlungs-Engine erkennt diese Interaktionen nicht automatisch ohne ein bestimmtes API-Signal.

    Implementieren Sie die [Methode `trackAddToWishList()` aus der Activation API](../../developer-docs/apis/activation-api-js/api-reference/api-reference#trackaddtowishlist). Diese Methode sendet die erforderlichen Ereignisdaten an Kameleoon, das den Wunschlisten-Algorithmus speist.
  </Accordion>

  <Accordion title="Welche Attribute kann ich aus Google Merchant Center im Vergleich zu Kameleoon XML importieren?">
    Welche Attribute unterstützt werden, hängt von Ihrem Feed-Format ab. Beachten Sie die folgenden Einschränkungen bezüglich Labels und Bestandsdaten:

    **Benutzerdefinierte Labels (`custom_label_0` - `custom_label_4`)**

    * **Nicht unterstützt**.
    * Das Empfehlungsmodul importiert keine `custom_label`-Attribute aus Google Merchant Center-Feeds. Sie können diese Felder nicht zum Filtern oder zur Anzeige verwenden.

    **Bestandsmenge (`stockquantity`)**

    * **Google Merchant Feeds:** **Nicht unterstützt**. Die Google-Produktdaten-Spezifikation enthält keinen numerischen Lagerbestand (nur den Status "availability"). Daher können Sie keine exakten Bestandszahlen über Google CSV/XML importieren.
    * **Kameleoon XML:** **Unterstützt**. Um exakte Bestandsmengen zu verwenden, nutzen Sie das native Kameleoon-XML-Format und befüllen Sie das Feld `stockquantity`.
    * **Bestandsdaten anzeigen und nutzen:** Wenn Sie Bestandsdaten über Kameleoon XML importieren, erscheinen die Werte in der Übersicht **Data feed**. Verwenden Sie das Attribut `stockquantity`, um Filter zu erstellen (zum Beispiel `stockquantity > 5`).
  </Accordion>

  <Accordion title="Wie entscheide ich zwischen XML-Import und API-Import für meinen Katalog?">
    Treffen Sie Ihre Entscheidung basierend auf Ihrer Kataloggröße und technischen Infrastruktur. Verwenden Sie die Methode **XML import**, wenn Ihr Katalog weniger als 50.000 Produkte enthält und Sie keinen Data Layer auf der Website haben. Umgekehrt [verwenden Sie die **Product Recommendation API**](../../developer-docs/apis/product-recommendation-api-rest/tutorials/import-a-product-catalog-into-kameleoon-using-the-product-recommendation-api), wenn Ihr Katalog mehr als 50.000 Produkte enthält.
  </Accordion>
</AccordionGroup>