idealo Connect App: Produktdaten Mapping

Produkt- & Varianten-Daten mit dem idealo Feed verknüpfen (Produktdaten Mapping)

Was ist das Produktdaten Mapping?

Mit dem neuen Mapping-Feature kannst du, zusätzlich zum automatisch erzeugten Standard-Feed, Produkt- und Variantenfelder aus Shopify sowie vorhandene Metafelder flexibel mit den Zielfeldern des idealo-Feeds verknüpfen. So bestimmst du, welche Daten aus Shopify für die Feed-Generierung genutzt werden, ohne Daten manuell exportieren oder pflegen zu müssen.

Das Feature hilft dir:

• zusätzliche Produktdaten automatisiert und korrekt an idealo zu übertragen
• individuelle Datenquellen aus Shopify (z. B. Grundpreis, Vergleichspreis, Stückpreis, Lieferzeit etc.) zu nutzen
• schnell auf Anforderungen je Kategorie / Markt / idealo-Feldanforderungen zu reagieren

• Fehler und manuelle Nachpflege zu reduzieren

  
  

Das Mapping-Feature ersetzt das bisherige Metafeld-Feature, bei dem nur Metafelder mit Namespace idealo_feed  manuell angelegt und befüllt werden konnten.

⭐ Was ist neu im Vergleich zum bisherigen Metafeld-Feature?

Legacy-Handling

• Bestehende Händler behalten ihre Daten → wir übernehmen bestehende idealo_feed.*   -Metafelder automatisch als Mapping-Einträge (sichtbar & editierbar)
• Legacy-Mapping bleibt für alle Pläne verfügbar (Starter / Standard / Premium)
• Standard & Premium → volle Mapping-Funktion
• Starter → nur Legacy-Mapping (idealo_feed Namespace)

Dokumentation zum bisherigen Feature:

➡️ https://apps.eshop-guide.de/article/176-metafelder-bulk-editor

🚀 Wie funktioniert das Mapping-Feature?

Schritt-für-Schritt

1. Navigiere zum Menüpunkt „Produktdaten Mapping“ in der App
2. Klicke „Neues Mapping erstellen“
3. Wähle Shopify-Quelle (Produktfeld / Variantenfeld / Metafeld)
4. Wähle idealo-Zielfeld
5. Speichere dein Mapping
6. Nutze die Quick Preview, um den Feed anhand eines ausgewählten Produkts zu prüfen

Schritt-für-Schritt: Produktdaten Mapping

1) Aufrufen des Mapping-Screens

1. Melde dich im Shopify Admin an und öffne die idealo Connect App.

   Wähle in der linken Navigation den Punkt „Produktdaten Mapping“.

2) Überblick: Was du siehst

• Mapping-Tabelle (zentrales Element): je Zeile ein Mapping.
  • Spalte A: Status (aktiv/inaktiv/ausstehend)
  • Spalte B: Shopify Quelle
  • Spalte C: Zielfeld (idealo-Feld)
  • Spalte D: Aktionen (Löschen, Ein-/Ausblenden)
• Savebar (oben): Speichern, Verwerfen
• Mapping Übersicht: Deine Mappings im Feed + Neue, nicht gespeicherte Mappings
• (Coming Soon) Quick Preview Button: Quick Preview des Feeds erstellen

3) Neues Mapping anlegen (Konkrete Schritte)

a) Klicke „Neues Mapping erstellen“ (Button unterhalb der Tabelle).

• In der neuen Zeile:

• Shopify Quelle: klicke das Dropdown → suche oder wähle aus Gruppen:
  • Produktinformationen (z. B. Produkttyp, Vendor)
  • Varianteninformationen (z. B. Grundpreis (basePrice) , Vergleichspreis, Stückzahl)
  • Metafelder (Produkt + Variante) – angezeigt als namespace.key    falls vorhanden + manuelle Metafeld-Eingabe.
    • Undefinierte Metafelder lassen sich über die manuelle Eingabe mit dem exakten namespace.key   erfassen.
  • Legacy-Felder (idealo_feed.key Metafelder).
• Tipp: Nutze die Suchfunktion im Dropdown (autocompletion).
• Unter dem Auswahlfeld wird ein Textlink zum Shopify Produkteditor angezeigt, welcher dich zu den Werten der Datenquelle im Produkteditor weiterleitet.
  • Hinweis: Nur für undefinierte Metafelder sowie kombinierte Datenquellen, um zielführende Werte für dich zu generieren, wird kein Textlink ausgespielt.

• Zielfeld: wähle das idealo-Zielfeld aus dem Dropdown:

• Pflichtfelder – Wähle hier ein für den Feed benötigtes oder empfohlenes Zielfeld (z.B. basePrice, DeliveryTime) aus, welches nicht bereits standardmäßig oder aus den Einstellungen der App heraus automatisch für den Feed erfasst wird.
• Optionale Standardfelder – Wähle hier ein für den Feed optionales oder bei bestimmten Produkten empfohlenes Zielfeld aus (z.B. basePrice, formerPrice, voucherCode).
• Custom Felder –  Erstelle per Freitext-Option ein individuelles Zielfeld, das in deinem Mapping verwendet werden kann, zum Beispiel für spezifische Felder bestimmter Produktkategorien. Weitere Informationen zu den idealo Attributen findest du hier.

b) Speichern: Klicke die Savebar „Speichern“, wenn dein gewünschtes Mapping eingerichtet ist. Nach Speichern werden deine Mappings für die nächste automatische Feedgenerierung berücksichtigt.

4) Validierung beim Speichern (Was die App prüft)

• Pflichtfelder: Es wird geprüft, ob alle idealo-Pflichtfelder (sku   , title   , price   , ean   , imageUrl   , url   , brand    …) eine gültige Quelle haben (entweder Default Shopify Quelle, über App-Einstellungen oder aktives Mapping).
• Doppelte Zielfeld-Nutzung: Wenn ein Zielfeld bereits von einem anderen Mapping belegt ist, wird ein Warnhinweis angezeigt: „Zielfeld bereits vorhanden“.
• Mapping unvollständig: Bei fehlender Auswahl eines nicht vorhandenen Zielfeldes oder einer Shopify Quelle → Fehler „Mapping nicht vollständig“.

5) Legacy-Metafelder (Was passiert mit bestehenden idealo_feed.*   Metafeldern)

• Beim erstmaligen Öffnen des Mapping-Screens importiert die App automatisch vorhandene idealo_feed.*   -Metafelder als Legacy-Mappings.

  Legacy-Mappings sind in der Tabelle ersichtlich und sind in der Shopify Quelle mit dem Namespace idealo_feed.   markiert.

  Du kannst Legacy-Mappings:

  • Bearbeiten (Source ändern) → die Zeile wird dann zu einem normalen Mapping.
  • Deaktivieren → bleibt aber sichtbar.
  • Löschen → entfernt die Legacy-Zuordnung (Achtung: diese Aktion löscht nicht automatisch das Metafeld in Shopify).
• Für neue Shops wird Legacy nicht empfohlen — neue Shops sollten direkt das erweiterte Mapping nutzen, um ihre Produktdaten für das Listing bei idealo dynamisch und flexibel aufzusetzen.

6) Coming Soon: Quick Preview (vollständige Feed-Vorschau eines Produkts)

Zweck: Visuelle Kontrolle, keine produktive Übertragung.

Schritte:

1. Während du Mappings konfigurierst klicke „Quick Preview“ (in der Mapping Übersicht).

   Produkt auswählen: Das Dropdown zeigt nur Produkte, die nicht in den App-Settings als ausgeschlossen markiert sind und die Settings-Filter erfüllen (z. B. Preisfilter, Verfügbarkeit).

   • Anzeige im Dropdown: Produktname / Handle / SKU / Anzahl Varianten.

     Nach Auswahl erzeugt die App eine komplette Vorschau:

   • Tabellarische Ansicht:
     • Zeilen = Varianten (je Variante eine eigene Zeile)
     • Spalten = alle aktiven Feed-Felder (automatisch generierte Pflichtfelder, Settings-Felder, aktivierte Mappings)

     • Spalten-Header zeigen Feldnamen (z. B. sku   , title   , basePrice   )

       Werte werden live aus Shopify (GraphQL) geholt.

       Interpretation:

     • Prüfe, je nach deinem Setting und Mapping, ob Werte in den Spalten korrekt sind (z. B. price   stimmt, specialPrice   korrekt berechnet, ean   gefüllt ist).
     • Bei Unstimmigkeiten: Button „Mapping bearbeiten“ (führt zurück in die Mapping-Tabelle).
2. Iteration: Nach deinem Review kannst du optional zur Übersicht zurückkehren oder beliebig viele weitere Previews mit anderen Produkten generieren.

Hinweise:

• Die Quick Preview berücksichtigt Settings wie Versandkosten-Logik, Preisfilter, excluded products. Ausgeschlossene Produkte erscheinen nicht im Auswahl-Dropdown.
• Die Preview erzeugt keine API-Calls zu idealo und verändert keine Live-Feeds.

7) Fehlerbehebung & Troubleshooting (häufige Fälle)

• „Zielfeld bereits verwendet“ → Entferne die doppelte Zuweisung.
• Custom Metafeld liefert keine Werte → Das Metafeld existiert entweder nicht, weist nicht den korrekten Namespace + Key auf oder gehört zu einem anderen OwnerType (Produkt vs Variante). Überprüfe das eingegebene Custom Metafeld oder verwende stattdessen Standardfelder, wenn möglich.
• Preview zeigt leere Werte → Stelle sicher, dass das ausgewählte Produkt die Daten in Shopify tatsächlich besitzt.
• Legacy-Werte falsch → Prüfe in Shopify, ob das idealo_feed.*    Metafeld noch Werte enthält; bei Bedarf migrieren oder löschen.

• Mapping unvollständig → Es fehlt entweder eine Quelle oder das Zielfeld. Vervollständige das Mapping.

  

8) Best Practices / Empfehlungen

• Pflichtfelder und empfohlene Felder zuerst mappen: starte mit basePrice , deliveryTime , deliveryCosts , han  .
• Nutze Preview vor Speicherung: prüfe mindestens ein repräsentatives Produkt (mit mehreren Varianten).
• Behalte Legacy-Mappings im Blick: migriere alte idealo_feed.*    Metafelder in neue Mappings.
• Feedback geben & Support: Falls du etwas nicht mappen kannst, melde dich direkt bei uns im Support. Wir helfen dir jederzeit!

📌 Meist genutzte Mappings

9) Kurz-Checklist (für den schnellen Workflow)

1. Mapping erstellen → Source + Zielfeld zuordnen.
2. Speichern (Savebar).
3. Quick Preview: Produkt auswählen → Vorschau prüfen → Mappings speichern.
4. Nächster Feedlauf generiert Feed mit neuem Mapping.

🧠 Mapping-Logik & Priorisierung

Pflichtfelder nach idealo

• Werden überschrieben, wenn eine alternative Quelle gemappt ist
• Falls kein Mapping existiert → Default Shopify-Quelle wird genutzt

Optionale Felder nach idealo

• Werden hinzugefügt, wenn ein Mapping existiert
• Existiert die Spalte noch nicht, erzeugt sie die App automatisch

Kontakt & Support

📩 idealoapp@eshop-guide.de

📄 Dokumentation: https://apps.eshop-guide.de/collection/65-idealo-app