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.

NOTE
If Cookie Restriction Mode (in our user guide) is enabled, Adobe Commerce does not 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 Configuration cache. Go to System > Tools > Cache Management , and clear the configuration cache.
  6. 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.

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