Produkte mit einer XML-Datei zu importieren, ist eine der schnellsten und einfachsten Möglichkeiten, einen großen Katalog von Produktinhalten in deinen Shop zu integrieren. Oftmals kann der XML-Import erforderlich sein, wenn du mit einem Partner oder Distributor arbeitest, der dir ein XML-Strukturverzeichnis bereitstellt. In diesem Artikel findest du Informationen darüber, was eine XML-Struktur ist und wie du sie verwenden kannst, um die von uns entwickelte Anwendung zu aktivieren, die dir hilft, den Produktkatalog in deinem Online-Shop zu verwalten.

In diesem Abschnitt:

XML-Dateistruktur

Die XML-Datei muss gut strukturierte Daten enthalten. Sie enthält Tags, die HTML-Tags sehr ähnlich sind. Ein XML-Dokument ist tatsächlich eine Textdatei, die verschiedene XML-Deklarationen und Tags sowie Text enthält. Hier ist ein Beispiel für ein XML-Dokument, das Informationen über mehrere Produkte beinhaltet:
In dem obigen Foto siehst du Tags, die jede Einheit der Produktzusammenfassungsinformationen enthalten. Jedes Element eines Produkts, wie ein Identifikationscode, Name, Kategorie, Beschreibung, Tags, Marke, Preis, Gewicht, Menge, Foto, Variante und Wert, muss mit einem öffnenden und schließenden Tag umschlossen sein. Die öffnenden und schließenden Tags müssen denselben Namen haben, wobei das schließende Tag durch einen Schrägstrich (/) vorangestellt wird, damit die Informationen korrekt gelesen und mit der XML-Importanwendung in deinen Shop importiert werden können. Zwischen diesen beiden Tags befindet sich der Inhalt, also die in dem betreffenden Abschnitt enthaltenen Daten.

Es muss ein grundlegendes Element geben, in dem sich alle anderen Elemente befinden. Es wird auch Dokument Wurzel genannt. Im Beispiel ist dies das <products>-Element. Dieses öffnende Haupt-Tag muss ein schließendes Tag </products> haben. Es enthält viele Unter-Tags, von denen jeder ein schließendes Tag hat und einige Informationen dazwischen, zum Beispiel: Hersteller-Tag <manufacturer> Herstellername </manufacturer>.

Die Namen der Tags selbst, die jedes Element enthalten, sind willkürlich, nicht streng definiert und werden vom Ersteller der XML-Datei bestimmt. Wenn sie importiert werden, werden sie tatsächlich mit den bereits vorhandenen Elementen für ein Produkt verknüpft.


Eine gut formatierte XML-Datei entspricht einer Reihe sehr strenger Regeln, die XML regeln. Wenn eine Datei diesen nicht entspricht, funktioniert das XML nicht mehr. Auf dem obigen Bild siehst du, dass jedes öffnende Tag ein entsprechendes schließendes Tag hat, das ist eine der grundlegenden Regeln für gut formatierte XML. Wenn du ein Tag entfernst und versuchst, diese Datei zu öffnen, wirst du eine Fehlermeldung sehen und das Programm wird dich daran hindern, die Datei zu verwenden.


Du musst die Regeln für die Erstellung gut formatierter XML-Dateien nicht kennen, aber du solltest dir merken, dass du XML-Daten nur zwischen Programmen und Systemen teilen kannst, wenn die Daten richtig formatiert sind. Wenn du eine XML-Datei nicht öffnen kannst, ist es sehr wahrscheinlich, dass diese Datei nicht die richtige Struktur hat.


Hier kannst du die Struktur einer gut formatierten Beispiel-XML-Datei.

Die Anwendung installieren

Um die XML-Import-Anwendung zu nutzen, benötigst du eine solche XML-Datei oder einen Feed (eine Datei, die in Form eines Links bereitgestellt wird, aus dem Informationen kontinuierlich gezogen werden). Eine andere Option ist, eine andere Informationsquelle zu haben (z. B. eine Tabelle in Google Sheets), die in das XML-Format konvertiert wird. Die Informationen zu einem Produkt in einer Tabelle sind normalerweise in einer einzigen Zeile enthalten, während in XML diese Informationen in vielen Zeilen enthalten sind, die in einem einzigen Tag (zum Beispiel <product>) umschlossen sind. Das heißt, die horizontale Datenvisualisierung wird im XML-Dokument in vertikal umgewandelt.


1. Gehe zum Admin-Bereich deines Shops, zu dem Abschnitt Einstellungen > Dateien und klicke auf die Schaltfläche Dateien hochladen in der oberen rechten Ecke deines Bildschirms, um die XML-Datei hochzuladen, falls du eine hast. Kopiere dann den Link und füge ihn in den Browser ein, um sicherzustellen, dass er funktioniert. Wenn es ein Problem mit der Datei gibt, erscheint eine Nachricht auf dem Bildschirm.

2. Der nächste Schritt ist, zum Abschnitt Apps> Alle Apps zu gehen und XML Import auszuwählen sowie auf die Installieren-Schaltfläche zu klicken.

Einstellungen (1. Schritt)

1. Klicke auf die Schaltfläche Job erstellen, um einen neuen Job für den Import zu starten.

  • Jobname - gib einen Namen ein, der den Job identifiziert. Anschließend wird er verwendet, um jedes Produkt zu identifizieren - aus welchem Job es importiert wurde. Der Jobname wird nur im Kontrollbereich sichtbar sein. Wenn du zum Beispiel Produkte aus einer bestimmten Kategorie (Kopfhörer) hochlädst, könnte das der Titel des Jobs sein.
  • XML URL - Füge im Feld XML URL Link den Link (XML Feed) ein, den du hast oder den du nach dem Hochladen der XML-Datei im Abschnitt Einstellungen> Dateien kopiert hast.
  • Alle Produkte in der Kategorie importieren - benutze das Dropdown-Menü, um eine vorhandene Produktkategorie auszuwählen, in die alle Produkte aus diesem XML-Job importiert werden sollen. Wenn die XML-Datei Informationen zur Produktkategorie enthält, musst du dieses Dropdown-Menü nicht verwenden. Wenn der XML-Feed, den du hochlädst, nur Produkte aus einer Kategorie enthält, kannst du diese im ersten Schritt auswählen. Wenn du eine solche Kategorie nicht ausgewählt hast, wird das System erwarten, dass du eine Kategorie für jedes Produkt im zweiten Schritt auswählst.


Wenn du keine Kategorien in deinem Shop erstellt hast, sieh dir an, wie du sie hier erstellen kannst.
  • Alle Produkte zum Anbieter importieren - benutze das Dropdown-Menü, um eine vorhandene Marke auszuwählen, in die alle Produkte aus diesem XML-Job importiert werden. Wenn die XML-Datei Informationen zur Produktmarke enthält, musst du dieses Dropdown-Menü nicht verwenden, überspringe es einfach und fahre mit dem nächsten Schritt der Einstellungen fort.
  • Alle Produkte als - wähle im Dropdown-Menü, ob die Produkte als direkt sichtbar in deinem Shop oder als nicht veröffentlicht importiert werden sollen. Sobald der gesamte Job abgeschlossen und die Produkte importiert wurden, kannst du die Schnellwerkzeuge im Abschnitt Produkte nutzen, um alle Produkte auf einmal zu veröffentlichen.
  • XML Produkt-Tag - ein Feld, in dem du wichtige Informationen eingeben musst, nämlich das Produkt-Tag. Im XML-Dokument definieren die öffnenden und schließenden Tags den Beginn und das Ende eines Produkts. In unserem Fall ist dies das <product>-Tag. Du musst das XML-Tag des Produkts aus deiner XML-Datei eingeben, damit der Parser (das Skript, das XML-Dateien liest) verstehen kann, wo ein Produkt in der XML-Struktur anfängt und endet. Dieses Tag kann beliebig sein, es gibt keinen festgelegten Standard, also achte darauf, wie es in deiner Datei bezeichnet ist.


Zum Beispiel:

Das Produkt-Tag enthält alle anderen Tags und Informationen für jedes Produkt:

  • Haupt-XML-Job zuweisen - Der XML-Importeur ist eine ziemlich fortschrittliche Software, die nicht nur importieren, sondern auch Produkte aktualisieren kann. Es kann auch mehrere Unter-Jobs geben, die an einen Hauptjob angehängt sind. Das heißt, wenn du einen Hauptjob zum Importieren von Produkten gestartet hast, kannst du weitere Unter-Jobs ausführen, um deinen Produktkatalog zu füllen. Dies ist eine nützliche Funktion, wenn nicht alle Produkte, die du hochladen möchtest, in einer Datei sind, sondern in mehreren. In diesem Fall kannst du mehrere Jobs ausführen, die als einer arbeiten und so den gesamten Produktkatalog zusammenführen.

  • Zeilen - gib hier die maximale Anzahl von Zeilen im XML-Feed ein, damit das System nach einem Produkt-Tag suchen kann. Wenn die Feed-Struktur korrekt ist, solltest du die Anzahl der Zeilen nicht ändern müssen, und das Produkt-Tag sollte in den ersten 500 Zeilen enthalten sein.
  • Fehlende Produkte deaktivieren - sehr nützliche Funktionalität beim Arbeiten mit Feeds, da sie ständig aktualisiert werden. Wenn ein Produkt nicht vorrätig oder von der Website des Distributors, mit dem du arbeitest, entfernt wurde, dann wird dieses Produkt automatisch aus deinem Shop entfernt, wenn du den Feed aktualisierst.
  • Lager überwachen - über diese Option wird die Menge aller Produkte, die importiert werden, vom System überwacht. Wenn ein Artikel verkauft wird, wird die verbleibende Menge von der insgesamt festgelegten Menge des Produkts neu berechnet.
  • Weiterverkaufen - wenn du diese Option aktivierst, erlaubt das System die Bestellung des Produkts, auch wenn die Menge des Produkts 0 beträgt.

  • Aufgaben-ID-Nummer - egal welchen Identifikator du wählst, wichtig ist, dass er für jeden Job einzigartig ist. Wenn es Jobs mit derselben ID gibt, können die Produkte wahrscheinlich in Konflikt geraten.
  • Feste Rabatttyp wählen - über den XML-Importeur ist es möglich, Produkt-Rabatte hinzuzufügen, aber dafür muss deine XML-Datei einen solchen Wert enthalten (Listenpreis und Rabattpreis).
Wenn du diese Option aktivierst, musst du einen Rabatt im Menü Marketing > Rabatte erstellen und den Rabatttyp „Fester Rabatt“ auswählen. Die XML-Importanwendung funktioniert nur mit dieser Art von Rabatt. Sobald du den Rabatt erstellst, wird er für die ständige Aktualisierung verwendet, wenn der XML-Feed solche Informationen enthält.


  • Vergleichen nach - um Produktduplikate zu vermeiden, kannst du Produkte im Shop mit denjenigen, die du importierst, vergleichen nach offizieller ID, SKU oder Barcode. Wenn ein bestimmtes Produkt bereits im Shop existiert, wird es im aktuellen Auftrag nicht importiert - es wird nur aktualisiert, wenn nötig. 
  • Aktion - du hast die Möglichkeit, die Produkte zu importieren und zu aktualisieren oder sie nur zu aktualisieren. Das bedeutet, dass die App es dir auch ermöglicht, die Produkte zu synchronisieren, ohne neue zu importieren. 

Einstellungen (2. Schritt) 

Nachdem du die im ersten Schritt eingegebenen Daten überprüft hast, nutze die Schaltfläche Speichern und gehe zu Schritt 2, in dem du angibst, wie die Daten aus dem XML-Feed in den Produktkatalog deines Shops importiert werden sollen.

  • XML Produkt-ID - Wähle aus dem Dropdown-Menü die Produkt-ID, die dieser Bedingung entspricht, damit es keine Produkte mit derselben SKU oder ID gibt, zum Beispiel. Auf der rechten Seite siehst du im Dropdown-Menü die Struktur deiner XML-Datei. Wähle den Identifikator für deine Produkte, nach dem sie sich unterscheiden, damit beim Aktualisieren des XML-Feeds nicht passiert, dass zwei Produkte, die beispielsweise denselben ID als Identifikator haben, gleich aktualisiert werden.
  • Titel - wähle das Tag aus, das den Namen jedes Produkts in der Datei enthält. Es kann ganz unterschiedlich sein (Name, Produktname, Validierungsname, Titel usw., in unserer Beispieldatei ist dies das <title>-Tag.
  • Kurze Beschreibung - wenn du solche Informationen in deiner Datei hast, wähle das entsprechende Tag aus. Wenn du keins hast, kannst du dieses Feld überspringen.
  • Beschreibung - die Beschreibung eines Produkts kann recht lang sein und verschiedene Zeichen, Links, Fotos usw. enthalten. Wähle das entsprechende Tag aus, das die Produktbeschreibung öffnet und schließt. In unserer Datei ist dies das <description>-Tag

Wenn in der Beschreibung eines Produkts Fotos vorhanden sind, wird die "XML Import"-Software sie extrahieren und direkt im Speicher deines Shops hochladen und speichern, sodass sie Teil der Beschreibung der jeweiligen Produkte werden.


Beim Importieren von Produkten, wenn die XML-Datei Tabs enthält, deren Beschreibungen ein Link zum Einbetten eines Videos von Youtube (Link nur) sind, wie hier: 

<tabs>
<tab>
<name> Video </name>
<description>https://www.youtube.com/embed/clJj2GUCic</description>
</tab>
</tabs>

In diesem Fall wird der Link durch einen Code ersetzt, der in der Lage sein wird, das Video direkt anzuzeigen.
  • SEO-Titel und SEO-Meta-Beschreibung - du musst sie möglicherweise nicht auswählen, sie werden automatisch aus dem Namen und der Beschreibung des Produkts selbst erstellt.
  • Alte URL Adresse- dient, wenn wir einen Shop migrieren. Wenn du einen Wert für die alte URL des Produkts festlegst, wird der XML-Importer automatisch 301-Links erstellen, um die Positionierung/Indexierung des Produkts zu erhalten. Siehe mehr hier.

  • Preis - wähle das Tag für den Originalpreis (wenn du einen mit Rabatt hast).
  • Rabattierter Preis - wähle ein Tag, das den rabattierten Preis angibt.
  • SKU - wähle das Tag, das die SKU des Produkts angibt.
  • Barcode - wähle das Tag, das dem Barcode des Produkts entspricht. 
  • Menge - wähle das Tag, das der Menge des Produkts entspricht.
  • Gewicht - Wenn solche Informationen in deiner Datei vorhanden sind, wähle das entsprechende Tag aus.
  • Neu - die Produkte werden als neu gekennzeichnet. Diese Funktionalität ist nützlich, wenn du eine Datei mit neuen Produkten hochlädst und möchtest, dass sie als solche gekennzeichnet werden.


Wenn du eine der oben genannten Zeilen ständig aktualisieren möchtest, musst du die Zeilen auswählen, die du möchtest, wie im obigen Foto gezeigt.

Beachte jedoch, dass je mehr Zeilen du zum Aktualisieren auswählst, desto langsamer der Import sein wird, da viele Kennzahlen unterschiedlicher Produkte verglichen werden müssen, damit die Software gemäß den angegebenen Kriterien aktualisieren kann.


Beschreibungstabs

Wenn du mehrere Beschreibungen für ein Produkt im Feed hast, ermöglicht diese Funktionalität die Erstellung mehrerer Tabs mit diesen Beschreibungen. Wenn du nur eine Beschreibung hast, musst du nichts auswählen.

Kategorieeigenschaft

Die Struktur einer Eigenschaft ist dieselbe wie die Produktdefinition:

Du hast einen zusammenfassenden Tag für alle Eigenschaften. Jede Eigenschaft hat einen Namen und einen Wert. Es muss einen öffnenden und schließenden Tag haben. Wähle aus dem Dropdown-Menü die entsprechenden Tags aus.

  • Eigenschaftswerte können mehrere sein, aber sie können im dritten Schritt der Einstellungen durch Kommas getrennt werden.
  • Eigenschaftswert - akzeptiert am häufigsten den Wert der Eigenschaft, sodass du hier dasselbe Tag auswählen kannst.

Im nächsten Abschnitt wähle das Tag, das zum Markennamen (Hersteller) passt.


Varianten

Um Produktvarianten zu importieren, muss deine XML-Datei Produktgruppen für Varianten enthalten. Die gleiche Logik gilt für die Varianten wie für die Eigenschaften. Auch hier musst du die geeigneten Tags aus deiner XML-Datei sorgfältig auswählen.

Bildverwaltung

Wenn du mehrere Fotos eines Produkts in einer XML-Datei hast, können sie unter einem Tag gruppiert und durch Kommas getrennt werden. Im dritten Schritt der Einstellungen kannst du eine Regel erstellen, in der die Software beim Erkennen eines Kommas die einzelnen Elemente trennt und sie als separate Dinge betrachtet.

Einstellungen (3. Schritt)

In diesem Schritt kannst du zusätzliche Operationen und Regeln für den Import von Produkten aus der XML-Datei in dein Shopverzeichnis erstellen. Zum Beispiel, wenn du möchtest, dass der Inhalt eines beliebigen Tags durch bestimmte Werte ergänzt oder modifiziert wird, kannst du all diese Aktionen einrichten und den Produktimport nach Bedarf ändern.
Diese Einstellung wird häufig verwendet, wenn du einen Wert im XML-Feed hast und ihn als höher im Produktkatalog hochladen möchtest. Du kannst eine Vielzahl von Operationen erstellen, je nach Inhalt deiner Datei und wie du sie modellieren musst.

Es ist wichtig zu beachten, dass wenn du das Produkt-Tag im ersten Schritt des XML-Uploads korrekt angegeben hast, du in den nächsten Schritten die Dropdown-Menüs verwenden wirst, durch die das System dir bereits erfolgreich die Informationen aus der Datei anzeigt und du nur angeben musst, wofür jedes Tag aus dem XML-Feed verwendet werden soll.


Beachte, dass die Art und Weise, wie der Text im abgebildeten Bereich unten geschrieben ist (kleingeschrieben / großgeschrieben), mit der Art und Weise übereinstimmen muss, wie er in der Datei geschrieben ist, andernfalls wird keine Übereinstimmung gefunden und die Operation wird nicht ausgeführt.


Wenn du fertig bist, speichere den Job mit der Schaltfläche in der oberen rechten Ecke des Bildschirms. Der Job wird aktiv, er wird in die Warteschlange gestellt, und wenn die Zeit für seine Ausführung kommt, wird er gestartet. 


Wenn du Fotos hochlädst, werden sie mit einer leichten Verzögerung hochgeladen, da eine Gruppe von Clustern - Server, jedes hochgeladene Foto verarbeitet. Die Fotos werden optimiert, die notwendigen Filter werden hinzugefügt, die Qualität wird optimiert, damit sie so schnell wie möglich auf deiner Seite geladen und geöffnet werden können, sodass sie von optimaler Qualität sind.

Zusätzliche Einstellungen

Sobald der Auftrag gestartet ist, stoppt er niemals, die nächsten Starts erfolgen alle 12 Stunden - der XML-Import beginnt, den Inhalt zu aktualisieren, falls es eine Änderung gibt, wie neue Produkte, Verfügbarkeiten, Preise usw.


Du kannst die Priorität deines Auftrags erhöhen, sowie das Implementierungsintervall verkürzen - anstelle von 12 Stunden kannst du beispielsweise festlegen, dass der Job alle 6 Stunden ausgeführt wird.


Über die XML-Import-Prioritätsaufgaben-Schaltfläche kannst du eine Priorität für deinen Job kaufen. Das bedeutet, dass er zu 20, 40, 60 oder 80 % vor den anderen Jobs abgeschlossen wird.

Über die andere Schaltfläche XML-Import-Intervall kannst du das Intervall für den Beginn des jeweiligen Jobs ändern.