Implementar eventos do usuário

Para configurar seus eventos do usuário:

  1. Importe eventos históricos do usuário.

  2. Grave eventos do usuário ao vivo.

  3. Marque eventos do usuário com entidades.

  4. Marque eventos do usuário com tokens de atribuição.

Informações do usuário

O valor visitorId representa o identificador exclusivo do usuário. Ele é obrigatório ao registrar um evento do usuário. (UserInfo) é incluído quando você registra um evento do usuário que tem o valor visitorId e, se disponível, o valor userId.

Você pode usar o valor opcional userId como um identificador exclusivo e persistente de um usuário em vários dispositivos sempre que ele fizer login no seu site. Quando você grava o userId de um usuário, a Vertex AI para Pesquisa para e-commerce pode gerar resultados mais personalizados para um usuário em vários dispositivos, como um dispositivo móvel e um navegador da Web.

Carimbo de data/hora do evento do usuário

Ao registrar um evento do usuário, inclua um carimbo de data/hora preciso de quando o evento ocorreu. Carimbos de data/hora precisos garantem que os eventos sejam armazenados na ordem correta. Os carimbos de data/hora são registrados automaticamente para eventos coletados usando o Gerenciador de tags e o JavaScript Pixel. Ao importar eventos, é necessário informar o carimbo de data/hora no campo eventTime no formato especificado pela RFC 3339.

Atributos personalizados para eventos do usuário

É possível incluir outros atributos e recursos personalizados para eventos do usuário. Isso pode resultar em recomendações melhores e mais específicas para seus usuários quando você usa recomendações. Para adicionar atributos personalizados, use attributes ao registrar um evento do usuário.

Se você fornecer atributos personalizados para eventos do usuário ingeridos, é importante incluí-los também nos eventos associados às solicitações de previsão. A formatação dos atributos personalizados precisa ser consistente entre os eventos importados e os eventos fornecidos com solicitações de previsão. Isso permite o uso desses atributos personalizados ao treinar modelos e veicular previsões, o que ajuda a melhorar a qualidade das recomendações.

Forneça valores de texto personalizados usando o campo text ou valores numéricos personalizados usando o campo number.

Por exemplo, a seguir é mostrada a seção attributes de uma solicitação para gravar um evento do usuário:

"attributes": {
  "user_age": {"text": ["teen", "young adult"]},
  "user_location": {"text": ["CA"]}
}

Monitorar a integridade da importação

É importante gravar eventos de usuários para ter resultados de alta qualidade. Monitore as taxas de erro de gravação de eventos e tome medidas se necessário. Para mais informações, consulte Como configurar alertas para problemas de upload de dados.