Menerapkan peristiwa pengguna

Untuk mengonfigurasi peristiwa pengguna:

  1. Mengimpor peristiwa pengguna historis.

  2. Merekam peristiwa pengguna live.

  3. Beri tag pada peristiwa pengguna dengan entity.

  4. Tandai peristiwa pengguna dengan token atribusi.

Informasi pengguna

Nilai visitorId mewakili ID pengguna unik. Ini diperlukan saat Anda merekam peristiwa pengguna. (UserInfo) disertakan saat Anda mencatat peristiwa pengguna yang memiliki nilai visitorId dan, jika tersedia, nilai userId.

Anda dapat menggunakan nilai userId opsional sebagai ID unik dan persisten untuk pengguna di seluruh perangkat setiap kali pengguna login ke situs Anda. Saat Anda merekam userId untuk pengguna, Vertex AI Search untuk Commerce dapat menghasilkan hasil yang lebih dipersonalisasi untuk satu pengguna di beberapa perangkat, seperti perangkat seluler dan browser web.

Stempel waktu peristiwa pengguna

Saat Anda merekam peristiwa pengguna, pastikan untuk menyertakan stempel waktu yang akurat saat peristiwa terjadi. Stempel waktu yang akurat memastikan peristiwa disimpan dalam urutan yang benar. Stempel waktu dicatat secara otomatis untuk peristiwa yang dikumpulkan menggunakan Tag Manager dan Piksel JavaScript. Saat mengimpor peristiwa, Anda harus memberikan stempel waktu di kolom eventTime dalam format yang ditentukan oleh RFC 3339.

Atribut kustom untuk peristiwa pengguna

Anda dapat menyertakan atribut dan fitur kustom tambahan untuk peristiwa pengguna. Hal ini dapat menghasilkan rekomendasi yang lebih baik dan lebih spesifik bagi pengguna saat Anda menggunakan rekomendasi. Untuk menambahkan atribut kustom, gunakan attributes saat Anda mencatat peristiwa pengguna.

Jika Anda memberikan atribut kustom untuk peristiwa pengguna yang diserap, sebaiknya sertakan juga atribut tersebut dalam peristiwa pengguna yang Anda kaitkan dengan permintaan prediksi. Format atribut kustom harus konsisten antara peristiwa yang diimpor dan peristiwa yang disediakan dengan permintaan prediksi. Hal ini memungkinkan penggunaan atribut kustom tersebut saat melatih model dan menayangkan prediksi, yang membantu meningkatkan kualitas rekomendasi.

Anda dapat memberikan nilai teks kustom menggunakan kolom text, atau nilai numerik kustom menggunakan kolom number.

Misalnya, berikut ini menunjukkan bagian attributes dari permintaan untuk mencatat peristiwa pengguna:

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

Memantau kondisi impor

Merekam peristiwa pengguna dengan sukses penting untuk mendapatkan hasil berkualitas tinggi. Anda harus memantau tingkat error perekaman peristiwa dan mengambil tindakan jika diperlukan. Untuk informasi selengkapnya, lihat Menyiapkan pemberitahuan untuk masalah upload data.