Entidades

Esta página apresenta as entidades, como e por que elas podem ser usadas.

Na maioria dos casos, as entidades não são necessárias para a Vertex AI Search for Retail. No entanto, varejistas que atendem várias marcas ou regiões de um único catálogo de produtos podem ter resultados melhores se usarem entidades.

Visão geral

Configurar várias entidades no projeto é uma forma de considerar comportamentos e preferências diferentes de compradores que estão em regiões ou países diferentes ou que fazem compras em sites de marcas diferentes que pertencem à empresa.

Exemplo de caso de uso: dois países

Uma varejista, a Organização Exemplo, tem presença na Web nos EUA e no Canadá.

A Organização de exemplo quer exibir resultados de navegação e pesquisa e sugestões de preenchimento automático que levem em conta as diferenças entre os compradores nos dois países. Assim, a organização Exemplo designa duas entidades: org_us e org_ca.

Os eventos do usuário são marcados com um valor de entidade, dependendo do site que o comprador visitou (.com ou ca). Quando um comprador faz uma solicitação de pesquisa, o valor da entidade é incluído na solicitação.

Os dois países têm feriados importantes, mas diferentes, em julho. Com as entidades configuradas, quando os compradores pesquisam July no site da Organização Exemplo, os compradores americanos recebem primeiro os itens temáticos do 4 de julho, e os compradores canadenses recebem itens temáticos do Dia do Canadá.

Da mesma forma, as recomendações para compradores canadenses têm mais chances de mostrar itens do Canada Day do que do Fourth of July.

Exemplo de caso de uso: uma aquisição

A Organização Exemplo de empresa adquiriu recentemente a Organização Exemplo de startup. Os catálogos foram combinados, mas a marca e o site da startup estão sendo mantidos porque têm seguidores fiéis.

A empresa cria uma entidade, startup, para marcar eventos do usuário originados do site da startup. Isso permite que as sugestões de pesquisa, navegação, preenchimento automático e recomendação veiculadas ao site da startup levem em consideração as preferências dos compradores do site da startup.

Vários projetos ou várias entidades?

Ao configurar a Vertex AI Search para varejo, é possível usar projetos ou entidades diferentes no mesmo projeto para receber sugestões diferentes para as diferentes populações de compradores.

Para alguns aplicativos, são necessários projetos separados. Para outros aplicativos, configurar entidades é a melhor solução.

Use entidades quando você tiver:

  • Um catálogo totalmente ou parcialmente compartilhado entre as entidades

  • Um ou mais dos seguintes:

    • Várias marcas no mesmo país ou área de idioma. Por exemplo, você tem a marca original e uma marca adquirida, google_home e nest.

    • Várias regiões no mesmo país, por exemplo, enterprise_east e enterprise_west.

    • Uma marca, mas em vários países com o mesmo idioma, por exemplo, brand_us e brand_ca.

Use projetos separados em vez de entidades quando você tiver:

  • Catálogos que não podem ser combinados ou catálogos que, se combinados, têm pouca ou nenhuma sobreposição.

  • Entidades que exigem idiomas diferentes. Apenas um idioma é permitido por projeto.

Eventos e entidades do usuário

Para aproveitar o recurso de entidades, adicione o campo de entidade aos seus eventos do usuário.

  • Para pesquisa e preenchimento automático:inclua o campo entity em eventos do usuário do tipo search.

    Incluir o campo de entidade em outros tipos de evento do usuário pode ser útil para solucionar problemas, mas não afeta a qualidade das respostas de pesquisa ou de preenchimento automático.

  • Para recomendações:inclua o campo de entidade em quantos tipos de evento de usuário for possível.

Normalmente, são necessários de 30 a 90 dias de dados de eventos do usuário para que o recurso de entidade retorne sugestões ideais.

Se uma entidade estiver ausente em uma solicitação, ela não fará suposições sobre a entidade no resultado. Você vai receber um resultado médio com base nos eventos do usuário com e sem a entidade especificada.

Pesquisa e entidades

Para receber resultados de pesquisa ou navegação que considerem a entidade:

  1. Inclua o campo entity nos eventos de usuário de pesquisa (eventType="search"). Para conferir um exemplo, consulte o exemplo completo de objeto para o evento de usuário Pesquisa.

  2. Adicione o campo entity à solicitação de pesquisa. Para saber como fazer solicitações de pesquisa, consulte Receber resultados da pesquisa.

Preenchimento automático e entidades

Para receber resultados de preenchimento automático que considerem a entidade:

Recomendações e entidades

Depois de adicionar o campo entity aos seus eventos de usuário, não é necessário fazer mais nada para aproveitar as entidades para recomendações. Isso ocorre porque o valor da entidade faz parte do evento do usuário, que, por sua vez, é incluído na chamada para o método predict.