Preenchimento automático para pesquisa

Esta página apresenta a funcionalidade de preenchimento automático e como usá-la. A Pesquisa oferece preenchimento automático para sugestões de escrita antecipada na caixa de pesquisa de condução.

O preenchimento automático é uma funcionalidade que prevê o resto de uma consulta que um utilizador está a introduzir, o que pode melhorar a experiência de pesquisa do utilizador e acelerar o processo de compras antes do pagamento. Também pode melhorar a qualidade da resposta da pesquisa e, assim, gerar uma receita mais elevada através de consultas bem formatadas.

Vista geral

Quando um utilizador final começa a escrever um termo de pesquisa no seu site, a pesquisa pode fornecer uma lista de sugestões que o utilizador pode querer. Por exemplo, sapatos e camisas podem ser sugeridos quando o utilizador introduz sa.

Origem de dados

Pode escolher uma das seguintes origens de dados para as suas previsões de sugestões:

• Um conjunto de dados do BigQuery que carrega.
• Um conjunto de dados gerado a partir de eventos do utilizador e outros metadados através da aprendizagem automática.

Conjunto de dados carregado

Uma tabela de sugestões do BigQuery que carrega como um conjunto de dados, que é usada para sugerir consultas. Para saber como carregar um conjunto de dados, consulte o artigo Importar dados de preenchimento automático.

Conjunto de dados de aprendizagem automática

Um conjunto de dados de sugestões com tecnologia de aprendizagem automática gerado pela pesquisa com base nos eventos de pesquisa dos utilizadores.

Para ativar a aprendizagem automática:

Cloud Console

1. Aceder à página Controlos

2. Aceda ao separador Controlos de preenchimento automático.

3. Clique em Editar definições.

4. Ative a Aprendizagem automática.

5. Clique em Guardar definições.

   A aprendizagem automática pode demorar 1 a 2 dias a atualizar.

cURL

curl -X PATCH -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type: application/json" \
  "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionConfig?update_mask.paths=auto_learning"  --data "{auto_learning: true}"

Pré-requisito do conjunto de dados de aprendizagem automática

A aprendizagem automática gera sugestões a partir de eventos de utilizadores do tipo de pesquisa (eventType = "search"). A geração usa os eventos de utilizadores dos últimos 180 dias. Requer uma boa qualidade e quantidade de eventos de utilizador importados.

A aprendizagem automática filtra sugestões raras. Por isso, se a quantidade de eventos do utilizador do tipo de pesquisa for demasiado pequena (inferior a 20 000), muitos candidatos a sugestões podem ser filtrados. Neste cenário, é recomendável testar primeiro a função de preenchimento automático com uma consulta de pesquisa mais frequente.

Agenda de lançamentos do conjunto de dados de aprendizagem automática

O conjunto de dados de aprendizagem automática é gerado diariamente e, em seguida, enviado para a indexação e a publicação. O ciclo completo demora cerca de dois dias.

Funcionalidades de aprendizagem automática

A Pesquisa aplica técnicas de aprendizagem automática para limpar e formatar as consultas e os dados de sugestões apenas para o conjunto de dados de aprendizagem automática.

Funcionalidade	Descrição	Exemplo
Remova pesquisas com 0 resultados	Remover consultas que não têm resultados da pesquisa.	Para o retalhista de produtos de mercearia, a pesquisa Bolsas Gucci tem 0 resultados da pesquisa, pelo que é removida.
Corrija erros ortográficos	Corrija a ortografia de palavras que são erros ortográficos. Também limpa as consultas de entrada em tempo real antes da correspondência.	Milc → Milk
Adicione consultas à lista de autorizações	As consultas que permite explicitamente são adicionadas.	Consulte a secção Mais informações
Remova consultas da lista de bloqueio	As consultas que bloqueia explicitamente são removidas.	Consulte a secção Mais informações
Remova termos inseguros	Utiliza a Pesquisa Segura do Google. Remova consultas inadequadas.	Conteúdo pornográfico, sugestivo, vulgar ou violento
Remova termos muito raros	O sistema de IA ajusta o limite de acordo com as estatísticas de consultas. Se os termos forem invulgarmente raros, são removidos.	Colchão de ar duplo de 74 x 39 x 9 polegadas com bomba manual de 120 V.
Remova termos duplicados	Com base na compreensão semântica orientada pela IA Para termos quase idênticos, qualquer um dos termos vai corresponder, mas apenas o mais popular é sugerido.	Sapatos para mulher, sapatos de mulher e sapatos de senhora são desduplicados, pelo que só é sugerido um.

Receba sugestões de conclusão

Use a API completeQuery para obter as sugestões. Exemplo:

cURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog:completeQuery?query=sho&dataset=user-data&deviceType=DESKTOP&maxSuggestions=5"

Opções e controlos de preenchimento automático

Esta secção explica as opções e os controlos disponíveis para o preenchimento automático. Veja uma vista geral na tabela seguinte e mais detalhes.

Controlo	Detalhes	Localização
Lista de negações	Remove manualmente as consultas dos dados de sugestões.	Pedido de API: CompletionData:import. Para mais informações, consulte o artigo Importe dados de preenchimento automático.
Lista de autorizações	Adiciona manualmente consultas aos dados de sugestões.	Pedido de API: CompletionData:import (consulte também Importar dados de preenchimento automático )
Duração mínima para acionar o preenchimento automático	Controla o número de carateres antes de o preenchimento automático ser acionado.	Google Cloud consola > Controlos
Ordem de correspondência	A ordem de correspondência determina como a consulta do utilizador e as sugestões são correspondidas.	Google Cloud consola > Controlos
Contagem de sugestões	Este é o número de sugestões que são devolvidas pelo preenchimento automático.	Google Cloud consola > Controlos ou Pedido de API: completeQuery.maxSuggestions
Tipo de dispositivo	Quando são especificados tipos de dispositivos, as sugestões são geradas com base na popularidade dos tipos de dispositivos indicados. Se não especificar este valor, são devolvidas sugestões com base na popularidade combinada de todos os tipos de dispositivos.	Pedido de API: completeQuery.deviceType
Origem de dados de sugestões	Se tiver origens de dados geradas automaticamente e carregadas, pode escolher qual usar no momento da consulta.	Pedido de API: completeQuery.dataset
Idioma	Pode especificar o idioma ou os idiomas das sugestões.	Pedido de API: completeQuery.languageCodes[]

Lista de autorizações (lista de não remoção)

A Pesquisa faz o pós-processamento, como a correção ortográfica, nos dados de sugestões de preenchimento automático. Pode criar uma lista de termos permitidos que a pesquisa ignora durante o pós-processamento.

Os termos permitidos nunca são filtrados das sugestões. A lista de autorizações funciona para conjuntos de dados carregados e conjuntos de dados de aprendizagem automática.

Exemplos: existem alguns nomes de marcas com erros ortográficos intencionais, como "froot loops" em vez de "fruit" ou "foot". Consulte instruções de carregamento detalhadas em Importe dados de conclusão.

Para a importação de dados, pode usar a Google Cloud consola > Controlos > Controlos de preenchimento automático > Lista Não remover ou usar CompletionData:import na API.

As alterações entram em vigor em cerca de 2 dias.

Lista de negações

A lista de recusa só funciona para conjuntos de dados de aprendizagem automática. A lista de exclusão não funciona para conjuntos de dados carregados.

Os termos numa lista de recusa nunca aparecem nas sugestões.

Para importar uma lista de exclusão, pode usar Google Cloud console > Controlos > Controlos de preenchimento automático > Lista de exclusão ou usar a API CompletionData:import. Para ver instruções detalhadas sobre como importar uma lista de exclusões, consulte o artigo Importe dados de conclusão.

As alterações entram em vigor em cerca de 2 dias.

Comprimento mínimo para acionar

Pode definir o número de carateres necessários antes de as consultas de preenchimento automático devolverem resultados. Pode encontrar a definição em Google Cloud consola > Controlos > Controlos de preenchimento automático > Comprimento mínimo para acionar.

As alterações entram em vigor imediatamente.

Ordem de correspondência

Isto determina como fazer corresponder as sugestões aos termos introduzidos pelo utilizador.

Quando definido como A sugestão começa com o termo, o preenchimento automático corresponde ao termo introduzido pelo utilizador como um prefixo exato para as sugestões. Por exemplo, a entrada do utilizador "sh" corresponde às sugestões "sapatos" e "camisas", mas não à sugestão "sapatos vermelhos".

Quando a opção está definida como A sugestão pode começar em qualquer parte do termo, o preenchimento automático tokeniza o termo introduzido pelo utilizador em palavras e faz a correspondência com as palavras nas sugestões, independentemente da ordem das palavras. Por exemplo, o termo introduzido pelo utilizador "red sh" corresponde às sugestões "camisas vermelhas", "sapatos vermelhos" e "sapatos vermelhos para crianças". No entanto, o termo de entrada "enxadas" não corresponde a estas sugestões, porque nenhuma das palavras nas sugestões começa por "enxadas".

Pode encontrar a definição na Google Cloud consola > Controlos > Controlos de preenchimento automático > Ordem de correspondência.

As alterações entram em vigor imediatamente.

Contagem de sugestões

Este é o número de sugestões que serão devolvidas das consultas de preenchimento automático e não pode exceder 20. Pode encontrar a definição na Google Cloud consola > Controlos > Controlos de preenchimento automático > Quantidade de sugestões ou pode defini-la em completeQuery.

As alterações entram em vigor imediatamente.

Tipo de dispositivo

O preenchimento automático da pesquisa suporta diferentes tipos de dispositivos, como mobile e desktop. Pode carregar ou receber sugestões diferentes com base nos tipos de dispositivos. Se deviceType não for especificado em completeQuery, a sugestão vai abranger todos os tipos de dispositivos.

Para um conjunto de dados de aprendizagem automática baseado em eventos de utilizadores de pesquisa, defina user_agent em UserEvent.user_info para suportar diferentes tipos de dispositivos. Consulte o agente do utilizador na wiki.

Funcionalidades avançadas

Esta secção descreve as funcionalidades avançadas de preenchimento automático disponíveis com a pesquisa. Por exemplo, pode complementar as sugestões de preenchimento automático de consultas com outras sugestões, como marcas e categorias.

Estas funcionalidades avançadas só estão disponíveis para conjuntos de dados de aprendizagem automática.

Suggestion FeatureSet

Disponibilizamos um FeatureSet adicional para cada termo de sugestão de consulta para permitir que os clientes apresentem funções avançadas nos respetivos Websites.

O FeatureSet aparece na resposta como um mapa de valores-chave. O Vertex AI Search for commerce devolve até cinco categorias e marcas populares relacionadas com cada sugestão de consulta na resposta da API completeQuery.completionResults.attributes. As sugestões de FeatureSet não têm de corresponder às strings de consulta introduzidas pelo utilizador final.

Pode usar o FeatureSet na resposta para enriquecer as sugestões de pesquisa. Por exemplo:

• Agrega e cria secções de Marcas populares e Categorias populares que aparecem abaixo da lista de sugestões de pesquisa.
• Apresentar a marca ou a categoria mais popular junto aos termos de sugestão de pesquisa.

Depois de fazer alterações ao catálogo, como alterar as categorias dos produtos, aguarde duas semanas a 30 dias até que as sugestões do FeatureSet reflitam as alterações do catálogo de produtos. Este tempo de espera deve-se ao facto de a aprendizagem automática ser preparada com base nos dados de eventos de pesquisa dos últimos 30 dias.

Sugestões de atributos

A Pesquisa fornece sugestões de atributos que correspondem a strings introduzidas pelo utilizador. Os tipos de sugestões de atributos suportados são marcas e categorias.

As sugestões de atributos diferem de um FeatureSet de sugestões. As sugestões de atributos são listas de atributos de produtos sugeridos (como marcas e categorias), semelhantes à forma como as sugestões de consultas são listas de consultas sugeridas. As sugestões de atributos podem ser usadas independentemente das sugestões de consultas. Um FeatureSet de sugestão é metadados para uma sugestão de consulta e, por isso, depende das sugestões de consultas.

As sugestões de atributos podem ser usadas para preencher automaticamente marcas ou categorias que um utilizador final está a escrever, em secções separadas abaixo da lista de sugestões de pesquisa.

Faceta de sugestão com contagens de produtos (experimental)

Esta é uma funcionalidade experimental para um número limitado de clientes. Para a usar, contacte a equipa de apoio técnico.

Quando a funcionalidade de faceta de sugestão com contagem de produtos está ativada, o resultado completeQuery.completionResults apresenta uma lista de sugestões de preenchimento automático como habitualmente, mas também contagens de produtos para cada sugestão com a contagem total e a contagem de produtos por faceta (como color, category).

Por exemplo, se a consulta de pesquisa for "sapato", as sugestões de preenchimento automático devolvidas podem ser:

• womens shoes
• sapatos masculinos

Além disso, se a chave de faceta de interesse for color, também é devolvida uma contagem de produtos e uma contagem de produtos por cor com cada sugestão de preenchimento automático:

• sapatos de senhora (32)
  • preto (10)
  • taupe (16)
  • branco (10)
• mens shoes (43)
  • preto (10)
  • castanho (5)
  • verde (17)

Como retalhista, não tem de apresentar a quantidade de produtos ao comprador, mas pode decidir ordenar a lista de sugestões com base na quantidade de produtos em vez da ordem devolvida em completeQuery.completionResults. Por exemplo, pode querer incentivar os compradores a verem sapatos verdes para homem, fazendo com que os sapatos verdes apareçam na parte superior da caixa de sugestões, mesmo que não sejam o artigo mais popular.

Por exemplo:

{
  "completion_results": [{ 
    "suggestion": "womens shoes"
    "facets": [ 
      {
        "key": "color"
        "values": [ 
          {
            "value": "black"
            "count": 10
          }
          {
            "value": "taupe"
            "count": 16
          }
          {
            "value": "white"
            "count": 10
          }
        ]
      }
    ]
    "total_product_count": 32
  },
  (...)
  ],
}

As informações de contagem de facetas aparecem como uma lista de Facets em completeQuery.completionResults.facets para cada consulta de pesquisa sugerida. Cada faceta tem uma lista FacetValues que contém a quantidade de produtos por valor de faceta. A quantidade total de produtos para cada consulta de pesquisa sugerida é devolvida em completeQuery.completionResults.totalProductCount.

Para ativar e usar as facetas de sugestões com contagens de produtos, siga estes passos:

1. Contacte a equipa de apoio técnico e peça-lhe para ativar a funcionalidade Facet de sugestões com contagens de produtos. Especifique para que FacetKeys quer as contagens de produtos. Apenas são permitidas facetas textual_fields.

2. Durante, pelo menos, 7 dias, certifique-se de que, quando usar a API search, inclui a chave de faceta em FacetSpecs.search.searchRequest.facetSpecs

   Este tempo de espera deve-se ao facto de as informações de facetas serem calculadas com base nos dados do histórico de pesquisas da semana anterior.

3. Depois de a funcionalidade ser ativada para si, as sugestões devolvidas da API completeQuery contêm as quantidades de produtos por faceta e por sugestão.

Sugestão filtrada por entidade

As entidades permitem-lhe filtrar sugestões de pesquisa de preenchimento automático. Uma entidade pode ser um Website para uma marca ou uma região diferente. Quer que o preenchimento automático reflita melhor o comportamento dos utilizadores que compram essa marca específica ou visitam esse Website regional. Para mais informações sobre entidades, consulte o artigo Entidades.

Tenha em atenção que a filtragem de entidades só se aplica a completion_results (relevante para UserEvent). Este filtro não se aplica a attribute_results (relevante para Product). Por isso, independentemente do valor de entity, o valor de attribute_results é o mesmo.

Para incluir entidades nas sugestões de preenchimento automático:

1. Inclua o campo entity nos eventos de utilizador de pesquisa (eventType = "search"). Para mais informações, consulte o exemplo de objeto completo para o evento de utilizador Search.

2. Defina o campo entity no seu pedido da API CompleteQuery para receber sugestões apenas para essa entidade.

   A string de entidade nos eventos do utilizador e nos pedidos API tem de ser uma correspondência exata. Caso contrário, o preenchimento automático devolve sugestões vazias.

3. Certifique-se de que a entidade (quer nos eventos do utilizador de pesquisa ou nas solicitações de preenchimento automático) tem, no máximo, 256 carateres. Um valor mais longo é truncado para 256 carateres quando os eventos ou os pedidos são processados, o que pode causar uma incompatibilidade.

Normalmente, são necessários 30 a 90 dias de dados de eventos do utilizador para que a funcionalidade de entidade possa devolver sugestões de preenchimento automático ideais.