Tangkap aktivitas pengunjung situs web dengan pelacak data web

Prasyarat Langkah 1: Aktifkan pengumpulan data pada widget Komunikasi Langkah 2: Sematkan widget dan inisialisasi pelacakan Langkah 3: (Opsional) Lacak acara khusus bisnis Kaitkan clickstream dengan pengguna yang diautentikasi Apa yang ditangkap Privasi dan persetujuan

Pelacak data web menangkap bagaimana pengunjung berinteraksi dengan situs web Anda — item yang diklik, pencarian dilakukan, pengiriman formulir. Ini mengaitkan aktivitas itu dengan profil mereka di Profil Pelanggan. Pelacak adalah bagian dari widget Komunikasi dan dikontrol pada tingkat widget. Untuk gambaran umum tentang cara kerja pelacak data web dan notifikasi web, lihatPelacak data web dan pemberitahuan web.

Instans Connect Customer dengan widget Communications yang dikonfigurasi. Untuk informasi selengkapnya, lihat Tambahkan antarmuka pengguna obrolan ke situs web Anda yang dihosting oleh Connect Customer.
Profil Pelanggan diaktifkan pada instance. Untuk informasi selengkapnya, lihat Aktifkan Profil Pelanggan untuk instans Connect Customer.

Masuk ke situs web Connect Customer admin.
Di menu navigasi, pilih Saluran, lalu pilih widget Komunikasi.
Buat widget baru atau edit yang sudah ada. Untuk informasi selengkapnya, lihat Tambahkan antarmuka pengguna obrolan ke situs web Anda yang dihosting oleh Connect Customer.
Aktifkan pengumpulan data untuk mengaktifkan pelacakan clickstream.
(Opsional) Pengaturan pengumpulan data mencakup opsi untuk Pengumpulan Data Lanjutan. Aktifkan ini sehingga layanan secara otomatis mengumpulkan interaksi pengunjung dengan konten HTML, yang menghasilkan wawasan prediktif yang lebih kaya dan lebih akurat.
(Opsional) Aktifkan pemberitahuan Web jika Anda berencana untuk mengirim pemberitahuan proaktif dari widget ini. Untuk informasi selengkapnya, lihat Kirim notifikasi web dengan kampanye keluar Connect Customer.
Tambahkan domain situs web tempat widget akan disematkan ke daftar domain yang diizinkan.
Simpan widget dan salin kode cuplikan widget. Sematkan cuplikan ini di situs web Anda di langkah berikutnya.

Sematkan cuplikan widget di HTML situs web Anda. Setelah cuplikan dimuat, inisialisasi pelacak setelah Anda mendapatkan persetujuan pengunjung.


// Start tracking visitor behavior (after obtaining consent)
await window.amazon_connect.Web.ClickStream.init();

// (Optional) Enable web notifications for this visitor
await window.amazon_connect.Web.Notification.init();

penting

Inisialisasi pelacakan hanya setelah mendapatkan persetujuan pengunjung yang sesuai sesuai dengan kebijakan privasi Anda dan peraturan yang berlaku.

catatan

Untuk aplikasi satu halaman, sematkan cuplikan sekali di halaman tingkat atas. Untuk aplikasi multi-halaman, sematkan cuplikan pada setiap halaman tempat Anda ingin menangkap aktivitas.

Untuk menangkap acara bisnis khusus - seperti penyelesaian pembelian, tindakan add-to-cart, atau tampilan produk - hubungi recordBusinessMetric dari situs web Anda JavaScript saat peristiwa terjadi.

penting

Jika Anda berencana untuk menggunakan pelacak data dengan pemberi rekomendasi yang memerlukan Konteks Item seperti Find Similar Items danFrequently Paired Items, Anda harus menggunakan peristiwa khusus bisnis dan menyertakan bidangnya. item_id


await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)

Parameter	Jenis	Deskripsi
`eventType`	string	Nama acara bisnis — jenis yang dicadangkan atau string kustom apa pun.
`eventPayload`	object	Data peristiwa terstruktur menggunakan Skema Objek di bawah ini.

eventPayloadMendukung objek berikut. Gunakan kombinasi bidang apa pun agar sesuai dengan kasus penggunaan Anda.

Objek	Bidang Kunci	Deskripsi
item	`item_id`, `item_name`, `quantity`*, `category`, `price`, `currency`, `impression_type`, `impression_id`	Satu produk atau item
item_list	Daftar <item>	Array objek item (minimal 1)
gerobak	`cart_id`, `item_list`, `total_value`, `currency`	Keranjang belanja
memesan	`order_id`, `item_list`, `total_value`, `currency`, `payment_method`, `shipping_address`, `discount`	Pesanan yang sudah selesai
pencarian	`search_query`*, `total_matching_results`, `results_per_page`, `filter_expression`, `sort_criteria`	Tindakan pencarian
bentuk	`form_id`*, `form_name`, `form_length`, `validation_errors`, `fields_completed`	Interaksi bentuk
gulir	`depth_percentage`, `position_x`, `position_y`	Posisi gulir (setidaknya satu bidang diperlukan)
event_value	number	Nilai numerik yang mewakili pentingnya suatu peristiwa

* Bidang yang dibutuhkan

Setelah meneleponamazon_connect.Web.ClickStream.init(), tambahkan recordBusinessMetric() panggilan di event handler situs web Anda (misalnya, onclick).

Contoh - Tambahkan ke Keranjang


await amazon_connect.Web.ClickStream.recordBusinessMetric('add_to_cart', {
    item: {
        item_id: 'prod-123',
        item_name: 'Wireless Headphones',
        price: 49.99,
        quantity: 1,
        currency: 'USD'
    }
});

Contoh - Lihat Item


await amazon_connect.Web.ClickStream.recordBusinessMetric('view_items', {
    item_list: [
        {
            item_id: 'item_10',
            quantity: 1,
            item_name: 'Premium Wireless Headphones',
            category: 'Electronics',
            price: 89.99,
            currency: 'USD'
        }
    ]
});

Jenis acara berikut dicadangkan dengan skema yang telah ditentukan:

Tipe Acara	Objek yang Diperlukan	Deskripsi
`add_to_cart`	item	Melacak saat pengunjung menambahkan item ke keranjang mereka
`purchase`	memesan	Melacak pembelian yang sudah selesai
`view_items`	item_list	Melacak saat pengunjung melihat satu atau beberapa item

Di luar jenis acara yang dicadangkan, Anda dapat menentukan string jenis acara khusus apa pun (misalnya, clear_cart atauwishlist_add). Untuk acara khusus:

Layanan tidak memberlakukan validasi ketat pada struktur acara.
Anda dapat menggunakan kombinasi bidang apa pun dari Skema Objek di atas agar sesuai dengan kasus penggunaan Anda.
Gunakan nama bidang persis seperti yang ditunjukkan (misalnya,cart_id, tidakcartId).


await amazon_connect.Web.ClickStream.recordBusinessMetric('clear_cart', {
    cart_id: 'cart-123',
    item_list: [
        { item_id: 'p1', item_name: 'Widget', quantity: 1 }
    ]
});

Data Clickstream yang ditangkap oleh pelacak data web terus dialirkan ke Profil Pelanggan dan terkait dengan profil pengunjung. Tabel berikut menjelaskan bagaimana asosiasi itu berperilaku untuk pengunjung anonim dan otentikasi.

Tipe pengunjung	Perilaku asosiasi profil
Pengunjung anonim	Dilacak oleh pengenal sesi saja. Data perilaku ditangkap tetapi tidak terkait dengan identitas pelanggan yang diketahui. Tidak ada informasi identitas pribadi yang dikumpulkan.
Pengunjung yang diautentikasi	Saat Anda meneruskan ID pengguna yang diautentikasi selama inisialisasi widget, layanan akan menautkan semua aktivitas clickstream ke profil yang diketahui pengguna tersebut di Profil Pelanggan. Ini memungkinkan personalisasi yang lebih kaya dan kondisi pemicu yang lebih akurat.

Untuk mengaitkan pelacakan dengan pengguna yang diautentikasi, gunakan salah satu pendekatan berikut:

(Disarankan) Gunakan klaim CustomerId JWT — Jika Anda mengaktifkan keamanan pada widget Komunikasi Anda, sertakan ID pengguna yang diautentikasi di CustomerId bidang klaim Token Web JSON (JWT) Anda. Ini menautkan aktivitas clickstream ke profil pengguna tanpa mengekspos ID dalam kode sisi klien. Untuk detail penyiapan, lihatLangkah 3: Konfirmasikan dan salin kode widget komunikasi dan kunci keamanan.
Lulus ID pengguna selama inisialisasi — Jika keamanan tidak diaktifkan pada widget Anda, berikan ID pengguna yang diautentikasi sebagai argumen saat menginisialisasi pelacak:
```
await window.amazon_connect.Web.ClickStream.init('<authenticated-user-id>');
```

penting

Jika ID pengguna yang diautentikasi diteruskan, itu akan menautkan ke profil yang ada melalui kunci akun. Karena peristiwa pelacak data terakumulasi dari waktu ke waktu, tetapkan batas objek _webAnalytics untuk WebAnalytics-Clickstream dan untuk mencegah peristiwa baru menimpa jenis objek lain setelah batas objek profil tercapai. Untuk panduan konfigurasi, lihat batas data Profil Pelanggan.

Untuk daftar lengkap aktivitas yang ditangkap pelacak secara default, lihat. Apa yang ditangkap oleh pelacak data web

Pelacak data web adalah opt-in berdasarkan desain. Jika Anda tidak mengaktifkan pengumpulan Data pada widget Komunikasi, tidak ada data clickstream yang ditangkap. Nilai bidang formulir, kata sandi, dan informasi pembayaran tidak pernah dikumpulkan secara otomatis, bahkan ketika peristiwa pengiriman formulir dilacak.

penting

Anda bertanggung jawab untuk mendapatkan persetujuan pengunjung yang sesuai sebelum menginisialisasi pelacakan data, sesuai dengan kebijakan privasi Anda dan peraturan yang berlaku seperti Peraturan Perlindungan Data Umum (GDPR) dan Undang-Undang Privasi Konsumen California (CCPA).

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Post-chat survei

Integrasikan obrolan ke dalam aplikasi seluler

Tangkap aktivitas pengunjung situs web dengan pelacak data web

Prasyarat

Langkah 1: Aktifkan pengumpulan data pada widget Komunikasi

Langkah 2: Sematkan widget dan inisialisasi pelacakan

penting

catatan

Langkah 3: (Opsional) Lacak acara khusus bisnis

penting

Metode Tanda Tangan

Skema Objek

Langkah Integrasi dan Contoh Penggunaan

Jenis Acara Cadangan

Peristiwa Kustom

Kaitkan clickstream dengan pengguna yang diautentikasi

penting

Apa yang ditangkap

Privasi dan persetujuan

penting