CAPI sa Server at Pagsubaybay ng Event

Lampasan ang mga ad blocker at limitasyon ng ITP sa pagruta ng trapiko ng MousePlayer sa sarili ninyong First-Party Server-Side GTM container, at subaybayan ang detalyadong analytics ng e-commerce.

1. Mga Mode ng Pagsubaybay

Nagpapakilala ang MousePlayer V2 ng makapangyarihang Event Router na nagbibigay sa inyo ng kontrol sa daloy ng datos mula sa browser ng user patungo sa aming mga server. May tatlong mode na mapagpipilian:

  • Web Only (Default): Direktang ipinapadala ang lahat ng datos sa MousePlayer gamit ang mga WebSocket. Pinakamainam para sa real-time na Live View, ngunit maaaring harangin ng malalakas na ad blocker.
  • Hybrid Mode: Pinagsasama ang mga pakinabang ng dalawa. Ipinapadala ang magaang coordinate ng mouse/scroll sa WebSocket para sa maayos na Live View, habang pinagsasama at ligtas na ipinapasa sa inyong Server-Side GTM sa HTTP POST ang mabibigat na pagbabago ng DOM at mga Custom Event.
  • Pure CAPI: 100% HTTP POST batching. Pinakamataas na privacy, walang WebSocket, ganap na first-party. Paalala: hindi pinagana ang Live View sa mode na ito.

2. Pag-set Up ng Google Tag Manager (Inirerekomenda)

Pinakamadaling gamitin ang aming mga opisyal na GTM Community Template para sa Hybrid o Pure CAPI mode. I-download ang mga file na .tpl sa ibaba at i-import sa inyong mga workspace ng GTM.

I-download ang mga Template:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

Hakbang 1: I-configure ang Client & Tag sa Server

Sa inyong Server-Side GTM container, i-import ang template na Ingest Client. Itakdang makinig sa custom na path (hal., /mp_capi). Pagkatapos, i-import ang Connector Tag, itakdang gumana sa event na mouseplayer_batch, at i-deploy ang container.

Hakbang 2: I-configure ang Tag ng Web GTM

Sa inyong Web GTM container, i-import ang SDK Tag. Piliin ang “Configuration at Pagsisimula” bilang Uri ng Tag, ilagay ang inyong Channel ID, piliin ang Hybrid Mode, at idikit ang inyong ssGTM Endpoint URL (hal., https://metrics.yourdomain.com/mp_capi).

3. Manu-manong Pag-install (Walang GTM)

Kung ilalagay ninyo sa code ang script, kailangang tukuyin ang object na window.mp_config bago i-load ang tracking snippet.

<!-- 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. Pagsubaybay sa Funnel ng E-commerce

Subaybayan ang buong paglalakbay ng customer. Dahil sa mga pamantayang pangalan ng event, awtomatikong nabubuo ng MousePlayer ang magagandang ulat ng E-Commerce Funnel sa workspace ng project. Ganap na katugma ang lahat ng event sa CAPI at Web-Only mode.

1. view_item

I-trigger ito kapag tiningnan ng user ang partikular na pahina ng produkto.

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

2. add_to_cart

I-trigger ito kapag nagdagdag ng item sa cart ang user.

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

3. begin_checkout

I-trigger ito kapag nagpatuloy ang user sa screen ng checkout.

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

4. purchase

I-trigger ito pagkatapos ng matagumpay na pagbabayad o kumpirmasyon ng order.

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

5. Mga Custom Event at Lead Generation

Hindi lamang e-commerce ang masusubaybayan. Subaybayan ang mga pagpapasa ng form, pagsali sa newsletter o custom na interaction na natatangi sa inyong web application.

Lead Generation (Pagpasa ng Form)

I-trigger ito kapag matagumpay na nagpasa ang user ng contact form o humiling ng quotation.

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

Custom na Interaction sa UI

Unawain kung paano ginagamit ng mga user ang masalimuot na elemento gaya ng calculator, modal o pagpapalit ng tab.

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

6. Mga Limitasyon at Gabay sa Parameter

Uri ng Datos: Awtomatikong tinutukoy ng MousePlayer ang uri ng parameter. Ipadala ang mga numero bilang integer o float (hal., 150.00, hindi "150.00") upang magamit ang detalyadong numerong filter (hal., “Presyo > 100”) sa dashboard.

Tuntunin Paglalarawan
Haba ng Pangalan ng Event Hanggang 128 character. Gamitin ang snake_case upang madaling basahin (hal., user_signup).
Haba ng Key ng Parameter Hanggang 64 character sa bawat pangalan ng key (hal., transaction_id).
Mga String na Value Pinuputol sa 255 character ang mga text parameter upang mapanatiling mabilis ang database.
Privacy ng Datos Huwag kailanman magpadala ng Personally Identifiable Information (PII) gaya ng raw na email address, tunay na pangalan o password bilang mga parameter ng event.