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

# Märkte und Länder

> Lege Märkte für Länder und Sprachen an, ordne ihnen Länder zu, ergänze Übersetzungen und lege fest, welcher Markt in einem Gespräch gilt.

Mit einem Markt bietest du Besuchern aus einem oder mehreren Ländern die passenden Produkte und Preise an. Jeder Markt hat einen eigenen Produktfeed, eine eigene Währung, Verfügbarkeit und Produktlinks. Ergänze [Übersetzungen](#translations), wenn du dieselben Produkte und Preise in einer weiteren Sprache brauchst.

Ein typischer Katalog sieht zum Beispiel so aus:

| Markt | Länder | Sprache | Währung |
| - | - | - | - |
| Deutschland | DE + alle übrigen Länder (**Standardmarkt des Katalogs**) | Deutsch | EUR |
| Österreich | AT | Deutsch | EUR |
| Schweiz | CH | Deutsch + Französisch als Übersetzung | CHF |

Jeder dieser Märkte liest seinen eigenen Produktfeed, auch wenn sich zwei Märkte nur in Preisen oder Währung unterscheiden.

## Einen Markt hinzufügen

**1. Märkte öffnen**

Öffne den Katalog, geh zu **Märkte** und wähle **Markt hinzufügen**.

**2. Produktfeed laden**

Gib in der Karte **Produktfeed des Markts** die URL des Produktfeeds an und wähle **Produktfeed laden**, wie in [Produktfeed und Feldzuordnung](https://docs.yourhomie.ai/de/user-guide/knowledge/catalog/field-mapping.md) beschrieben.

**3. Markt festlegen**

In der Karte **Markt** gibst du unter **Name** an, wie der Markt in Listen heißt, zum Beispiel „Deutschland“ oder „Schweiz“. Prüfe die **Sprache der Produkttexte**, wähle unter **Länder** die Länder, die der Markt bedient, und prüfe die **Währung**. Länder sind optional: Ein Markt ohne Länder wird nur genutzt, wenn er der Standardmarkt des Katalogs ist.

**4. Spalten zuordnen und Markt anlegen**

Ordne die Spalten des Produktfeeds zu, lege unter **Automatischer Import** fest, wie oft der Markt importiert wird, und wähle **Markt anlegen**.

Die Sprache eines Markts ist die **Sprache der Produkttexte** seines Produktfeeds. Weitere Sprachen ergänzt du als [Übersetzungen](#translations), auf Wunsch mit eigenen Produktlinks in der Sprache. Einen eigenen Markt brauchst du für eine Sprache nur, wenn sie eigene Preise, ein eigenes Sortiment oder eine eigene Verfügbarkeit hat, etwa ein eigener Shop unter `shop.at/en`.

## Länder zuordnen

Auf der Seite **Märkte** siehst du jeden Markt mit **Länder**, **Sprache**, **Währung**, **Produktschlüssel**, der Zahl seiner **Produkte** und seinem **Status**. Ein Klick auf eine Zeile öffnet den Markt.

Die letzte Zeile **Alle übrigen Länder** zeigt mit einem Pfeil, welchen Markt alle übrigen Länder bekommen, zum Beispiel „Alle übrigen Länder → Deutschland (Standardmarkt)“. Sie erscheint, solange Besucher aus Ländern ohne eigenen Markt die Produkte des Standardmarkts sehen. Sehen diese Besucher keine Produkte, fehlt die Zeile, und beim Standardmarkt steht in der Spalte **Länder** stattdessen **Gespräche ohne Land**. Ein anderer Markt ohne Länder zeigt **Keine Länder**; ihn bekommt kein Besucher.

Prüfe unter **Status**, ob ein Markt bereit ist oder deine Aufmerksamkeit braucht. Schlägt ein Import fehl, öffne den Markt und lies die Fehlermeldung. Siehe [Importstatus und Fehlerbehebung](https://docs.yourhomie.ai/de/user-guide/knowledge/catalog/imports.md#review-imports).

Die Länder eines Markts wählst du beim Hinzufügen. Später änderst du sie im Tab **Einstellungen** des Markts in der Karte **Allgemein**. Dabei gilt:

* **Ein Land je Sprache:** Ein Land kann in jeder Sprache nur einen Markt haben. Österreich kann also einen deutschen und einen englischen Markt haben, aber nicht zwei deutsche.
* **Standardmarkt je Land:** Wird ein Land auch von anderen Märkten bedient, zeigen die Markteinstellungen unter **Erweitert** im Bereich **Standardmarkt je Land** die Standardoption für dieses Land, zum Beispiel **Standard für Schweiz**. Aktiviere sie, damit dieser Markt dort der Standard ist. Der Standardmarkt eines Lands gilt, wenn es für die Sprache des Besuchers keinen eigenen Markt gibt. Wird ein Land nur von einem Markt bedient, gibt es nichts zu wählen.
* **Standardmarkt des Katalogs:** Ein Markt ist der Ersatz für Gespräche ohne Land. Er bedient auch Länder ohne eigenen Markt, sofern du für diese Besucher nicht **Sehen keine Produkte** wählst. Den ersten Markt eines Katalogs macht die Plattform automatisch dazu. Ändern kannst du ihn in den Katalog-Einstellungen unter **Einstellungen → Allgemein** in der Karte **Standardmarkt** unter **Standardmarkt des Katalogs**.

## Welcher Markt in einem Gespräch gilt

Der Assistent wählt den Markt bei jeder Produktsuche aus zwei Angaben: dem **Land** und der **Sprache**.

* **Land:** Es kommt von deiner Seite, über die [Einbindung](https://docs.yourhomie.ai/de/api-reference/client/configuration.md) oder bei Shopify aus dem aktiven Markt des Shops. Übergibt die Seite kein Land, gilt das **Standardland** unter **Wissensquellen → Produkte** im Assistenten. Ist auch das leer, gilt der Standardmarkt des Katalogs.
* **Sprache:** Sie kommt aus den Spracheinstellungen deiner Webseite. Sonst gilt die Standardsprache des Assistenten. Siehe [Sprachauswahl](https://docs.yourhomie.ai/de/api-reference/client/configuration.md#sprach-auflösung).

Damit wählt der Assistent den Markt in dieser Reihenfolge:

**1. Markt für Land und Sprache**

Gibt es einen Markt für genau dieses Land und diese Sprache, kommt alles aus ihm.

**2. Standardmarkt des Lands**

Sonst gilt der Standardmarkt des Lands. Hat er eine Übersetzung in der Sprache des Gesprächs, zeigt der Assistent deren Texte; fehlt ihr ein Text, nutzt er für diesen Text die Grundsprache des Markts. Produktlinks kommen aus der Übersetzung, wenn sie welche hat, sonst aus dem Markt. Preise und Verfügbarkeit kommen immer aus diesem Markt.

**3. Standardmarkt des Katalogs**

Hat das Land keinen eigenen Markt, gilt der Standardmarkt des Katalogs, außer du hast für diese Besucher **Sehen keine Produkte** gewählt.

Preise, Verfügbarkeit und Sortiment stammen aus dem gewählten Markt. Wird der Markt eines anderen Lands verwendet, kann der Assistent erklären, welche Preise er zeigt.

**Land im Gespräch wechseln:** Fragt ein Besucher nach einem anderen Land, etwa „Was kostet das in der Schweiz?“, sucht der Assistent im Markt dieses Lands. Über den [Produktschlüssel](#product-key) findet er dort dasselbe Produkt.

> [!NOTE]
>
> Der Assistent rechnet keine Währungen um. Teste Preisfragen in der Währung des jeweiligen Markts.

> [!TIP]
>
> Wähle im [Playground](https://docs.yourhomie.ai/de/user-guide/assistants/playground.md) unter **Markt** ein Land und unter **Sprache der Produkttexte** eine Sprache, um den Assistenten so zu sehen wie Besucher dieses Markts.

## Länder ohne eigenen Markt

Lieferst du nur in bestimmte Länder, wähle in den Katalog-Einstellungen in der Karte **Standardmarkt** unter **Besucher aus Ländern ohne eigenen Markt** die Option **Sehen keine Produkte**. Der Assistent sagt diesen Besuchern dann, dass der Shop nicht in ihr Land liefert. Gespräche ohne Land nutzen weiterhin den Standardmarkt des Katalogs.

Als **Standardland** kannst du bei den Assistenten des Katalogs dann nur Länder mit eigenem Markt wählen. Haben Assistenten dort bereits ein Land ohne Markt eingestellt, nennen die Katalog-Einstellungen sie, sobald die Option gewählt ist: Deren Gespräche ohne Land bekämen sonst keine Produkte. Wähle für sie ein Land mit Markt oder lass das Feld leer.

## Welche Produkte in einem Markt erhältlich sind

Nimm alle Produkte, die der Assistent in diesem Markt empfehlen soll, in den Produktfeed auf. Produkte, die nur in einem anderen Markt vorhanden sind, stehen hier nicht für Empfehlungen zur Verfügung.

> [!WARNING]
>
> Jede Feed-Aktualisierung muss das vollständige Sortiment dieses Markts enthalten. Entfernst du Produkte aus der Datei, werden sie nach dem Import auch aus dem Markt entfernt. Siehe [Kleinere Dateien](https://docs.yourhomie.ai/de/user-guide/knowledge/catalog/imports.md#kleinere-dateien).

## Produktschlüssel

Der **Produktschlüssel** legt fest, woran Produkte innerhalb eines Markts und zwischen Märkten erkannt werden: bei [Übersetzungen](#translations), bei [verwandten Produkten und Nachfolgern](https://docs.yourhomie.ai/de/user-guide/knowledge/catalog/field-mapping.md#related-products) und wenn jemand fragt, ob es ein Produkt auch in der Schweiz gibt. Ein neuer Markt nutzt die **Produkt-ID**. Ändern kannst du den Schlüssel im Tab **Einstellungen** des Markts in der Karte **Produktschlüssel**:

* **Produkt-ID** — die ID aus der Feldzuordnung des Produktfeeds.
* **GTIN** — die GTIN/EAN des Produkts.
* **SKU** — deine eigene Artikelnummer. Wählbar, sobald in der Feldzuordnung eine Spalte für **SKU** zugeordnet ist.

Produkte werden nur zwischen Märkten mit demselben Schlüssel wiedererkannt. Nutzt ein Markt einen anderen Schlüssel als die übrigen Märkte, zeigt die Karte **Produktschlüssel** in seinen Einstellungen den Hinweis **Märkte nutzen unterschiedliche Produktschlüssel**. Der Produktschlüssel verbindet nur Produkte; er übernimmt nie Texte, Preise oder andere Daten aus einem anderen Markt.

## Übersetzungen

Mit Übersetzungen finden Kunden Produkte und lesen deren Angaben in einer weiteren Sprache. Die übersetzten Produkttexte und optional Links zu den Produktseiten in dieser Sprache kommen aus einer eigenen Datei oder aus zusätzlichen Spalten im Produktfeed des Markts, zum Beispiel `title_fr` neben `title`. Preise, Verfügbarkeit und Bilder bleiben wie im ursprünglichen Markt.

**1. Übersetzungen öffnen**

Öffne den Markt und geh zum Tab **Übersetzungen**. Wähle **Sprache hinzufügen**.

**2. Quelle wählen**

Wähle unter **Texte aus**, woher die Texte kommen:

* **URL**: eine eigene Datei in der Sprache. Gib die **Quell-URL** ein, wähle das **Format** und wähle **Einlesen**. Kann die Datei nicht gelesen werden, zeigt der Dialog den Grund.
* **Dieser Feed**: Spalten im eigenen Produktfeed des Markts. Wähle **Einlesen**. Die Übersetzung verwendet dann die URL des Produktfeeds; eine Übersetzung, deren **Quell-URL** die URL des Produktfeeds ist, wird immer als **Dieser Feed** angezeigt. Die Spalten stehen zur Verfügung, sobald der Markt importiert wurde. Die Spalten, die du hier zuordnest, erscheinen nicht mehr als Produktangaben in der Sprache des Markts; unter **Ausgeschlossene Felder** stehen sie als **Von einer Übersetzung verwendet**, und das Speichern einer Änderung an ihnen importiert den Markt neu.

Danach öffnet sich das Seitenpanel mit den Spalten. Für eine andere Quelle wählst du später neben **Texte aus** **Ändern**.

Wähle die **Sprache**. Jeder Markt unterstützt bis zu 20 Übersetzungen, eine pro Sprache. Wähle eine andere Sprache als die Grundsprache des Markts.

**3. Zeilen zuordnen**

Wähle bei einer Datei (**URL**) unter **Produktzuordnung** im gleichnamigen Feld die Spalte mit dem Produktschlüssel des Markts, zum Beispiel bei **Produkt-ID** (oder **GTIN** bzw. **SKU**, je nachdem, was für den Markt eingestellt ist). Über sie werden die Zeilen den Produkten des Markts zugeordnet.

Mit **Dieser Feed** gibt es nichts zuzuordnen: Jede Zeile gehört zu dem Produkt, das sie im Feed des Markts beschreibt.

**4. Texte zuordnen**

Wähle die Spalten mit den übersetzten Texten. Du kannst auch Textfelder ergänzen, die im ursprünglichen Markt fehlen. Diese stehen dann nur in dieser Sprache zur Verfügung.

* **Produktdetails**: **Produktname**, **Beschreibung**, **Produkt-URL** (optional, siehe unten) und **Kategorie**. Die **Beschreibung** darf wie im Feed des Markts HTML enthalten.
* **Varianten**: **Gemeinsamer Titel** und **Variantenoptionen** im Format `Name:Wert`, in derselben Reihenfolge wie im Feed des Markts.
* **Hinweistexte**: **Preishinweis** und **Verfügbarkeitshinweis**.
* **Beraterhinweise**: Wähle je Spalte mit Beraterhinweisen die Spalte der Übersetzung.
* **Verbraucherhinweise**: Wähle je Spalte mit Verbraucherhinweisen die Spalte der Übersetzung. Nennt eine übersetzte Zelle keinen Typ, behält der Hinweis den Typ aus dem Markt.

Prüfe bei einer Datei vor dem Speichern die vorgeschlagenen Spalten für **Produktname** und **Beschreibung**. Mit **Dieser Feed** werden keine Spalten vorgeschlagen: Ordne mindestens eine Spalte in der Sprache zu, zum Beispiel `title_fr` als **Produktname**. Fehlt ein übersetzter Text oder Link, wird der Text oder Link des ursprünglichen Markts verwendet.

Deine Quelldatei kann ein vollständiger Export in der Sprache sein oder nur die übersetzten Spalten und den Produktschlüssel enthalten. Preise, Verfügbarkeit, Zahlen und Bilder ordnest du hier nicht zu, sie kommen immer aus dem Markt.

**5. Speichern**

Speichere die Übersetzung. Sie gilt nach wenigen Augenblicken, in der Regel ohne neuen Import des Markts. Nur wenn du änderst, welche Spalten des Produktfeeds eine Übersetzung mit **Dieser Feed** liest, wird der Markt zuerst neu importiert; danach gilt die Übersetzung. Speichern ohne Änderungen startet nichts, und das Löschen einer Sprache entfernt ihre Texte.

Bringt ein Import neue oder geänderte Produkte in den Markt, werden alle seine Übersetzungen erneut gelesen: Neue Produkte erhalten ihre Texte, und Änderungen in deiner Übersetzungsdatei gelten.

### Produkt-URL in der Sprache

Eine Übersetzung gehört zu genau einem Markt. Ihre **Produkt-URL** ist deshalb die Produktseite dieses Markts in der Sprache der Übersetzung. Beispiel: Dein Markt Schweiz hat eine französische Übersetzung aus dem Export von `shop.ch/fr`. Ordnest du dort die Link-Spalte als **Produkt-URL** zu, verlinkt der Assistent französischsprachige Besucher in der Schweiz auf `shop.ch/fr`, mit den Schweizer Preisen und der Schweizer Verfügbarkeit.

* Das Feld ist optional. Lass es leer, wenn dein Shop keine eigenen Seiten je Sprache hat, zum Beispiel weil Besucher die Sprache auf derselben Seite umschalten. Dann verlinkt der Assistent die Seite des Markts.
* Fehlt einem Produkt oder einer Variante der Link in der Übersetzung, gilt für genau dieses Produkt oder diese Variante der Link des Markts.
* Hat die Datei eine Link-Spalte, etwa `link` oder `url`, ist sie als **Produkt-URL** bereits zugeordnet. Prüfe sie oder leere das Feld.
* Hat die Sprache eigene Preise, ein eigenes Sortiment oder eine eigene Verfügbarkeit, lege sie als eigenen Markt an statt als Übersetzung.

> [!TIP]
>
> Sobald die Sprache im Tab **Übersetzungen** **Aktiv** zeigt, öffne **Produkte** im Katalog und wähle den Markt und die Sprache der Übersetzung. Prüfe einen übersetzten Namen und Produktlink. Der Tab **Übersetzungen** zeigt, wie viele Zeilen einem Produkt zugeordnet wurden. Wurden Zeilen nicht zugeordnet, prüfe die Spalte mit dem Produktschlüssel in deiner Übersetzungsdatei oder bei **Dieser Feed**, ob die Zeilen in den zugeordneten Spalten einen Wert haben.

## Einen Markt in einen anderen Katalog verschieben

Im Tab **Einstellungen** eines Markts verschiebst du ihn in der Karte **Katalog wechseln** mit **Verschieben** in einen bestehenden oder einen neuen Katalog. Produktfeed, Feldzuordnung und Importe bleiben erhalten. Der Dialog nennt die Folgen:

* Assistenten des bisherigen Katalogs zeigen die Produkte dieses Markts danach nicht mehr.
* Preislisten, Aktionen und Bewertungen des bisherigen Katalogs gelten nicht mehr für ihn.
* Im Zielkatalog wählst du seine Länder neu.

Öffne nach dem Verschieben **Allgemein** im Tab **Einstellungen**; wähle dort seine **Länder**.

> [!NOTE]
>
> Den Standardmarkt des Katalogs kannst du nicht verschieben oder löschen, solange der Katalog weitere Märkte hat. Wähle zuerst in den Katalog-Einstellungen einen anderen Standardmarkt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.