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.
Antes de começar
As recomendações e as configurações de veiculação de pesquisa têm requisitos e opções diferentes:
As configurações de veiculação de recomendações exigem um modelo. Se você pretende anexar um modelo a uma nova configuração de veiculação, obtenha o ID do modelo que pretende usar (obrigatório ao usar o método
ServingConfig.create
).Se estiver criando a configuração de exibição usando o console, é possível criar um novo modelo durante o processo de criação, em vez de anexar um atual.
É possível mudar de modelo mais tarde, desde que o modelo 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 a uma nova configuração de veiculação, confira os IDs dos controles que 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 alternar ou adicionar controles de exibição à configuração de exibição depois de criá-la.
Criar uma configuração de veiculação
É possível criar uma configuração de veiculação usando:
São permitidas até 100 configurações de veiculação por catálogo.
Se você tiver posições ou criar novas, 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 exclui a posição correspondente, e a exclusão de uma posição remove a configuração de veiculação correspondente.
Crie 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 do Search for Retail.
Para criar uma configuração de veiculação:
Acesse a página Configurações de exibição no console da Pesquisa para varejo.
Acessar a página "Configurações de exibição"Clique em add_boxCriar configuração de veiculação.
Recomendações
Selecione Recomendação como o produto em que a configuração de exibição será usada.
Dê um nome à 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.
Opcional: atualize o ID, se necessário.
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.
Escolha ou crie um modelo para que a configuração de exibição forneça recomendações.
Saiba mais sobre como criar novos modelos.
Selecione o nível de impacto da reclassificação de preços nos 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.
Escolha se você quer usar a diversificação baseada em regras ou em dados:
Com base em regras:a diversificação com base em regras afeta se resultados retornados de uma única solicitação de previsão são diferentes categorias do seu catálogo de produtos.
Baseada em dados: a diversificação baseada em dados usa o aprendizado de máquina para equilibrar a diversidade e a relevância da categoria nos resultados de previsão.
Para mais informações, consulte Diversificação.
Selecione o valor para diversificar os resultados da recomendação.
Se você selecionou um modelo de itens semelhantes para essa configuração de veiculação, selecione ativar ou não a correspondência de categoria.
Quando a correspondência de categoria está ativada, os únicos resultados de produto 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 outros filtros como preço, disponibilidade e tags de filtro.
Pesquisar
- 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 ser 1.024 caracteres ou menos e pode conter apenas caracteres alfanuméricos, sublinhados, hifens e espaços. - Opcional: se necessário, atualize o ID.
Ele é gerado com base no nome fornecido e precisa ser único em seu projeto. Ele precisa ter até 50 caracteres e não pode conter espaços. - Clique em Continuar.
- Escolha se você quer ativar os atributos dinâmicos para essa configuração de exibição.
- Escolha ou crie controles de veiculaçã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 conferir 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 exibição com o método da API ServingConfig.create
. Para consultar a documentação de referência da API para esse método, consulte
ServingConfig.create
.
Os campos que você usa dependem se você está 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 veiculação e uma
instância de ServingConfig
contida no corpo da solicitação.
servingConfigId
: obrigatório. Cria um ID para oServingConfig
. Esse valor precisa ter de 4 a 63 caracteres. Os caracteres válidos são/[a-z][0-9]-_/
.displayName
: obrigatório. O nomeServingConfig
legível por humanos exibido no console da Pesquisa para varejo.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 precisa afetar os resultados da recomendação. Os valores permitidos sãono-price-reranking
(valor padrão se não definido),low-price-raranking
,medium-price-reranking
, ehigh-price-reranking
.diversityLevel
: opcional. Define o quanto as recomendações devem ser diversificadas resultados. Os valores permitidos sãono-diversity
(padrão),low-diversity
,medium-diversity
,high-diversity
eauto-diversity
. SediversityLevel
não estiver definido, a diversidade será desativada.diversityType
: opcional. Defina comoRULE_BASED_DIVERSITY
para diversificar recomendações com base na categoria dos produtos. Defina comoDATA_DRIVEN_DIVERSITY
para diversificar as recomendações com base no aprendizado dos metadados do produto para equilibrar a relevância e a diversidade da categoria. SediversityLevel
estiver definido, masdiversityType
não estiver,diversityType
vai ser definido como baseado em regras. Para mais informações, consulte Diversificação.enableCategoryFilterLevel
: opcional. Define se é necessário adicionar filtros de categoria no modelo Itens semelhantes. Os valores permitidos sãorelaxed-category-match
(padrão se não definido) eno-category-match
.solutionTypes
: obrigatório. Definir comoSOLUTION_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 veiculação e um
Instância de ServingConfig
contida no corpo da solicitação.
servingConfigId
: obrigatório. Cria um ID para oServingConfig
. Esse valor precisa ter de 4 a 63 caracteres. Os caracteres válidos são/[a-z][0-9]-_/
.displayName
: obrigatório. O nomeServingConfig
legível por humanos exibido no console da Pesquisa para varejo.facetControlIds
: opcional. IDs de controles que têm apenasFacetSpec
definido.dynamicFacetSpec.mode
: opcional. Modo do recursoDynamicFacet
. Os valores permitidos sãoDISABLED
(padrão, se não definido) eENABLED
.boostControlIds
: opcional. IDs dos controles de veiculação do boost.filterControlIds
: opcional. IDs dos controles de veiculação de filtros.redirectControlIds
: opcional. IDs dos controles de veiculação de redirecionamento.twowaySynonymsControlIds
: opcional. IDs dos controles de veiculação de sinônimos bidirecionais.onewaySynonymsControlIds
: opcional. IDs de veiculação de sinônimos unidirecionais controles de segurança.doNotAssociateControlIds
: opcional. IDs dos controles de veiculação de não associação.replacementControlIds
: opcional. IDs dos controles de veiculação substitutos.ignoreControlIds
: opcional. IDs dos controles de ignorar veiculação.solutionTypes
: obrigatório. Defina comoSOLUTION_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.