Implemente eventos do utilizador

Para configurar os seus eventos de utilizador:

1. Importe eventos de utilizadores históricos.

2. Registe eventos de utilizadores em direto.

3. Etiquete eventos do utilizador com entidades.

4. Marque eventos de utilizador com tokens de atribuição.

Informações do utilizador

O valor visitorId representa o identificador exclusivo do utilizador. É obrigatório quando regista um evento do utilizador. (UserInfo) é incluído quando regista um evento do utilizador que tem o valor visitorId e, se disponível, o valor userId.

Pode usar o valor userId opcional como um identificador exclusivo e persistente de um utilizador em vários dispositivos sempre que um utilizador inicia sessão no seu site. Quando regista o userId de um utilizador, a Vertex AI Search for commerce pode gerar resultados mais personalizados para um utilizador em vários dispositivos, como um dispositivo móvel e um navegador de Internet.

Nota: use uma forma segura de um identificador único para manter os utilizadores anónimos para a Vertex AI Search for commerce e proteger a privacidade dos seus utilizadores. É responsável por ocultar IIP (informações de identificação pessoal), como endereços de email ou de casa, dos seus dados.

Data/hora do evento do utilizador

Quando regista um evento do utilizador, certifique-se de que inclui uma indicação de tempo precisa de quando o evento ocorreu. As datas/horas precisas garantem que os eventos são armazenados pela ordem correta. As datas/horas são registadas automaticamente para eventos recolhidos através do Gestor de Etiquetas e do píxel JavaScript. Quando importa eventos, tem de indicar a data/hora no campo eventTime no formato especificado pela RFC 3339.

Atributos personalizados para eventos do utilizador

Pode incluir atributos e funcionalidades personalizados adicionais para eventos do utilizador. Isto pode resultar em recomendações melhoradas e mais específicas para os seus utilizadores quando usa recomendações. Para adicionar atributos personalizados, use attributes quando registar um evento do utilizador.

Se fornecer atributos personalizados para eventos de utilizadores carregados, é importante incluí-los também nos eventos de utilizadores que associa a pedidos de previsão. A formatação dos atributos personalizados tem de ser consistente entre os eventos importados e os eventos fornecidos com pedidos de previsão. Isto permite a utilização desses atributos personalizados ao preparar modelos e publicar previsões, o que ajuda a melhorar a qualidade das recomendações.

Pode fornecer valores de texto personalizados através do campo text ou valores numéricos personalizados através do campo number.

Por exemplo, o seguinte mostra a secção attributes de um pedido para registar um evento do utilizador:

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

Monitorize o estado da importação

A gravação bem-sucedida de eventos do utilizador é importante para obter resultados de alta qualidade. Deve monitorizar as taxas de erro de gravação de eventos e tomar medidas, se necessário. Para mais informações, consulte o artigo Configurar alertas para problemas de carregamento de dados.