Entidades

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

Na maioria dos casos de uso, as entidades não são necessárias para a Vertex AI para Pesquisa para varejo. No entanto, os varejistas que atendem a 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 maneira de considerar os diferentes comportamentos e preferências dos compradores que estão em regiões ou países diferentes ou que compram em sites de marcas diferentes que pertencem à sua empresa.

Exemplo de caso de uso: dois países

Um varejista, a organização Example, está presente na Web dos EUA e do Canadá.

A organização de exemplo quer veicular resultados de navegação e pesquisa e sugestões de preenchimento automático que consideram as diferenças entre os compradores nos dois países. Assim, a organização de 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 pesquisarem July no site da organização de exemplo, os compradores dos EUA vão receber primeiro itens temáticos de quatro de julho, e os compradores canadenses vão receber itens temáticos para o Dia do Canadá.

Da mesma forma, as recomendações para compradores canadenses têm mais chances de mostrar itens do Dia do Canadá do que itens de quatro de julho.

Exemplo de caso de uso: uma aquisição

A organização de exemplo empresarial adquiriu recentemente a organização de exemplo de startup. Os catálogos foram combinados, mas a marca e o site da startup estão sendo mantidos porque têm seguidores leais.

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

Vários projetos ou várias entidades?

Ao configurar a Vertex AI para Pesquisa para o varejo, é possível usar projetos ou entidades diferentes no mesmo projeto para receber sugestões diferentes para 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 tiver:

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

  • Um ou mais dos seguintes itens:

    • Várias marcas no mesmo país ou idioma. Por exemplo, você tem sua 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 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 eventos do usuário.

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

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

  • Para recomendações:inclua o campo de entidade no maior número possível de tipos de evento do usuário.

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

Se faltar uma entidade em uma solicitação, a solicitação não faz suposição sobre a entidade no resultado. Você terá um resultado médio baseado em eventos de usuário com e sem a entidade especificada.

Pesquisa e entidades

Para acessar resultados de pesquisa ou navegação que consideram a entidade:

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

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

Preenchimento automático e entidades

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

Recomendações e entidades

Depois de adicionar o campo entity aos eventos de usuário, nenhuma outra ação é necessária 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.