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

# Vault-Mapping

> Zuordnung von Merkmalen, Attributen, Variationen und Funktionsattributen zu den Vaults der API

## Allgemeine Beschreibung

Zuordnung von Merkmalen, Attributen, Variationen und Funktionsattributen zu den Vaults `properties`, `attributes` und `similarity` der API. Ein Key darf in mehreren Vaults landen.

## Kategorie & Meta

Welche Haupt-Kategorie im `category`-Feld der API landet, und ob Kategorien/Warengruppe zusätzlich als virtuelle Properties gepusht werden.

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>
    <img src="https://mintcdn.com/dzm/HXyitjfAiy0u1yWt/images/panderra-ai-vault-mapping-kategorie-meta.png?fit=max&auto=format&n=HXyitjfAiy0u1yWt&q=85&s=9cf09c2b25c63ba15c6b9c48eea8fe50" alt="Kategorie & Meta" width="2026" height="816" data-path="images/panderra-ai-vault-mapping-kategorie-meta.png" />
  </Frame>
</div>

<ParamField path="Hauptkategorie-Strategie" type="select">
  Woher der Wert im `category`-Feld kommt.

  **Optionen:**

  * **Erste Kategorie des Artikels**
  * **Warengruppe (twarengruppe)**
  * **Aus Attribut (AttributeAssoc)**
</ParamField>

<ParamField path="Fallback auf erste Kategorie" type="boolean">
  Falls Warengruppe/Attribut keinen Wert hat, auf die erste zugeordnete Kategorie des Artikels zurückfallen.
</ParamField>

<ParamField path="Kategoriepfad" type="boolean">
  Bei Strategie "Erste Kategorie" (oder Fallback darauf) den ganzen Pfad "A {'>'} B {'>'} C" übergeben. Aus: nur Blatt-Kategorie ("C").
</ParamField>

<ParamField path="Kategorien als Property" type="boolean">
  Fügt alle Kategorien des Artikels als `properties["Kategorien"] = [Namen]` hinzu (ohne Pfade).
</ParamField>

<ParamField path="Warengruppe als Property" type="boolean">
  Fügt die Warengruppe als `properties["Warengruppe"] = cName` hinzu (immer in der Shop-Standardsprache).
</ParamField>

<ParamField path="Lauf-Abschluss an Panderra melden" type="boolean">
  Meldet nach jedem Sync-Lauf eine Zusammenfassung (geprüft, gepusht, übersprungen, fehlgeschlagen, Zeitraum). Beantwortet dort die Frage "ist mein Sortiment aktuell?", ohne für jeden Artikel ein Lebenszeichen zu senden.

  <Note>
    Die Meldung geht an die im Feed hinterlegte API-URL. Prüfe vor dem Aktivieren, auf welches System der Feed zeigt.
  </Note>
</ParamField>

<ParamField path="Funktionsattribute in den Rohdaten mitschicken" type="boolean">
  Funktionsattribute sind Steuerfelder aus Wawi, Logistik und SEO (`gpsr_*`, `POS:*`, Dropshipping, noindex), keine Sachmerkmale. Sie gehen nur in die Rohdaten, nie in die Suche.

  <Note>
    Standardmäßig aus, weil sie in großen Shops die Rohdatenmenge etwa verdoppeln, ohne etwas über das Produkt auszusagen.
  </Note>
</ParamField>

## properties-Vault

Diskrete Werte (Farbe: Schwarz, Spannung: 18V). Gut für Filter-Queries wie "Akkuschrauber 18V".

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>
    <img src="https://mintcdn.com/dzm/HXyitjfAiy0u1yWt/images/panderra-ai-vault-mapping-properties.png?fit=max&auto=format&n=HXyitjfAiy0u1yWt&q=85&s=10818592f7c36e43175c0405de11800e" alt="properties-Vault" width="2014" height="268" data-path="images/panderra-ai-vault-mapping-properties.png" />
  </Frame>
</div>

<ParamField path="Zugeordnete Keys" type="select">
  Mehrfachauswahl aus Merkmalen, Variationen, Attributen und Funktionsattributen. Keys dürfen auch im attributes-Vault landen.
</ParamField>

## attributes-Vault

Freitext/beschreibender Kontext. Fließt in den Attribut-Embedding-Vektor ein.

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>
    <img src="https://mintcdn.com/dzm/HXyitjfAiy0u1yWt/images/panderra-ai-vault-mapping-attributes.png?fit=max&auto=format&n=HXyitjfAiy0u1yWt&q=85&s=fa284e5c70e0009034b91f0ba7cf2666" alt="attributes-Vault" width="2028" height="276" data-path="images/panderra-ai-vault-mapping-attributes.png" />
  </Frame>
</div>

<ParamField path="Zugeordnete Keys" type="select">
  Typischerweise Attribute und Funktionsattribute mit beschreibendem Inhalt.
</ParamField>

## similarity-Vault

Wird als flacher String `"key:value;key:value;..."` an `similarity_text` gesendet. Mehrfachwerte erzeugen mehrere Einträge mit gleichem Key, sentence-transformers tokenisieren jedes Paar als eigenes Cluster-Match-Token.

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>
    <img src="https://mintcdn.com/dzm/HXyitjfAiy0u1yWt/images/panderra-ai-vault-mapping-similarity.png?fit=max&auto=format&n=HXyitjfAiy0u1yWt&q=85&s=98f4a5a5523f7b006e7429c9f9b30370" alt="similarity-Vault" width="2024" height="304" data-path="images/panderra-ai-vault-mapping-similarity.png" />
  </Frame>
</div>

<ParamField path="Zugeordnete Keys" type="select">
  Mehrfachauswahl aus Merkmalen, Variationen, Attributen und Funktionsattributen. Werte werden konkateniert und gehen in das Embedding für ähnliche Produkte.
</ParamField>

<div style={{height: '1px', backgroundColor: 'silver', margin: '24px 0'}} />