CAPI fuq is-server & traċċar tal-avvenimenti

Għelbu adblockers u ITP bi traffiku mill-container GTM tal-ewwel parti fuq is-server tagħkom u analiżi kummerċjali profonda.

1. Modalitajiet tat-traċċar

MousePlayer V2 jintroduċi Event Router biex tikkontrollaw il-fluss mill-browser għas-servers. Tliet modi:

  • Web biss (standard): Data kollha WebSockets direttament. L-aħjar għal veduta diretta, iżda vulnerabbli għal adblockers qawwija.
  • Ibridu: Koordinati ħfief maws/skrolljar WebSockets għal veduta lixxa; DOM kbir u Custom Events f’batches HTTP POST mill-GTM server sigur.
  • Pure CAPI: 100% batching HTTP POST. Privatezza massima, ebda WebSockets, kollox tal-ewwel parti. Nota: veduta diretta mitfija hawn.

2. Google Tag Manager (rakkomandat)

Community Templates uffiċjali l-eħfef għal Hybrid jew Pure CAPI. Niżżlu l-fajls .tpl u importawhom fil-workspaces GTM.

Niżżlu t-templates:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

Pass 1: client & tag fuq is-server

Importaw it-template Ingest Client fis-server GTM. Smigħ fuq path personalizzat (eż., /mp_capi). Importaw ukoll Connector Tag, għal avveniment mouseplayer_batch , u ppubblikaw il-container.

Pass 2: Web GTM tag

Importaw SDK Tag. Agħżlu "Konfigurazzjoni & Inizjalizzazzjoni" bħala tip, daħħlu Channel ID, agħżlu Modalità ibrida, u endpoint ssGTM (eż., https://metrics.yourdomain.com/mp_capi).

3. Manwali (bla GTM)

Qabel it-tagħbija tal-snippet iddefinixxu l-oġġett window.mp_config .

<!-- 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. Lembut tal-kummerċ elettroniku

Segwu l-vjaġġ sħiħ. Ismijiet standard joħolqu rapporti tal-lembut awtomatiċi fil-workspace. Avvenimenti kollha kompatibbli ma’ CAPI u Web-Only.

1. view_item

Meta utent jara prodott speċifiku.

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

2. add_to_cart

Meta jżid oġġett mal-basket.

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

3. begin_checkout

Meta jmur fiċ-checkout.

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

4. purchase

Fuq ħlas jew konferma tal-ordni b’suċċess.

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

5. Avvenimenti personalizzati & leads

Mhux biss kummerċ: formoli, newsletters jew interazzjonijiet uniċi tal-app.

Leads (formola mibgħuta)

Fuq formola ta’ kuntatt jew talba ta’ kwotazzjoni b’suċċess.

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

Interazzjoni UI personalizzata

Fhmu kalkulaturi, modals u tibdil tat-tabs kumplessi.

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

6. Limiti & gwida

Tipi tad-data: Tipi jinstabu waħedhom. Numri bħala integers jew floats (eż., 150.00, mhux "150.00") għal filtri numeriċi avvanzati (eż. "Prezz > 100").

Regola Deskrizzjoni
Tul tal-isem Sa 128 karattru. snake_case l-aktar leġġibbli (eż., user_signup).
Tul taċ-ċavetta Sa 64 karattru kull isem (eż., transaction_id).
Valuri strings Test maqtugħ għal 255 karattru għal prestazzjoni ottimali tad-database.
Privatezza Tibagħtux PII bħal emails mhux ipproċessati, ismijiet veri jew passwords bħala parametri.