Heureka-Elementreferenz on Mergado Wissensdatenbank

Element ACCESSORY

Mon, 01 Jan 0001 00:00:00 +0000

Element ACCESSORY#

Grundlegende Informationen#

Element ACCESSORY enthält die ITEM_ID des Produkts, das Zubehör zum jeweiligen Produkt ist. Insgesamt kann das Element ACCESSORY bei einem Produkt 10× angegeben werden, also bis zu 10 verschiedene Zubehörartikel.

Diese Informationen nutzt Heureka vor allem im Rahmen des Heureka Marketplace, wo nach dem Hinzufügen eines Produkts zum Warenkorb das Angebot „Wir empfehlen dazu" genau mit diesem Zubehör angezeigt wird.

Häufige Fragen#

Wie füge ich das Element ACCESSORY hinzu, wenn es im Feed fehlt?
- Klicken Sie in Mergado Editor auf der Seite Elements (Elemente) auf die Schaltfläche New element (Neues Element) und tragen Sie den Namen ein: ACCESSORY
Wie füge ich einem Produkt mehrere ACCESSORY-Elemente hinzu?
- Verwenden Sie die Regel Wert zu einem Mehrfachelement hinzufügen oder die Regel Überschreiben mit Angabe einer konkreten Position. Erfahren Sie mehr über sogenannte Mehrfachelemente.

Was Mergado Audit beim Element ACCESSORY prüft#

Das Element ACCESSORY ist nicht verpflichtend, daher prüft Mergado Audit bei diesem Element bislang nichts.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element CATEGORYTEXT

Mon, 01 Jan 0001 00:00:00 +0000

Element CATEGORYTEXT#

Grundlegende Informationen#

Das Element CATEGORYTEXT soll den Pfad zur Kategorie gemäß Heureka enthalten. Es dient der Einordnung der Produkte aus dem Feed in die richtigen Kategorien im Heureka-Katalog. Es ist ein wichtiges Element für das Pairing der Produkte mit den Produktkarten. Als Trennzeichen zwischen den einzelnen Kategorieebenen wird der senkrechte Strich verwendet: |

Spezifikation des Elements CATEGORYTEXT auf der Heureka-Website
Heureka-Kategoriebaum (XML-Format)

Häufige Fragen#

Wie stelle ich die Kategorien gemäß dem Heureka-Kategoriebaum ein?
- Dafür gibt es in Mergado eine spezielle Regel: Kategorien im Stapel umbenennen.
Wird das Element CATEGORYTEXT für das Pairing der Produkte mit den Produktkarten verwendet?
- Ja, es ist eines der wichtigsten Pairing-Elemente (zusammen mit PRODUCTNAME).
Lässt sich das Element CATEGORYTEXT im Stapel und automatisch anpassen?
- Ja, wenn Sie die Zusatzerweiterung Pairing Bear für Mergado verwenden, die den von Heureka erzeugten Bericht über nicht gepaarte Produkte verarbeiten kann, können Sie im Prinzip mit einem Klick auch Tausende Kategorien gemäß den Vorschlägen direkt von Heureka anpassen. Voraussetzung ist, dass Heureka im Bericht Vorschläge für die richtigen Kategorien enthält.
Werden Produkte bei Heureka entpaart, wenn sich das Element CATEGORYTEXT ändert?
- Ja, die Produkte durchlaufen danach erneut den Pairing-Prozess, dessen Dauer von den Möglichkeiten Heurekas abhängt.

Was Mergado Audit beim Element CATEGORYTEXT prüft#

Ob das Element CATEGORYTEXT bei Produkten nicht fehlt oder leer ist.
Ob bei Produkten nicht mehrere Elemente CATEGORYTEXT vorkommen -> Heureka verarbeitet bei jedem Artikel nur das erste Vorkommen von CATEGORYTEXT.
Der Audit weist darauf hin, wenn CATEGORYTEXT ein ungültiges Trennzeichen zwischen den Kategorieebenen oder überflüssige zusätzliche Trennzeichen enthält. (Das korrekte Trennzeichen zwischen den einzelnen Kategorien ist beim Heureka-Feed der senkrechte Strich |).
Ob das Element CATEGORYTEXT nicht nur einen einzigen Wert (eine Ebene) der Kategorie enthält, bzw. ob in diesem Element kein ungültiger Wert steht. Korrekt sollte in diesem Element der vollständige Kategorisierungspfad bis zur tiefsten Ebene stehen, also mindestens die Kategorie samt Unterkategorie, getrennt durch das Zeichen |.
Der Audit erkennt auch, wenn CATEGORYTEXT Links (URL-Adressen) enthält, was in dieses Element nicht gehört.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element DELIVERY

Mon, 01 Jan 0001 00:00:00 +0000

Element DELIVERY#

Grundlegende Informationen#

Das Element DELIVERY ist nur eine Hülle für:

DELIVERY_ID (Kennung des Versanddienstleisters),
DELIVERY_PRICE (Versandpreis bei Vorauszahlung) und
DELIVERY_PRICE_COD (Versandpreis bei Nachnahme, COD = Cash On Delivery).

Diese Elemente dienen zur Angabe des Versandpreises für das Produkt, inklusive MwSt. Wie viele Versandarten für ein Produkt möglich sind, so oft steht der Block DELIVERY im Feed.

Die Unterelemente DELIVERY_ID und DELIVERY_PRICE sind verpflichtend. Das Unterelement DELIVERY_PRICE_COD ist nicht verpflichtend und muss im Feed nicht vorhanden sein, wenn eine Lieferung mit Nachnahme über den jeweiligen Versanddienstleister nicht möglich ist.

Element DELIVERY_DATE

Mon, 01 Jan 0001 00:00:00 +0000

Element DELIVERY_DATE#

Grundlegende Informationen#

Das Element DELIVERY_DATE enthält die Anzahl der Tage bis zum Versand des bestellten Produkts. Wenn das Produkt auf Lager ist, ist DELIVERY_DATE 0. Heureka zeigt diesen Wert nicht direkt an, sondern wandelt ihn in eine Textbeschreibung um, die im Shop auf der Produktkarte angezeigt wird:

DELIVERY_DATE		Text bei Heureka
0	->	Auf Lager
1–3	->	Innerhalb von 3 Tagen
4–7	->	Innerhalb einer Woche
8–14	->	Innerhalb von 2 Wochen
15–30	->	Innerhalb eines Monats
31 und mehr	->	Mehr als einen Monat
ohne Wert	->	Info im Shop

In DELIVERY_DATE kann auch ein Datum im Format JJJJ-MM-TT angegeben werden, dieser Wert wird als Termin verstanden, ab dem das Produkt verfügbar sein wird.

Element DESCRIPTION

Mon, 01 Jan 0001 00:00:00 +0000

Element DESCRIPTION#

Grundlegende Informationen#

Das Element DESCRIPTION enthält die lange Produktbeschreibung. Es sollte sich um eine prägnante Beschreibung und Spezifikation handeln. Es sollte keine Werbung und Aktionen enthalten, z. B. dass das Produkt kostenlosen Versand hat oder im Angebot ist. Das gehört nicht in DESCRIPTION.

Die maximale Länge ist nicht begrenzt, in der Volltextsuche werden jedoch nur die ersten 200 Zeichen angezeigt.

Spezifikation des Elements DESCRIPTION auf der Heureka-Website

Häufige Fragen#

Wie entferne ich HTML-Tags aus DESCRIPTION?
- Verwenden Sie in Mergado die Regel HTML-Tags entfernen. Diese Regel kann zusätzlich auch den Text korrigieren, wenn statt Buchstaben mit Diakritika nur HTML-Entitäten stehen.
Wie entferne ich Links aus DESCRIPTION?
- Mithilfe der Regel Suchen und ersetzen unter Verwendung regulärer Ausdrücke.
Wie kürze ich den Text in DESCRIPTION?
- Verwenden Sie die Regel Wert kürzen, mit der Sie die Beschreibung einfach auf die gewünschte Länge kürzen können.
Wie umschließe ich den Wert in DESCRIPTION mit CDATA?
- Auf der Seite Elements (Elemente) -> mithilfe des Symbols: >[c in der Zeile mit DESCRIPTION. Heureka verlangt das Umschließen des Werts mit CDATA jedoch nicht.
Wie formatiere ich die Produktbeschreibung (Überschriften, Aufzählungszeichen, Fettschrift usw.)?
- Einzeln ist das auf der Seite Products (Produkte) möglich, im Rahmen der manuellen Bearbeitung des Werts des Elements DESCRIPTION, wo ein WYSIWYG-Editor zur Verfügung steht.
- Im Stapel geht das mithilfe von künstlicher Intelligenz (KI) und der Erweiterung Mergado Sources, die die Produktbeschreibung verbessern und um HTML-Formatierung ergänzen kann.
Wie generiere ich automatisch Produktbeschreibungen mit KI?
- Probieren Sie die Zusatzerweiterung Mergado Sources aus.
Wie übersetze ich die Beschreibung in DESCRIPTION in eine andere Sprache?
- Für die maschinelle Übersetzung des Feeds in weitere Sprachen, bei der Sie nicht nur den Inhalt von DESCRIPTION, sondern auch Kategorien, Parameter und Produktnamen übersetzen können, dient die Zusatzerweiterung Mergado Translate. Sie ist an Google Translate oder DeepL angebunden und merkt sich bereits übersetzte Texte, sodass Sie nicht wiederholt für die Übersetzung desselben Textes bezahlen müssen.
Wie finde ich Produkte, bei denen die Beschreibung in DESCRIPTION fehlt?
- Erstellen Sie auf der Seite Products eine Auswahl, bei der Sie im Suchfeld das Element DESCRIPTION eintragen und anschließend die Bedingung ist leer wählen.
Wie erstelle ich eine eindeutige Beschreibung in DESCRIPTION, wenn sie bei mehreren Produkten doppelt vorkommt?
- Mithilfe der Regel Überschreiben können Sie dem Element DESCRIPTION Werte aus anderen Elementen hinzufügen, wie Parameter, Preis, Produktname oder Hersteller bzw. Kategorie. Das können Sie zum Beispiel an das Ende der bestehenden Beschreibung anfügen, indem Sie in der Regel Überschreiben in das Feld für den neuen Wert folgende Überschreibungsmaske eintragen:

%DESCRIPTION%

%PRODUCTNAME% ist ein hochwertiges Produkt der Marke %MANUFACTURER% zum Preis von %PRICE_VAT%.

Es hängt natürlich davon ab, welche Werte in den Elementen stehen; entsprechend muss die Überschreibungsmaske angepasst werden, damit der resultierende Text Sinn ergibt.

Element EAN

Mon, 01 Jan 0001 00:00:00 +0000

Element EAN#

Grundlegende Informationen#

Das Element EAN enthält den numerischen Code zur Kennzeichnung von Produkten. Heureka unterstützt EAN-13, der aus 13 Ziffern besteht.

Spezifikation des Elements EAN auf der Heureka-Website

Häufige Fragen#

Ist der EAN-Code bei Produkten verpflichtend?
- Nein, außer bei der Werbung in den Heureka-Kategorien: Bücher, Lehrbücher, Karten und Reiseführer, Filme, Musik und Comics, wo der EAN verpflichtend ist.
Wird der EAN auf Heureka zum Pairing von Produkten in Produktkarten verwendet?
- Er wird nicht direkt zum Pairing selbst verwendet, Heureka erstellt jedoch einen Report nicht gepaarter Produkte, in dem Produkte zum Pairing auf Basis übereinstimmender EAN-Codes vorgeschlagen werden.
Was, wenn ich die Produkte selbst herstelle und keinen EAN habe?
- Einen eigenen EAN-Code können Sie durch Registrierung bei einem EAN-Anbieter erhalten. Grundlegende Informationen finden Sie in unserem Artikel Was ist ein EAN-Code und wofür ist er gut?
Kann ich in Mergado Produkte mit fehlendem EAN ausblenden?
- Ja. Erstellen Sie eine Abfrage, mit der Sie solche Produkte finden, und wenden Sie darauf die Regel Hide product (Produkt ausblenden) an. Sie können auch die vorbereitete Automatisierung Produkte mit fehlendem EAN-Code ausblenden nutzen, die das für Sie erledigt.
Kann ich Produkte mit ungültigem EAN im Feed finden? (z. B. falsche Länge oder nicht-numerische Zeichen)
- Ja, mit unserer vorbereiteten Automatisierung, die Sie nur starten müssen – sie erstellt eine Abfrage der Produkte, bei denen der EAN nicht die richtige Länge hat oder nicht-numerische Zeichen enthält. Die Automatisierung heißt Produkte mit ungültigem EAN suchen.
Wie filtere ich in Mergado Produkte nach EAN-Codes?
- Durch Erstellen einer Abfrage auf der Seite Products, zum Beispiel:
  - EAN = „<konkrete Nummer>" oder
  - EAN enthält „<konkrete Nummer>" oder
  - wenn Sie Produkte nach mehreren EAN-Codes suchen möchten, verwenden Sie die Abfrage per Aufzählung.
Wie finde ich doppelte EAN-Codes?
- Auf der Seite Elements, in der Wertübersicht des Elements EAN. Folgen Sie dabei unserer Anleitung, wie Sie doppelte Werte finden.
Kann ich in Mergado Produkte mit doppelten EAN-Codes herausfiltern?
- Ja. Stellen Sie beim Import in Mergado die sogenannten Pairing-Elemente nur auf EAN ein – dann gelangen Produkte mit doppeltem EAN-Code gar nicht erst nach Mergado. Mergado entfernt sie bereits beim Import des Eingabefeeds.

Was Mergado Audit beim Element EAN prüft#

Ob EAN bei Produkten nicht fehlt oder nicht leer ist (ohne Wert).
Ob die EAN-Codes eindeutig sind und im Feed keine doppelten Werte vorkommen (d. h. derselbe EAN bei mehreren Produkten).
Ob das Element EAN keinen unzulässigen Wert enthält – anstelle des numerischen Codes stehen zum Beispiel Buchstaben, Leerzeichen oder Bindestriche im EAN.
Ob das Element EAN die richtige Länge hat.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element EXTENDED_WARRANTY

Mon, 01 Jan 0001 00:00:00 +0000

Element EXTENDED_WARRANTY#

Grundlegende Informationen#

Das Element EXTENDED_WARRANTY ist nur eine Hülle für:

VAL (Anzahl der Monate)
DESC (Beschreibung)

Diese Elemente dienen zur Angabe der verlängerten Garantie des Produkts. Der Wert des Subelements VAL wird als Anzahl der Monate der verlängerten Garantie angegeben – bei einer dreijährigen Garantie geben Sie zum Beispiel an: 36.

Die maximale Länge des Subelements DESC beträgt 128 Zeichen.

Spezifikation des Elements EXTENDED_WARRANTY auf der Heureka-Website

Häufige Fragen#

Wie zeige ich bei Produkten auf Heureka das Label Verlängerte Garantie an?
- Eine Anleitung finden Sie im Artikel in unserem Blog: Wie Sie auf Heureka die verlängerte Garantie EXTENDED_WARRANTY einrichten.
Kann die verlängerte Garantie im XML-Feed als Anzahl der Jahre angegeben werden?
- Nein. Laut Heureka-Spezifikation muss die Garantiedauer im Element EXTENDED_WARRANTY | VAL als Anzahl der Monate angegeben werden, zum Beispiel:
  - statt 3 (gemeint sind Jahre) geben Sie hier an: 36 (gemeint sind Monate),
  - statt 5 (Jahre) geben Sie hier 60 (Monate) an usw.
- Im Element EXTENDED_WARRANTY | DESC können Sie in der Beschreibung durchaus auch die Anzahl der Jahre nennen – die Anforderung nach Monaten betrifft nur das Element EXTENDED_WARRANTY | VAL.
Wie stelle ich für verschiedene Produktgruppen unterschiedliche Werte der verlängerten Garantie ein?
- Verwenden Sie die Regel Bulk rewriting by query (Im Stapel nach Abfrage überschreiben).

Was Mergado Audit beim Element EXTENDED_WARRANTY prüft#

Der Audit prüft die maximale Länge der Beschreibung im Element EXTENDED_WARRANTY | DESC, die 128 Zeichen beträgt.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element GIFT

Mon, 01 Jan 0001 00:00:00 +0000

Element GIFT#

Grundlegende Informationen#

Das Element GIFT enthält die Textbeschreibung eines kostenlosen Geschenks zum Produkt. GIFT kann im Feed mehrfach vorkommen, sofern alle diese Geschenke ohne weitere Bedingungen kostenlos zum Produkt dazugehören.

Bei mehreren GIFT-Elementen können die einzelnen Geschenke mit dem verschachtelten Attribut ID unterschieden werden. Jedes Geschenk kann so optional seine eigene Kennung haben.

Die maximale Textlänge im Element GIFT beträgt 250 Zeichen.

Spezifikation des Elements GIFT auf der Heureka-Website

Wie arbeite ich in Mergado mit dem Attribut ID des Elements GIFT?#

In Mergado wird vor den Namen von Attributen das Zeichen @ gesetzt. Der grundlegende Pfad zum Attribut ID unter dem Element GIFT würde in Abfragen oder Regeln so aussehen: GIFT | @ID

Element HEUREKA_CPC

Mon, 01 Jan 0001 00:00:00 +0000

Element HEUREKA_CPC#

Grundlegende Informationen#

Das Element HEUREKA_CPC enthält den Klickpreis. Es ist der maximale Betrag, den der Verkäufer bereit ist zu zahlen, um einen Besucher von Heureka in seinen Onlineshop zu bringen.

Als Dezimaltrennzeichen wird ein Komma verwendet: , Der maximal mögliche Wert von HEUREKA_CPC ist 1000.

Spezifikation des Elements HEUREKA_CPC auf der Heureka-Website

Im Zusammenhang mit der Einstellung von HEUREKA_CPC wird der Begriff Bidding verwendet, also die Einstellung eines geeigneten Klickpreises.

Element IMGURL

Mon, 01 Jan 0001 00:00:00 +0000

Element IMGURL#

Grundlegende Informationen#

Das Element IMGURL enthält die Adresse des Hauptbilds des Produkts. Diese Adresse darf keine Leerzeichen oder diakritischen Zeichen enthalten. Die Bildadresse kann bei mehreren Produkten gleich sein, sie muss nicht eindeutig sein.

Die Mindestanforderungen an das Produktbild sind:

Auflösung von mindestens 30.000 Pixeln, was ungefähr 175 × 175 Pixeln entspricht
darf keine Wasserzeichen enthalten
darf keine Rabatte, Boni oder etwaige Produktauszeichnungen enthalten

Die maximale Länge der Bildadresse beträgt 255 Zeichen. Die maximale Bildgröße beträgt 4096 × 4096 Pixel, die Dateigröße darf 2000 KB (2 MB) nicht überschreiten.

Element IMGURL_ALTERNATIVE

Mon, 01 Jan 0001 00:00:00 +0000

Element IMGURL_ALTERNATIVE#

Grundlegende Informationen#

Das Element IMGURL_ALTERNATIVE enthält die Adresse eines weiteren Produktbilds, das nicht das Hauptbild ist. Es kann sich um eine Ansicht aus einem anderen Blickwinkel oder um die vollständige Verpackung des Produkts handeln.

Es kann bei Produkten im Feed mehrfach vorkommen. Heureka gibt jedoch nicht an, wie viele alternative Bilder ein Produkt haben darf.

Die Abmessungen alternativer Bilder, deren Mindestauflösung sowie die Datengröße gibt Heureka nicht an. Es ist anzunehmen, dass für alternative Produktbilder dasselbe gilt wie für das Hauptbild in IMGURL.

Element ISBN

Mon, 01 Jan 0001 00:00:00 +0000

Element ISBN#

Grundlegende Informationen#

Das Element ISBN betrifft nur den Buchsortiment, es handelt sich um die eindeutige Nummer der Buchausgabe. Heureka unterstützt die Formate ISBN-10 und ISBN-13. Die einzelnen Teile des ISBN-Codes werden durch einen Bindestrich getrennt: -

Spezifikation des Elements ISBN auf der Heureka-Website

Häufige Fragen#

Wie füge ich das Element ISBN hinzu, wenn es im Feed fehlt?
- Klicken Sie im Mergado Editor auf der Seite Elements auf die Schaltfläche New element (Neues Element) und geben Sie als Namen ein: ISBN.

Was Mergado Audit beim Element ISBN prüft#

Ob das Element ISBN keine unzulässigen Zeichen enthält – erlaubt sind nur Zahlen und Bindestriche.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element ITEM_ID

Mon, 01 Jan 0001 00:00:00 +0000

Element ITEM_ID#

Grundlegende Informationen#

Das Element ITEM_ID ist der eindeutige Identifikator der Produkte im Feed. Es ist sowohl für Heureka als auch für Heureka Marketplace erforderlich.

Es darf höchstens 36 Zeichen enthalten. In den Werten von ITEM_ID sind erlaubt: Klein- und Großbuchstaben ohne diakritische Zeichen, Zahlen, Bindestriche und Unterstriche.

Spezifikation des Elements ITEM_ID auf der Heureka-Website

Häufige Fragen#

Wird ITEM_ID zum Pairing von Produkten in Produktkarten verwendet?
- Nein. Für das Pairing werden der Produktname und die Kategorie verwendet, mehr dazu im Artikel Umfassender Leitfaden zum Produkt-Pairing auf Heureka mit Mergado.
Kann ITEM_ID im Feed doppelt vorkommen, also bei mehreren Produkten gleich sein?
- Nein, ITEM_ID muss bei jedem Produkt eindeutig sein, damit Heureka das Produkt im Rahmen des Dienstes Verified by Customers oder im Verfügbarkeitsfeed korrekt identifizieren kann, wo ITEM_ID als eindeutiger Identifikator verwendet wird.
- Wie Sie Produkte mit doppelten Werten in ITEM_ID finden und ausblenden, beschreiben wir in der Anleitung Wie Sie doppelte Werte finden.
Was, wenn ITEM_ID in meinem Feed fehlt – lässt sich das in Mergado beheben?
- Ja. Mit der Regel Rewrite können Sie das Element ITEM_ID mit der Mergado-Systemvariable @MERGADO_ID befüllen, die für jedes Produkt eine eindeutige Nummer enthält. So erhalten Sie eindeutige Werte für jede ITEM_ID.
- Dafür können Sie auch die vorbereitete Automatisierung ITEM_ID from MERGADO_ID (ITEM_ID aus MERGADO_ID) nutzen, die Sie nur starten müssen.
- Weitere mögliche Lösungen: Produkte mit fehlender ITEM_ID mit der Regel Hide product (Produkt ausblenden) ausblenden oder Werte in ITEM_ID mit der Regel Data file import (Datendatei-Import) importieren.
Was ist der Unterschied zwischen ITEM_ID und ITEMGROUP_ID?
- ITEM_ID muss bei jedem Produkt eindeutig sein, während Werte in ITEMGROUP_ID bei Varianten desselben Produkts gleich (doppelt) sein können. ITEMGROUP_ID ist nämlich der gemeinsame Identifikator der Produktvarianten.
Wie filtere ich Produkte nach bestimmten ITEM_ID-Werten?
- Erstellen Sie in Mergado auf der Seite Products eine Abfrage der Werte des Elements ITEM_ID per Aufzählung, d. h. mit der Bedingung ist in der Aufzählung enthalten.

Was Mergado Audit beim Element ITEM_ID prüft#

Ob das Element ITEM_ID bei Produkten nicht fehlt oder nicht leer ist.
Ob das Element ITEM_ID die richtige Länge hat (höchstens 36 Zeichen) und keine unzulässigen Werte enthält, also: Unterstriche, Bindestriche, Zahlen sowie Klein- und Großbuchstaben ohne diakritische Zeichen. In ITEM_ID dürfen also weder Leerzeichen noch Buchstaben mit diakritischen Zeichen vorkommen.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element ITEM_TYPE

Mon, 01 Jan 0001 00:00:00 +0000

Element ITEM_TYPE#

Grundlegende Informationen#

Das Element ITEM_TYPE dient zur Kennzeichnung eines Produkts, das nicht neu ist. In diesem Fall wird in diesem Element der Wert bazar angegeben.

Spezifikation des Elements ITEM_TYPE auf der Heureka-Website

Häufige Fragen#

Ist es möglich, gebrauchte oder geöffnete Ware auf Heureka zu bewerben?
- Ja, bei solchen Produkten muss im Element ITEM_TYPE der Wert bazar angegeben werden. Ein solches Produkt erscheint nicht in den Produktkarten der Kategorien, lässt sich aber über die Volltextsuche von Heureka finden.

Was Mergado Audit beim Element ITEM_TYPE prüft#

Ob das Element ITEM_TYPE keine unzulässigen Werte enthält – es darf nur new oder bazar enthalten.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element ITEMGROUP_ID

Mon, 01 Jan 0001 00:00:00 +0000

Element ITEMGROUP_ID#

Grundlegende Informationen#

Das Element ITEMGROUP_ID ist der gemeinsame Identifikator für Produkte, die Varianten bilden. Heureka verlangt nämlich, dass Produktvarianten als separate SHOPITEMs angegeben werden. Das heißt, jede Variante, zum Beispiel eine bestimmte Größe oder Farbe, wird im Feed als eigenständiges Produkt aufgeführt. Mithilfe von ITEMGROUP_ID können Sie die einzelnen Gruppen von Variantenprodukten mit demselben Code kennzeichnen – der Gruppen-ID.

Ebenso wie ITEM_ID darf das Element ITEMGROUP_ID höchstens 36 Zeichen enthalten. In den Werten sind erlaubt: Klein- und Großbuchstaben ohne diakritische Zeichen, Zahlen, Bindestriche und Unterstriche.

Element MANUFACTURER

Mon, 01 Jan 0001 00:00:00 +0000

Element MANUFACTURER#

Grundlegende Informationen#

Das Element MANUFACTURER soll den Namen des Produktherstellers enthalten, gegebenenfalls die Marke, unter der das Produkt bekannt ist. Der Wert dieses Elements wird zur Filterung innerhalb von Kategorien auf Heureka verwendet.

MANUFACTURER wird nicht zum Pairing von Produkten in Produktkarten verwendet, daher muss der Hersteller bei jedem Produkt im Feed zusätzlich im Produktnamen angegeben werden, also im Element PRODUCTNAME.

Spezifikation des Elements MANUFACTURER auf der Heureka-Website

Häufige Fragen#

Wie füge ich den Herstellernamen aus MANUFACTURER zu PRODUCTNAME hinzu?
- Dafür haben wir die Automatisierung Add producer to product title (Hersteller zum Produkttitel hinzufügen) vorbereitet – starten Sie sie einfach.
Wie filtere ich Produkte nach bestimmten Herstellern?
- Verwenden Sie als Abfragebedingung die Aufzählung.
Wie entferne ich einen doppelten Herstellernamen aus dem Produktnamen?
- Das erledigen Sie mithilfe regulärer Ausdrücke.
Was, wenn bei meinen Produkten der Hersteller fehlt?
- Befüllen Sie das Element MANUFACTURER dann mindestens mit dem Namen Ihres Onlineshops mithilfe der Automatisierung Store name into MANUFACTURER if missing (Shopname in MANUFACTURER, falls fehlend).

Was Mergado Audit beim Element MANUFACTURER prüft#

Ob das Element MANUFACTURER bei Produkten nicht fehlt oder nicht leer ist.
Ob das Element MANUFACTURER die richtige Länge hat – weder zu kurz noch zu lang (nicht länger als 255 Zeichen).
Der Audit erkennt auch, wenn MANUFACTURER nur Kleinbuchstaben enthält – der Herstellername sollte mindestens mit einem großen Anfangsbuchstaben geschrieben sein.
Ein spezifischer Fehler kann eine falsche Zeichenkodierung im Wert des Elements MANUFACTURER sein, worauf der Feed-Audit ebenfalls hinweist.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element PARAM

Mon, 01 Jan 0001 00:00:00 +0000

Element PARAM#

Grundlegende Informationen#

Das Element PARAM ist nur eine Hülle für:

PARAM_NAME (Parametername) und
VAL (Parameterwert).

Diese drei Elemente dienen zur Angabe von Produktparametern. Wie viele Parameter ein Produkt hat, so viele PARAM-Blöcke wird es im Feed geben.

Parameter werden bei Heureka zum Filtern von Produkten innerhalb einer Kategorie verwendet.

Spezifikation des Elements PARAM auf der Heureka-Website

Hinweis: Bei manchen Produkten müssen die sogenannten Pflichtparameter auch im Produktnamen enthalten sein, im Element PRODUCTNAME.

Element PRICE_VAT

Mon, 01 Jan 0001 00:00:00 +0000

Element PRICE_VAT#

Grundlegende Informationen#

Das Element PRICE_VAT enthält den Endpreis inklusive MwSt. und eventueller Urheber- oder Recyclinggebühren. Als Dezimaltrennzeichen kann ein Komma , oder ein Punkt . verwendet werden, maximal 2 Nachkommastellen.

Spezifikation des Elements PRICE_VAT auf der Heureka-Website

Häufige Fragen#

Ist es möglich, Preise automatisch an die Konkurrenz anzupassen?
- Ja, verwenden Sie die Mergado-Erweiterung Pricing Fox. Sie ändert die Preise des Sortiments automatisch entsprechend der Bewegung der Konkurrenzpreise und Ihrer eingestellten Anforderungen, damit Ihr Angebot bestmöglich positioniert ist.
Wie runde ich den Preis in PRICE_VAT?
- Verwenden Sie die Regel Round Numbers (Zahlen runden). Achten Sie jedoch darauf, dass der Preis im Ausgabefeed mit dem im Onlineshop angezeigten Preis übereinstimmen muss. Verwenden Sie also die gleiche Rundungsart wie bei den Preisen im Onlineshop.
Wie rechne ich die Währung mithilfe eines Kurses um, z. B. von EUR in CZK oder umgekehrt von CZK in EUR für die slowakische Heureka?
- Verwenden Sie die Regel Calculation (Berechnung) mit einem festen oder dynamischen Koeffizienten (Variable). Eine konkrete Anleitung finden Sie im Artikel Rechnen Sie die Währung bequem mit Mergado um auf unserem Blog.
Soll im Element PRICE_VAT auch die Währung angegeben werden?
- Nein, geben Sie in diesem Element nur den Zahlenwert an, also nur den Betrag ohne Währungssymbol CZK oder EUR.
Welchen Preis soll ich in PRICE_VAT angeben, wenn ein Rabattgutschein SALES_VOUCHER verwendet wird?
- Wenn bei einem Produkt ein Rabattgutschein vorhanden ist (siehe Element SALES_VOUCHER), muss in PRICE_VAT der Preis angegeben werden, der nach Anwendung dieses Gutscheins gilt.

Was Mergado Audit beim Element PRICE_VAT prüft#

Ob das Element PRICE_VAT bei Produkten nicht fehlt oder leer ist.
Ob das Element PRICE_VAT eine positive Zahl enthält. Der Warenpreis inklusive MwSt. muss immer eine positive Zahl sein.
Ob im Element keine zu hohe Zahl steht, z. B. ob kein Wert über 1.000.000 CZK enthalten ist, was ein Tippfehler sein könnte.
Im Zusammenhang mit dem Element VAT prüft der Audit, ob im Feed nicht gleichzeitig PRICE_VAT und VAT fehlen (wenn z. B. Preise im Element PRICE angegeben sind, also ohne MwSt., sollte im Feed das Element VAT nicht fehlen).

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element PRODUCT

Mon, 01 Jan 0001 00:00:00 +0000

Element PRODUCT#

Grundlegende Informationen#

PRODUCT sollte denselben Wert wie PRODUCTNAME plus eventuelle Zusatzinformationen enthalten. Es handelt sich um den erweiterten Produktnamen.

Die Informationen können zum Beispiel die Ablaufzeit, die Vertriebsart des Produkts oder Hinweise zur Selbstabholung enthalten.

Die maximale Länge beträgt 255 Zeichen für die Anzeige in der Volltextsuche, bei der Produktkarte maximal 200 Zeichen.

Spezifikation des Elements PRODUCT auf der Heureka-Website

Häufige Fragen#

Muss das Element PRODUCT im Feed vorhanden sein?
- Nicht zwingend, wenn PRODUCTNAME im Feed vorhanden ist.
Wie bekomme ich denselben Inhalt wie in PRODUCTNAME in das Element PRODUCT?
- Verwenden Sie die Regel Bulk Copy Values (Werte im Stapel kopieren), mit der Sie den Inhalt des Elements PRODUCTNAME in das Element PRODUCT kopieren. Dabei wird der bisherige Wert in PRODUCT durch den Wert aus PRODUCTNAME überschrieben.
Welche zusätzlichen Informationen kann das Element PRODUCT im Vergleich zu PRODUCTNAME enthalten?
- Zum Beispiel die Ablaufzeit, die Vertriebsart des Produkts oder Hinweise zur Selbstabholung.
Welche Informationen darf das Element PRODUCT nicht enthalten?
- Es darf nicht enthalten:
  - Informationen zur verlängerten Garantie – diese geben Sie in EXTENDED_WARRANTY an.
  - Zusatzleistungen wie Transport in ein Stockwerk, Service/Austausch/Installation eines Geräts usw. Diese Leistungen geben Sie im Element SPECIAL_SERVICE an.
  - Informationen zu kostenlosem Versand – diese geben Sie im Element DELIVERY an.
  - Informationen zur Verfügbarkeit der Produkte – diese geben Sie im Element DELIVERY_DATE oder in einem separaten Verfügbarkeits-Feed an, den Heureka unterstützt.
  - Weitere Beispiele finden Sie in der Spezifikation des Elements PRODUCT direkt auf der Heureka-Website.

Was Mergado Audit beim Element PRODUCT prüft#

Ob PRODUCT nicht doppelt vorkommt, d. h. ob es für jedes Produkt im Feed eindeutig ist.
Ob das Element PRODUCT die richtige Länge hat (höchstens 255 Zeichen).
Der Audit erkennt auch, wenn PRODUCT zusätzliche Wörter wie „Ratenzahlung", „Aktionspreis", „Selbstabholung", URL-Adressen oder nicht standardmäßige Zeichen enthält.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element PRODUCTNAME

Mon, 01 Jan 0001 00:00:00 +0000

Element PRODUCTNAME#

Grundlegende Informationen#

PRODUCTNAME ist der genaue Produktname. Es ist ein Pflichtelement im Heureka-Feed. Es wird für das Pairing von Produkten verwendet. Für bestimmte Sortimente muss es die von Heureka geforderten Angaben erfüllen, z. B. muss bei Bekleidung die Größe im Namen enthalten sein. Gleichzeitig darf es keine weiteren Angaben enthalten, die nicht mit dem Produktnamen zusammenhängen, wie Geschenke zum Produkt, Garantieinformationen und andere. Die maximale Länge beträgt 200 Zeichen.

Element SALES_VOUCHER

Mon, 01 Jan 0001 00:00:00 +0000

Element SALES_VOUCHER#

Grundlegende Informationen#

Das Element SALES_VOUCHER ist nur eine Hülle für:

CODE (Rabattgutschein-Code) und
DESC (Beschreibung der Rabattaktion).

Diese drei Elemente dienen dazu, Nutzern einen Rabattcode für das jeweilige Produkt bereitzustellen. Der Wert des Subelements CODE enthält den Rabattcode, den der Kunde anschließend beim Einkauf im Onlineshop verwendet. Wenn die Rabattaktion zeitlich begrenzt ist, empfiehlt es sich, das Gültigkeitsdatum im Subelement DESC anzugeben.

Die maximale Länge des Subelements CODE beträgt 24 Zeichen.
Die maximale Länge des Subelements DESC beträgt 128 Zeichen.

Spezifikation des Elements SALES_VOUCHER auf der Heureka-Website

Einstellung von PRICE_VAT bei einem Rabattgutschein#

Wenn bei einem Produkt ein Rabattgutschein angegeben ist, muss gleichzeitig im Element PRICE_VAT der bereits reduzierte Preis angegeben werden, der dem Kunden im Onlineshop nach Anwendung des Rabattgutscheins angezeigt würde.

Element SHOP

Mon, 01 Jan 0001 00:00:00 +0000

Element SHOP#

Grundlegende Informationen#

SHOP ist das Wurzelelement des Heureka-Produktfeeds. Mit diesem Element beginnen die eigentlichen Daten (davor steht nur der Header, also die Zeile, die die XML-Version und die Zeichenkodierung definiert, üblicherweise in der Form <?xml version="1.0" encoding="utf-8"?>).

Spezifikation des Elements SHOP auf der Heureka-Website.

Häufige Fragen#

Kann das Element SHOP im Heureka-Feed mehrfach vorkommen?
- Nein, es darf nur einmal vorhanden sein. Genauer gesagt steht am Anfang des Feeds das Element <SHOP> und am Ende </SHOP>, ansonsten darf es im Feed nicht vorkommen.

Was Mergado Audit beim Element SHOP prüft#

Ob das Wurzel-XML-Tag SHOP nur einmal vorkommt und nicht mehrfach im Feed enthalten ist.
Ob das Element SHOP im Feed nicht fehlt.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element SHOPITEM

Mon, 01 Jan 0001 00:00:00 +0000

Element SHOPITEM#

Grundlegende Informationen#

SHOPITEM ist das Hüllelement der Produkte. Es kommt im Feed so oft vor, wie Sie Produkte haben. Wenn Ihre Produkte Varianten haben, z. B. Kleidungsgrößen, Parfümflaschenvolumen usw., muss jede Produktvariante ihr eigenes SHOPITEM haben. Heureka verlangt, Produktvarianten als separate Positionen im Feed anzugeben.

Spezifikation des Elements SHOPITEM auf der Heureka-Website

Häufige Fragen#

Wenn der Eingabefeed zusammengeführte Varianten enthält, werden solche Positionen dann automatisch in separate SHOPITEM aufgeteilt?
- Ja, dazu muss jedoch im Assistenten zum Erstellen eines neuen Projekts das passende Eingabeformat gewählt werden. Für Integrationen wie Shoptet, Upgates, Malfini und andere, die zusammengeführte Varianten generieren können, muss z. B. als Eingabeformat in Mergado die Version des jeweiligen Formats mit der Bezeichnung „Produktvarianten als separate Positionen" gewählt werden. Dadurch wird sichergestellt, dass eventuelle Variantenprodukte aus dem Eingabefeed beim Import in Mergado automatisch in separate SHOPITEM aufgeteilt werden.

Was Mergado Audit beim Element SHOPITEM prüft#

Ob die Produkte im Feed innerhalb der Elemente <SHOPITEM> … </SHOPITEM> Daten enthalten (und es sich somit nicht um „leere Produkte" handelt).
Ob sich kein Element im Feed außerhalb der Hüllelemente der Position <SHOPITEM> und </SHOPITEM> befindet.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element SPECIAL_SERVICE

Mon, 01 Jan 0001 00:00:00 +0000

Element SPECIAL_SERVICE#

Grundlegende Informationen#

Das Element SPECIAL_SERVICE dient zur Angabe von Zusatzleistungen zum Kauf eines Produkts, wie zum Beispiel: „Transport ins Stockwerk" oder „Kostenlose Geräteinstallation" usw. Dieses Element kann bei jedem Produkt im Feed höchstens 5-mal angegeben werden, sodass maximal 5 Zusatzleistungen zum Kauf des Produkts angegeben werden können.

Die maximale Textlänge im Element SPECIAL_SERVICE beträgt 128 Zeichen.

Spezifikation des Elements SPECIAL_SERVICE auf der Heureka-Website

Häufige Fragen#

Wie viele SPECIAL_SERVICE-Elemente kann es bei jedem Produkt im Feed geben?
- Maximal 5.
Wie füge ich das Element SPECIAL_SERVICE hinzu, wenn es im Feed fehlt?
- Erstellen Sie auf der Seite Elements (Elemente) zunächst ein neues Element mit dem Namen SPECIAL_SERVICE, gehen Sie dann zur Seite Rules (Regeln) und Sie können es mit einem Wert befüllen. Wenn Sie bei Produkten SPECIAL_SERVICE mehrfach angeben möchten, verwenden Sie zur Erstellung des zweiten bis fünften Werts die Regel Add a Value to a Multi-Value Element (Wert zu einem Mehrfachelement hinzufügen) oder die Regel Rewrite (Überschreiben) zusammen mit der Angabe einer konkreten Position.
Was kann SPECIAL_SERVICE enthalten?
- Zum Beispiel:
  - Kostenlose Geräteinstallation
  - Kostenlose Montage
  - Kostenloser Service
  - Entsorgung von Verpackungen/Verpackungsmaterial
  - Transport ins Stockwerk
  - Verlängerung des Garantie-/Nachgarantieservices
  - Verlängerte Rückgabefrist
  - und andere.
Was darf SPECIAL_SERVICE nicht enthalten?
- Jegliche Rabatte, Aktionen, Boni, Informationen zum Ratenkauf, Informationen zur Selbstabholung oder zum kostenlosen Versand (diese geben Sie in DELIVERY an), Erwähnungen eines autorisierten Händlers oder Informationen zur Verfügbarkeit (diese geben Sie in DELIVERY_DATE an).

Was Mergado Audit beim Element SPECIAL_SERVICE prüft#

Der Audit prüft die maximale Textlänge in jedem der Elemente SPECIAL_SERVICE, die 128 Zeichen beträgt.
Der Audit überwacht auch die maximal zulässige Anzahl dieser Elemente bei einem Produkt, die 5 beträgt. Diese Kontrolle ist besonders wichtig, weil Heureka die Informationen aus allen diesen Elementen ignorieren würde, wenn SPECIAL_SERVICE bei einem Produkt mehr als 5-mal vorkäme.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element URL

Mon, 01 Jan 0001 00:00:00 +0000

Element URL#

Grundlegende Informationen#

Das Element URL enthält den Link zum konkreten Produkt im Onlineshop, über den das Produkt in den Warenkorb gelegt werden kann. Die URL-Adresse des Produkts muss über alle Produkte im Feed hinweg eindeutig sein.

Die maximale Länge beträgt 300 Zeichen.

Spezifikation des Elements URL auf der Heureka-Website

Häufige Fragen#

Wie füge ich UTM-Parameter zur URL hinzu?
- Verwenden Sie die Regel Set UTM Parameters (UTM-Parameter setzen), die genau dafür vorgesehen ist.
Wie entferne ich UTM- und andere Parameter aus der URL?
- Mithilfe der Regel Find and Replace (Suchen und ersetzen) unter Verwendung regulärer Ausdrücke.
Wie behebe ich doppelte URL-Adressen, zum Beispiel bei Variantenprodukten?
- Mithilfe der Regel Rewrite (Überschreiben) können Sie am Ende der URL-Adressen das Zeichen # und dahinter die Systemvariable @@MERGADO_ID hinzufügen, die für jedes Produkt im Feed eindeutig ist. Beispiel für die Überschreibmaske der Regel: %URL%#%@@MERGADO_ID% Auf diese Weise machen Sie aus doppelten URL-Adressen eindeutige, ohne dass der eigentliche Link zur Produktseite im Onlineshop beeinflusst wird.
Werden Produkte bei Heureka entpaart, wenn sich ihre URL-Adresse ändert?
- Ja, wenn sich jedoch die übrigen Werte in den für das Pairing wichtigen Elementen (PRODUCTNAME und CATEGORYTEXT) nicht geändert haben, paart Heureka das Produkt bald wieder der Produktkarte zu.

Was Mergado Audit beim Element URL prüft#

Ob das Element URL bei Produkten nicht fehlt oder leer ist.
Ob URL nicht doppelt vorkommt, d. h. ob es für jedes Produkt im Feed eindeutig ist.
Der Audit überwacht auch das korrekte Format der URL-Adresse.

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.

Element VAT

Mon, 01 Jan 0001 00:00:00 +0000

Element VAT#

Grundlegende Informationen#

Das Element VAT enthält die Mehrwertsteuer (MwSt.) in Prozent angegeben, z. B. 21 %. Es ist bei Waren mit abweichendem (ermäßigtem) MwSt.-Satz im Heureka-Warenkorb Pflicht.

Spezifikation des Elements VAT auf der Heureka-Website

Häufige Fragen#

Welches Zahlenformat soll VAT haben?
- Es sollte sich um eine ganze Zahl handeln, idealerweise mit dem Zeichen %, zum Beispiel 21 %.
Wie passe ich VAT an, wenn darin eine Dezimalzahl steht, zum Beispiel 0,21?
- Entweder können Sie mit der Regel Rewrite (Überschreiben) den Wert auf den konkreten Steuersatz ändern, oder mit der Regel Calculation (Berechnung) mit 100 multiplizieren (die Formel in der Regel wäre: %VAT%*100).

Was Mergado Audit beim Element VAT prüft#

Ob das Element VAT keinen unzulässigen Wert enthält, es sollte den MwSt.-Satz in Prozent enthalten, zum Beispiel 21 %.
Im Zusammenhang mit dem Element PRICE_VAT prüft der Audit, ob im Feed nicht gleichzeitig VAT und PRICE_VAT fehlen (wenn z. B. Preise im Element PRICE angegeben sind, also ohne MwSt., sollte im Feed das Element VAT nicht fehlen).

Falls Sie nicht weiterwissen, kontaktieren Sie einfach unseren technischen Support.