CAPI Sisih Server lan Pelacakan Prastawa

Liwati pamblokir iklan lan watesan ITP kanthi ngarahaken trafik MousePlayer mawi container GTM Sisih Server Pihak Kapisan panjenengan piyambak, lan lacak analitik E-commerce rinci.

1. Ringkesan Mode Pelacakan

MousePlayer V2 ngenalaken Event Router ingkang kiyat, ngidinaken panjenengan ngendhaleni alur data saking browser panganggo dhateng server kula. Panjenengan saged milih tigang mode:

  • Namung Web (Gawan): Ngaliraken sedaya data mawi WebSocket langsung dhateng MousePlayer. Paling saé kanggé Tampilan Langsung wekdal nyata, nanging rentan dhateng pamblokir iklan ingkang ketat.
  • Mode Hybrid: Kauntungan kekalih cara. Ngintun koordinat panuding/gulung ènthèng mawi WebSocket kanggé Tampilan Langsung lancar, déné mutasi DOM awrat lan Prastawa Khusus dipunklompokaken lan dipunarahaken kanthi aman mawi GTM Sisih Server panjenengan kanthi HTTP POST.
  • Pure CAPI: Panglompokan HTTP POST 100%. Privasi paling ageng, tanpa WebSocket, sedaya pihak kapisan. Cathetan: Tampilan Langsung dipunpateni ing mode punika.

2. Setelan Google Tag Manager (Dipunsaranaken)

Cara paling gampil ngetrapaken mode Hybrid utawi Pure CAPI punika migunakaken Cithakan Komunitas GTM resmi kula. Undhuh berkas .tpl ing ngandhap lan impor ing ruang kerja GTM panjenengan.

Undhuh Cithakan:

↓ Web GTM: Tag SDK MousePlayer

↓ Server GTM: Klien Panampi MousePlayer

↓ Server GTM: Tag Konektor MousePlayer

Langkah 1: Atur Klien lan Tag Sisih Server

Ing container GTM Sisih Server, impor cithakan Klien Panampi . Atur supados mirengaken path khusus (umpaminipun, /mp_capi). Lajeng impor Tag Konektor, atur supados lumampah ing prastawa mouseplayer_batch lan terbitaken container.

Langkah 2: Atur Tag Web GTM

Ing container Web GTM, impor Tag SDK. Pilih “Konfigurasi lan Inisialisasi” minangka Jinis Tag, lebetaken Channel ID, pilih Mode Hybrid lan tempel URL Endpoint ssGTM (umpaminipun, https://metrics.yourdomain.com/mp_capi).

3. Instalasi Manual (Tanpa GTM)

Menawi langkung remen masang skrip langsung, panjenengan kedah nemtokaken obyek window.mp_config sadèrèngipun muat cuplikan pelacakan.

<!-- 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. Pelacakan Funnel E-Commerce

Lacak alur pelanggan pepak. Jeneng prastawa standar ngidinaken MousePlayer otomatis damel laporan Funnel E-Commerce ingkang saé ing ruang kerja proyek. Sedaya prastawa cocog kaliyan mode CAPI lan Namung Web.

1. view_item

Picu prastawa punika nalika panganggo mirsani kaca produk tartamtu.

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

2. add_to_cart

Picu prastawa punika nalika panganggo nambah barang ing kranjang tumbas.

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

3. begin_checkout

Picu prastawa punika nalika panganggo lumajeng dhateng layar checkout.

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

4. purchase

Picu prastawa punika nalika pambayaran kasil utawi konfirmasi pesenan.

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

5. Prastawa Khusus lan Lead

Panjenengan boten winates ing e-commerce. Lacak pangiriman formulir, pendaftaran buletin utawi interaksi khusus aplikasi web panjenengan.

Lead (Pangiriman Formulir)

Picu prastawa punika nalika panganggo kasil ngintun formulir kontak utawi nyuwun penawaran.

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

Interaksi UI Khusus

Mangertos cara panganggo interaksi kaliyan unsur rumit kados kalkulator, modal utawi panggantos tab.

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

6. Wates Parameter lan Pandhuan

Jinis Data: MousePlayer otomatis ndeteksi jinis parameter. Kintun angka minangka wilangan bulat utawi pecahan (umpaminipun, 150.00, sanès "150.00") kanggé ngaktifaken panyaring angka majeng (umpaminipun, “Rega > 100”) ing dasbor.

Aturan Andharan
Dawane Jeneng Prastawa Paling kathah 128 karakter. Ginakaken snake_case supados gampil dipunwaos (umpaminipun, user_signup).
Dawane Kunci Parameter Paling kathah 64 karakter saben jeneng kunci (umpaminipun, transaction_id).
Nilai String Parameter teks dipunpotong ing 255 karakter kanggé njagi kinerja basis data paling saé.
Privasi Data Panjenengan boten pareng ngintun Katrangan Pengenal Pribadi (PII) kados alamat email mentah, jeneng asli utawi sandhi minangka parameter prastawa.