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 em tempo real.

  3. Marque eventos do usuário com entidades.

  4. Sinalizar 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 é necessário para gravar um evento de usuário. (UserInfo) é incluído quando você registra um evento de usuário com o valor visitorId e, se disponível, o valor userId.

Você pode usar o valor opcional userId como um identificador exclusivo e permanente de um usuário em vários dispositivos sempre que um usuário fizer login no site. Quando você grava o userId de um usuário, a Vertex AI para Pesquisa de comércio pode gerar resultados mais personalizados para um usuário em vários dispositivos, como dispositivos móveis 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 pixel do JavaScript. 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ê usar 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, também é importante incluí-los nos eventos do usuário associados a 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 exibir 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.