> 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/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/datenfelder.md).

# Datenfelder

Legen Sie fest, welche Produktdaten InsightSearch erhält und welche davon Filter, Regeln und Ähnlichkeit nutzen dürfen.

Datenfelder sind die Produktinformationen, die InsightSearch von Ihrem Shop bekommt: Name, Preis, Marke, Kategorien, aber auch Eigenschaften wie Farbe oder Größe und Ihre eigenen Zusatzfelder. Nur Felder, die übertragen und aktiv sind, können Sie später in Filtern, im Regel-Baukasten und bei der Gewichtung verwenden. Diese Seite brauchen Sie, wenn Ihnen in einer Vorlage ein Feld fehlt, ein Filter nicht so greift wie erwartet oder Sie Etiketten (Badges) auf den Produktkarten zeigen möchten.

Es gibt zwei Stellen, die zusammengehören:

| Stelle                                    | Frage, die sie beantwortet                                                       |
| ----------------------------------------- | -------------------------------------------------------------------------------- |
| Bereich „Datenfelder“ im Plugin-Dashboard | Welche Felder kennt InsightSearch, welche sind aktiv, und welchen Typ haben sie? |
| „Datenfelder bearbeiten“                  | Welche Daten schickt Ihr Shop überhaupt an InsightSearch?                        |

## Der Bereich „Datenfelder“

Sie öffnen ihn über **Inhalte → KI-gestütztes Cross-Selling** und in der Seitenleiste **Produkte & Daten → Datenfelder**.

1. Wählen Sie oben unter „Datenquelle“ den Produkt-Feed bzw. die Datenquelle, deren Felder Sie sehen möchten.
2. Die Liste zeigt alle Felder dieser Quelle. Über „Suchen“ finden Sie ein Feld nach Name oder Typ, darüber steht ein Zähler wie „12 von 30 Feldern aktiv“.
3. Mit den Auswahl-Knöpfen „Alle“, „Aktiv“, „Inaktiv“, „In Vorlagen genutzt“ und „Typ prüfen“ grenzen Sie die Liste ein.
4. „Liste aktualisieren“ lädt die Felder neu.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-4fc6f552150cc13a3807e8b342ab9820543257c1%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-datenfelder.png?alt=media" alt="Bereich Datenfelder mit den Feldgruppen"><figcaption></figcaption></figure>

### Gruppen

| Gruppe                           | Inhalt                                                                                           |
| -------------------------------- | ------------------------------------------------------------------------------------------------ |
| „Grundfelder“                    | Name, Preis, Marke, Kategorien, Lieferbarkeit. Diese Felder liefert jeder Feed und jeder Push.   |
| „Eigenschaften und Zusatzfelder“ | Eigenschaften (Farbe, Größe …) und Zusatzfelder Ihres Shops. Gut geeignet für Filter und Regeln. |
| „KI-Felder“                      | Felder, die InsightSearch selbst erzeugt, zum Beispiel Produkttyp oder Bildmerkmale.             |

Jede Zeile zeigt „Feld“, „Typ“, „Genutzt in“ (wie viele Vorlagen das Feld verwenden) und den Schalter „Aktiv“. KI-Felder können Sie nicht abschalten: „KI-Felder verwaltet InsightSearch automatisch.“

### Feldtypen

Der Typ entscheidet, welche Bedingungen der Regel-Baukasten für ein Feld anbietet.

| Typ                   | Geeignet für                                                                        |
| --------------------- | ----------------------------------------------------------------------------------- |
| „Auswahlwert (exakt)“ | Bedingungen wie „ist gleich“ oder „ist eines von“, zum Beispiel Farbe oder Material |
| „Text“                | Teiltreffer in längeren Texten                                                      |
| „Zahl“                | „mindestens“ oder „höchstens“, zum Beispiel Füllmenge oder Leistung                 |
| „Ja/Nein“             | Schalter, zum Beispiel „Als Topseller markiert“                                     |
| „Datum“               | Zeiträume                                                                           |

Ist ein Typ falsch erkannt, öffnen Sie das Menü der Zeile und wählen „Typ ändern“. Im Fenster „Datenattribut-Typ ändern“ sehen Sie das Feld „Aktueller Typ“ und wählen unter „Neuer Typ“ den richtigen aus. Danach lesen Sie die Produktdaten neu ein, sonst wirkt die Änderung nicht.

{% hint style="info" %}
Die Markierung „Typ prüfen“ weist auf einen wahrscheinlichen Fehler hin: Der Name lässt eine Zahl erwarten, das Feld ist aber als Ja/Nein gespeichert. Ein Filter wie „mindestens 20“ funktioniert dann nicht. Stellen Sie den Typ auf „Zahl“ und lesen Sie neu ein.
{% endhint %}

### Felder abschalten

Mit dem Schalter „Aktiv“ nehmen Sie ein Feld aus Filtern, Regeln und Ähnlichkeit heraus. Wird das Feld noch in einer Vorlage genutzt, fragt das Plugin nach („Feld wird in Vorlagen genutzt“) und listet die betroffenen Vorlagen auf. Bestätigen Sie mit „Trotzdem abschalten“, fallen die Regeln und Booster mit diesem Feld bei der Berechnung weg.

Nach jeder Änderung erscheint der Hinweis „Du hast Felder geändert. Damit die Änderung wirkt, die Produktdaten einmal neu einlesen.“ Klicken Sie dann auf „Produktdaten neu einlesen“. Bis dahin steht bei betroffenen Feldern „Wartet auf Neuindexierung“.

## „Datenfelder bearbeiten“: was Ihr Shop überträgt

Hier legen Sie fest, welche Produktdaten InsightSearch für Empfehlungen bekommt. Sie öffnen den Editor mit dem Knopf „Datenfelder bearbeiten“ im Bereich „Datenfelder“ oder im Bereich „Quellen“.

Der Editor steht nur für Datenquellen zur Verfügung, die Ihr Shop selbst erzeugt: den Produkt-Feed aus einem Shopware-Verkaufskanal vom Typ Produktvergleich (der Standard im Livebetrieb) oder den Push (gedacht für Entwicklungs- und Stage-Umgebungen). Bei einem externen Feed steht: „Diese Quelle ist ein externer Feed. Ihre Felder lassen sich hier nicht bearbeiten.“

### Welche Produkte übertragen werden

Beim Produkt-Feed bestimmt eine dynamische Produktgruppe, welche Produkte übertragen werden. Der Knopf „Produkt-Stream öffnen“ führt direkt dorthin. Ist keine Gruppe zugeordnet, werden alle Produkte des Verkaufskanals übertragen.

### Aufbau

| Gruppe                   | Inhalt                                                                                       |
| ------------------------ | -------------------------------------------------------------------------------------------- |
| „Pflichtfelder“          | Ohne diese Felder kann InsightSearch keine Empfehlungen berechnen.                           |
| „Produktdaten“           | Standardfelder aus Shopware wie Name, Beschreibung, Marke oder Maße.                         |
| „Eigenschaften“          | Eigenschaftsgruppen wie Farbe oder Größe.                                                    |
| „Zusatzfelder“           | Die eigenen Zusatzfelder Ihres Shops.                                                        |
| „Felder anderer Plugins“ | Von Plugins angelegte Zusatzfelder, zunächst zugeklappt. Für Empfehlungen meist ohne Nutzen. |

Je Feld sehen Sie:

| Spalte   | Bedeutung                                                                                                                                                           |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| „Feld“   | Name des Feldes im Index. Unter diesem Namen erscheint es in Filtern und im Regel-Baukasten.                                                                        |
| „Aktiv“  | Ob das Feld beim Export bzw. Push mitgesendet wird.                                                                                                                 |
| „Quelle“ | Woher der Wert kommt: „Produkt“, „Zusatzfeld“, „Eigenschaft“ oder „Fester Wert“.                                                                                    |
| „Wert“   | Welches Feld der gewählten Quelle genutzt wird, zum Beispiel die Eigenschaftsgruppe „Farbe“. „Automatisch (vom System bestimmt)“ heißt, InsightSearch wählt selbst. |

Plaketten zeigen „Pflichtfeld“ und „Empfohlen“. Felder mit Schloss gibt InsightSearch fest vor („Fest vorgegeben: InsightSearch braucht dieses Feld so.“). Mit Suche und den Auswahl-Knöpfen „Alle“, „Aktiv“, „Inaktiv“, „Pflichtfelder“, „Empfohlen“ finden Sie Felder schneller.

Ein weiteres Feld legen Sie mit „Benutzerdefiniertes Feld hinzufügen“ an.

### Badges auf den Produktkarten

Ein Badge ist das kleine Etikett auf der Produktkarte, zum Beispiel „Sale“ in Rot. Im Badge-Feld legen Sie mit „Badge-Regel hinzufügen“ eine oder mehrere Regeln an:

* „Text aus“ und „Textfeld“: woher der Text kommt.
* „Farbe aus“ und „Farbe / Farbfeld“: woher die Farbe kommt, oder „Feste Farbe“ mit Farbwähler.
* „Entfernen“ löscht eine Regel.

Ob Badges im Shop erscheinen, steuern Sie zusätzlich je Ausspielort mit „Badges anzeigen“.

### Speichern und testen

* „Export testen“ (nur beim Produkt-Feed) prüft, ob der Shopware-Produktexport mit diesen Einstellungen fehlerfrei erzeugt werden kann.
* „Speichern“ (beim Push „Feldeinstellungen speichern“) übernimmt die Einstellungen.
* Danach erscheint „Gespeichert. Damit InsightSearch die neuen Felder kennt, die Produktdaten einmal neu einlesen.“ mit dem Knopf „Jetzt neu einlesen“.
* Wird Ihr Export per geplanter Aufgabe erzeugt, setzt „Neu einlesen“ ihn zurück und startet das Einlesen automatisch, sobald der neue Export fertig ist.
* Verlassen Sie die Seite mit ungespeicherten Änderungen, fragt das Plugin nach („Weiter bearbeiten“ oder „Verwerfen und verlassen“).

{% hint style="warning" %}
Änderungen wirken sich direkt auf die Daten aus, die an InsightSearch gehen. Prüfen Sie bei eigenen Zuordnungen, ob Quelle und Wert passen. Sonst fehlen Daten in den Empfehlungen.
{% endhint %}

## Ablauf: ein neues Feld in einer Regel nutzen

Ein Beispiel: Sie möchten nur Produkte einer bestimmten Materialgruppe empfehlen, die in einem Zusatzfeld gepflegt ist.

1. Öffnen Sie **Produkte & Daten → Datenfelder**, wählen Sie die Datenquelle und klicken Sie auf „Datenfelder bearbeiten“.
2. Suchen Sie das Zusatzfeld in der Gruppe „Zusatzfelder“ und schalten Sie „Aktiv“ ein.
3. Speichern Sie und klicken Sie auf „Jetzt neu einlesen“.
4. Wenn das Einlesen fertig ist, prüfen Sie im Bereich „Datenfelder“, ob das Feld aktiv ist und den passenden Typ hat.
5. Nutzen Sie das Feld in der Empfehlungs-Vorlage im Regel-Baukasten.

{% hint style="info" %}
Regeln im Regel-Baukasten schränken die Auswahl ein, sie bevorzugen nicht. Wenn Sie bestimmte Produkte gezielt platzieren möchten, nutzen Sie in der Vorlage „Feste Produkte“.
{% endhint %}

## Berechtigungen

Zum Ändern von Datenfeldern, Feldtypen und zum Neu-Einlesen braucht ein Admin-Benutzer in Shopware das Recht „Systemkonfiguration bearbeiten“.

## Weiterlesen

{% content-ref url="/pages/QgU30LU0ZaCBRpIydy5p" %}
[Filter und Regel-Baukasten](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/filter-und-regeln.md)
{% endcontent-ref %}

{% content-ref url="/pages/kmAEtVd6SYzhWwzFcHfH" %}
[Gewichtung, Vielfalt und Booster](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/gewichtung-und-booster.md)
{% endcontent-ref %}

{% content-ref url="/pages/MlUopJ21I4c96ZRDSIZ5" %}
[Das Plugin-Dashboard](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/plugin-dashboard.md)
{% endcontent-ref %}

{% content-ref url="/pages/6k1qZUWCUdvgoVMAXycx" %}
[Wann wirkt eine Änderung?](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/wann-wirkt-eine-aenderung.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/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/datenfelder.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.
