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 o varejo. No entanto, os varejistas que atendem várias marcas ou regiões de um único catálogo de produtos podem conseguir melhores resultados se usarem entidades.

Informações gerais

Configurar várias entidades no 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 de marcas diferentes que pertencem à empresa.

Exemplo de caso de uso: dois países

Um varejista, a organização de exemplo, tem presença na Web nos EUA e no 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 pesquisam o site da organização de exemplo para July, os compradores americanos recebem primeiro itens com tema de quatro de julho, e os compradores canadenses recebem itens com tema do Dia do Canadá.

Da mesma forma, é mais provável que as recomendações para compradores canadenses exibam itens do Dia do Canadá do que de quatro.

Exemplo de caso de uso: uma aquisição

A organização Enterprise Example adquiriu recentemente a organização Startup Example. 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 de usuários originados do site da startup. Isso permite que as sugestões de pesquisa, navegação, preenchimento automático e recomendação exibidas para o site de startups considerem as preferências dos compradores desse site.

Vários projetos ou várias entidades?

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

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 completo ou parcial compartilhado entre as entidades

  • Uma ou mais das seguintes opções:

    • 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, 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:

  • 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. Só é permitido um idioma por projeto.

Eventos e entidades de usuário

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

  • Para a pesquisa e o preenchimento automático: inclua o campo entity nos eventos de 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 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 de entidade retorne sugestões ideais.

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

Pesquisa e entidades

Para ver resultados de pesquisa ou navegação que levam em conta a entidade:

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

  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 ver resultados de preenchimento automático que consideram a entidade:

Recomendações e entidades

Depois de adicionar o campo entity aos eventos do usuário, nenhuma outra ação será 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 do método predict.