Entidades

Esta página apresenta as entidades, formas de captar o comportamento variado dos utilizadores, consoante várias marcas ou produtos num único site empresarial, bem como como e por que motivo podem ser usadas.

Para a maioria dos exemplos de utilização, não são necessárias entidades para o Vertex AI Search para comércio. No entanto, os retalhistas que publicam várias marcas ou regiões a partir de um único catálogo de produtos podem obter melhores resultados se usarem entidades.

Vista geral

A configuração de várias entidades no seu projeto é uma forma de ter em consideração diferentes comportamentos e preferências dos compradores que se encontram em diferentes regiões ou países, ou que compram em sites com marcas diferentes pertencentes à sua empresa.

Exemplo de utilização: dois países

Um retalhista, a organização de exemplo, tem uma presença na Web nos EUA e no Canadá.

A organização de exemplo quer publicar resultados de navegação e pesquisa, bem como sugestões de preenchimento automático, que tenham em conta 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 de utilizador são etiquetados com um valor de entidade, consoante o Website que o comprador visitou (.com ou ca). Quando um comprador faz um pedido de pesquisa, o valor de entidade é incluído no pedido.

Os dois países têm feriados importantes, mas diferentes, em julho. Com as entidades configuradas, quando os compradores pesquisam o site da organização de exemplo para July, os compradores americanos recebem primeiro artigos com o tema do Dia da Independência e os compradores canadianos recebem artigos com o tema do Dia do Canadá.

Da mesma forma, é mais provável que as recomendações para compradores canadianos mostrem artigos do Dia do Canadá do que artigos do Dia da Independência.

Exemplo de utilização: uma aquisição

A organização empresarial de exemplo adquiriu recentemente a organização de exemplo de startup. Os catálogos foram combinados, mas a marca e o Website da startup vão ser mantidos porque têm um público fiel.

A empresa cria uma entidade, startup, para etiquetar eventos do utilizador originários do site da startup. Isto permite que as sugestões de pesquisa, navegação, preenchimento automático e recomendações apresentadas no site de arranque tenham em conta as preferências dos compradores do site de arranque.

Vários projetos ou várias entidades?

Quando configura a Vertex AI Search for commerce, pode usar diferentes projetos ou diferentes entidades no mesmo projeto para receber sugestões diferentes para as suas diferentes populações de compradores.

Para algumas aplicações, são necessários projetos separados. Para outras aplicações, a configuração de entidades é a melhor solução.

Use entidades quando tiver:

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

  • Uma ou mais das seguintes opções:

    • Várias marcas no mesmo país ou área de idioma, por exemplo, tem a 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 tiver:

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

  • Entidades que requerem idiomas diferentes. Só é permitido um idioma por projeto.

Eventos e entidades do utilizador

Para tirar partido da funcionalidade de entidades, adicione o campo de entidade aos seus eventos de utilizador.

  • Para a pesquisa e o preenchimento automático: inclua o campo entity nos eventos do utilizador do tipo search.

    A inclusão do campo de entidade noutros tipos de eventos do utilizador pode ser útil para a resolução de problemas, mas não afeta a qualidade das respostas de pesquisa ou de preenchimento automático.

  • Para recomendações: inclua o campo da entidade no maior número possível de tipos de eventos do utilizador.

Normalmente, são necessários 30 a 90 dias de dados de eventos do utilizador antes de a funcionalidade de entidade devolver sugestões ideais.

Se uma entidade estiver em falta num pedido, o pedido não faz qualquer suposição sobre a entidade no resultado. Vai receber um resultado médio com base nos eventos do utilizador com e sem a entidade especificada.

Pesquisa e entidades

Para obter resultados da pesquisa ou da navegação que tenham em conta a entidade:

  1. Inclua o campo entity nos seus eventos de utilizador de pesquisa (eventType="search"). Para ver um exemplo, consulte o exemplo de objeto completo para o evento de utilizador Search.

  2. Adicione o campo entity ao seu pedido de pesquisa. Para informações sobre como fazer pedidos de pesquisa, consulte o artigo Obtenha resultados da pesquisa.

Preenchimento automático e entidades

Para obter resultados do preenchimento automático que tenham em conta a entidade:

Recomendações e entidades

Depois de adicionar o campo entity aos eventos de utilizador, não é necessária nenhuma ação adicional para tirar partido das entidades para recomendações. Isto deve-se ao facto de o valor da entidade fazer parte do evento do utilizador que, por sua vez, está incluído na chamada ao método predict.