Entidades

Esta página apresenta as entidades, maneiras de capturar o comportamento variado do usuário dependendo de várias marcas ou produtos em um único site empresarial, além de 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 e-commerce. No entanto, varejistas que atendem várias marcas ou regiões com um único catálogo de produtos podem ter resultados melhores se usarem entidades.

Visão geral

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

Exemplo de caso de uso: dois países

Uma varejista, a Example Organization, tem presença na Web nos EUA e no Canadá.

A Example Organization quer veicular resultados de navegação e pesquisa e sugestões de preenchimento automático que considerem as diferenças entre os compradores dos 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 pesquisam July no site da Example Organization, os compradores americanos recebem primeiro itens com tema do Dia da Independência, e os canadenses recebem itens com tema do 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 do Quatro de Julho.

Exemplo de caso de uso: uma aquisição

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

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

Vários projetos ou várias entidades?

Ao configurar a Vertex AI Search para comércio, você pode usar projetos ou entidades diferentes no mesmo projeto para receber sugestões diferentes para seus diferentes públicos-alvo.

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

Use entidades quando você tiver:

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

  • Um ou mais dos seguintes casos:

    • Várias marcas no mesmo país ou área de 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 em vários países com o mesmo idioma, por exemplo, brand_us e brand_ca.

Use projetos separados em vez de entidades quando 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. Só é permitido um idioma 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 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 em tantos tipos de evento do usuário quanto 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 faltando em uma solicitação, ela não fará nenhuma proposição sobre a entidade no resultado. Você vai receber um resultado médio com base em 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 um exemplo, consulte o exemplo de objeto completo para o evento de usuário Pesquisar.

  2. Adicione o campo entity à sua solicitação de pesquisa. Para 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 do usuário, não é necessário fazer mais nada para aproveitar as entidades nas recomendações. Isso ocorre porque o valor da entidade faz parte do evento do usuário, que, por sua vez, é incluído na chamada do método predict.