Serveripoolne CAPI & sündmuste jälgimine

Minge reklaamiblokeerijatest ja ITP piirangutest mööda, suunates MousePlayeri liikluse läbi enda esimese osapoole serveripoolse GTM-i konteineri, ning jälgige põhjalikku e-kaubanduse analüütikat.

1. Jälgimisrežiimide ülevaade

MousePlayer V2 tutvustab võimsat sündmuste marsruuterit, mis võimaldab juhtida andmevoogu kasutaja brauserist meie serveritesse. Valida saab kolme režiimi vahel:

  • Ainult veeb (vaikimisi): Edastab kõik andmed WebSocketi kaudu otse MousePlayerile. Parim reaalajavaate jaoks, kuid tundlik rangete reklaamiblokeerijate suhtes.
  • Hübriidrežiim: Mõlema maailma eelised. Saadab väikesemahulised hiire- ja kerimiskoordinaadid sujuva reaalajavaate jaoks WebSocketi kaudu, samal ajal koondatakse mahukad DOM-i muudatused ja kohandatud sündmused pakkidesse ning suunatakse turvaliselt HTTP POST päringutega läbi teie serveripoolse GTM-i.
  • Puhas CAPI: 100% HTTP POST pakkedastus. Maksimaalne privaatsus, WebSocketi ühendusi pole, täielikult esimese osapoole lahendus. Märkus: selles režiimis on reaalajavaade keelatud.

2. Google Tag Manageri seadistamine (soovitatav)

Lihtsaim viis hübriid- või puhta CAPI režiimi rakendamiseks on kasutada meie ametlikke GTM Community Templatesi malle. Laadige alla järgmised .tpl failid ja importige need oma GTM-i tööruumidesse.

Laadi mallid alla:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

Samm 1: seadistage serveripoolne klient ja silt

Importige oma serveripoolsesse GTM-i konteinerisse mall Ingest Client. Määrake see kuulama kohandatud teekonda (näiteks /mp_capi). Seejärel importige Connector Tag, seadistage see käivituma sündmuse mouseplayer_batch korral ja avaldage konteiner.

Samm 2: seadistage Web GTM-i silt

Importige oma Web GTM-i konteinerisse SDK Tag. Valige sildi tüübiks "Configuration & Initialization", sisestage oma Channel ID, valige Hybrid Mode ja kleepige ssGTM-i lõpp-punkti URL (näiteks https://metrics.yourdomain.com/mp_capi).

3. Käsitsi paigaldamine (ilma GTM-ita)

Kui eelistate skripti otse koodi lisada, peate enne jälgimiskoodi laadimist määrama objekti 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. E-kaubanduse lehtri jälgimine

Jälgige kogu klienditeekonda. Standardsete sündmusenimede kasutamine võimaldab MousePlayeril automaatselt luua teie projekti tööruumis ilusaid e-kaubanduse lehtri aruandeid. Kõik sündmused sobivad täielikult nii CAPI kui ka ainult veebi režiimiga.

1. view_item

Käivitage see sündmus, kui kasutaja vaatab konkreetset tootelehte.

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

2. add_to_cart

Käivitage see sündmus, kui kasutaja lisab kauba ostukorvi.

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

3. begin_checkout

Käivitage see sündmus, kui kasutaja liigub ostu vormistamise kuvale.

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

4. purchase

Käivitage see sündmus pärast edukat makset või tellimuse kinnitamist.

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

5. Kohandatud sündmused ja müügivihjete kogumine

Te ei piirdu e-kaubandusega. Jälgige vormide saatmist, uudiskirjaga liitumist või teie veebirakendusele eriomaseid kohandatud tegevusi.

Müügivihjete kogumine (vormi saatmine)

Käivitage see sündmus, kui kasutaja saadab edukalt kontaktivormi või küsib pakkumist.

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

Kohandatud tegevus kasutajaliideses

Mõistke, kuidas kasutajad suhtlevad keerukate elementidega, nagu kalkulaatorid, modaaldialoogid või vahekaardivahetused.

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

6. Parameetrite piirangud ja juhised

Andmetüübid: MousePlayer tuvastab parameetrite tüübid automaatselt. Saatke arvud täis- või ujukomaarvudena (näiteks 150.00, mitte "150.00"), et kasutada töölaual täpsemaid arvulisi filtreid (näiteks "Price > 100").

Reegel Kirjeldus
Sündmuse nime pikkus Kuni 128 märki. Parima loetavuse jaoks kasutage snake_case-kuju (näiteks user_signup).
Parameetri võtme pikkus Kuni 64 märki võtmenime kohta (näiteks transaction_id).
Stringiväärtused Tekstiparameetrid kärbitakse 255 märgini, et tagada andmebaasi parim jõudlus.
Andmete privaatsus Ärge kunagi saatke sündmuse parameetritena isikut tuvastada võimaldavaid andmeid (PII), nagu töötlemata e-posti aadressid, pärisnimed või paroolid.