Introdução ao Retail Search - Configurações de exibição

Abaixo iremos mostrar o passo-a-passo de como criar configurações de exibição.

Uma configuração de exibição é uma entidade de exibição que associa um modelo ou um conjunto de controles usados para gerar os resultados da pesquisa ou de recomendações.

As configurações do Retail Search tem requisitos diferentes das configurações de exibição do Recommendations AI (que exigem um modelo), na retail search podemos usar os controles de veiculação, mas eles não são obrigatórios.

Há duas formas de se criar uma configuração de exibição: usando o console ou a api. Há um limite de até 100 configurações de exibição por catálogo.

Uma etapa importante desse processo é estipular os controles de veiculação (são regras que você define e aplica a configurações específicas de veiculação da retail search e que personalizam como as configurações de exibição veiculam resultados da pesquisa.)

Os controles de exibição são:

Boost/bury: afeta a classificação e a ordem dos resultados na lista de resultados retornada.
Filtro: remove os resultados que não passam no filtro da lista de resultados retornados.
Redirecionar: redireciona seus usuários para uma página específica, dependendo da consulta de pesquisa.
Linguística: personaliza a linguística da consulta de pesquisa. Vários tipos de controle linguístico estão disponíveis:
- Sinônimo: expande os sinônimos considerados para uma consulta de pesquisa.
- Sinônimo unidirecional: expande os sinônimos considerados unidirecionalmente para termos específicos.
- Não associar: impede que um grupo de termos seja usado na pesquisa quando termos específicos aparecem.
- Ignorar: impede que um termo seja usado em pesquisas.
- Substituição: substitui termos na consulta de pesquisa.

Cenário 1 - Console

Acesse a página "Configurações de exibição".
Clique em Criar configuração de veiculação.
Na página Criar configuração de exibição, escolha Pesquisa como o produto em que a configuração de exibição será usada.
Forneça um nome para sua configuração de exibição. O nome precisa ter 1.024 caracteres ou menos e pode conter apenas caracteres alfanuméricos, sublinhados, hifens e espaços.
Se necessário, atualize o ID. Ele é gerado com base no nome fornecido e precisa ser exclusivo no seu projeto. Ele pode ter até 50 caracteres e não pode conter espaços.
Clique em Continuar.
Escolha se você quer ativar o atributo dinâmico para esta configuração de exibição.
Escolha ou crie controles de veiculação para otimizar as pesquisas.
Clique em Criar para gerar a nova configuração. A nova configuração aparece na página Configurações de exibição.

Cenário 2 - API

Faça uma solicitação usando o métodoServingConfig.create da api com um ID de configuração de exibição e uma instância de ServingConfig no corpo da solicitação.

Valores importantes:

servingConfigId: obrigatório. Cria um ID para o ServingConfig. Esse valor precisa ter de 4 a 63 caracteres. Os caracteres válidos são /[a-z][0-9]-_/.
displayName: obrigatório. O nome legível do ServingConfig exibido no Console do varejo.
facetControlIds: opcional. IDs de controles que têm apenas FacetSpec definido.
dynamicFacetSpec.mode: opcional. Modo do recurso DynamicFacet. Os valores permitidos são DISABLED (padrão se não for definido) e ENABLED.
boostControlIds: opcional. IDs de controles de exibição maiores.
filterControlIds: opcional. IDs dos controles de veiculação de filtros.
redirectControlIds: opcional. IDs dos controles de exibição de redirecionamento.
twowaySynonymsControlIds: opcional. IDs dos controles de veiculação de sinônimos de mão dupla.
onewaySynonymsControlIds: opcional. IDs dos controles de veiculação de sinônimos unidirecional.
doNotAssociateControlIds: opcional. IDs de controles de veiculação não associar.
replacementControlIds: opcional. IDs dos controles de veiculação substitutos.
ignoreControlIds: opcional. IDs de controles de veiculação ignorados.
solutionTypes: obrigatório. Defina como SOLUTION_TYPE_SEARCH para as configurações de exibição da pesquisa de varejo.

Exemplo de código:

curl -X POST \\
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \\
     -H "Content-Type: application/json; charset=utf-8" \\
     --data '{
              "displayName":DISPLAY_NAME,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \\
    "<https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID>"

Referências:

https://cloud.google.com/retail/docs/create-configs?hl=pt-br

https://cloud.google.com/retail/docs/manage-controls?hl=pt-br