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.
Catalog SaaS Export module
For issues related to the Catalog SaaS Export (
saas-export
) module:
-
Confirm the cron (in our developer documentation) jobs are running.
-
Confirm the indexers (in our developer documentation) are running and the
php Product Feed
indexer is set tophp Update by Schedule
. -
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"
-
Check the logs (in our developer documentation). Make sure there are no errors associated with the above modules.
-
Refresh the Configuration cache. Go to System > Tools > Cache Management, and clear the Configuration cache.
-
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.
Related reading
- Product Recommendations Administrator Development in our developer documentation
- Introduction to Product Recommendations in the Product Recommendations Guide
- Create Product Recommendations in the Product Recommendations Guide
- Review logs and troubleshoot in the SaaS Data Export Guide
- SaaS Data Export Extension Release Notes in the Adobe Commerce Data Export Guide for SaaS Services
- Best practices for modifying database tables in the Commerce Implementation Playbook