> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenattribute.md).

# Datenattribute

Felder der Suche ein- und ausschalten, ihren Typ prüfen und festlegen, wie stark sie für die Reihenfolge der Treffer zählen.

Im Bereich **Datenattribute** sehen Sie, welche Produktfelder die Suche kennt und wie stark jedes Feld für die Reihenfolge der Treffer zählt. Hier schalten Sie einzelne Felder ab oder korrigieren ihren Typ. Nur aktive Felder stehen anschließend im Bereich „Filter“ zur Verfügung.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-a40f8b15b39b6ea9f326fb11bbd81047a3213e80%2Fsuche-intelligent-und-ki-optimiert-datenattribute.png?alt=media" alt="Bereich Datenattribute mit Filtern, Grundfeldern, Typ, Gewichtung und Aktiv-Schalter je Feld"><figcaption></figcaption></figure>

Neue Felder aus Ihrem Shop legen Sie unter „Datenfelder bearbeiten“ an. Nach dem nächsten „Produktdaten neu einlesen“ erscheinen sie hier.

## Aufbau

Oben wählen Sie die **Datenquelle**. Die erste ist vorgewählt. Daneben stehen „Datenfelder bearbeiten“ (bei einem externen Feed stattdessen der Hinweis, dass sich dessen Felder hier nicht bearbeiten lassen) und „Liste aktualisieren“. Ist die Quelle noch leer, steht dort „Für diese Datenquelle wurden noch keine Datenattribute gefunden.“

### Suche, Zähler und Filter-Knöpfe

* Im Suchfeld „Suchen“ finden Sie Felder nach technischem Namen, lesbarem Namen oder Typ.
* Der Zähler zeigt, wie viele Felder aktiv sind, zum Beispiel „18 von 25 Feldern aktiv“.
* Die Filter-Knöpfe zeigen jeweils die Anzahl: „Alle“, „Aktiv“, „Inaktiv“, „Suchgewichtung gesetzt“ und „Typ prüfen“. Knöpfe ohne Treffer blenden sich aus.
* Passt nichts, steht dort „Keine Felder passen zu Suche und Filter.“

{% content-ref url="/pages/OmNGCvlIfQV60CzrLwrX" %}
[Datenfelder bearbeiten](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feed-template-editor.md)
{% endcontent-ref %}

### Gruppen

Die Felder stehen in aufklappbaren Gruppen mit einem Zähler wie „12 von 15 aktiv“. Während Sie suchen oder filtern, sind alle Gruppen aufgeklappt.

| Gruppe                         | Inhalt                                                                                                |
| ------------------------------ | ----------------------------------------------------------------------------------------------------- |
| Grundfelder                    | Name, Preis, Marke, Kategorien, Lieferbarkeit. Diese Felder liefert jeder Feed bzw. Push.             |
| Eigenschaften und Zusatzfelder | Eigenschaften wie Farbe oder Größe und Zusatzfelder Ihres Shops, ideal für Filter und Suchgewichtung. |
| KI-Felder                      | Von InsightSearch erzeugt, zum Beispiel Produkttyp oder Bildmerkmale.                                 |

### Spalten

Jede Zeile zeigt den lesbaren Namen (fett) mit dem technischen Schlüssel darunter, den **Typ**, die **Gewichtung**, den Schalter **Aktiv** und ein Aktionsmenü (…). Inaktive Zeilen sind abgeblendet. Der Aktiv-Schalter wirkt sofort und meldet „Attribut wurde aktiviert.“ oder „Attribut wurde deaktiviert.“ Mit dem Info-Symbol neben „Typ“ und „Gewichtung“ lesen Sie eine Kurzhilfe.

## Das Aktionsmenü

Im Menü (…) jeder Zeile finden Sie:

1. **Suchgewichtung bearbeiten** (nur mit Zusatzkauf, siehe unten)
2. **Typ ändern**
3. **Deaktivieren** bzw. **Aktivieren**

## Suchgewichtung bearbeiten

Die Suchgewichtung legt fest, wie stark Treffer in einem Feld zählen. Je höher die Zahl, desto weiter oben stehen Treffer in diesem Feld. Zum Beispiel soll ein Treffer im Feld „Marke“ stärker zählen als ein Treffer in der Beschreibung.

Der Dialog „Datenattribut bearbeiten“ zeigt „Feldname“ und „Typ“ nur zum Lesen. Im Feld „Suchgewichtung“ tragen Sie eine ganze Zahl ab 0 ein. Eine Obergrenze gibt es in der Oberfläche nicht. Mit „Speichern“ übernehmen Sie die Änderung („Das Datenattribut wurde aktualisiert.“).

{% hint style="info" %}
**Zusatzkauf „Individuelle Suchgewichtung“:** Ohne diesen Zusatzkauf nutzt die Suche eine Standardgewichtung für alle Felder. Die Aktion „Suchgewichtung bearbeiten (Zusatzfunktion)“ ist dann ausgegraut, und oben erscheint ein Banner mit dem Knopf „Mehr Details“. Er öffnet den Kaufdialog der Erweiterung in Shopware.
{% endhint %}

## Typ ändern

Der Typ bestimmt, wie die Suche ein Feld behandelt. Im Dialog „Datenattribut-Typ ändern“ sehen Sie den „Aktuellen Typ“ und wählen den „Neuen Typ“. „Speichern“ ist erst aktiv, wenn Sie den Typ geändert haben.

| Typ in der Auswahl                        | Wofür                                        | Beispiel       |
| ----------------------------------------- | -------------------------------------------- | -------------- |
| Text (text)                               | Volltextsuche mit Teiltreffern.              | Beschreibung   |
| Auswahlwert (exakt) (keyword)             | Exakter Wert, für Filter mit festen Werten.  | Marke, Farbe   |
| Zahl (integer), Zahl (long), Zahl (float) | Zahlen für Bereichsfilter wie Schieberegler. | Preis, Gewicht |
| Ja/Nein (boolean)                         | Schalter.                                    |                |
| Datum (date)                              | Zeiträume.                                   |                |

Bei den Zahlen gibt es drei Einträge für verschiedene Zahlenarten. „Zahl (float)“ steht üblicherweise für Dezimalzahlen, „Zahl (integer)“ und „Zahl (long)“ für ganze Zahlen.

Nach dem Speichern erscheint „Typ wurde gespeichert.“ mit dem Hinweis, die Produktdaten neu einzulesen.

### Markierung „Typ prüfen“

Ein gelbes Label „Typ prüfen“ erscheint, wenn ein Feld als Ja/Nein geführt wird, sein Name aber eine Zahl erwarten lässt, zum Beispiel bei „Preis“, „Gewicht“, „Breite“, „Menge“ oder „Anzahl“. Dann funktionieren Bereichsfilter wie „ab 20“ nicht. Ändern Sie den Typ auf eine Zahl und lesen Sie die Produktdaten neu ein. Mit dem Filter-Knopf „Typ prüfen“ sehen Sie alle betroffenen Felder auf einmal.

## Wann wirken Änderungen?

Änderungen an Aktiv-Status, Typ und Suchgewichtung wirken erst, nachdem Sie die Produktdaten neu eingelesen haben. Nach einer Änderung erscheint der Hinweis „Du hast Felder geändert. Damit die Änderung wirkt, die Produktdaten einmal neu einlesen.“ mit dem Knopf „Produktdaten neu einlesen“, der das Einlesen der gewählten Quelle direkt startet.

{% hint style="warning" %}
Nur aktive Felder stehen anschließend im Bereich „Filter“ als Filter-Attribut zur Verfügung. Fehlt dort ein Feld, aktivieren Sie es hier und lesen Sie die Produktdaten neu ein.
{% endhint %}

## Weiterlesen

{% content-ref url="/pages/OmNGCvlIfQV60CzrLwrX" %}
[Datenfelder bearbeiten](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feed-template-editor.md)
{% endcontent-ref %}

{% content-ref url="/pages/vHbSYnjIL0wgwKxanyHw" %}
[Filter](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/filter.md)
{% endcontent-ref %}

{% content-ref url="/pages/dJoO5DWs6VHjJlMD4xiD" %}
[Quellen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/indizes.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenattribute.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
