Regel: Wert zu einem Mehrfachelement hinzufügen#

Das Grundprinzip der Regel besteht darin, dass sie dem von Ihnen gewählten, bereits bestehenden Element einen weiteren Wert hinzufügt.

Zusatzfunktionen#

Wie verhält sich die Regel in verschiedenen Situationen? Wenn:

das Element noch keinen Wert hat – wird der neue Wert an der ersten Position hinzugefügt, es entsteht dabei noch kein Mehrfachelement:
- <g:additional_image_link></g:additional_image_link> -> <g:additional_image_link>neuer Wert</g:additional_image_link>
das Element bereits einen Wert hat – wird der neue Wert an der nächsten, also zweiten Position hinzugefügt, dabei entsteht ein Mehrfachelement:
- <g:additional_image_link>ursprünglicher WertA</g:additional_image_link> -> <g:additional_image_link>ursprünglicher WertA</g:additional_image_link> <g:additional_image_link>neuer Wert</g:additional_image_link>
das Element bereits mehrere Werte hat (also schon ein Mehrfachelement ist) – wird der neue Wert an der nächsten, also ersten freien Position hinzugefügt:
- <g:additional_image_link>ursprünglicher WertA</g:additional_image_link> <g:additional_image_link>ursprünglicher WertB</g:additional_image_link> -> <g:additional_image_link>ursprünglicher WertA</g:additional_image_link> <g:additional_image_link>ursprünglicher WertB</g:additional_image_link> <g:additional_image_link>neuer Wert</g:additional_image_link>

Konkrete Beispiele#

Beispiel 1: Hinzufügen einer weiteren URL für ein alternatives Bild#

1. Erstellen einer neuen Regel:

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

2. Auswahl des Regeltyps:

Wählen Sie im Feld Rule type (Regeltyp) die Option Add a Value to a Multi-Value Element (Wert zu einem Mehrfachelement hinzufügen).

3. 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 Sie die Regel anwenden möchten.

4. Auswahl des Elements für die Änderung:

Wählen Sie im Feld Element das Element, bei dem Sie die Änderung vornehmen möchten.
In unserem Fall ist das g:additional_image_link

5. Geben Sie den neuen Wert ein:

Geben Sie im Feld New value (Neuer Wert) ein:
- einen Textwert, zum Beispiel eine konkrete URL (https://www…)
- eine Variable, in der der Wert gespeichert ist, zum Beispiel: %url%
- eine Kombination aus Variable und Text, zum Beispiel: https://www.mein-shop.com/%image_handle%

6. Benennung der Regel:

Geben Sie im letzten Schritt einen Regelnamen ein, zum Beispiel: „Alternative Bilder hinzufügen".

Weitere Verwendung der Regel#

Weitere alternative Kategorien hinzufügen.

FAQ#

Wozu dient die Regel „Wert zu einem Mehrfachelement hinzufügen"?#

Diese Regel ermöglicht es, einen neuen Wert zu einem bestehenden Element hinzuzufügen, das mehrere Werte unterstützt (z. B. Bilder, Kategorien oder Parameter). Sie wird typischerweise verwendet, um weitere Bild-URLs (g:additional_image_link) oder alternative Kategorien zu ergänzen.

Wie verhält sich die Regel, wenn das Element noch keinen Wert hat?#

Wenn das Element noch keinen Wert hat, erstellt Mergado den ersten Wert, und das Element gilt noch nicht als Mehrfachelement.

<g:additional_image_link></g:additional_image_link> → <g:additional_image_link>neuer Wert</g:additional_image_link>

Was passiert, wenn das Element einen oder mehrere Werte hat?#

Hat es einen Wert, wird der neue Wert an der nächsten Position hinzugefügt, und das Element wird zu einem Mehrfachelement.
Hat es mehrere Werte, wird der neue Wert an der ersten freien Stelle hinzugefügt (also als nächster Eintrag in der Reihenfolge).

💡 Beispiel:

<g:additional_image_link>ursprünglichA</g:additional_image_link>

→

<g:additional_image_link>ursprünglichA</g:additional_image_link>

<g:additional_image_link>neuer_wert</g:additional_image_link>

Kann ich mit dieser Regel mehrere Werte gleichzeitig hinzufügen?#

Nicht direkt. Jede Regel fügt einen Wert pro Zeile hinzu. Wenn Sie mehrere Werte hinzufügen möchten (z. B. mehrere Bild-URLs), verwenden Sie mehrere Regeln dieses Typs.

Welche Arten von Werten kann ich zum Element hinzufügen?#

Im Feld New value (Neuer Wert) können Sie eingeben:

einen Textwert, z. B. https://www.meinshop.de/img123.jpg,
eine Variable, z. B. %url%,
eine Kombination aus Text und Variable, z. B. https://cdn.meinshop.de/%image_name%.

Kann ich mit dieser Regel auch einen dynamischen Wert aus einem anderen Element hinzufügen?#

Ja. Wenn Sie einen Wert aus einem anderen Element hinzufügen möchten, verwenden Sie dessen Variable (z. B. %g:image_link%). Mergado ergänzt bei der Neugenerierung automatisch den Wert jedes Produkts anhand dieser Variable.

Woran erkenne ich, dass mein Element ein Mehrfachelement ist?#

Auf der Seite Elemente im Projekt wird bei Mehrfachelementen (z. B. g:additional_image_link) die maximale Anzahl der Werte in Klammern angezeigt, z. B. (6×). Solche Elemente können bei einem Produkt mehrfach vorkommen. Eine Übersicht finden Sie in der Dokumentation: Mehrfachelemente in Mergado.

Kann die Regel auch für andere Zwecke als Bilder verwendet werden?#

Ja. Die Regel kann zum Beispiel verwendet werden für:

das Hinzufügen weiterer Kategorien,
das Ergänzen alternativer URLs,
die Erweiterung der Parameterliste (z. B. Hinzufügen eines neuen Parameters bei Produkten mit einer bestimmten Abfrage).

Kann der hinzugefügte Wert auf bestimmte Produkte beschränkt werden?#

Ja. Im Feld „Query" (Abfrage) können Sie entweder All products (Alle Produkte) wählen oder eine eigene Abfrage erstellen, zum Beispiel nur für Produkte einer bestimmten Marke, Kategorie oder mit fehlendem Bild.

Was passiert, wenn das Element, zu dem ich hinzufügen möchte, im Feed fehlt?#

Die Regel erstellt es nicht automatisch – Sie müssen es zuerst manuell hinzufügen:

Öffnen Sie die Seite Elements (Elemente),
klicken Sie auf New element (Neues Element),
geben Sie den Elementnamen ein (z. B. g:additional_image_link),
und bestätigen Sie die Erstellung.

Kann das Hinzufügen von Werten zeitlich geplant werden?#

Ja. Wenn Sie zum Beispiel Links nur in einem bestimmten Zeitraum hinzufügen möchten (z. B. saisonale Bilder), können Sie den Regel-Timer aktivieren und konkrete Tage oder Stunden einstellen, an denen die Regel ausgeführt werden soll.

Wie überprüfe ich, dass das Hinzufügen des Werts erfolgreich war?#

Nach dem Speichern und Anwenden der Regeln oder nach der Neugenerierung des Feeds:

öffnen Sie die Seite Elements (Elemente) oder die Seite Products (Produkte),
überprüfen Sie, dass die neue Wertzeile hinzugekommen ist,
oder starten Sie den Rule walkthrough (Regeldurchlauf) für ein konkretes Produkt – er zeigt Ihnen das Ergebnis der Regel in Echtzeit.

Kann diese Regel einen bestehenden Wert ersetzen?#

Nein. Die Regel fügt nur neue Werte hinzu, sie ändert oder löscht bestehende Werte nicht. Wenn Sie Werte überschreiben müssen, verwenden Sie die Regel Überschreiben oder Im Stapel nach Abfrage überschreiben.

Worauf sollte ich bei der Verwendung dieser Regel achten?#

Führen Sie nach dem Hinzufügen der Regel immer eine Neugenerierung des Feeds durch.
Wenn sich die Werte nicht zeigen, überprüfen Sie die Produktauswahl und ob das Element tatsächlich existiert.

Kann ich einen Wert zu einem Element hinzufügen, das im Ausgabeformat nicht erlaubt ist?#

Wenn das Zielelement im Format nicht unterstützt wird, nimmt Mergado es nicht in die Ausgabe auf. In diesem Fall müssen Sie zuerst das Ausgabeformat des Projekts anpassen oder das Element manuell auf der Seite Elemente erstellen.

Kann ich mit dieser Regel Bilder aus einer externen Tabelle ergänzen (z. B. aus Google Sheets)?#

Ja. Wenn Sie eine Tabelle mit Bildlinks haben, können Sie diese mithilfe der Regel Datendatei-Import (CSV / XML) in Mergado importieren und anschließend mit dieser Regel ergänzen. So lassen sich externe Daten mit Mehrfachelementen im Feed kombinieren.