Regel: Datendatei-Import (CSV / XML)#

Mithilfe der Regel Datendatei-Import können Sie Daten aus einer externen XML- oder CSV-Datei in bereits vorhandene Positionen Ihres Projekts importieren. Die Datei lässt sich der Regel direkt als Upload hinzufügen, oder Sie geben eine URL-Adresse an, von der die Daten regelmäßig geladen werden. So können Sie Produktdaten zum Beispiel um Verfügbarkeit, Leistungsstatistiken, Margen oder andere ergänzende Informationen anreichern.

Zusatzfunktionen#

  • Abgleichsmodus:
    • Schlüssel stimmt exakt überein – die Werte des Abgleichselements sind in der Quelle und in Mergado vollkommen identisch.
      • Der Wert aus der importierten Datei wird nur geladen, wenn der Wert im Import dem Wert des Abgleichselements im Projekt entspricht.
      • Wird typischerweise für den Abgleich nach der eindeutigen Produkt-ID verwendet.
    • Schlüssel ist enthalten – die Werte des Abgleichselements stimmen teilweise überein.
      • Der Wert aus der importierten Datei wird nur geladen, wenn der Abgleichswert aus dem Import im Wert des Abgleichselements im Projekt enthalten ist.
      • Wird typischerweise beim Abgleich nach einem Schlüsselwort im Namen oder in den Kategorien eines Produkts verwendet.
  • Unterstützte Dateitypen:
    • XML
    • CSV
    • Google Sheets (über die Veröffentlichung des Sheets als CSV unter einer öffentlichen URL-Adresse)
  • Art der Dateianbindung:
    • Datei-Upload – einmaliger Import.
      • Ändern sich die Daten in der Datei, muss die Datei erneut manuell hochgeladen werden.
    • URL angeben – dynamische Anbindung.
      • Ändern sich die Daten in der Datei, werden neue Werte automatisch bei jeder Neugenerierung des Projekts geladen.
  • Feldtrennzeichen:
    • Komma, Semikolon, senkrechter Strich – je nach Format in der Quelldatei (Komma ist der Standard)

Konkrete Beispiele#

Beispiel 1: Import der Lagerverfügbarkeit aus einem Heureka-Verfügbarkeits-XML-Feed#

Dieses Beispiel zeigt, wie Sie mithilfe der Regel Datendatei-Import (CSV / XML) einen Standard-Produktfeed um Informationen zur Produktverfügbarkeit aus einem externen XML-Feed (z. B. Heureka) anreichern.

1. Vorbereitung des Projekts vor dem Import – vor dem eigentlichen Import muss das Projekt so vorbereitet werden, dass der Import anschließend funktioniert.

  • Namen der Elemente, die Sie importieren möchten (bzw. Spaltennamen in der CSV-Datei), müssen mit den Namen der Elemente im Projekt übereinstimmen, in die Sie die Daten schreiben.
  • Wenn Sie ein Element importieren möchten, das im Projekt noch nicht existiert, müssen Sie es manuell erstellen:
    • Öffnen Sie die Seite Elements (Elemente).
    • Klicken Sie auf die Schaltfläche New element (Neues Element).
    • Geben Sie den Namen des Elements ein und bestätigen Sie die Erstellung.
  • Elemente, in die Sie importieren, können ausgeblendet sein – ihre Sichtbarkeit hat keinen Einfluss auf den Import.

2. Erstellung einer neuen Regel:

  • Öffnen Sie die Seite Rules (Regeln).
  • Klicken Sie auf die Schaltfläche New rule (Neue Regel).

3. Auswahl des Regeltyps:

  • Wählen Sie im Feld Rule type (Regeltyp) die Option Data File Import (CSV / XML) (Datendatei-Import (CSV / XML)).

4. Auswahl der Produkte:

  • Wählen Sie im Feld Query (Abfrage) entweder All products (Alle Produkte) oder erstellen Sie eine eigene Product query (Produktauswahl) für bestimmte Produkte, auf die die Regel angewendet werden soll.

5. Quelle der Datendatei:

  • Wählen Sie mithilfe des Schalters (Radiobutton), von wo die Datei geladen werden soll:
    • URL angeben
      • Fügen Sie im Feld URL-Adresse die Adresse zur XML- oder CSV-Datei ein (z. B. die URL des Heureka-Verfügbarkeitsfeeds).
      • Klicken Sie auf die Schaltfläche „Import".
      • Mergado erkennt automatisch, ob es sich um CSV oder XML handelt, und passt die Regeloberfläche entsprechend an.
    • Datei vom Computer hochladen
      • Klicken Sie im Feld Datendatei auf die Schaltfläche „Datei hochladen" und wählen Sie die Datei von Ihrem Computer aus (z. B. den Heureka-Verfügbarkeitsfeed).
      • Mergado erkennt auch hier automatisch das Format und passt die Einstellungen an.
      • 💡 Tipp: Die maximale Größe der hochgeladenen Datei beträgt 25 MB.

6. Element, das den Datensatz umschließt (nur beim XML-Import):

  • Legen Sie im Feld Element bounding the item (Element, das den Datensatz umschließt) das Element fest, das in der XML-Datei den Datensatz umschließt (typischerweise z. B. SHOPITEM oder ITEM), einschließlich des übergeordneten Wurzelelements (sog. ROOT-Element).
    • In unserem Fall verwenden wir: item_list | item

7. Abgleichselement im aktuellen Projekt:

  • Wählen Sie das Element aus dem aktuellen Projekt in Mergado, anhand dessen Sie Produkte mit den Daten aus der importierten Datei abgleichen möchten, zum Beispiel die Produkt-ID: g:id
    • 💡Tipp: Wählen Sie das Abgleichselement nach Möglichkeit aus dem Eingabefeed des Projekts. Das ermöglicht eine schnellere Auswertung und Verarbeitung der Regel bei der Neugenerierung des Projekts.

8. Abgleichselement in der importierten Datei:

  • Wählen Sie das Element aus der importierten Datei, das Werte enthält, die dem gewählten Abgleichselement im aktuellen Projekt entsprechen, z. B. das Attribut mit der Produkt-ID im Heureka-Verfügbarkeitsfeed: @id

9. Nach Eingabewerten abgleichen:

  • Die Checkbox „Match by input values" (Nach Eingabewerten abgleichen) ist standardmäßig aktiviert.
    • Wenn sie aktiv ist, werden die Daten anhand der ursprünglichen Werte aus dem Eingabefeed des Projekts abgeglichen (vor jeder Bearbeitung durch Mergado).
    • Deaktivieren Sie sie, erfolgt der Abgleich anhand von Werten, die bereits durch andere Regeln geändert wurden.
    • ⚠️ Hinweis: Das Deaktivieren dieser Option kann die Datenverarbeitung verlangsamen.

10. Erweiterte Einstellungen:

  • Legen Sie im Abschnitt Advanced settings (Erweiterte Einstellungen) fest:
    • den Abgleichsmodus über die Selectbox
      • in unserem Fall verwenden wir den Modus Schlüssel stimmt exakt überein
    • ob Groß- und Kleinschreibung berücksichtigt werden soll, über die Checkbox
      • in unserem Fall lassen wir die Checkbox deaktiviert

11. Benennung der Regel:

  • Geben Sie im letzten Schritt den Namen der Regel ein, zum Beispiel Import der Verfügbarkeit.

Weitere Verwendung der Regel#

  • Einmaliger Import von EAN-Codes oder anderen Werten (zum Beispiel: GPSR-Angaben oder URL-Adressen fehlender Bilder)
  • Anbindung dynamischer Werte aus Google Sheets an Mergado
    • Leistungsdaten aus Google Analytics (Klicks, Impressionen, Bestellungen)
    • Saisonalität von Produkten
    • Lagerbestände
  • Import von custom_label für PPC
  • Import von Daten für die Segmentierung und Festlegung von custom_label für PPC
  • Import von Einkaufspreisen und Margen für automatisches Pricing mithilfe der Erweiterung Pricing Fox
  • Import von Übersetzungen (wenn Sie Übersetzungen in einer anderen Sprache in einem anderen Feed haben und sie nach Mergado übertragen möchten)

FAQ#

Wofür dient die Regel Datendatei-Import?#

Die Regel dient dem Import externer Daten aus einer XML- oder CSV-Datei in bereits vorhandene Produkte in einem Mergado-Projekt. So können Sie den Feed um Informationen anreichern, die die ursprüngliche Quelle nicht enthält – z. B. Lagerverfügbarkeit, Marge, Einkaufspreis, Leistungsstatistiken oder dynamische Labels für PPC-Kampagnen.

Welche Dateiformate unterstützt Mergado?#

  • XML (z. B. Heureka-Verfügbarkeitsfeed)
  • CSV (z. B. Tabellenexport aus einem internen System oder ERP)
  • Google Sheets, wenn als CSV unter einer öffentlichen URL-Adresse veröffentlicht

💡 Die maximale Größe der hochgeladenen Datei beträgt 25 MB.

Was ist der Unterschied zwischen dem Hochladen einer Datei und der Angabe einer URL-Adresse?#

  • Datei-Upload – einmaliger Import. Ändern sich die Daten in der Datei, muss die Datei erneut manuell hochgeladen werden.
  • Angabe einer URL-Adresse – dynamische Anbindung. Bei jeder Neugenerierung des Projekts werden die aktuellen Werte aus der externen Datei automatisch geladen.
  • 💡 Empfohlen für Datenquellen, die regelmäßig aktualisiert werden (z. B. Verfügbarkeit, Preise, Leistung).

Was bedeutet „Element, das den Datensatz umschließt" beim XML-Import?#

Diese Einstellung legt fest, welcher XML-Knoten ein einzelnes Produkt darstellt. Im Heureka-Feed ist das z. B. SHOPITEM, in anderen XML-Feeds kann es ITEM oder PRODUCT sein. In Mergado wird es zusammen mit dem Wurzelelement angegeben, z. B.: item_list | item.

Wie läuft der Abgleich von Produkten zwischen der importierten Datei und dem Projekt ab?#

Über Abgleichselemente:

  • Im aktuellen Projekt wählen Sie das Element, anhand dessen Produkte abgeglichen werden sollen (z. B. g:id).
  • In der importierten Datei wählen Sie das entsprechende Element oder Attribut (z. B. @id).

💡 Idealerweise sind die Werte dieser Elemente zwischen Projekt und Datei eindeutig und identisch.

Was ist der Unterschied zwischen den Modi „Schlüssel stimmt exakt überein" und „Schlüssel ist enthalten"?#

  • Schlüssel stimmt exakt überein – die Werte der Abgleichselemente müssen vollkommen identisch sein (123 = 123). Wird zum Beispiel beim Abgleich nach Produkt-IDs verwendet.
  • Schlüssel ist enthalten – der Abgleich erfolgt, wenn der Abgleichswert aus dem Import innerhalb des Werts des Abgleichselements im Projekt enthalten ist (z. B. ist 123 in SKU_12345 enthalten). Geeignet für den Abgleich nach einem Textteil (z. B. Name oder Kategorie).

Wofür dient die Option „Nach Eingabewerten abgleichen"?#

Diese Option legt fest, ob Mergado beim Abgleich verwendet:

  • Eingabewerte aus dem Quellfeed (Standardeinstellung), oder
  • Werte nach Anwendung der Regeln (wenn Sie die Option deaktivieren).

💡 Es wird empfohlen, sie aktiviert zu lassen – der Abgleich ist dann stabiler und schneller. Das Deaktivieren kann die Generierung des Projekts verlangsamen. Achten Sie aber darauf, ob das gewählte Abgleichselement des Projekts Eingabewerte hat. Ist das nicht der Fall, müssen Sie diese Option deaktivieren, sonst funktioniert der Abgleich nicht.

Was bedeutet die Option „Groß-/Kleinschreibung beachten" in den erweiterten Einstellungen?#

Ist die Option aktiv, berücksichtigt der Abgleich den Unterschied zwischen Klein- und Großbuchstaben. Zum Beispiel ABC ≠ Abc. Lassen Sie sie deaktiviert (empfohlen), ignoriert Mergado den Unterschied in der Groß-/Kleinschreibung.

Was passiert, wenn ein Element aus der importierten Datei im Projekt nicht existiert?#

Der Import funktioniert erst, wenn Sie das betreffende Element im Projekt manuell erstellt haben (mit demselben Namen). Klicken Sie auf der Seite „Elements" auf „New element", geben Sie den Namen ein (z. B. availability) und bestätigen Sie. Das Element kann auch ausgeblendet sein – die Sichtbarkeit beeinflusst den Import nicht.

Kann ich mehrere Werte gleichzeitig importieren (z. B. Verfügbarkeit, Preis und EAN)?#

Ja. Die Regel Datendatei-Import ermöglicht den gleichzeitigen Import mehrerer Spalten (CSV) oder Elemente (XML), sofern sie korrekt zugeordnet sind.

Wie kann ich den Import für Daten aus Google Sheets nutzen?#

  1. Klicken Sie in Google Sheets auf Datei → Freigeben → Im Web veröffentlichen.
  2. Wählen Sie das Format CSV und kopieren Sie die generierte URL.
  3. Fügen Sie diese URL in das Feld „URL-Adresse" in der Regel Datendatei-Import ein.
  4. Bei jeder Neugenerierung lädt Mergado die aktuellen Daten aus dem Sheet.

💡 Auf diese Weise lassen sich zum Beispiel dynamische Labels, Leistungsdaten oder Tagespreise anbinden.

Wie kontrolliere ich, ob die Daten korrekt importiert wurden?#

Nach dem Speichern und Anwenden der Regeln oder nach der Neugenerierung des Feeds können Sie:

  • die Seite Products (Produkte) öffnen, ein bestimmtes Produkt suchen und prüfen, ob die neuen Daten in den entsprechenden Elementen erschienen sind,
  • oder die Funktion Rule walkthrough (Regel-Durchlauf) verwenden, die zeigt, wie die Daten zugeordnet und geladen wurden.

💡 Wurden die Werte nicht importiert, prüfen Sie die Elementnamen und Abgleichsschlüssel.

Lässt sich die Regel auch für einen einmaligen Datenimport verwenden?#

Ja. Für eine einmalige Ergänzung (z. B. EAN-Codes oder GPSR-Angaben) genügt es, die Datei manuell hochzuladen. Die Regel muss aber im Projekt bestehen bleiben, sonst werden die hochgeladenen Daten wieder gelöscht.

Lassen sich mit der Regel auch Leistungsdaten aus Google Analytics oder anderen Tools importieren?#

Ja, sofern die Daten im CSV- (oder XML-)Format vorliegen. Alternativ können Sie die Erweiterung Bidding Fox Elements nutzen, die diese Daten automatisch in Mergado lädt. Sie können zum Beispiel Klickzahlen, Impressionen oder Bestellungen anhand der Produkt-ID importieren. So reichern Sie den Feed um Leistungskennzahlen an, die anschließend zur Optimierung von Bidding-Strategien genutzt werden können.

Was tun, wenn der Import nicht korrekt funktioniert?#

Prüfen Sie:

  1. ob die Datei erreichbar ist (die URL ist öffentlich, erfordert keine Anmeldung),
  2. ob sie die korrekte UTF-8-Kodierung hat,
  3. ob die Element-/Spaltennamen den Namen im Projekt entsprechen,
  4. und ob der Abgleich korrekt eingerichtet ist.

💡 Zum Testen können Sie eine Datei mit einer geringeren Anzahl an Positionen hochladen und prüfen, ob die Zuordnung korrekt erfolgt.

Lässt sich der Import auch für automatische Preisgestaltung nutzen (z. B. Margen, Einkaufspreise)?#

Ja. Mithilfe des Imports können Sie dem Feed zum Beispiel Einkaufspreise oder Margen hinzufügen, die Sie anschließend in den Regeln Berechnung oder Zahlen runden für dynamisches Pricing verwenden. In Kombination mit der Erweiterung Pricing Fox lässt sich die Preisanpassung sogar vollständig automatisieren.

Related articles

Was this article helpful?