Implementare gli eventi utente

Per configurare gli eventi utente:

  1. Importa gli eventi utente storici.

  2. Registra eventi utente in tempo reale.

  3. Tagga gli eventi utente con entità.

  4. Segnala gli eventi utente con i token di attribuzione.

Informazioni utente

Il valore visitorId rappresenta l'identificatore univoco dell'utente. È obbligatorio quando registri un evento utente. (UserInfo) viene incluso quando registri un evento utente con il valore visitorId e, se disponibile, il valore userId.

Puoi utilizzare il valore facoltativo userId come identificatore univoco e permanente di un utente su più dispositivi ogni volta che l'utente accede al tuo sito. Quando registri il userId per un utente, Vertex AI Search for Commerce può generare risultati più personalizzati per un utente su più dispositivi, ad esempio un dispositivo mobile e un browser web.

Timestamp evento utente

Quando registri un evento utente, assicurati di includere un timestamp preciso del momento in cui si è verificato. I timestamp accurati assicurano che gli eventi vengano archiviati nell'ordine corretto. I timestamp vengono registrati automaticamente per gli eventi raccolti utilizzando Tag Manager e il pixel JavaScript. Quando importi gli eventi, devi fornire il timestamp nel campo eventTime nel formato specificato da RFC 3339.

Attributi personalizzati per gli eventi utente

Puoi includere altri attributi e funzionalità personalizzati per gli eventi utente. Ciò può comportare consigli migliori e più specifici per i tuoi utenti quando li utilizzi. Per aggiungere attributi personalizzati, utilizza attributes quando registri un evento utente.

Se fornisci attributi personalizzati per gli eventi utente importati, è importante includerli anche negli eventi utente associati alle richieste di previsione. La formattazione degli attributi personalizzati deve essere coerente tra gli eventi importati e quelli forniti con le richieste di previsione. In questo modo, è possibile utilizzare questi attributi personalizzati durante l'addestramento dei modelli e la pubblicazione delle previsioni, il che contribuisce a migliorare la qualità dei consigli.

Puoi fornire valori di testo personalizzati utilizzando il campo text o valori numerici personalizzati utilizzando il campo number.

Ad esempio, di seguito è riportata la sezione attributes di una richiesta per registrare un evento utente:

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

Monitorare lo stato di integrità dell'importazione

La registrazione degli eventi utente è importante per ottenere risultati di alta qualità. Devi monitorare le percentuali di errore di registrazione degli eventi e intervenire se necessario. Per ulteriori informazioni, consulta Configurare gli avvisi per i problemi di caricamento dei dati.