DocumentaçãoCommerceGuia do Live Search

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Configurar para sucesso com Live Search

Last update: Fri Sep 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Desenvolvedor

O Adobe Commerce Live Search e o Catalog Service trabalham juntos para fornecer uma solução de pesquisa intuitiva, relevante e eficiente, que permite aos clientes encontrar o que precisam com rapidez. Especificamente, Catalog Service exibe seus dados de catálogo para serviços SaaS, como Live Search para usar.

Este artigo fornece as instruções passo a passo para implementar o Live Search com o Catalog Service.

Público-alvo

Este artigo destina-se ao desenvolvedor ou ao integrador de sistemas de sua equipe responsável pela instalação e configuração da instância do Adobe Commerce.

Requisitos

  • Adobe Commerce 2.4.4+
  • PHP 8.1, 8.2 ou 8.3
  • Composer
  • Execução de trabalhos e indexadores do cron
IMPORTANT
Antes de implementar o Live Search, consulte a seção Limites e Limites para garantir que o Live Search atenda às suas necessidades comerciais.

Atualizações importantes

  • A partir do Live Search 3.0.2, a extensão Catalog Service é agrupada com a instalação.

  • Devido ao anúncio do fim do suporte do Elasticsearch 7 para agosto de 2023, a Adobe recomenda que todos os clientes do Adobe Commerce migrem para o mecanismo de pesquisa OpenSearch 2.x. Para obter informações sobre como migrar o mecanismo de pesquisa durante uma atualização de produto, consulte Migrando para OpenSearch no Guia de Atualização.

Plataformas compatíveis

  • Adobe Commerce na nuvem (ECE): 2.4.4+
  • Adobe Commerce no local (EE) : 2.4.4+

Visão geral do fluxo de trabalho

Em um nível superior, a integração do Live Search exige que você:

  1. Instalar a extensão Live Search
  2. Configurar as chaves de API
  3. Sincronizar seus dados de catálogo
  4. Verificar se os dados do catálogo foram exportados
  5. Configurar os dados
  6. Testar a conexão
  7. Verificar se os eventos estão capturando dados
  8. Personalizar sua loja

Live Search está instalado como uma extensão do Adobe Marketplace até o Composer. Após instalar e configurar o Live Search, o Adobe Commerce começa a compartilhar dados de pesquisa e catálogo com serviços SaaS. Neste ponto, os usuários do Administrador podem configurar, personalizar e gerenciar aspectos de pesquisa, sinônimos e regras de merchandising.

Nova instância do Commerce

Siga estas instruções se estiver instalando o Live Search em uma nova instância do Commerce.

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

  2. Use o Composer para adicionar o módulo Live Search ao seu projeto:

    code language-bash 
    composer require magento/live-search --no-update

  3. Atualize as dependências e instale a extensão:

    code language-bash 
    composer update magento/live-search --with-dependencies

  4. Desabilite temporariamente o OpenSearch e os módulos relacionados e instale o Live Search.

    code language-bash 
    bin/magento module:disable Magento_ Magento_Elasticsearch8 Magento_Elasticsearch7 Magento_OpenSearch Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch Magento_ElasticsearchCatalogPermissionsGraphQl

    O Elasticsearch continua gerenciando solicitações de pesquisa da loja enquanto o serviço do Live Search sincroniza dados de catálogo e indexa produtos em segundo plano.

  5. Instale as atualizações.

    code language-bash 
    bin/magento setup:upgrade

  6. Verifique se os indexadores a seguir estão definidos como "Atualizar por Agendamento":

    • Feed do produto
    • Feed de variante de produto
    • Feed de atributos do catálogo
    • Feed de preços do produto
    • Feed de dados do site de escopos
    • Feed de dados dos grupos de clientes dos escopos
    • Feed de categorias
    • Feed de permissões de categoria

Depois de verificar os indexadores, a próxima etapa é configurar as chaves de API.

Instância do Commerce existente

Siga estas instruções se estiver instalando o Live Search em uma instância existente do Commerce.

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

  2. Use o Composer para adicionar o módulo Live Search ao seu projeto:

    code language-bash 
    composer require magento/live-search --no-update

  3. Atualize as dependências e instale a extensão:

    code language-bash 
    composer update magento/live-search --with-dependencies

  4. Desabilite os módulos Live Search que apresentam resultados de pesquisa de vitrine eletrônica.

    code language-bash 
    bin/magento module:disable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover Magento_LiveSearchProductListing

    O Elasticsearch continua gerenciando solicitações de pesquisa da loja enquanto o serviço do Live Search sincroniza dados de catálogo e indexa produtos em segundo plano.

  5. Instale as atualizações.

    code language-bash 
    bin/magento setup:upgrade

  6. Verifique se os indexadores a seguir estão definidos como "Atualizar por Agendamento":

    • Feed do produto
    • Feed de variante de produto
    • Feed de atributos do catálogo
    • Feed de preços do produto
    • Feed de dados do site de escopos
    • Feed de dados dos grupos de clientes dos escopos
    • Feed de categorias
    • Feed de permissões de categoria

  7. Habilite a extensão Live Search e desabilite o OpenSearch (Magento Elasticsearch e módulos OpenSearch).

    code language-bash 
    bin/magento module:enable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover  Magento_LiveSearchProductListing
    code language-none 
    bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch6 Magento_Elasticsearch7 Magento_Elasticsearch8 Magento_OpenSearch Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch Magento_ElasticsearchCatalogPermissionsGraphQl
    note note
    NOTE
    O comando disable inclui a lista de módulos do Commerce que oferecem suporte ao OpenSearch. Se a instância do Commerce não tiver um módulo instalado, você verá um erro module does not exist.

  8. Instale as atualizações.

    code language-bash 
    bin/magento setup:upgrade

Depois de verificar os indexadores, a próxima etapa é configurar as chaves de API.

IMPORTANT
O recurso a seguir está na versão beta. Para participar da versão beta, envie uma solicitação de email para commerce-store-services.

Esta versão beta oferece suporte a três novos recursos na consulta productSearch:

  • Pesquisa em camadas - Pesquisar em outro contexto de pesquisa - Com esse recurso, você pode realizar até duas camadas de pesquisa para suas consultas de pesquisa. Por exemplo:

    • Pesquisa de Camada 1 - Pesquise por "motor" em "product_attribute_1
    • Pesquisa de camada 2 - Pesquise por "part number 123" em "product_attribute_2". Este exemplo procura por "número de peça 123" nos resultados por "motor".

    A pesquisa em camadas está disponível para a indexação de pesquisa startsWith e a indexação de pesquisa contains, conforme descrito abaixo:

  • startsWith indexação de pesquisa - Pesquisar usando a indexação startsWith. Esse novo recurso permite:

    • Procurando produtos em que o valor do atributo começa com uma string específica.
    • Configurar uma pesquisa "termina com" para que os compradores possam pesquisar produtos em que o valor do atributo termina com uma determinada string. Para habilitar uma pesquisa "termina com", o atributo de produto precisa ser assimilado na ordem inversa, e a chamada de API também deve ser uma sequência invertida.

  • contém a indexação de pesquisa -Pesquise um atributo usando a indexação contains. Esse novo recurso permite:

    • Procurando uma consulta em uma cadeia de caracteres maior. Por exemplo, se um comprador procurar o número de produto "PE-123" na cadeia de caracteres "HAPE-123".

      note note
      NOTE
      Este tipo de pesquisa é diferente da pesquisa de frase existente, que executa uma pesquisa de preenchimento automático. Por exemplo, se o valor do atributo do seu produto for "calças de ar livre", uma pesquisa de frase retornará uma resposta para "fora da panela", mas não retornará uma resposta para "ou formigas". A contém busca, no entanto, retorna uma resposta para "ou formigas".

Essas novas condições aprimoram o mecanismo de filtragem de consultas de pesquisa para refinar os resultados da pesquisa. Essas novas condições não afetam a consulta de pesquisa principal.

Você pode implementar essas novas condições na página de resultados da pesquisa. Por exemplo, você pode adicionar uma nova seção na página, onde o comprador pode refinar ainda mais os resultados da pesquisa. Você pode permitir que os compradores selecionem atributos específicos do produto, como "Fabricante", "Número da peça" e "Descrição". A partir daí, eles pesquisam dentro desses atributos usando as condições contains ou startsWith. Consulte o Guia do administrador para obter uma lista de atributos pesquisáveis.

  1. Para instalar a versão beta, adicione a seguinte dependência ao seu projeto:

    code language-bash 
    composer require magento/module-live-search-search-types:"^1.0.0-beta1"

  2. Confirme e envie por push as alterações nos arquivos do composer.json e do composer.lock para o projeto de nuvem. Saiba mais.

    Este beta adiciona Search types caixas de seleção para Autocomplete, Contains e Starts with no Administrador. Ela também atualiza a API do GraphQL productSearch para incluir esses novos recursos de pesquisa.

  3. No Administrador, defina um atributo de produto para ser pesquisável e especifique o recurso de pesquisa para esse atributo, como Contém (padrão) ou Começa com. Você pode especificar no máximo seis atributos a serem habilitados para Contém e seis atributos a serem habilitados para Começa com. Para beta, esteja ciente de que o Administrador não impõe essa restrição, mas ela é imposta em pesquisas de API.

    Especificar recurso de pesquisa

  4. Consulte a documentação do desenvolvedor para saber como atualizar suas chamadas de API do Live Search usando os novos recursos de pesquisa do contains e do startsWith.

Descrições dos campos

Campo
Descrição
Autocomplete
Ativado por padrão e não pode ser modificado. Com Autocomplete, você pode usar contains no filtro de pesquisa. Aqui, a consulta de pesquisa em contains retorna uma resposta de pesquisa do tipo preenchimento automático. A Adobe recomenda usar esse tipo de pesquisa para campos de descrição, que normalmente têm mais de 50 caracteres.
Contains
Ativa uma pesquisa de "texto contido em uma sequência de caracteres" verdadeira em vez de uma pesquisa de preenchimento automático. Use contains no filtro de pesquisa. Consulte as Limitações para obter mais informações.
Starts with
Sequências de consulta que começam com um valor específico. Use startsWith no filtro de pesquisa.

​2. Configurar chaves de API

A chave de API do Adobe Commerce e sua chave privada associada são necessárias para conectar o Live Search a uma instalação do Adobe Commerce. A chave de API é gerada e mantida na conta do detentor da licença Commerce, que pode compartilhá-la com o desenvolvedor ou com o integrador de sistemas. Em seguida, o desenvolvedor poderá criar e gerenciar os Espaços de dados SaaS em nome do detentor da licença. Se você já tiver um conjunto de chaves de API, não será necessário gerá-las novamente.

Saiba como configurar suas chaves de API no artigo Commerce Services Connector.

O Live Search move dados de catálogo para a infraestrutura SaaS da Adobe. Os dados são indexados e os resultados da pesquisa são enviados desse índice diretamente para a loja. Dependendo do tamanho e da complexidade, a indexação pode levar de 30 minutos a algumas horas.

Para iniciar a sincronização inicial dos dados do catálogo com os serviços SaaS, execute os seguintes comandos nesta ordem:

bin/magento saas:resync --feed productattributes
bin/magento saas:resync --feed products
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed productoverrides
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed categoryPermissions

Quando você executa esses comandos, a sincronização inicial dos dados do catálogo com os serviços SaaS é iniciada.

WARNING
As operações de pesquisa e pesquisa de categoria não estão disponíveis durante a sincronização. O processo pode levar mais de uma hora, dependendo do tamanho do catálogo.

Monitorar progresso da sincronização

Use o Painel de Gerenciamento de Dados para monitorar o progresso da sincronização. Esse painel fornece informações valiosas sobre a disponibilidade dos dados do produto na loja, garantindo que eles possam ser exibidos imediatamente para os clientes.

Painel de gerenciamento de dados

Você também pode executar comandos de sincronização e solucionar problemas do processo de sincronização usando a CLI do Commerce e os logs de extensão de exportação de dados.

Futuras atualizações do produto

Após a sincronização inicial, pode levar até 15 minutos para que atualizações de produtos incrementais sejam disponibilizadas para pesquisa na loja. Para saber mais, consulte Streaming de Atualizações de Produto na documentação de Indexação.

​4. Verifique se os dados foram exportados

Para verificar se os dados do catálogo foram exportados do Adobe Commerce e sincronizados com o Live Search, você tem algumas opções:

  • Procure entradas nas seguintes tabelas:

    • cde_products_feed
    • cde_product_attributes_feed
    note note
    NOTE
    Se você receber um erro table does not exist, procure entradas nas tabelas catalog_data_exporter_products e catalog_data_exporter_product_attributes. Estes nomes de tabela são usados em Live Search versões anteriores à 4.2.1.

  • Use a área de jogo do GraphQL com a consulta padrão (consulte a referência do GraphQL para obter mais detalhes) para verificar o seguinte:

    • A contagem de produtos retornada está próxima do que você espera da exibição da loja.
    • Os aspectos são retornados.

Para obter ajuda adicional, consulte Live Search catálogo não sincronizado na Base de Dados de Conhecimento de Suporte.

​5. Configurar os dados

A configuração correta dos dados do produto garante bons resultados de pesquisa para os clientes. Nesta seção, você ativa os widgets da lista de produtos e atribui categorias.

Ativar widgets de lista de produtos

Quando você instala o Live Search 4.0.0+, os widgets de lista de produtos são habilitados por padrão. Quando os widgets são ativados, um componente de interface do usuário diferente é usado para os resultados da pesquisa e as páginas de listagem de produtos do navegador de categorias. Este componente da interface faz chamadas diretas à API do Serviço de Catálogo, o que resulta em tempos de resposta mais rápidos.

Se você tiver uma versão do Live Search anterior à 4.0.0+, deverá habilitar manualmente o Widget de listagem de produtos.

  1. No Admin, vá para Stores > Settings>Configuration.

  2. Em Live Search, selecione Storefront Features.

  3. Defina Enable Product Listing Widgets como Yes.

    Habilitar Widgets de Listagem de Produtos

Quando você alterar essa configuração, a mensagem Page cache is invalidated será exibida. É necessário liberar o cache do Magento para salvar a alteração.

  1. Acesse a página Gerenciamento de Cache seguindo um destes procedimentos:

    • Clique no link Cache Management na mensagem acima do espaço de trabalho.
    • Na barra lateral Admin, vá para System > Tools>Cache Management.

  2. Selecione a Configuração Cache Type e clique em Flush Magento Cache.

    As alterações na loja são imediatas depois de liberar o cache.

Atribuir categorias

Os produtos retornados em Live Search devem ser atribuídos a uma categoria. Na Luma, por exemplo, os produtos são colocados em categorias como "Homens", "Mulheres" e "Engrenagens". As subcategorias também são configuradas para "Topos", "Partes inferiores" e "Inspeções". Essas atribuições de categoria melhoram a granularidade ao filtrar.

​6. Testar a conexão

Com seus dados de catálogo agora em SaaS, teste para garantir que os dados do produto sejam retornados nas seguintes situações:

  • A caixa Search retorna os resultados corretamente
  • A pesquisa de categoria retorna os resultados corretamente
  • Os aspectos estão disponíveis como filtros nas páginas de resultados da pesquisa

Se tudo funcionar corretamente, Live Search está instalado, conectado e pronto para uso.

Se você encontrar problemas na loja, verifique o arquivo var/log/system.log em busca de falhas de comunicação da API ou erros no lado dos serviços.

Para permitir Live Search por meio de um firewall, adicione commerce.adobe.io ao arquivo de inclui na lista de permissões.

​7. Verifique se os eventos estão capturando dados

Verifique se os eventos da loja implantados em seu site estão funcionando. Essa verificação é especialmente importante para implementações headless.

​8. Personalize para sua loja

Você instalou a extensão Live Search, sincronizou, validou e configurou seus dados. A próxima etapa é garantir que os widgets do Live Search estejam de acordo com a aparência da sua loja.

Você pode estilizar os widgets popover e PLP definindo regras CSS personalizadas, conforme necessário. Consulte Elementos Popover de estilo e widget da página de listagem de produtos.

Se você quiser estender a funcionalidade dos widgets, o código-fonte de cada um deles estará disponível em um repositório público.
Nesse cenário, você pode personalizar o JavaScript de acordo com suas necessidades e, em seguida, hospedar seu código personalizado no CDN. Este script personalizado se comunica com o serviço Live Search e retorna os resultados normalmente, permitindo que você controle a funcionalidade do widget.

Antes de atualizar o Live Search, verifique a versão do Live Search que está instalada usando o Composer.

composer show magento/module-live-search | grep version

Para atualizar Live Search, execute o seguinte na linha de comando:

composer update magento/live-search --with-dependencies

Para atualizar para uma versão principal, como 3.1.1 para 4.0.0, edite o arquivo Composer .json raiz do projeto da seguinte maneira:

  1. Se sua versão do magento/live-search instalada no momento for a 3.1.1 ou inferior, e você estiver atualizando para a versão 4.0.0 ou superior, execute o seguinte comando antes da atualização:

    code language-bash 
    bin/magento module:enable Magento_AdvancedSearch

    Para obter informações sobre a versão magento/live-search instalada no momento, execute o seguinte comando:

    code language-bash 
    composer show magento/live-search

  2. Abra o arquivo raiz composer.json e procure por magento/live-search.

  3. Na seção require, atualize o número da versão da seguinte maneira:

    code language-json 
    "require": {
   ...
   "magento/live-search": "^4.0",
   ...
 }

  4. Salve composer.json. Em seguida, execute o seguinte a partir da linha de comando:

    code language-bash 
    composer update magento/live-search --with-dependencies

Para desinstalar o Live Search, consulte Desinstalar módulos.

Live Search pacotes

A extensão Live Search consiste nos seguintes pacotes:

Pacote
Descrição
module-live-search
Permite que os comerciantes definam suas configurações de pesquisa para facetas, sinônimos, regras de consulta e assim por diante, além de fornecer acesso a um playground do GraphQL somente leitura para testar consultas do Administrador.
module-live-search-adapter
Encaminha solicitações de pesquisa da loja para o serviço Live Search e renderiza os resultados na loja.
- Navegação de categoria - Encaminha solicitações da navegação superior da vitrine para o serviço de pesquisa.
- Pesquisa global - Encaminha solicitações do campo pesquisa rápida para o serviço Live Search. O campo de pesquisa rápida está localizado no canto superior direito da página da loja.
module-live-search-storefront-popover
Um popover "pesquisar ao digitar" substitui a pesquisa rápida padrão e retorna dados e miniaturas dos principais resultados da pesquisa.

Live Search dependências

O metapackage Composer para instalar a extensão Live Search inclui as seguintes dependências de módulo.

  • magento/module-saas-catalog
  • magento/module-saas-category
  • magento/module-saas-category-permissions
  • magento/module-saas-product-override
  • magento/module-saas-product-variant
  • magento/module-saas-price
  • magento/module-saas-scopes
  • magento/module-bundle-product-data-exporter
  • magento/module-catalog-inventory-data-exporter
  • magento/module-catalog-url-rewrite-data-exporter
  • magento/module-configurable-product-data-exporter
  • magento/module-parent-product-data-exporter
  • magento/module-gift-card-product-data-exporter
  • magento/module-bundle-product-override-data-exporter
  • data-services
  • services-id

Conceitos avançados

As seções a seguir fornecem tópicos mais avançados ao usar Live Search e Catalog Service.

Endpoint

Live Search se comunica através do ponto de extremidade em https://catalog-service.adobe.io/graphql.

Como Live Search não tem acesso ao banco de dados completo do produto, as APIs principais do GraphQL do Commerce e do GraphQL Live Search não têm paridade completa.

A Adobe recomenda chamar as APIs SaaS diretamente — especificamente, o endpoint do Serviço de catálogo.

  • Obter desempenho e reduzir a carga do processador, ignorando o processo de banco de dados/Graphql do Commerce
  • Aproveite a federação Catalog Service para chamar Live Search, Catalog Service e Product Recommendations de um único ponto de extremidade.

Para alguns casos de uso, talvez seja melhor ligar para Catalog Service para obter detalhes sobre o produto e casos semelhantes. Consulte refineProduct para obter mais informações.

Se você tiver uma implementação headless personalizada, confira as Live Search implementações de referência:

A coleta automática de dados de interação do usuário não funciona por padrão se você não usar os componentes padrão, como o Adaptador de pesquisa, os widgets do Luma ou os Widgets do AEM CIF. O Adobe Sensei usa esses dados coletados para um merchandising inteligente e para o rastreamento de desempenho. Para resolver esse problema, é necessário desenvolver uma solução personalizada para implementar essa coleção de dados de forma headless.

A última versão de Live Search já usa Catalog Service.

Suporte de idioma

Os widgets Live Search oferecem suporte aos seguintes idiomas:

Idioma
Região
Código do idioma
Localidade do Magento
Búlgaro
Bulgária
bg_BG
bg_BG
Catalão
Espanha
ca_ES
ca_ES
Tcheco
República Checa
cs_CZ
cs_CZ
Dinamarquês
Dinamarca
da_DK
da_DK
Alemão
Alemanha
de_DE
de_DE
Grego
Grécia
el_GR
el_GR
Inglês
Reino Unido
en_GB
en_GB
Inglês
Estados Unidos
pt_BR
pt_BR
Espanhol
Espanha
es_ES
es_ES
Estoniano
Estônia
et_EE
et_EE
Basco
Espanha
eu_ES
eu_ES
Persa
Irã
fa_IR
fa_IR
Finlandês
Finlândia
fi_FI
fi_FI
Francês
França
fr_FR
fr_FR
Galego
Espanha
gl_ES
gl_ES
Hindi
Índia
hi_IN
hi_IN
Húngaro
Hungria
hu_HU
hu_HU
Indonésio
Indonésia
id_ID
id_ID
Italiano
Itália
it_IT
it_IT
Coreano
Coreia do Sul
ko_KR
ko_KR
Lituano
Lituânia
lt_LT
lt_LT
Letão
Letônia
lv_LV
lv_LV
Norueguês
Noruega - Bokmal
nb_NO
nb_NO
Holandês
Holanda
nl_NL
nl_NL
Polonês
Polônia
pl_PL
pl_PL
Português
Brasil
pt_BR
pt_BR
Português
Portugal
pt_PT
pt_PT
Romeno
Romênia
ro_RO
ro_RO
Russo
Rússia
ru_RU
ru_RU
Sueco
Suécia
sv_SE
sv_SE
Tailandês
Tailândia
th_TH
th_TH
Turco
Turquia
tr_TR
tr_TR
Chinês
China
zh_CN
zh_Hans_CN
Chinês
Taiwan
zh_TW
zh_Hant_TW

Se o widget detectar que a configuração de idioma do administrador do Commerce corresponde a um idioma suportado, o padrão será esse idioma. Caso contrário, o widget usará o inglês como padrão. No Admin, a configuração de idioma é definida navegando até Stores> Settings >Configuration > General> Country Options.

Os administradores também podem definir o idioma do índice de pesquisa, para ajudar a garantir melhores resultados de pesquisa.

Repositório de código do widget

O código do widget página da listagem de produtos e do widget de campo Live Search está disponível para download no GitHub.

Os desenvolvedores que têm acesso ao código podem personalizar completamente o funcionamento e a aparência. Eles hospedam o código em seus próprios servidores, mas ainda usam o serviço Live Search.

Extensão Data Export

Depois que Live Search é habilitado, a extensão Exportação de Dados sincroniza os dados do Commerce entre o aplicativo Commerce e Live Search. Esse processo garante que os dados mais atuais do Commerce estejam disponíveis na loja. No Admin, você pode verificar o status da sincronização usando o painel Gerenciamento de dados. Você pode gerenciar e solucionar problemas do processo de exportação de dados usando a CLI e os logs do Commerce. Para obter detalhes, consulte o Guia de Exportação de Dados.

Inventory management

O Live Search oferece suporte aos recursos do Inventory management na Commerce (anteriormente conhecido como Inventário de Várias Source, ou MSI). Para habilitar o suporte completo, você deve atualizar o módulo de dependência commerce-data-export para a versão 102.2.0+.

Live Search retorna um valor booleano observando se um produto está disponível no Inventory management, mas não contém informações sobre qual origem tem o estoque.

Indexador de preços

Live Search clientes podem usar o indexador de preços SaaS, que fornece atualizações de alteração de preço e tempo de sincronização mais rápidos.

Suporte de preço

Os widgets Live Search são compatíveis com a maioria, mas não com todos os tipos de preços aceitos pelo Adobe Commerce.

Atualmente, os preços básicos são suportados. Os preços avançados que não são compatíveis são:

  • Custo
  • Preço Mínimo Anunciado

Examine a API Mesh para cálculos de preço mais complexos.

O formato de preço oferece suporte à definição de configuração de localidade na instância do Commerce: Lojas > Configurações > Configuração > Geral > Geral > Opções Locais > Localidade.

Suporte a vitrine headless

Opcionalmente, talvez seja necessário instalar o módulo module-data-services-graphql que expande a cobertura de GraphQL existente do aplicativo para incluir campos necessários para a coleta de dados comportamentais da loja.

composer require magento/module-data-services-graphql

Esse módulo adiciona contextos adicionais às consultas do GraphQL:

  • dataServicesStorefrontInstanceContext
  • dataServicesMagentoExtensionContext
  • dataServicesStoreConfigurationContext

Suporte B2B

Live Search dá suporte à funcionalidade B2B com limitações adicionais.

Suporte ao PWA

O Live Search funciona com o PWA Studio, mas os usuários podem ver pequenas diferenças em comparação a outras implementações do Commerce. Funcionalidades básicas, como pesquisa e listagem de produtos, funcionam em Venia, mas algumas permutas de Graphql podem não funcionar corretamente. Também pode haver diferenças de desempenho.

  • A implementação atual do PWA de Live Search requer mais tempo de processamento para retornar resultados de pesquisa do que Live Search com a loja nativa do Commerce.
  • Live Search no PWA não oferece suporte a manipulação de eventos. Como resultado, os relatórios de pesquisa e o merchandising inteligente não funcionam nas vitrines do PWA.
  • Ao usar o PWA Studio, o GraphQL não oferece suporte à filtragem diretamente em description, name, short_description, mas esses campos podem ser retornados com um filtro mais geral.

Para usar o Live Search com o PWA Studio, os integradores também devem:

  1. Instale o livesearch-storefront-utils.

  2. Defina o environmentId no objeto storeDetails.

    code language-javascript 
    const storeDetails: StoreDetailsProps = {
    environmentId: <Storefront_ID>,
    websiteCode: "base",
    storeCode: "main_website_store",
    storeViewCode: "default",
    searchUnitId: searchUnitId,
    config: {
        minQueryLength: 5,
        pageSize: 8,
        currencySymbol: "$",
        },
    };

Cookies

O Live Search coleta dados de interação do usuário para melhorar a funcionalidade de pesquisa e armazena essas informações em cookies do navegador. Essa coleta de dados exige o consentimento do usuário quando as restrições de cookie são ativadas. Live Search e Product Recommendations compartilham o mesmo mecanismo de coleta de dados e tratamento de cookies. Para obter mais informações sobre restrições de cookies e conformidade com a privacidade, consulte Manipular restrições de cookies.

recommendation-more-help
8eedb3c4-09d2-4e4f-917b-524833fc6b4f