Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tangkap aktivitas pengunjung situs web dengan pelacak data web

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

Prasyarat

Langkah 1: Aktifkan pengumpulan data pada widget Komunikasi

Langkah 2: Sematkan widget dan inisialisasi pelacakan

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();

Langkah 3: (Opsional) Lacak acara khusus bisnis

Untuk menangkap acara bisnis khusus — seperti penyelesaian pembelian, tindakan penambahan ke keranjang, atau tampilan produk — hubungi recordBusinessMetric dari situs web Anda JavaScript saat acara terjadi.

Metode Tanda Tangan

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

Skema Objek

Men eventPayload dukung objek-objek berikut. Gunakan kombinasi bidang apa pun agar sesuai dengan kasus penggunaan Anda.

* Bidang wajib

Langkah-langkah Integrasi dan Contoh Penggunaan

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 yang Dipesan

Jenis peristiwa berikut dicadangkan dengan skema yang telah ditentukan sebelumnya:

Peristiwa Kustom

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

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

Mengaitkan clickstream dengan Profil Pelanggan

Data clickstream yang ditangkap oleh pelacak data web terus dialirkan ke Profil Pelanggan. Bagaimana data dikaitkan dengan profil tergantung pada apakah kunci profil disediakan selama inisialisasi widget.

Tautkan acara analisis web dengan profil yang ada

Untuk mengaitkan pelacakan dengan profil yang dikenal, atur profileKeys klaim JWT Anda untuk mencari dan mengaitkan dengan profil yang ada pada waktu koneksi, dan layanan menggunakan kunci ini untuk menemukan profil yang cocok melalui SearchProfiles API. Ini membutuhkan keamanan untuk diaktifkan pada widget Komunikasi Anda. Untuk detail penyiapan, lihatLangkah 3: Konfirmasikan dan salin kode widget komunikasi dan kunci keamanan.

{
  "sub": "<widgetId>",
  "iat": 1234567890,
  "exp": 1234571490,
  "profileKeys": {
    "_email": "user@example.com",
    "_account": "ACCT-12345"
  },
  "profileKeysOperator": "OR"
}

Mengelompokkan peristiwa dengan pengidentifikasi khusus

Jika Anda tidak perlu menautkan ke profil yang ada tetapi ingin mengelompokkan aktivitas clickstream sendiri, Anda dapat memberikan pengenal khusus. Peristiwa clickstream yang berbagi pengenal yang sama dikelompokkan di bawah kunci _webAnalyticsUserId profil umum.

Ada dua cara untuk menyediakannya:

Apa yang ditangkap

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

Privasi dan persetujuan

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