Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 veiculaçã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 depois de criá-la.

Criar uma configuração de exibição

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

O console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience.
A API ServingConfig.create.

São permitidas até 100 configurações de veiculaçã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 Pesquisa de comércio com IA.

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 da Pesquisa de comércio com IA no Gemini Enterprise para experiência do cliente.

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

Acesse a página Configurações de exibição no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience.

Acessar a página "Configurações de exibição"
Clique em Criar configuração de veiculação.
Recomendações
1. Selecione Recomendação como o produto que será usado na configuração de exibição.
2. Forneça um nome para a 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 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 categoria.
  
  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 em 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.
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.
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 conferir a documentação de referência da API para esse método, consulte 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.

Recomendações

Faça uma solicitação ServingConfig.create com um ID de configuração de exibição e uma instância de ServingConfig contida no corpo da solicitação.

servingConfigId: obrigatório. Cria um ID para seu 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 ServingConfig exibido no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience.
modelID: obrigatório. O ID do modelo a ser usado no momento da veiculação.
priceRerankingLevel: opcional. Define quanto a reclassificação de preços deve afetar os resultados da recomendação. Os valores permitidos são no-price-reranking (valor padrão se não for definido), low-price-raranking, medium-price-reranking e high-price-reranking.
diversityLevel: opcional. Define o valor para diversificar os resultados das recomendações. Os valores permitidos são no-diversity (padrão), low-diversity, medium-diversity, high-diversity e auto-diversity. Se diversityLevel não estiver definido, a diversidade será desativada.
diversityType: opcional. Defina como RULE_BASED_DIVERSITY para diversificar os resultados de recomendação com base na categoria do produto. Defina como DATA_DRIVEN_DIVERSITY para diversificar as recomendações com base no aprendizado de metadados de produtos para equilibrar a relevância e a diversidade de categorias. Se diversityLevel estiver definido, mas diversityType não, o padrão de diversityType será baseado em regras. Para mais informações, consulte diversificação de resultados.
enableCategoryFilterLevel: opcional. Define se é necessário adicionar outros filtros de categoria ao modelo de itens semelhantes. Os valores permitidos são relaxed-category-match (valor padrão se não estiver definido) e no-category-match.
solutionTypes: obrigatório. Definido como SOLUTION_TYPE_RECOMMENDATION para configurações de veiculaçã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 uma solicitação ServingConfig.create com um ID de configuração de exibição e uma instância de ServingConfig contida no corpo da solicitação.

servingConfigId: obrigatório. Cria um ID para seu 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 ServingConfig exibido no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience.
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 dos controles de veiculação de reforço.
filterControlIds: opcional. IDs dos controles de exibição de filtros.
redirectControlIds: opcional. IDs dos controles de veiculação de redirecionamento.
twowaySynonymsControlIds: opcional. IDs de controles de veiculação de sinônimos bidirecionais.
onewaySynonymsControlIds: opcional. IDs de controles de veiculação de sinônimos unidirecionais.
doNotAssociateControlIds: opcional. IDs de controles de veiculação de não associação.
replacementControlIds: opcional. IDs dos controles de exibição de substituição.
ignoreControlIds: opcional. IDs de controles de veiculação ignorados.
solutionTypes: obrigatório. Defina como SOLUTION_TYPE_SEARCH para configurações de veiculação de pesquisa.

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.

Criar configurações de veiculação Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Criar uma configuração de exibição

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

Recomendações

Pesquisar

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

Recomendações

Pesquisar

Próximas etapas

Criar configurações de veiculação

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