> For the complete documentation index, see [llms.txt](https://docs.fact-finder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fact-finder.com/integration/de/suggest-integration/suggest-integration-best-practices.md).

# Bewährte Vorgehensweisen für die Suggest-Integration

## Zusammenfassung

Dieser Artikel beschreibt praktische Empfehlungen für die Integration des FactFinder Suggest-Moduls. Diese Best Practices helfen Benutzern, Produkte schneller zu finden und ein reibungsloseres Sucherlebnis zu schaffen.

Dies sind allgemeine Richtlinien. Verwenden Sie die, die am besten zu Ihrem Shop und Ihrem Produktbereich passen.

## Verbesserung von Benutzererlebnis und Benutzerfreundlichkeit

Das Hauptziel von Suggest ist es, die Suche einfacher und schneller zu machen. Konzentrieren Sie sich auf eine intuitive Interaktion:

* **Unterstützen Sie mehrere Auswahlmethoden** — Ermöglichen Sie Kunden, Vorschläge sowohl mit der Maus als auch mit der Tastatur auszuwählen. Das verbessert die Barrierefreiheit und unterstützt unterschiedliche Browsing-Stile.
* **Die aktuelle Auswahl deutlich hervorheben** — Machen Sie den fokussierten Vorschlag visuell eindeutig, zum Beispiel mit einem kontrastreichen Hintergrund oder fetter Schrift. So erhalten Benutzer beim Navigieren durch die Liste ein klares Feedback.
* **Den passenden Teil des Begriffs hervorheben** — Heben Sie die Zeichen oder Wörter hervor, die mit dem übereinstimmen, was der Benutzer bereits eingegeben hat. Dadurch wirkt der Vorschlag relevanter und lässt sich leichter überblicken.
* **Autocomplete für den obersten Vorschlag anbieten** — Erwägen Sie, das Suchfeld automatisch mit dem relevantesten Vorschlag zu vervollständigen. Benutzer können ihn dann schnell mit `Tab` oder `Enter`.

## Optimierung von visuellem Design und Layout

Eine nahtlose Integration in das bestehende Shop-Design ist entscheidend für einen professionellen Eindruck:

* **Ein einheitliches Farbschema beibehalten** — Das Suggest-Dropdown sollte zur gesamten Farbpalette und zum Branding Ihres Shops passen. Konsistenz sorgt dafür, dass die Erfahrung ausgefeilter und vertrauenswürdiger wirkt.
* **Das Dropdown eng am Suchfeld ausrichten** — Halten Sie den visuellen Abstand zwischen dem Suchfeld und der Vorschlagsliste so klein wie möglich. Die Liste sollte sich wie eine natürliche Erweiterung des Suchfelds anfühlen.

## Funktionsverbesserungen und Verhalten nutzen

* **Vorschaubilder sinnvoll einsetzen** — Wenn Produktbilder auch in kleiner Größe klar erkennbar bleiben, können Vorschaubilder in der Vorschlagsliste die Wiedererkennung verbessern. In der Regel wird das erste Produktbild verwendet, das dem Suchbegriff zugeordnet ist. Bei Markenvorschlägen können auch Markenlogos gut funktionieren.

  Bilder vergrößern die Gesamtgröße des Vorschlags-Dropdowns und können dadurch die Anzahl der sichtbaren Vorschläge verringern. Finden Sie ein Gleichgewicht zwischen visueller Attraktivität und Informationsdichte.
* **Nicht-Produktvorschläge einbeziehen, wenn sie sinnvoll sind** — FactFinder [Campaign Manager](/integration/de/campaign-specific-integration.md) kann Benutzer zu relevanten Inhaltsseiten wie AGB, Rechtsseiten, Kaufratgebern oder Katalogseiten weiterleiten. Wenn diese Begriffe als Vorschläge erscheinen sollen, fügen Sie sie über die entsprechende Whitelist hinzu.
* **Direkte Navigation für bestimmte Vorschlagstypen verwenden** — Standardmäßig führt die Auswahl eines Vorschlags zu einer Suche nach diesem Begriff. Wenn sich ein Vorschlag eindeutig auf ein bestimmtes Produkt bezieht, sollten Sie direkt auf die Produktdetailseite verlinken. Bei Marken- oder Kategorievorschlägen verlinken Sie auf die passende Landingpage oder eine vorgefilterte Ergebnisseite. Diese Verhaltensweisen sind in FactFinder-Antwortvorlagen oft konfigurierbar. Bei individuellen Implementierungen wenden Sie sich an Ihren FactFinder-Kontakt.

## Leistung priorisieren

* **Auf eine schnelle Anzeige der Vorschläge abzielen** — Vorschläge sollten fast sofort erscheinen, während der Benutzer tippt. Verzögerungen verringern den Nutzen der Funktion und können Benutzer frustrieren.
* **Die Vorschlagsliste fokussiert halten** — Vermeiden Sie, Benutzer mit einer langen Liste zu überfordern. Zeigen Sie eine kompakte Menge relevanter Vorschläge, etwa 5 bis 10 Einträge, und priorisieren Sie die wahrscheinlichsten Treffer.

## Visuelle Beispiele für die Implementierung von Suggest

![suggest\_intergation\_example1](/files/01a404ed097db8f3a21e0700322d2e87d25de86a) ![suggest\_intergation\_example2](/files/f786ca010e450c75543d7fed20211ba5bda0926a)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fact-finder.com/integration/de/suggest-integration/suggest-integration-best-practices.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
