Crie configurações de publicação

Esta página descreve como criar configurações de publicação. Uma configuração de publicação é uma entidade de publicação que associa um modelo ou um conjunto de controlos que são usados para gerar os resultados da pesquisa ou da recomendação. Para mais informações sobre as configurações de publicação, consulte o artigo Acerca das configurações de publicação.

Antes de começar

As recomendações e as configurações de publicação de pesquisas têm requisitos e opções diferentes:

  • As configurações de publicação de recomendações requerem um modelo. Se planeia anexar um modelo existente a uma nova configuração de publicação, obtenha o ID do modelo que planeia usar (obrigatório quando usar o método ServingConfig.create ).

    Se criar a configuração de publicação através da consola, pode criar um novo modelo durante o processo de criação em vez de anexar um modelo existente.

    Pode mudar de modelo mais tarde, desde que seja do mesmo tipo de modelo.

  • A Pesquisa pode usar controlos de publicação, mas estes não são obrigatórios. Se planeia anexar controlos existentes a uma nova configuração de publicação, obtenha os IDs dos controlos que planeia usar.

    Se criar a configuração de publicação através da consola, também pode criar novos controlos durante o processo de criação.

    Pode mudar ou adicionar controlos de publicação à sua configuração de publicação depois de a criar.

Crie uma configuração de publicação

Pode criar uma configuração de publicação através do seguinte:

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

A pesquisa funciona com configurações de publicação não configuradas. Qualquer serving_config_id pode ser colocado como parte do pedido de pesquisa, e este default_search vai pesquisar o catálogo com a capacidade de pesquisa predefinida do Vertex AI Search para comércio.

Se tiver posicionamentos existentes ou criar novos posicionamentos, é criada automaticamente uma configuração de publicação associada a cada posicionamento. A criação de uma configuração de publicação não cria um posicionamento correspondente. A eliminação de uma configuração de publicação elimina o respetivo posicionamento correspondente e a eliminação de um posicionamento elimina a respetiva configuração de publicação correspondente.

Crie uma configuração de publicação na consola

Adicione uma nova configuração de publicação na página Configurações de publicação na consola de pesquisa para comércio.

Para criar uma nova configuração de publicação:

  1. Aceda à página Configurações de publicação na consola do Search for commerce.

    Aceda à página Configurações de publicação

  2. Clique em Criar configuração de publicação.

    Recomendações

    1. Selecione Recomendação como o produto para o qual a configuração de publicação vai ser usada.

    2. Indique um nome para a configuração de publicação.

      O nome tem de ter 1024 carateres ou menos e só pode conter carateres alfanuméricos, sublinhados, hífenes e espaços.

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

      O ID é gerado a partir do nome que indicar e tem de ser exclusivo no seu projeto. Tem de ter 50 carateres ou menos e não pode conter espaços.

    4. Escolha ou crie um modelo para o qual quer que esta configuração de publicação forneça recomendações.

      Saiba mais sobre a criação de novos modelos.

    5. Selecione o impacto que a reclassificação de preços deve ter nos resultados das recomendações, se estiver disponível para o modelo selecionado.

      A reclassificação de preços faz com que os produtos recomendados com uma probabilidade de recomendação semelhante sejam ordenados por preço, com os artigos de preço mais elevado primeiro. A relevância também é usada para ordenar os artigos, pelo que a reclassificação de preços não é o mesmo que ordenar por preço.

    6. Selecione se quer usar a diversificação de resultados baseada em regras ou orientada por dados:

      • Baseada em regras: a diversificação de resultados baseada em regras afeta se os resultados devolvidos de um único pedido de previsão são de diferentes categorias do seu catálogo de produtos.

      • Com orientação por dados: a diversificação de resultados com orientação por dados usa a aprendizagem automática para equilibrar a diversidade e a relevância das categorias nos resultados da previsão.

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

    7. Selecione o nível de diversificação dos resultados das recomendações.

    8. Se selecionou um modelo de itens semelhantes para esta configuração de publicação, selecione se quer ativar a correspondência de categorias.

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

    1. Na página Criar configuração de publicação, escolha Pesquisa como o produto para o qual a configuração de publicação vai ser usada.
    2. Indique um nome para a configuração de publicação.

      O nome tem de ter, no máximo, 1024 carateres e só pode conter carateres alfanuméricos, sublinhados, hífenes e espaços.
    3. Opcional: se necessário, atualize o ID.

      O ID é gerado a partir do nome que indicar e tem de ser exclusivo no seu projeto. Tem de ter 50 carateres ou menos e não pode conter espaços.
    4. Clique em Continuar.
    5. Escolha se quer ativar a segmentação dinâmica para esta configuração de publicação.
    6. Escolha ou crie controlos de publicação para otimizar as suas pesquisas.

      Para mais informações sobre os controlos, consulte o artigo Criar e gerir controlos.

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

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

    A configuração pode demorar alguns minutos a ficar disponível para utilização em pedidos de pesquisa. Está imediatamente disponível para recomendações.

  4. Opcional: na página Configurações de publicação, clique no nome de uma configuração de publicação e aceda ao separador Avaliar para pré-visualizar os produtos que seriam devolvidos para esta configuração.

    A pré-visualização da avaliação pode ajudar a confirmar que a sua configuração está a ter o desempenho esperado.

Crie uma configuração de publicação com ServingConfig.create

Pode criar uma configuração de publicação com o método ServingConfig.create API. Para consultar a documentação de referência da API para este método, consulte ServingConfig.create.

Os campos que usa dependem de estar a criar uma configuração de publicação para recomendações ou para pesquisa.

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

Recomendações

Faça um pedido ServingConfig.create com um ID de configuração de publicação e uma instância de ServingConfig contida no corpo do pedido.

  • servingConfigId: obrigatório. Cria um ID para o seu ServingConfig. Este valor deve ter entre 4 e 63 carateres. Os carateres válidos são /[a-z][0-9]-_/.
  • displayName: obrigatório. O nome ServingConfig legível apresentado na consola de pesquisa para comércio.
  • modelID: obrigatório. O ID do modelo a usar no momento da publicação.
  • priceRerankingLevel: opcional. Define o impacto da reclassificação de preços nos resultados das recomendações. Os valores permitidos são no-price-reranking (valor predefinido se não estiver definido), low-price-raranking, medium-price-reranking> e high-price-reranking.
  • diversityLevel: opcional. Define o grau de diversificação dos resultados das recomendações. Os valores permitidos são no-diversity (predefinição), low-diversity, medium-diversity, high-diversity e auto-diversity. Se o elemento diversityLevel não estiver definido, a diversidade é desativada.
  • diversityType: opcional. Definido como RULE_BASED_DIVERSITY para diversificar os resultados das recomendações com base na categoria do produto. Definido como DATA_DRIVEN_DIVERSITY para diversificar as recomendações com base na aprendizagem dos metadados dos produtos, de modo a equilibrar a relevância e a diversidade das categorias. Se diversityLevel estiver definido, mas diversityType não estiver definido, a predefinição de diversityType é baseada em regras. Para mais informações, consulte o artigo sobre a diversificação de resultados.
  • enableCategoryFilterLevel: opcional. Define se devem ser adicionados filtros de categoria adicionais no modelo de artigos semelhantes. Os valores permitidos são relaxed-category-match (valor predefinido se não estiver definido) e no-category-match.
  • solutionTypes: obrigatório. Definido como SOLUTION_TYPE_RECOMMENDATION para configurações de publicação de recomendações.
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"

Pesquisar

Faça um pedido ServingConfig.create com um ID de configuração de publicação e uma instância de ServingConfig contida no corpo do pedido.

  • servingConfigId: obrigatório. Cria um ID para o seu ServingConfig. Este valor deve ter entre 4 e 63 carateres. Os carateres válidos são /[a-z][0-9]-_/.
  • displayName: obrigatório. O nome ServingConfig legível apresentado na consola de pesquisa para comércio.
  • facetControlIds: opcional. IDs dos controlos que foram apenas FacetSpec definidos.
  • dynamicFacetSpec.mode: opcional. Modo da funcionalidade DynamicFacet. Os valores permitidos são DISABLED (predefinição se não estiver definido) e ENABLED.
  • boostControlIds: opcional. IDs dos controlos de publicação de aumentos.
  • filterControlIds: opcional. IDs dos controlos de publicação de filtros.
  • redirectControlIds: opcional. IDs dos controlos de publicação de redirecionamentos.
  • twowaySynonymsControlIds: opcional. IDs dos controlos de publicação de sinónimos bidirecionais.
  • onewaySynonymsControlIds: opcional. IDs dos controlos de publicação de sinónimos unidirecionais.
  • doNotAssociateControlIds: opcional. IDs dos controlos de publicação de não associação.
  • replacementControlIds: opcional. IDs dos controlos de publicação de substituição.
  • ignoreControlIds: opcional. IDs dos controlos de publicação ignorados.
  • solutionTypes: obrigatório. Definido como SOLUTION_TYPE_SEARCH para configurações de publicação de pesquisas.
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"

Passos seguintes