DokumentationCommerceProduct Recommendations

Installieren und Konfigurieren

Letzte Aktualisierung: 26. Juni 2026

Erstellt für:

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Für die Bereitstellung von Product Recommendations in Ihrer Storefront und in Ihrem Administrator müssen Sie das Modul installieren und den Commerce Services-Connector konfigurieren. Sobald Updates veröffentlicht werden, können Sie die Installation einfach mit der neuesten Version aktualisieren.

Installieren von Product Recommendations install

Da das Product Recommendations-Modul ein eigenständiges Metapaket ist, werden Aktualisierungen häufiger veröffentlicht als Adobe Commerce. Um sicherzustellen, dass Sie über die neuesten Fehlerbehebungen und Funktionen verfügen, lesen Sie die Versionshinweise.

IMPORTANT
Stellen Sie sicher, dass Sie über die richtigen Berechtigungen zur Verwendung von Produktempfehlungen verfügen.

Installieren Sie das Modul magento/product-recommendations mit Composer:

composer require magento/product-recommendations

Hinzufügen der Page Builder-Unterstützung pbsupport

Product Recommendations für Page Builder ist ein optionales Modul und wird separat installiert. Um Product Recommendations mit Page Builder zu verwenden, installieren Sie das -Modul, indem Sie den folgenden Befehl ausführen:

composer require magento/module-page-builder-product-recommendations

Durch die Aktivierung von Product Recommendations in Page Builder können Sie eine vorhandene, aktive Empfehlungseinheit zu allen in Page Builder erstellten Inhalten hinzufügen, z. B. Seiten, Blöcke und dynamische Blöcke.

Weitere ​ finden Product Recommendations unter „Verwenden ​ Page Builder-Inhalten“.

Hinzufügen des Empfehlungstyps für visuelle Ähnlichkeit vissimsupport

Mit Empfehlungstyp " Ähnlichkeit“ können Sie eine Empfehlungseinheit auf Ihrer Produktdetailseite bereitstellen, die Produkte anzeigt, die dem angezeigten Produkt visuell ähnlich sind. Dieser Empfehlungstyp ist am nützlichsten, wenn Bilder und visuelle Aspekte der Produkte wichtige Teile des Einkaufserlebnisses sind. Installieren Sie Empfehlungstyp " Ähnlichkeit“, indem Sie den folgenden Befehl ausführen:

composer require magento/module-visual-product-recommendations

Konfigurieren von Product Recommendations configure

  1. Konfigurieren Sie nach der Installation des magento/product-recommendations den Commerce Services-Connector indem Sie API-Schlüssel angeben und einen SaaS-Datenspeicher auswählen.

    Durch die Konfiguration dieser Verbindung wird die Datensynchronisation und Kommunikation zwischen der Commerce-Instanz, dem Katalog-Service und anderen unterstützenden Services aktiviert. Die Datensynchronisation wird von der SaaS-Datenexporterweiterung“ ​.

  2. Um sicherzustellen, dass der Katalogexport ordnungsgemäß ausgeführt werden kann, überprüfen Sie, ob cron-Vorgänge und indexers ausgeführt werden und der Product Feed-Indexer auf Update by Schedule festgelegt ist.

Nachdem Sie die Commerce-Anwendung erfolgreich mit Commerce Services verknüpft und den SaaS-Datenspeicher angegeben haben, beginnt die Katalogsynchronisierung. Sie können ​ überprüfen ob Verhaltensdaten an Ihre Storefront gesendet werden.

Überwachen und Fehlerbehebung bei der Datensynchronisation

Um sicherzustellen, dass die Datensynchronisierung funktioniert, überprüfen Sie, ob die Daten erfolgreich aus Adobe Commerce exportiert und erfolgreich an den verbundenen Commerce-Service übermittelt wurden. Verwenden Sie die Dashboards für Ihre Bereitstellung, um beide Schritte zu überprüfen.

Mit Export beginnen und dann Versand bestätigen.

  1. Überprüfen Sie den Synchronisierungsstatus in der Commerce Admin Console.

    Navigieren Sie zu System > Data Transfer > Data Feed Sync Status.

    Seite „Daten-Feed-Synchronisierungsstatus“ mit Reporting zum Feed-Elementstatus {width="800" modal="regular"}

    Wenn die Synchronisierung ausgeführt wird, zeigen die Feed-Daten erfolgreich gesendete Datensätze an. Feed auswählen, um Details anzuzeigen oder Synchronisierungsprobleme zu beheben.

  2. Vergewissern Sie sich, dass die Daten an verbundene Commerce Services gesendet wurden.

    Navigieren Sie vom Commerce-Administrator aus zu System > Data Transfer > Data Management Dashboard.

    Daten-Management-Dashboard mit synchronisierten Katalogdaten in Connected Commerce Services {width="700" modal="regular"}

    Überprüfen Sie, ob die erwarteten Produkte, Preise und Attribute angezeigt werden.

TIP
Wenn Sie zusätzliche Probleme mit der Datensynchronisation haben, lesen Sie Überprüfen Sie die Protokolle und beheben Sie Fehler.
NOTE
Wenn die Seite Synchronisierungsstatus für Daten-Feeds nicht in der Commerce Admin für Commerce in Cloud- oder lokalen Bereitstellungen verfügbar ist, befolgen Sie die Installationsanweisungen für Erweiterungen, um sie zu aktivieren.

Aktualisieren der Product Recommendations update

Wie alle Adobe Commerce-Versionen nutzt Product Recommendations Composer für die Installation und Aktualisierung. Führen Sie die folgenden Schritte aus, um das magento/product-recommendations-Modul zu aktualisieren:

composer update magento/product-recommendations --with-dependencies

Um auf eine Hauptversion zu aktualisieren, z. B. von 5.0 auf 6.0, müssen Sie die composer.json für Ihr Projekt bearbeiten. (Informationen zur ​ Version finden ​ in den Versionshinweisen.) Beispiel: Öffnen Sie die composer.json und suchen Sie nach dem magento/product-recommendations:

"require": {
    ...
    "magento/product-recommendations": "^5.0",
    ...
}

Lassen Sie uns die Hauptversion von 5.0 auf 6.0 anheben:

"require": {
    ...
    "magento/product-recommendations": "^6.0",
    ...
}

Speichern Sie die composer.json und führen Sie Folgendes aus:

composer update magento/product-recommendations --with-dependencies

Oder wenn Sie die magento/module-visual-product-recommendations und magento/module-page-builder-product-recommendations Module installiert haben:

composer update --with-dependencies magento/product-recommendations magento/module-visual-product-recommendations magento/module-page-builder-product-recommendations
NOTE
In Version 3.x.x von Product Recommendations benötigen Sie nur einen einzigen API-Schlüssel. In Version 4.x.x und höher müssen Sie öffentliche und private API-Schlüssel für die Sandbox- und die Produktionsumgebung bereitstellen. Wenn Sie nicht beide Paare von API-Schlüsseln angeben, können Sie im Admin-Bereich nicht auf die Funktion „Produktempfehlungen“ zugreifen. Die Datenerfassung wird jedoch in Ihrer Storefront fortgesetzt und Ihren Kundinnen und Kunden werden weiterhin vorhandene Empfehlungen angezeigt.

Firewalls

Um Produktempfehlungen durch eine Firewall zu lassen, fügen Sie commerce.adobe.io zur Zulassungsliste hinzu.

Product Recommendations deinstallieren uninstall

Bei Bedarf können Sie ​ Modul ​product-recommendations“ (deinstallieren).

recommendation-more-help
commerce-help-product-recommendations