[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur) und lokale Projekte."}

Kataloganreicherung

Die Kataloganreicherung ist eine native Adobe Commerce-Funktion, mit der Sie Produktnamen und lange Beschreibungen verbessern können, sodass Ihr Katalog präziser dargestellt wird, wenn Käufer LLMs und KI-Assistenten für die Produktforschung und -erkennung verwenden.

NOTE
Die Anreicherung von Katalogen basiert auf Commerce Catalog Agent und Adobe Brand Visibility hinter den Kulissen. Sie verwenden die Anreicherung im Rahmen Ihres Commerce-Katalog-Workflows. Sie verwalten keine separate Adobe Brand Visibility-Integration, um genehmigte Name- und Beschreibungsaktualisierungen anzuwenden. Eine umfassendere LLM-Überwachung und -Optimierung außerhalb von Commerce finden Sie unter Adobe Brand Visibility Produktdokumentation.

Funktionsweise how-it-works

Ihr Adobe Commerce Produktkatalog ist das „System of Record“ für Produktdaten: Namen, Beschreibungen, Attribute, Preise und Inventar. Adobe Commerce Storefront MCP (Model Context Protocol) verbindet Live-Katalogdaten mit Adobe AI-Erlebnissen. Von dort aus kann der Katalogagent Lücken in Produktnamen und langen Beschreibungen identifizieren, Verbesserungen vorschlagen und genehmigte Änderungen zurück an Commerce schreiben, damit Sie sie in der Commerce-Admin überprüfen können.

Mit der Anreicherung von Katalogen haben Sie folgende Möglichkeiten:

  • Identifizieren Sie Lücken und Inkonsistenzen in Produktnamen und langen Beschreibungen, die sich auf die Interpretation Ihrer Produkte durch LLMs auswirken.
  • Überprüfen Sie Verbesserungsvorschläge mit unterstützendem Kontext, einschließlich Rechtfertigungen und Vergleiche vor und nach dem Kauf.
  • Wenden Sie genehmigte Aktualisierungen direkt auf den Commerce-Katalog an, damit der Admin, die Storefront und andere Kanäle, die diese Felder lesen, weiterhin ausgerichtet sind.

Da Produktnamen und lange Beschreibungen in Commerce live sind, kann die einmalige Verbesserung der Kopie für jeden Kanal, der diese Produktdaten verwendet, von Vorteil sein. Der Nutzen hängt davon ab, wie und wann Ihre Systeme aktualisiert werden.

Richtung
Zweck
Commerce-Katalog -> Analyse
Katalog- und URL-Signale speisen Anreicherungsvorschläge ein.
Anreicherung -> Commerce-Katalog
Nachdem Sie eine Aktualisierung genehmigt haben, werden Änderungen am Produktnamen und an der Beschreibung im Commerce-Katalog gespeichert, sodass Admin und Storefront die optimierten Werte widerspiegeln.

Für wen ist das? who-this-is-for

  • Digitale Marketer und Merchandiser, die möchten, dass Produktdaten in LLM-basierten Antworten korrekt und konsistent sind.
  • Digitale Marketer und Merchandiser, die eine kontrollierte Möglichkeit benötigen, die Katalogkopie skaliert zu verbessern.
  • Commerce-Administratoren, die für die Katalogintegrität, Admin-Prozesse und Integrationen (API, CSV, PIM) verantwortlich sind, die Produktattribute befüllen.

Voraussetzungen prerequisites

Die folgenden Voraussetzungen gelten, wenn Sie Zugriff auf die Kataloganreicherung haben.

  • Ihre Storefront kann durch LLM-orientierte und agentische Bots crawlen werden, bei denen eine crawlen Abdeckung für katalogorientierte Vorschläge erforderlich ist.
  • Die erforderlichen Commerce-Services und die Katalogkonnektivität sind aktiviert und funktionieren ordnungsgemäß. Weitere Informationen ​ Sie unter ​ der Kataloganreicherung aktivieren .
  • Der Commerce-Admin-Benutzer, der über Adobe IMS auf die Anmeldungen zur Kataloganreicherung zugreift. Siehe IMS-Anmeldung und Organisationsanforderungen.
  • Sie haben Zugriff auf die Adobe Admin Console.
  • Ihre Organisation hat den GenAI-Fahrer für die zugrunde liegenden KI-Services unterzeichnet oder sich ausdrücklich dagegen entschieden.
NOTE
Im Rahmen der Einrichtung überprüft Commerce, ob Ihr Unternehmen den GenAI-Treiber unterzeichnet hat, der die KI-Services hinter der Kataloganreicherung abdeckt. Wenn Sie den Fahrer noch nicht angemeldet oder sich abgemeldet haben, werden Sie aufgefordert, den Fahrer zu signieren oder zu aktualisieren, bevor Sie die Kataloganreicherung verwenden können.

Anforderungen an die IMS-Anmeldung und Organisation ims-sign-in-requirements

Die Kataloganreicherung verwendet das Adobe IMS-Zugriffstoken des angemeldeten Commerce-Admin-Benutzers, um eine Verbindung zu Adobe Brand Visibility herzustellen. Eine native Commerce-Admin-Anmeldung mit nur einem Commerce-Benutzernamen und -Kennwort erzeugt dieses Token nicht. Daher muss sich der Admin-Benutzer, der auf die Kataloganreicherung zugreift, über Adobe IMS anmelden.

Um die IMS-Anmeldung zu unterstützen, muss für Ihre Commerce-Instanz die Commerce Admin-Integration mit Adobe ID aktiviert sein. Siehe Konfigurieren der Commerce Admin-Integration mit Adobe ID.

IMPORTANT
Die Aktivierung der Commerce Admin-Integration mit Adobe ID ist eine instanzweite Änderung. Nach der Aktivierung muss sich jeder Admin-Benutzer über Adobe IMS authentifizieren, und die native Anmeldung mit Benutzername und Kennwort bei Commerce ist nicht mehr verfügbar. Lesen Sie Übersicht über die Adobe Identity Management Service (IMS)-Integration bevor Sie diese Integration aktivieren.

Die Adobe IMS-Organisation, die Ihrer Commerce-Instanz zugeordnet ist, unterscheidet sich in der Regel von der IMS-Organisation, die Ihre Adobe Brand Visibility innehat. Die Aktivierung der Commerce Admin-Integration mit Adobe ID gewährt allein keinen Zugriff auf die Markensichtbarkeit-Berechtigung, und die beiden Organisationen müssen nicht identisch sein. Arbeiten Sie mit Ihrem Adobe-Administrator oder Account-Team zusammen, um zu bestätigen, welche IMS-Organisationsmitgliedschaften und Kontozugriffskatalog-Anreicherung in Ihrem Setup erforderlich sind.

Kataloganreicherung aktivieren enable-catalog-enrichment

Arbeiten Sie mit Ihrem Commerce-Administrator oder Implementierungspartner zusammen, um Folgendes sicherzustellen, bevor Sie Vorschläge überprüfen oder anwenden:

Installieren von Erweiterungen für Kataloganreicherung und Katalog-Services

  1. Installieren Sie die Kataloganreicherungserweiterung in Ihrer Commerce-Instanz und wenden Sie die Änderungen an:

    code language-bash
    composer require magento/module-catalog-enrichment:^2.1
    bin/magento setup:upgrade
    bin/magento cache:flush
    

    setup:upgrade aktiviert die Erweiterung, erstellt ihre Datenbanktabelle und gewährt den Admin-Berechtigungen. Leeren Sie den Cache danach, damit die Berechtigungen wirksam werden. Im Produktionsmodus auch bin/magento setup:di:compile und bin/magento setup:static-content:deploy ausführen.

  2. Wenn Sie noch keine Katalog-Services installiert haben, ​ Sie ().

    Catalog enrichment ist jetzt in Ihrer Commerce-Instanz verfügbar.

IMPORTANT
Catalog Enrichment 2.1.2 und höher erfordert Adobe Commerce 2.4.7 oder höher in PHP 8.3 oder höher und kann nicht zusammen mit der Adobe Brand Visibility-Erweiterung (magento/llm-optimizer) installiert werden. Wenn Sie es installiert haben, entfernen Sie es vor dem Upgrade. Siehe Upgrade von früheren Versionen in den Versionshinweisen.

Zugriff auf die Kataloganreicherung

Nach der Installation der Erweiterungen Catalog Enrichment und Catalog Services ist die Funktion Catalog Enrichment in Admin unter AI Product Discovery > Catalog Enrichment verfügbar.

Kataloganreicherung {modal="regular"}

NOTE
Das AI Product Discovery Menü enthält auch Product Details Page Enrichment (Beta). Die Anreicherung der Produktdetailseite befindet sich in der Beta-Phase und ist noch nicht allgemein verfügbar.

Konfigurieren der Kataloganreicherung configure-catalog-enrichment

Konfigurieren Sie die Kataloganreicherung auf der Registerkarte Settings , damit Commerce Catalog Agent eine Verbindung zu Ihrer Adobe Commerce-Umgebung herstellen und Vorschläge in Commerce Admin einblenden können.

Die Felder auf dieser Registerkarte identifizieren die Commerce-Umgebung und die Store-Ansicht, mit der sich die Kataloganreicherung verbindet. Sie sind nicht mit der Adobe IMS-Organisation identisch, die Ihre Adobe Brand Visibility-Berechtigung besitzt. Siehe IMS-Anmeldung und Organisationsanforderungen.

  1. Navigieren Sie in der Admin-Liste zu AI Product Discovery > Catalog Enrichment.

  2. Wählen Sie in der Scope oben auf der Seite die Store-Ansicht aus, die Sie konfigurieren möchten, oder lassen Sie All Store Views, um die Einstellungen in allen Store-Ansichten zu verwalten.

  3. Öffnen Sie die Registerkarte Settings .

  4. Erweitern Sie in Commerce Configuration das Ansichtsfeld Store mit der Bezeichnung und der URL.

    Geben Sie Details zur Adobe Commerce an, um den Katalog-Adobe Brand Visibility-Service und Audit-Workflows zu aktivieren.

    Commerce-Konfiguration auf der Registerkarte „Kataloganreicherungseinstellungen“ {modal="regular"}

  5. Geben Sie die erforderlichen Verbindungsdetails für die Store-Ansicht ein.

    • Store View URL: URL, die der Store-Ansicht entspricht (z. B. https://brand.example.com/fr/).
    • Environment ID: Eindeutige Kennung für die Adobe Commerce Umgebung, auf die die Verbindung zugreift.
    • Website Code, Store Code und Store View Code: Website-, Store- und Store-Ansichtscodes für die Commerce-Website. Diese Werte müssen mit den Codes in Ihrem Commerce-Admin übereinstimmen.
    • Host Name: Host-Name Ihrer Adobe Commerce.
  6. Klicken Sie auf Save.

Warten Sie nach dem Speichern, bis ein erster Synchronisierungs- oder Validierungsauftrag abgeschlossen ist, bevor Sie sich auf die Katalog- oder Auditergebnisse für diese Store-Ansicht verlassen. Es kann bis zu 24 Stunden dauern, bis Produktvorschläge auf der Catalog Enrichment angezeigt werden.

Um eine Store-Ansichtskonfiguration zu entfernen, erweitern Sie diesen Eintrag und klicken Sie auf Delete.

Feldbeschreibungen commerce-connection-fields

Erforderliche Felder sind im Commerce Configuration Formular mit einem Sternchen (*) gekennzeichnet.

Feld
Erforderlich
Beschreibung
URL für Store-Ansicht
Ja
URL, die der Store-Ansicht entspricht (z. B. https://brand.example.com/fr/)
Umgebungs-ID
Ja
Eindeutige Kennung für die Adobe Commerce Umgebung, auf die die Verbindung zugreift.
Website-Code
Ja
Website-Code der Commerce-Website.
Speichercode
Ja
Store-Code der Commerce-Website.
Code für Shop-Ansicht
Ja
Store-Ansicht der Commerce-Website.
Host-Name
Ja
Hostname der Adobe Commerce.

Überprüfen und Anwenden der Kataloganreicherung review-and-apply

Nachdem die Kataloganreicherung aktiviert und konfiguriert wurde, werden auf der Registerkarte Agentic Opportunities Produktvorschläge angezeigt. Von hier aus können Sie Vorschläge überprüfen und genehmigte Aktualisierungen auf Produktnamen und lange Beschreibungen in Ihrem Commerce-Katalog anwenden.

Die Kataloganreicherung verwendet die folgenden Workflow-Ansichten:

  • Current Suggestions: Neue oder aktive Elemente zur Überprüfung.
  • Fixed Suggestions: Elemente, die Sie bereits angewendet oder aufgelöst haben.
  • Ignored Suggestions: Elemente, die Sie absichtlich von der Aktion ausgeschlossen haben.

Kataloganreicherung {modal="regular"}

Genehmigte Vorschläge bereitstellen review-deploy-catalog

So stellen Sie genehmigte Vorschläge bereit:

  1. Wählen Sie Current Suggestions aus.
  2. Klicken Sie auf das Erweiterungssteuerelement für die URL- oder SKU-Zeile, um die vorgeschlagenen Aktualisierungen des Produktnamens und der Produktbeschreibung anzuzeigen.
  3. Überprüfen Sie den Vorschlag und bestätigen Sie, dass er mit Ihrer Merchandising- und SEO-Strategie übereinstimmt.

Sie können einen Vorschlag bearbeiten, bevor Sie ihn bereitstellen, oder ihn in Ignored Suggestions verschieben, wenn er nicht Ihrer Strategie entspricht.

  1. Wählen Sie die Zeile aus, in der die URL oder SKU aktualisiert werden soll.
  2. Klicken Sie auf Deploy optimizations und bestätigen Sie.

Genehmigte Name- und Beschreibungsänderungen werden wie andere Produktaktualisierungen im Adobe Commerce gespeichert.

IMPORTANT
Behandeln Sie jede angewendete Aktualisierung als Änderung des Produktionskatalogs. Verwenden Sie Ihre üblichen Verfahren für Änderungskontrolle, Staging und Qualitätssicherung. Wenden Sie Aktualisierungen erst an, nachdem sich Merchandising- und SEO-Stakeholder auf die endgültige Kopie geeinigt haben.

Nachdem Sie eine Aktualisierung angewendet haben, wechseln die Vorschläge zu Fixed Suggestions mit dem Status Als behoben markiert.

Überprüfen der Anreicherung im Administrator verify-in-admin

So überprüfen Sie die angewendete Kataloganreicherung:

  1. Navigieren Sie zu Catalog > Products in der Commerce Admin Console.

  2. Verwenden Sie Filter und den Store View nach Bedarf (z. B. Default Store View).

  3. Suchen Sie nach der SKU.

  4. Öffnen Sie das Produkt im Bearbeitungsmodus.

    Das Produktformular zeigt den angereicherten Produktnamen und/oder die Beschreibung an.

    Angereicherter Produktname {modal="regular"}

  5. Optional: Wählen Sie Override Catalog Agent provided Product Name aus, wenn Sie stattdessen einen manuell eingegebenen Namen beibehalten möchten.

    Manuelle Überschreibungen beeinflussen, wie Vorschläge mit dem Katalog synchronisiert werden. Weitere Informationen finden Sie unter Manuelles Überschreiben in der Admin.

  6. Erweitern Sie den Abschnitt Content und suchen Sie das Feld Beschreibung .

    Die angereicherte Beschreibung wird angezeigt, wenn Sie Änderungen der Beschreibung angewendet haben.

    Produktbeschreibung anreichern {modal="regular"}

  7. Optional: Wählen Sie Override Catalog Agent provided Description aus, wenn Sie stattdessen eine manuell eingegebene Beschreibung beibehalten möchten.

Manuelle Überschreibungen beeinflussen, wie Vorschläge mit dem Katalog synchronisiert werden. Weitere Informationen finden Sie unter Manuelles Überschreiben in der Admin.

Überprüfen der Anreicherung in der Storefront verify-storefront

So überprüfen Sie die Anreicherung in der Storefront:

  1. Suchen Sie die SKU in Ihrer Storefront.

  2. Öffnen Sie die Produktseite.

  3. Bestätigen Sie, dass der Produktname und die Beschreibung mit dem übereinstimmen, was Sie genehmigt haben.

    Es kann einige Zeit dauern, bis die Anreicherungen in Ihrer Storefront angezeigt werden.

  4. Bestätigen Sie, dass die Regionen mit der langen Beschreibung mit den genehmigten Werten übereinstimmen.

  5. Optional: Bestätigen Sie nachgelagerte Kanäle, die dieselben Katalogattribute verwenden, sofern für Ihren Rollout relevant.

Überschreibungen, Aufnahme und veraltete Vorschläge overrides-ingestion

Nachdem die Kataloganreicherung den Namen oder die Beschreibung eines Produkts aktualisiert hat, können andere Aufnahmesysteme dieselben Felder ändern. Beispiele sind REST-API-Aufrufe, CSV-Importe und PIM-Feeds.

Ausgangswert erneut aufgenommen original-value-reingested

Wenn ein externer Prozess den ursprünglichen Namen oder die ursprüngliche Beschreibung schreibt (den Wert, der vor der Anwendung der Anreicherung existierte), berücksichtigt Commerce weiterhin den angereicherten Wert für dieses Feld gemäß den Regeln der Kataloganreicherung. Der Vorschlag wird möglicherweise nicht automatisch basierend auf dieser Aufnahme zurückgesetzt.

Neuer Wert erneut aufgenommen new-value-reingested

Wenn der externe Prozess einen neuen Wert sendet, bei dem es sich nicht um eine Wiederholung des Textes vor der Anreicherung handelt, berücksichtigt Commerce den neuen Katalogwert. Wenn Sie beispielsweise von „Rote Schuhe“ in „Ikonische rote Schuhe“ umbenennen, wird der angereicherte Wert ersetzt. Der zugehörige Anreicherungsvorschlag wird in der Regel als veraltet“, da der Live-Katalog nicht mehr mit dem Vorschlagskontext übereinstimmt.

Manuelle Überschreibung in der Admin manual-override-in-the-admin

Wenn Sie den Produktnamen oder die Beschreibung im Adobe Commerce Admin manuell bearbeiten:

  • Der Admin-Wert gewinnt als Aufzeichnungssystem für diese manuelle Änderung.
  • Der Anreicherungsvorschlag ist mit Veraltet gekennzeichnet.
  • Der Vorschlag -Workflow kehrt zum ursprünglichen Status für dieses Element zurück, sodass Sie einen neuen Vorschlag erneut planen oder akzeptieren können, wenn die Analyse erneut ausgeführt wird.

Diese Regeln helfen Ihnen zu ermitteln, ob Kataloganreicherung, Aufnahme-Feeds oder Admin-Bearbeitungen relevant sind, wenn mehrere Kanäle dieselbe SKU berühren.

Einschränkungen und Überlegungen limits

  • Die Anreicherung unterstützt derzeit nur englischsprachige Produktinhalte.
  • Die Anreicherung gilt nur für Produktnamen und lange Beschreibungen. Das PDP-Layout, Widgets oder andere Storefront-Inhalte auf Seitenebene werden nicht geändert.
  • Große Kataloge und eine hohe URL-Anzahl können sich darauf auswirken, wie schnell die Analyse abgeschlossen wird und wie viele Vorschläge gleichzeitig angezeigt werden.
  • Aussagekräftige Vorschläge gehen davon aus, dass LLM-relevante Bots auf die von Ihnen gewünschten Produkt-URLs zugreifen können. Roboterregeln, Authentifizierung, Geoblocking und umfassende Personalisierung können die Abdeckung verringern.

Best Practices best-practices

  • Dokumentieren Sie die Systemeignerschaft für Produktname und Beschreibung, damit PIM- oder Feed-Vorgänge nicht unbeabsichtigt mit der Kataloganreicherung kollidieren.
  • Koordinieren Sie sich mit SEO- und Marken-Teams, bevor Sie Titel oder Beschreibungen in großen Mengen anwenden.
  • Führen Sie nach wichtigen Katalogimporten eine Synchronisierung bzw. Neuanalyse durch, damit die Vorschläge den aktuellen Katalogstatus widerspiegeln.

Beispiele

Die folgenden Beispiele zeigen, wie die Kataloganreicherung technische Rohattribute in kundenorientierte, erzählerische Produktkopien umwandelt, die LLMs zur Beantwortung von Fragen zum Einkauf verwenden können.

Beispiel: Kaffeeprodukt mit technischen Attributen

Ein Coffee retailer-Katalog speichert nur die technischen Daten für ein Kaffeebohnen-Produkt mit mittlerer Röstung: Bohnensorte, Ursprungsregion, Verarbeitungsmethode, Röstniveau und Höhenbereich. Diese Felder beschreiben das Produkt, vermitteln dem Käufer jedoch nicht seinen Wert, sodass ein KI-Assistent wenig zu tun hat, wenn er eine Frage wie „Welcher Kaffee hat einen glatten, säurearmen Geschmack?“ beantwortet.

Die Kataloganreicherung liest die technischen Attribute und Gründe durch ihre Interaktion, um daraus käuferrelevante Merkmale abzuleiten:

Technisches Attribut
Abgeleitetes Merkmal
Überlegung
Honigverfahren, Medium Roast
Niedriger Säuregehalt
Obstschleim, der während der Honigverarbeitung auf der Bohne verbleibt, unterdrückt den Säuregehalt, und der mittlere Braten zersetzt die restlichen sauren Verbindungen.
Honigverfahren, Arabica, Medium Roast
Haselnussaroma
Fruchtzucker aus dem Schleim verbinden sich mit Arabicas natürlichen Nussnoten, verstärkt bei mittlerem Rösten.
Honigverfahren, Arabica
Reichhaltiges, cremiges Mundgefühl
Öle, die während der Trocknung aus dem Schleim absorbiert werden, erhöhen die Viskosität und den Körper.
Honigverfahren, Höhe 900-1200m
Karamelll-Untertöne
Die dichteren, hoch gelegenen Bohnen entwickeln komplexere Zucker, die durch die Honigverarbeitung vertieft werden.

Die Kataloganreicherung wendet diese abgeleiteten Merkmale auf die Produktkopie an:

  • Vorher: "Medium Röstkaffeebohnen - Arabica, Brasilien Minas Gerais, Honigverfahren, 900-1200m“
  • Nachher: „Arabica-Bohnen, die in 900-1200m im brasilianischen Minas Gerais angebaut werden, Honig verarbeitet und mittelgeröstet, entwickeln ein natürlich süßes, cremiges Mundgefühl mit ausgeprägtem Haselnuss-Charakter, Karamelll-Untertönen und geringer Säure. Ein konsistenter, zugänglicher Spezialkaffee, den man am besten durch Umgießen erleben kann.“

Der aktualisierte Name und die aktualisierte Beschreibung werden direkt im Commerce-Katalog gespeichert, sodass die Storefront, die LLM-Feeds und andere Kanäle, die diese Felder lesen, alle dieselbe angereicherte Kopie widerspiegeln.

Beispiel: Modulare Möbelkonfiguration

Ein Möbel-retailer verkauft eine modulare Sektionalcouch, bei der die Produktbeschreibung nur die Konfigurationscodes und Stoffnamen auflistet, z. B. 6 Standard Seats + 6 Standard Sides in Sapphire Navy Corded Velvet. Diese Kurzschreibweise ist für einen wiederkehrenden Kunden verständlich, gibt einem KI-Assistenten jedoch wenig Kontext darüber, wie das Produkt funktioniert oder was es langlebig oder komfortabel macht.

Die Kataloganreicherung erweitert die Konfigurations- und Fabric-Attribute zu einer erzählenden Beschreibung, die erklärt, was jede Komponente tut und warum sie für einen Käufer wichtig ist:

  • Vorher: „6 Standardsitze + 6 Standardseiten in Sapphire Navy Corded Velvet“
  • Nachher: „Diese Konfiguration umfasst 6 Standard-Sitzeinsätze und 6 Standard-Seiteneinsätze, die austauschbar als Arme oder Rücken fungieren und die modularen Bausteine Ihres Layouts bilden. Jeder Sitz verfügt über Standardschaum mit drei hochdichten Schichten, die entwickelt wurden, um den Auftrieb zu erhalten und dem Durchhängen zu widerstehen. Die Sapphire Navy Corded Velvet Hülle ist genauso haltbar wie luxuriös, mit strukturierten Kordeln, die einen subtilen Glanz und ein weiches, weiches Gefühl erzeugen. Die Abdeckungen werden von Hand genäht, um einen präzisen, maßgeschneiderten Look zu erzielen, und sind maschinenwaschbar und veränderbar, sodass sich Ihr Schnitt mit Ihrem Raum entwickeln kann.“

Da die angereicherte Beschreibung in den Commerce-Katalog zurückgeschrieben wird, ist sie für KI-Bots verfügbar, die die Produktdetailseite crawlen haben, sowie für jeden nachgelagerten Kanal oder Feed, der die Katalogdaten des Produkts verwendet, ohne das Layout oder Design zu ändern, das Kundinnen und Kunden auf der Seite sehen.

Versionshinweise release-notes

In diesen Versionshinweisen werden Ergänzungen und Fehlerbehebungen in der Catalog Enrichment Extension (magento/module-catalog-enrichment) erfasst:

Neu Neue Funktionen
Problem behoben Fehlerbehebungen und Verbesserungen
Bekanntes Problem Bekannte Probleme

v2.1.2

22. Oktober 2026

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce 2.4.9, 2.4.8, 2.4.7 auf PHP 8.3 bis 8.5.

Version 2.1.2 macht die Kataloganreicherung zu einer eigenständigen Erweiterung. Sie enthält jetzt alles, was zuvor von der separaten Adobe Brand Visibility-Erweiterung (magento/llm-optimizer) bereitgestellt wurde: Anwenden genehmigter Vorschläge auf den Katalog, Zurücksetzen dieser Vorschläge und Schützen der eigenen Bearbeitungen vor Überschreibungen.

Upgrade von früheren Versionen upgrade-from-earlier-versions

IMPORTANT
Version 2.1.2 kann nicht zusammen mit der Adobe Brand Visibility-Erweiterung installiert werden. Wenn Sie es installiert haben, entfernen Sie es als Teil des Upgrades.
  1. Entfernen Sie die Adobe Brand Visibility Erweiterung, falls sie installiert ist:

    code language-bash
    composer remove magento/llm-optimizer
    

    Wenn die Erweiterung durch Kopieren oder Symlinking von Magento/LlmoCatalog nach app/code installiert wurde, löschen Sie dieses Verzeichnis. Deaktivieren Sie nicht nur das Modul . Ein deaktiviertes Modul, das sich noch auf der Festplatte befindet, kann dazu führen, dass setup:upgrade die Tabelle verwerfen, in der die Originalwerte von angereicherten Produkten gespeichert sind.

  2. Aktualisieren Sie die Kataloganreicherung und wenden Sie die Änderungen an:

    code language-bash
    composer require magento/module-catalog-enrichment:^2.1
    bin/magento setup:upgrade
    bin/magento cache:flush
    

    Leeren Sie den Cache nach dem Upgrade. Bei einem Upgrade werden bestehende Zugriffsberechtigungen auf neue Berechtigungsressourcen verschoben, und diese Berechtigungen werden erst wirksam, wenn der Cache gelöscht wird.

Anforderungen

Neu PHP 8.3 und Adobe Commerce 2.4.7 oder höher—PHP 8.1 ist das Ende des Lebenszyklus und PHP 8.2 erreicht am 31. Dezember 2026 das Ende des Lebenszyklus, sodass keines von beiden unterstützt wird. Adobe Commerce 2.4.6 und früher wird nicht unterstützt.

Neue Funktionen

Neu Menü AI Product Discovery - Die Seiten zur Kataloganreicherung haben jetzt einen eigenen Abschnitt in der Admin-Seitenleiste. Navigieren Sie zu AI Product Discovery > Catalog Enrichment. Zuvor war die Seite unter Catalog.

Neu [Beta]{class="badge informative" title="Noch nicht allgemein verfügbar"} Product Details Page Enrichment (Beta) - Eine neue Seite unter AI Product Discovery, auf der Anreicherungsvorschläge für Produktdetailseiten überprüft werden können. Die Anreicherung der Produktdetailseite befindet sich in der Beta-Phase und ist noch nicht allgemein verfügbar.

Neu Genehmigte Vorschläge anwenden und zurücksetzen - Genehmigte Name- und Beschreibungsaktualisierungen werden von dieser Erweiterung in den Katalog geschrieben. Commerce zeichnet den ursprünglichen Wert jedes angereicherten Attributs auf, wenn es sich zum ersten Mal ändert. Daher wird bei einem Rollback immer der Wert wiederhergestellt, den Sie vor der Anreicherung hatten, auch nachdem mehrere Vorschläge auf dasselbe Attribut angewendet wurden.

Neu Ihre Bearbeitungen werden berücksichtigt - Wenn Sie einen angereicherten Namen oder eine Beschreibung im Admin-Produktformular ändern, mit Update Attributes oder durch einen Import, wird Ihr Wert beibehalten und der zugehörige Vorschlag wird Veraltet. Eine Änderung am Standardbereich betrifft nur Store-Ansichten, die den Wert erben.

Neu Schreibgeschützter Katalogzugriff für Vorschläge - Commerce Catalog Agent können Produkt-, Kategorie-, Attributsatz- und Produkttypdaten lesen, um Produkte für die Analyse auszuwählen. Der Lesevorgang gibt nur Attribute zurück, die mit Used in Product Listing gekennzeichnet sind, sowie die Attribute, die angereichert werden können. Katalogdaten können nicht geändert werden.

Fehlerbehebungen und Verbesserungen

Problem behoben Erfolge beim Anwenden von Berichten - Wenn eine Anfrage zum Anwenden nach bereits abgeschlossenem Vorgang erneut versucht wird, werden die Änderungen jetzt als angewendet gemeldet, anstatt keine Änderungen zu melden. Nichts wird zweimal geschrieben.

Problem behoben Nur genehmigte Services können den Katalog ändern—Apply und Rollback akzeptieren nur Anfragen von Commerce Catalog Agent. Zuvor wurde jedes gültige Adobe IMS-Token akzeptiert. Dieselbe Prüfung gilt jetzt auch für SOAP-Anfragen.

Problem behoben deutlichere Fehler - Ein Adobe IMS-Ausfall gibt jetzt 401 anstelle von 500 zurück, sodass die Anfrage nicht erneut für den Katalog versucht wird und eine nicht erkannte Adobe IMS-Umgebung abgelehnt wird, anstatt als Staging behandelt zu werden.

Problem behoben Adobe IMS-Umgebung - Die Kataloganreicherung meldet sich jetzt standardmäßig bei der Adobe IMS-Produktionsumgebung an, einschließlich der Instanzen, die mit einem Commerce Services-Datenbereich verbunden sind. Zuvor wurden diese Instanzen an die Staging-Umgebung gesendet.

Problem behoben Anmelden nach der Adobe Brand Visibility Domain-Änderung - Die Seite Kataloganreicherung wird jetzt von abv.adobe.com geladen, was eine Anmeldungsschleife behebt, nachdem die vorherige Domain weitergeleitet wurde.

Bekannte Probleme

Bekanntes Problem Rollen mit Catalog Zugriff - Eine Benutzerrolle, die vor dieser Version gespeichert wurde und der Catalog Zugriff gewährt wurde, behält den Zugriff auf die Catalog Enrichment Service API Ressource. Überprüfen Sie diese Rollen in System > Permissions > User Roles und löschen Sie die Ressource, in der sie nicht benötigt wird.

v1.0.2

Erste Version der Admin-Seite für die Kataloganreicherung. Erfordert, dass die Adobe Brand Visibility Erweiterung Vorschläge auf den Katalog anwendet.

recommendation-more-help
commerce-admin-help-catalog