Troubleshoot 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.3.x
- Adobe Commerce 2.4.x
Troubleshoot product-recommendations module
If you have configured the
magento/product-recommendations
module correctly (Check Product Recommendations - Install and Configure Recommendations in our developer documentation.), but you are not seeing any recommendations, try the following:
-
It is possible that the module has not 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 are not seeing the recommendations that you configured, it is possible there is not 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 Configuration cache. Go to System > Tools > Cache Management , and clear the configuration cache.
- Confirm there is data in the
php catalog_data_exporter_products
database table.
Events
Recommendation Events, in our developer documentation, describes the behavioral events that are sent to Adobe Commerce.
Related reading
- Product Recommendations - Overview in our developer documentation
- Product Recommendations - Install and Configure Recommendations in our developer documentation
- Marketing - Product Recommendations in our user guide
- Create Product Recommendations in our user guide