Lewati ke konten utama

Pendahuluan

Catat apa yang dilakukan pengguna dan tamu Anda, dan ubah menjadi pengalaman yang dipersonalisasi.

Informasi lebih lanjut tentang antarmuka pengguna modul ini https://doc.oneentry.cloud/docs/category/useractivity

🎯 Apa yang dilakukan modul ini?​

Modul UserActivity memungkinkan Anda untuk melacak peristiwa aktivitas untuk pengguna atau tamu saat ini - tampilan produk, tampilan halaman, pencarian, tindakan keranjang dan daftar keinginan, pembelian, dan penilaian.

Peristiwa yang Anda kirim memberi umpan ke mesin rekomendasi OneEntry, yang mendukung blok personalisasi seperti rekomendasi pribadi, yang baru saja dilihat, pembelian ulang, dan trending.

🚀 Memulai dengan Cepat​

Inisialisasi modul dari defineOneEntry:


const { UserActivity } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

Catat peristiwa tampilan produk (bekerja untuk pengguna yang terotorisasi atau tamu):

// Track that the visitor opened a product page.
const ok = await UserActivity.trackUserActivity({
  type: "product_view",
  productId: 12345,
  meta: { sourceBlock: "catalog" },
});

console.log(ok); // true on success

trackUserActivity() mengambil satu objek body dan menyelesaikan menjadi true saat berhasil. Ini adalah fire-and-forget — jangan blok rendering di atasnya.

✨ Konsep Utama​

Bekerja untuk pengguna dan tamu​

Aktivitas terkait dengan konteks saat ini: pengguna yang terotorisasi (melalui modul AuthProvider) atau tamu. Untuk tamu, SDK mengirimkan header x-guest-id sehingga peristiwa dikaitkan dengan pengunjung anonim yang tepat. Lihat Mode tamu untuk detail.

Jenis peristiwa​

type peristiwa adalah salah satu dari sekumpulan nilai tetap: product_view, page_view, category_view, search, product_add_to_cart, product_remove_from_cart, product_add_to_wishlist, product_remove_from_wishlist, product_purchase, product_rating.

📋 Apa yang Perlu Anda Ketahui​

  • Kirim field yang sesuai dengan tindakan: sertakan productId untuk peristiwa produk, pageId untuk tampilan halaman/kategori, dan query untuk pencarian.
  • Field meta menerima data sembarang (blok sumber, varian A/B, kedalaman gulir) untuk analitik Anda sendiri.
  • trackUserActivity() menyelesaikan menjadi true saat berhasil - ini adalah fire-and-forget dan tidak boleh memblokir UI.

📊 Tabel Referensi Cepat​

MetodeDeskripsi
trackUserActivity()Catat peristiwa aktivitas pengguna atau tamu

❓ Pertanyaan Umum (FAQ)​

Apakah saya perlu mengotorisasi pengguna untuk melacak aktivitas?​

Tidak. Aktivitas dicatat untuk konteks saat ini - pengguna yang terotorisasi atau tamu. Di browser, SDK secara otomatis menghasilkan dan mempertahankan id tamu; di server, kirimkan guestId per pengunjung.

Apa fungsi field meta?​

meta adalah objek bebas untuk informasi tambahan yang ingin Anda lampirkan pada suatu peristiwa, seperti blok sumber, varian tes A/B, atau kedalaman gulir.

🎓 Praktik Terbaik​

  • Lacak peristiwa saat terjadi, tetapi jangan blok rendering pada panggilan jaringan.
  • Kirim productId / pageId / query yang sesuai dengan type peristiwa.
  • Pertahankan id tamu tetap stabil sehingga aktivitas tamu konsisten di seluruh permintaan.

🔗 Dokumentasi Terkait​