Troubleshoot the Product Recommendations module in Adobe Commerce

This article talks about troubleshooting suggestions for the

magento/product-recommendations

module and its dependency

saas-export

module since you need both modules operating in order to use the Product Recommendations tool in Adobe Commerce.

Affected products and versions

  • Adobe Commerce 2.4.4 - 2.4.7

Troubleshoot product-recommendations module

If you have configured the

magento/product-recommendations

module correctly, (Check Product Recommendations - Install and Configure in our developer documentation.) but you aren’t seeing any recommendations, try the following:

  • It’s possible that the module hasn’t had enough time to collect behavioral data. Allow the system to run for 24 hours so it can start collecting data. Consider deploying a recommendation type that does not require any behavioral data, such as “More like this”.

  • If you aren’t seeing the recommendations that you configured, it’s possible there isn’t yet sufficient data to build recommendations for the user.

  • Ensure the SaaS Data Space or API Key are valid. If you get an error after specifying your SaaS Data Space or your API key during the product recommendations initialization, check to make sure you have entered the SaaS Data Space and API key (in our user guide) correctly. To ensure the MageID and API key are linked, the user who owns the MageID, typically the user who owns the Adobe Commerce license, needs to be the same user who generates the API key. If you must change the MageID that was used, submit a Support ticket.

NOTE
If Cookie Restriction Mode (in our user guide) is enabled, Adobe Commerce doesn’t collect behavioral data until the shopper consents. If Cookie Restriction Mode is disabled, Adobe Commerce collects behavioral data by default.

Catalog SaaS Export module

For issues related to the Catalog SaaS Export (

saas-export

) module:

  1. Confirm the cron (in our developer documentation) jobs are running.

  2. Confirm the indexers (in our developer documentation) are running and the php Product Feed indexer is set to php Update by Schedule .

  3. Confirm the modules are enabled. The php saas-export metapackage installs the following modules, all of which must be enabled: php "magento/module-catalog-data-exporter" "magento/module-catalog-inventory-data-exporter" "magento/module-catalog-url-rewrite-data-exporter" "magento/module-configurable-product-data-exporter" "magento/module-data-exporter" "magento/module-saas-catalog"

  4. Check the logs (in our developer documentation). Make sure there are no errors associated with the above modules.

  5. Refresh the Configuration cache. Go to System > Tools > Cache Management, and clear the Configuration cache.

  6. Confirm there is data in the cde_products_products_feed database table.

    note note
    NOTE
    If you can’t find that table, check the catalog_data_exporter_products table. The table name was changed in the Data Export version 103.3.0 release.

Events

Verify Event Collection, in our developer documentation, describes the behavioral events that are sent to Adobe Commerce.

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a