Implementar eventos do usuário

Para configurar os eventos do usuário:

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

  2. Registre eventos do usuário em tempo real.

  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 de usuário único. Ele é obrigatório ao registrar um evento do usuário. (UserInfo) é incluído ao registrar um evento do usuário que tem o valor visitorId e, se disponível, o valor userId.

Você pode usar o valor userId opcional como um identificador exclusivo e persistente para um usuário em todos os dispositivos sempre que ele fizer login no seu site. Quando você registra o userId de um usuário, a Pesquisa do AI 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 eventTime campo 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, também é importante incluí-los nos eventos do usuário associados a solicitações de previsão. A formatação de atributos personalizados precisa ser consistente entre eventos importados e 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.

Você pode fornecer 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"]}
}

Como 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.