CAPI bahagian pelayan & Penjejakan Peristiwa

Atasi penyekat iklan dan sekatan ITP dengan menghalakan trafik MousePlayer melalui bekas GTM bahagian pelayan pihak pertama anda sendiri, dan jejaki analitik e-dagang mendalam.

1. Gambaran keseluruhan mod penjejakan

MousePlayer V2 memperkenalkan Penghala Peristiwa berkuasa yang membolehkan anda mengawal aliran data daripada pelayar pengguna ke pelayan kami. Anda boleh memilih daripada tiga mod berbeza:

  • Web sahaja (Lalai): Menstrim semua data melalui WebSocket terus ke MousePlayer. Terbaik untuk paparan langsung masa sebenar, tetapi terdedah kepada penyekat iklan yang ketat.
  • Mod Hibrid: Gabungan kelebihan kedua-duanya. Menghantar koordinat tetikus/tatalan ringan melalui WebSocket untuk paparan langsung lancar, manakala mutasi DOM besar dan peristiwa tersuai dikelompokkan dan dihalakan dengan selamat melalui GTM bahagian pelayan anda menggunakan HTTP POST.
  • CAPI sahaja: Pengelompokan HTTP POST 100%. Privasi maksimum, tanpa WebSocket, sepenuhnya pihak pertama. Nota: paparan langsung dinyahaktifkan dalam mod ini.

2. Persediaan Google Tag Manager (Disyorkan)

Cara termudah melaksanakan mod Hibrid atau CAPI sahaja ialah menggunakan Templat Komuniti GTM rasmi kami. Muat turun fail .tpl di bawah dan import ke ruang kerja GTM anda.

Muat turun templat:

↓ Web GTM: Tag SDK MousePlayer

↓ Server GTM: Klien Penerima MousePlayer

↓ Server GTM: Tag Penyambung MousePlayer

Langkah 1: konfigurasikan klien & tag bahagian pelayan

Dalam bekas GTM bahagian pelayan anda, import templat Ingest Client . Tetapkannya untuk mendengar pada laluan tersuai (cth. /mp_capi). Kemudian import Connector Tag, konfigurasikannya supaya dicetuskan pada peristiwa mouseplayer_batch , dan lancarkan bekas anda.

Langkah 2: konfigurasikan tag Web GTM

Dalam bekas Web GTM anda, import SDK Tag. Pilih “Configuration & Initialization” sebagai Jenis Tag, masukkan Channel IDanda, pilih Mod Hibrid, dan tampal URL titik akhir ssGTM anda (cth. https://metrics.yourdomain.com/mp_capi).

3. Pemasangan manual (Tanpa GTM)

Jika anda lebih suka menetapkan skrip terus dalam kod, anda mesti mentakrifkan objek window.mp_config sebelum memuatkan cebisan kod penjejakan.

<!-- MousePlayer Config & SDK --> <script> window.mp_config = { channel: 'YOUR_UNIQUE_ID_HERE', mode: 'hybrid', // 'web_only', 'hybrid', or 'pure_capi' capi_endpoint: 'https://metrics.yourdomain.com/mp_capi' }; window.mp = window.mp || function() { (window.mp.q = window.mp.q || []).push(arguments); }; (function(w, d, s) { var f = d.getElementsByTagName(s)[0], j = d.createElement(s); j.async = true; j.src = 'https://www.mouseplayer.com/mp.js'; f.parentNode.insertBefore(j, f); })(window, document, 'script'); </script>

4. Penjejakan corong e-dagang

Jejak seluruh perjalanan pelanggan. Nama peristiwa standard membolehkan MousePlayer menjana laporan Corong E-dagang yang menarik secara automatik dalam ruang kerja projek anda. Semua peristiwa serasi sepenuhnya dengan mod CAPI dan Web sahaja.

1. view_item

Cetuskan peristiwa ini apabila pengguna melihat halaman produk tertentu.

mp('event', 'view_item', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', item_category: 'Electronics', price: 299.99 });

2. add_to_cart

Cetuskan peristiwa ini apabila pengguna menambahkan item ke troli beli-belah.

mp('event', 'add_to_cart', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', price: 299.99, quantity: 1 });

3. begin_checkout

Cetuskan peristiwa ini apabila pengguna meneruskan ke skrin pembayaran.

mp('event', 'begin_checkout', { cart_value: 299.99, currency: 'USD', total_items: 1 });

4. purchase

Cetuskan peristiwa ini apabila bayaran berjaya atau pesanan disahkan.

mp('event', 'purchase', { transaction_id: 'T_1002938', value: 299.99, tax: 24.00, shipping: 0.00, currency: 'USD', coupon_used: 'FREESHIP' });

5. Peristiwa tersuai & penjanaan prospek

Anda tidak terhad kepada e-dagang. Jejak penghantaran borang, pendaftaran surat berita atau interaksi tersuai yang unik kepada aplikasi web anda.

Penjanaan prospek (Penghantaran borang)

Cetuskan peristiwa ini apabila pengguna berjaya menghantar borang hubungan atau meminta sebut harga.

mp('event', 'generate_lead', { form_name: 'B2B Contact Form', industry: 'Software Development', company_size: '50-200' });

Interaksi UI tersuai

Fahami cara pengguna berinteraksi dengan elemen kompleks seperti kalkulator, modal atau penukar tab.

mp('event', 'calculator_used', { loan_amount: 50000, duration_months: 48, interest_rate: 7.5 });

6. Had parameter & panduan

Penaipan data: MousePlayer mengesan jenis parameter secara automatik. Hantar nombor sebagai integer atau apungan (cth. 150.00, bukan "150.00") untuk membolehkan penapisan angka lanjutan (cth. “Harga > 100”) dalam papan pemuka.

Peraturan Huraian
Panjang nama peristiwa Maksimum 128 aksara. Gunakan snake_case untuk kebolehbacaan terbaik (cth. user_signup).
Panjang kunci parameter Maksimum 64 aksara setiap nama kunci (cth. transaction_id).
Nilai rentetan Parameter teks dipotong kepada 255 aksara untuk memastikan prestasi pangkalan data optimum.
Privasi data Jangan hantar Maklumat Pengenalpastian Peribadi (PII) seperti alamat e-mel mentah, nama sebenar atau kata laluan sebagai parameter peristiwa.