Criar configurações de veiculação

Nesta página, descrevemos 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. Para mais informações sobre configurações de veiculação, consulte Sobre configurações de veiculação.

Antes de começar

As configurações de veiculação de recomendações e pesquisa têm requisitos e opções diferentes:

• As configurações de veiculação de recomendações exigem um modelo. Se você planeja anexar um modelo a uma nova configuração de veiculação, extraia o ID do modelo que você quer usar. Isso é necessário ao usar o método ServingConfig.create.

  Se você estiver criando a configuração de exibição usando o console, poderá criar um novo modelo durante o processo de criação em vez de anexar um modelo existente.

  É possível mudar de modelo depois, desde que seja do mesmo tipo.

• A pesquisa pode usar controles de exibição, mas eles não são obrigatórios. Se você planeja anexar controles atuais a uma nova configuração de exibição, extraia os IDs dos controles que você pretende usar.

  Se você estiver criando a configuração de exibição usando o console, também poderá criar novos controles durante o processo de criação.

  É possível trocar ou adicionar controles de exibição à configuração de exibição depois de criá-la.

Criar uma configuração de exibição

É possível criar uma configuração de exibição usando:

• O console de pesquisa para comércio.
• A API ServingConfig.create.

São permitidas até 100 configurações de exibição por catálogo.

A pesquisa funciona com configurações de exibição não configuradas. Qualquer serving_config_id pode ser colocado como parte da solicitação de pesquisa, e esse default_search vai pesquisar o catálogo com o recurso de pesquisa padrão da Vertex AI para Pesquisa no comércio.

Se você tiver posições existentes ou criar novas posições, uma configuração de exibição associada a cada posição será criada automaticamente. A criação de uma configuração de exibição não cria uma posição correspondente. A exclusão de uma configuração de veiculação remove o posicionamento correspondente, e a exclusão de um posicionamento remove a configuração de veiculação correspondente.

Criar uma configuração de exibição no console

Adicione uma nova configuração de exibição na página "Configurações de exibição" no console "Pesquisa para comércio".

Para criar uma configuração de veiculação:

1. Acesse a página Configurações de exibição no console da Pesquisa para e-commerce.
   
   Acessar a página "Configurações de exibição"

2. Clique em add_boxCriar configuração de veiculação.

   Recomendações

   1. Selecione Recomendação como o produto que será usado na configuração de exibição.

   2. Dê um nome à configuração de exibição.

      O nome precisa ter 1.024 caracteres ou menos e pode conter apenas caracteres alfanuméricos, sublinhados, hífens e espaços.

   3. Opcional: se necessário, atualize o ID.

      O ID é gerado a partir do nome fornecido e precisa ser exclusivo em todo o projeto. Ele precisa ter até 50 caracteres e não pode conter espaços.

   4. Escolha ou crie um modelo para que a configuração de exibição forneça recomendações.

      Saiba mais sobre como criar novos modelos.

   5. Selecione quanto a reclassificação de preços deve afetar os resultados da recomendação, se disponível para o modelo selecionado.

      A reclassificação de preços organiza, por ordem decrescente de preço, os produtos recomendados que têm probabilidade similar de serem pedidos. A relevância ainda é usada para ordenar itens. Portanto, ativar a reclassificação de preços não é o mesmo que classificar por preço.

   6. Selecione se quer usar a diversificação de resultados com base em regras ou em dados:

      • Baseada em regras:a diversificação de resultados baseada em regras afeta se os resultados retornados de uma única solicitação de previsão são de categorias diferentes do catálogo de produtos.

      • Baseada em dados:a diversificação de resultados baseada em dados usa o machine learning para equilibrar a diversidade e a relevância da categoria nos resultados de previsão.

      Para mais informações, consulte Diversificação de resultados.

   7. Selecione o valor para diversificar os resultados da recomendação.

   8. Se você selecionou um modelo de itens semelhantes para essa configuração de exibição, escolha se quer ativar a correspondência de categorias.

      Quando a correspondência de categoria está ativada, os únicos resultados de produtos retornados são aqueles que compartilham pelo menos uma categoria com o produto de contexto. A correspondência de categoria pode ser usada em combinação com outras opções de filtragem, como preço, disponibilidade e tags de filtro.

   Pesquisar

   1. Na página Criar configuração de exibição, escolha Pesquisa como o produto em que a configuração de exibição será usada.
   2. Dê um nome à sua configuração de veiculação.
      
      O nome precisa ter 1.024 caracteres ou menos e pode conter apenas caracteres alfanuméricos, sublinhados, hífens e espaços.
   3. Opcional: se necessário, atualize o ID.
      
      O ID é gerado com base no nome fornecido e precisa ser exclusivo em todo o projeto. Ele precisa ter até 50 caracteres e não pode conter espaços.
   4. Clique em Continuar.
   5. Escolha se quer ativar o atributo dinâmico para essa configuração de exibição.
   6. Escolha ou crie controles de disponibilização para otimizar suas pesquisas.
      
      Para mais informações sobre controles, consulte Como criar e gerenciar controles.

3. Clique em Criar para gerar a nova configuração.

   A nova configuração aparece na página Configurações de exibição.

   Pode levar alguns minutos para que a configuração fique disponível para uso em solicitações de pesquisa. Ela fica disponível imediatamente para recomendações.

4. Opcional: na página "Configurações de exibição", clique em um nome de configuração e acesse a guia Avaliar para visualizar os produtos que seriam retornados para essa configuração.

   A visualização da avaliação pode ajudar a confirmar se a configuração está funcionando conforme o esperado.

Criar uma configuração de veiculação com ServingConfig.create

É possível criar uma configuração de disponibilização com o método da API ServingConfig.create. Para consultar a documentação de referência da API para esse método, acesse ServingConfig.create.

Os campos usados dependem de você estar criando uma configuração de exibição para recomendações ou pesquisa.

Para mais detalhes sobre os campos ServingConfig, consulte a referência da API ServingConfigs.

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",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityType": "DIVERSITY_TYPE",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

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"
  

Próximas etapas

• Solicite previsões da nova posição.