> 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/docs/de/modules/geo.md). # Geo ## Zusammenfassung Geo stellt Verbindungen zwischen Produkten und Standorten her. Sie können Suchregeln erstellen, die die Entfernung zwischen Kunden und Lagerstandorten berücksichtigen. Beispielsweise können Sie Produkte je nach Lagerregion rabattieren oder ausblenden. Im Folgenden werden diese Standorte — identifiziert durch eine ID und Geo-Koordinate — als Märkte bezeichnet. Sie finden das **Geo** Modul im linken Menü unter **Weitere Einstellungen…** innerhalb der **Module** Bereich. ![](/files/817273fdb8f513530e614b8ae61e04fecd06fc16) **Hinweis:** Geo muss vor der Aktivierung separat lizenziert werden. Außerdem müssen zusätzlich zum Produktdaten-Feed zwei Dateien bereitgestellt werden: * GeoMarket-CSV zum Verknüpfen von Markt-IDs und Standorten. * GeoStock-CSV mit Markt-IDs und marktspezifischen Daten wie Lagerbeständen. Beide Dateien können über [Felder](/docs/de/basic-settings/fields.md). ## Geo konfigurieren ### Allgemeine Einstellungen ![](/files/53ebe2f3c3bc48d9c0bb9eb3293e93489314f662) Die folgenden **Allgemeine Einstellungen** sind verfügbar für **Geo** Konfiguration: ![](/files/d60b9a1d295f3e5a431e240b70b5c4fdedd41532) **Aktiv**: Wenn deaktiviert, werden keine 'Geo'-Daten importiert und andere Module werden nicht von 'Geo' beeinflusst. ![](/files/0dbecdbb252eaee5740388b19366e17865d71e8e) **Alle vorhandenen Märkte in Suchantworten einschließen:** Wenn aktiviert, enthält die Suchantwort alle vorhandenen Märkte. Die Liste kann umfangreich sein und die Leistung negativ beeinträchtigen. ![](/files/60e0c8a7ed46e9052ac662f12023d5b64e55c542) **Entfernung für Märkte berechnen:** Wenn diese Option aktiviert ist, enthält die Suchantwort die Entfernung zu jedem verfügbaren Markt. Dies kann sich negativ auf die Leistung auswirken. ![](/files/ad29674a4c646d4f0b4f78412d8300168f7c58f9) **Produktkennung:** Wenn das Feld mit der Rolle „Master ID“ als Produktkennung in der GeoStock-Datei verwendet wird, müssen alle anderen Felder mit einer Daten-Import-Quelle, die keine Feldrolle haben, die sich auf das Geo-Modul bezieht, Nicht-Variant-Felder sein. Wenn stattdessen das Feld mit der Rolle „Product Number“ verwendet wird, müssen alle diese Geo-Felder Variant-Felder sein. ![](/files/aed3689b754a85a0d4ac9f5d13e013a6d74a0090) **Standard-Marktauswahl:** Definiert das Standardverhalten, wenn in einer Suchanfrage keine „marketId“ angegeben wird. Es wird die angegebene Markt-ID oder die Auswahlstrategie verwendet, um die Produkte anhand des Felds „market Id“ zu filtern. Wählen Sie die ID eines Marktes, „online“ für den Online-Shop oder eine der beiden Strategien: * Die Strategie „Alle“ ignoriert alle Produkte, die keinen Wert im Feld Markt-ID haben. * Wählen Sie 'Keine Auswahl', um die 'skip'-Strategie zu verwenden. Diese Strategie filtert die Produkte nicht anhand einer Marktauswahl. Wenn also alle Produkte einen Wert im Feld Markt-ID haben, verhalten sich beide Strategien gleich. ![](/files/3a04e53772ec7fc29f791308a14e5a5259026f8d) **Daten-Import Geo-Daten im Produktimportintervall importieren:** Wenn aktiv, wird ein Geo-Daten-Import durchgeführt, der dem Produktdaten-Import in seinem Aktualisierungsintervall folgt. ![](/files/9ba63d413974dede99e4ad6343d339d67a97ad2f) **Geo-Daten-Importdateien im Produkt-Daten-Importintervall herunterladen:** Wenn aktiv, werden sowohl die Geo-Standortdatei als auch die Geo-Bestandsdatei heruntergeladen, wenn eine mit dem Daten-Import verknüpfte Aktion beim Start des Daten-Imports erfolgt. Diese Einstellung hat keine Auswirkung, wenn „Geo-Daten im Produkt-Importintervall importieren“ nicht aktiviert ist. ### Einstellungen für die Distanzregel ![](/files/7602540772d7b12df3d6f17ec12beb77056a9960) Mit den Einstellungen für Distanzregeln können Sie Produkten Gewichte basierend auf der Entfernung zwischen Märkten und dem Suchstandort zuweisen. Obwohl ein Produkt Werte für mehrere Märkte haben kann, werden Gewichte nur für den Markt angewendet, der dem Suchstandort am nächsten liegt. Die folgenden **Einstellungen der Distanzregel** sind verfügbar: ![](/files/d60b9a1d295f3e5a431e240b70b5c4fdedd41532) **Produkte außerhalb des Radius ausschließen:** Wenn aktiviert, werden Produkte, die auf Märkten im angegebenen Radius nicht verfügbar sind, aus dem Suchergebnis entfernt. Das Setzen von 'Produkte außerhalb des Radius ausschließen' auf false für eine Suchanfrage könnte sich negativ auf die Suchleistung auswirken. Daher werden nur Märkte innerhalb eines Radius von 20 km berücksichtigt. Dies ist das 2-Fache des in '**Radius in km**'. ![](/files/0dbecdbb252eaee5740388b19366e17865d71e8e) **Max. Anzahl der Märkte:** Wenn kein Markt ausgewählt ist, wird die Anzahl der gefundenen Märkte auf diese Zahl begrenzt. Natürlich werden nur die nächstgelegenen Märkte berücksichtigt. Diese Einstellung kann hilfreich sein, wenn eine Suche mit der konfigurierten Entfernung in dicht besiedelten Gebieten zu viele Märkte zurückgibt. ![](/files/60e0c8a7ed46e9052ac662f12023d5b64e55c542) **Radius in km:** Nur Produkte innerhalb des angegebenen Radius (in km) erhalten eine Score-Anpassung. ![](/files/ad29674a4c646d4f0b4f78412d8300168f7c58f9) **Anpassung bei kürzester Entfernung:** Die maximale Score-Anpassung für das Produkt bei der kürzesten Entfernung zum Marktstandort. Die Anpassung wird als Gewicht angewendet, d. h. sie wird mit dem Score multipliziert statt addiert. Eine Anpassung von X % würde bedeuten, dass der Produktscore mit 1.0X multipliziert wird. ![](/files/aed3689b754a85a0d4ac9f5d13e013a6d74a0090) **Anpassung bei größter Entfernung:** Die maximale Score-Anpassung für das Produkt bei der definierten maximalen Entfernung. Die Anpassung wird als Gewicht angewendet, d. h. sie wird mit dem Score multipliziert statt addiert. Eine Anpassung von X % würde bedeuten, dass der Produktscore mit 1.0X multipliziert wird. ![](/files/3a04e53772ec7fc29f791308a14e5a5259026f8d) **Anpassung für den Online-Markt:** Die Score-Anpassung für das Produkt im Falle eines Online-Scores. Die Anpassung wird als Gewicht angewendet, d. h. sie wird mit dem Score multipliziert statt addiert. Eine Anpassung von X % würde bedeuten, dass der Produktscore mit 1.0X multipliziert wird. ![](/files/9ba63d413974dede99e4ad6343d339d67a97ad2f) **Vorschau auf der Karte:** Märkte und ihre Radien auf einer Karte anzeigen. #### Beispiel – Produkte außerhalb des Radius ausschließen: ![](/files/15d7186b6decb8e7e6e6cc9b246e73ad57c2b73a) Der Kunde kann nur nach Produkten aus den Märkten A und B suchen. #### Beispiel – Produkte außerhalb des Radius nicht ausschließen: ![](/files/2357b8cd6ab738c0fa3e1afaa428d3d9cd801599) Der Kunde kann auch Produkte aus den Märkten C und D finden. Markt E liegt weiterhin außerhalb seines Einzugsgebiets. **Hinweis:** Das Anwenden eines Geo-Feldfilters zeigt Produkte an, die mit der angegebenen Markt-ID übereinstimmen. Die Ergebnisse können Produkte enthalten, deren Marktwert nicht den Filterkriterien entspricht. **Wichtig:** Kunden, die sich außerhalb aller Einzugsgebiete der Märkte befinden, erhalten nur Suchanfragen ohne Treffer. Stellen Sie sicher, dass Ihr gesamtes Versorgungsgebiet von mindestens einem Kreis in der Kartenvorschau abgedeckt wird. Alternativ können Sie eine [Kampagne](/docs/de/discovery/campaigns.md). ### Geo-Ranking und Markt-Ranking Geo verwendet zwei verschiedene Ranking-Typen. Bevor Sie sie verwenden, stellen Sie sicher, dass Geo korrekt eingerichtet ist: * Importieren Sie Ihre Geo-Markt- und Geo-Bestandsdaten und weisen Sie die erforderlichen [Geo-Felder](/docs/de/basic-settings/fields/geo-fields.md). * Erstellen Sie Ihre [Rankingregeln](/docs/de/discovery/ranking-rules.md) mit Geo-Feldern. * Erstellen Sie ein Feld mit der Rolle **Markt-Ranking**. FactFinder schreibt den berechneten Markt-Ranking-Wert zur Suchzeit in dieses Feld. In diesem Kontext ist ein **Produkt-zu-Markt-Zuordnung** bedeutet ein Geo-Eintrag für ein Produkt in einem Markt. Wenn beispielsweise ein Produkt in drei Märkten verfügbar ist, hat es drei Produkt-zu-Markt-Zuordnungen. **Markt-Ranking** bewertet jedes Produkt-Markt-Paar für sich. Es verwendet nur Geo Felder aus Rankingregeln. FactFinder ordnet dann die Einträge nach dem Ranking-Score von hoch nach niedrig. Wenn zwei Einträge denselben Score haben, kommt der nähere Markt zuerst. **Geo-Ranking** ändert die endgültige Position des Produkts in der Ergebnisliste. Es kann ein Produkt hervorheben, niedriger einstufen oder vollständig ausschließen. Es wird nur ausgeführt, wenn die Suche Geo-Informationen enthält, wie z. B. `Breitengrad` und `Längengrad`, ein ausgewählter `marketId`, oder ein Filter auf einem Geo-Feld. Für jede Regel prüft FactFinder alle relevanten Märkte und verwendet das stärkste Ergebnis. Ein passender Markt reicht aus, um ein Produkt zu boosten. Ein Produkt wird nur ausgeschlossen oder niedriger eingestuft, wenn alle relevanten Märkte diese Regel erfüllen. ### Einstellungen für Daten-Importdateien ![](/files/500d411994c6b135809c25c43300edbb7a446e9c) **Daten-Import-Dateieinstellungen** ermöglicht die Konfiguration des Daten-Imports für **Geo:** ![](/files/d60b9a1d295f3e5a431e240b70b5c4fdedd41532) **Dateiauswahl:** Wählen Sie zwischen der Geo-Bestandsdatei oder der Geo-Marktdatei ![](/files/0dbecdbb252eaee5740388b19366e17865d71e8e) **URL:** Legt den Speicherort der Quelldatei fest, die ausgewählt und geparst werden soll. ![](/files/60e0c8a7ed46e9052ac662f12023d5b64e55c542) **Frequenz:** Definiert die Periodizität der Auslösung. ![](/files/ad29674a4c646d4f0b4f78412d8300168f7c58f9) **Intervall verwenden als** **Daten-Import auslösen:** Ermöglicht die Angabe eines Intervalls als Auslösebedingung. ![](/files/aed3689b754a85a0d4ac9f5d13e013a6d74a0090) **Trennzeichen: Definiert das Feldtrennzeichen, das in der Daten-Importdatei verwendet wird, um zwischen Felder zu unterscheiden.** ![](/files/3a04e53772ec7fc29f791308a14e5a5259026f8d) **Einschließendes (Anführungs-)Zeichen: Umgebende Zeichen (z. B. Anführungszeichen) für den Feldinhalt (optional).** ![](/files/9ba63d413974dede99e4ad6343d339d67a97ad2f) **Escape-Zeichen: Ein Zeichen, das das Trennzeichen maskiert, wenn es in Feldinhalten vorkommt (optional).** ![](/files/90b955a235506cae47168c179bbd0ef0f21e484c) **Min. Dateigröße:** Definiert die minimale Dateigröße, die akzeptiert wird. Zeigt außerdem die aktuelle Dateigröße an. ![](/files/d8e86b8ed130c0f66ebb470ea895a687e629172a) **Läuft ab nach:** Wie lange eine zuvor heruntergeladene Datei gültig bleibt, bevor ein neuer Download erzwungen wird. --- # 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/docs/de/modules/geo.md?ask=&goal= ``` `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.