DocumentaçãoKCS da Experience Cloud

Solução de problemas do módulo de recomendações de produto no Adobe Commerce

Última atualização: 19 de agosto de 2026

Se você não estiver vendo as recomendações do produto no Adobe Commerce, verifique a coleção de dados comportamentais, o Espaço de dados SaaS e a chave de API, e a configuração Exportação de SaaS do catálogo. O módulo magento/product-recommendations e sua dependência, saas-export, devem estar sendo executados corretamente para usar a ferramenta Recomendações de Produto. O Recommendations também pode levar até 24 horas para ser exibido após a configuração.

Descrição description

Ambiente

Adobe Commerce 2.4.4 - 2.4.7

Problema/Sintomas

O módulo magento/product-recommendations e sua dependência, saas-export, devem estar sendo executados corretamente para usar a ferramenta Recomendações de Produto no Adobe Commerce.

Mesmo quando o módulo magento/product-recommendations está configurado corretamente (consulte Recomendações de Produto - Instalar e Configurar), as recomendações podem não aparecer. As possíveis causas incluem dados comportamentais insuficientes, configuração SaaS inválida ou problemas com o módulo de exportação SaaS de catálogo.

Resolução resolution

Siga as etapas a seguir para tentar resolver o problema com o módulo Recomendações de Produto

  • O módulo pode não ter tido tempo suficiente para coletar dados comportamentais. Deixe o sistema em execução por 24 horas para que ele possa começar a coletar dados. Considere a implantação de um tipo de recomendação que não exija dados comportamentais, como Mais itens similares.
  • Se você não estiver vendo as recomendações configuradas, talvez ainda não haja dados suficientes para criar as recomendações.
  • Verifique se o Espaço de dados SaaS ou a chave da API é válida. Se você receber um erro depois de especificar seu Espaço de dados SaaS ou chave de API durante a inicialização das Recomendações de produto, verifique se inseriu corretamente o Espaço de dados SaaS e a chave de API.
  • Para garantir que a MageID e a chave da API estejam vinculadas, a MageID e a chave da API devem ser de propriedade da mesma pessoa, normalmente quem tem a licença do Adobe Commerce. Se precisar alterar a MageID que foi usada, envie um tíquete de Suporte.

OBSERVAÇÃO: se o Modo de Restrição de Cookies estiver habilitado, a Adobe Commerce não coletará dados comportamentais até que o comprador dê o seu consentimento. Se o Modo de Restrição de Cookie estiver desabilitado, a Adobe Commerce coletará dados comportamentais por padrão.

Resolver problemas do módulo de exportação SaaS do catálogo:

Para problemas relacionados ao módulo Exportação de SaaS de catálogo (saas-export):

  1. Confirme se os trabalhos cron estão em execução.

  2. Confirme se os indexadores estão em execução e se o indexador de Feed do Produto está definido como Atualizar por Agendamento.

  3. Confirme se os módulos estão habilitados. O metapackage saas-export instala os seguintes módulos, que devem ser habilitados:

    • 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. Verifique os logs. Verifique se não há erros associados aos módulos listados acima.

  5. Atualize o cache de Configuração. Vá para Sistema, depois Ferramentas, depois Gerenciamento de Cache e limpe o cache da Configuração.

  6. Confirme se há dados na tabela do banco de dados cde_products_feed.

OBSERVAÇÃO: se você não encontrar essa tabela, verifique a tabela catalog_data_exporter_products. O nome da tabela foi alterado na versão 103.3.0 da Exportação de dados.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles