Zerbitzari-aldeko CAPI eta gertaeren jarraipena

Gainditu iragarki-blokeatzaileak eta ITP murrizketak MousePlayer trafikoa zure lehen alderdiaren zerbitzari-aldeko GTM edukiontzitik bideratuz, eta egin merkataritza elektronikoko analisi sakona.

1. Jarraipen-moduen ikuspegi orokorra

MousePlayer V2k honako hau aurkezten du: Event Router tresna indartsua, zure erabiltzailearen nabigatzailetik gure zerbitzarietara datuak nola doazen kontrolatzeko. Hiru modu desberdin aukeratu ditzakezu:

  • Web Only (lehenetsia): Datu guztiak WebSocket bidez zuzenean MousePlayer-era transmititzen ditu. Onena denbora errealeko zuzeneko ikuspegirako, baina iragarki-blokeatzaile zorrotzek eragin diezaiokete.
  • Hybrid modua: Bi munduetako onena. Saguaren eta korritzearen koordenatu arinak WebSocket bidez bidaltzen ditu zuzeneko ikuspegi leunerako; DOM mutazio astunak eta gertaera pertsonalizatuak, berriz, sortetan bildu eta segurtasunez bideratzen dira zure zerbitzari-aldeko GTMtik HTTP POST bidez.
  • Pure CAPI: 100% HTTP POST sorta-prozesamendua. Pribatutasun handiena, WebSocketik gabe, erabat lehen alderdiaren bidez. Oharra: zuzeneko ikuspegia desaktibatuta dago modu honetan.

2. Google Tag Manager konfigurazioa (gomendatua)

Hybrid edo Pure CAPI moduak ezartzeko modurik errazena gure GTM komunitateko txantiloi ofizialak erabiltzea da. Deskargatu beheko .tpl fitxategiak eta inportatu zure GTM lan-eremuetara.

Deskargatu txantiloiak:

↓ Web GTM: MousePlayer SDK etiketa

↓ Server GTM: MousePlayer sarrera-bezeroa

↓ Server GTM: MousePlayer konektore-etiketa

1. urratsa: konfiguratu zerbitzari-aldeko bezeroa eta etiketa

Zure zerbitzari-aldeko GTM edukiontzian, inportatu Sarrera-bezeroa txantiloia. Ezarri bide pertsonalizatu bat entzun dezan (adibidez, /mp_capi). Ondoren, inportatu Konektore-etiketa, konfiguratu honako gertaeran exekutatzeko: mouseplayer_batch eta ezarri zure edukiontzia.

2. urratsa: konfiguratu Web GTM etiketa

Zure Web GTM edukiontzian, inportatu SDK etiketa. Hautatu «Configuration & Initialization» etiketa mota gisa, sartu zure Channel ID, hautatu Hybrid modua eta itsatsi zure ssGTM muturraren URLa (adibidez, https://metrics.yourdomain.com/mp_capi).

3. Eskuzko instalazioa (GTM gabe)

Scripta kodean zuzenean ezarri nahi baduzu, honako hau definitu behar duzu: window.mp_config objektua, jarraipen-kodea kargatu aurretik.

<!-- 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. Merkataritza elektronikoko inbutuen jarraipena

Jarraitu bezeroaren ibilbide osoa. Gertaera-izen estandarizatuak erabiltzeak MousePlayer-i aukera ematen dio zure proiektuaren lan-eremuan merkataritza elektronikoko inbutu-txosten argiak automatikoki sortzeko. Gertaera guztiak CAPI eta Web-Only moduekin guztiz bateragarriak dira.

1. view_item

Abiarazi gertaera hau erabiltzaileak produktu-orri zehatz bat ikusten duenean.

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

2. add_to_cart

Abiarazi gertaera hau erabiltzaileak produktu bat bere erosketa-saskira gehitzen duenean.

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

3. begin_checkout

Abiarazi gertaera hau erabiltzailea ordainketa-pantailara doanean.

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

4. purchase

Abiarazi gertaera hau ordainketa arrakastatsua edo eskaeraren berrespena gertatzean.

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

5. Gertaera pertsonalizatuak eta bezero potentzialen sorrera

Ez zaude merkataritza elektronikora mugatuta. Jarraitu inprimaki-bidalketak, buletinetarako erregistroak edo zure web-aplikazioko interakzio bereziak.

Bezero potentzialen sorrera (inprimakia bidaltzea)

Abiarazi gertaera hau erabiltzaileak harremanetarako inprimakia behar bezala bidaltzen duenean edo aurrekontua eskatzen duenean.

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

Interfazeko interakzio pertsonalizatua

Ulertu erabiltzaileek nola interakzionatzen duten kalkulagailuak, leihoak edo fitxa-aldaketak bezalako elementu konplexuekin.

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

6. Parametroen mugak eta jarraibideak

Datuen tipatzea: MousePlayer-ek automatikoki hautematen ditu parametro motak. Bidali zenbakiak zenbaki oso edo hamartar gisa (adibidez, 150.00, ez "150.00"), aginte-panelean zenbakizko iragazketa aurreratua gaitzeko (adib. «Prezioa > 100»).

Araua Deskribapena
Gertaeraren izenaren luzera Gehienez 128 karaktere. Erabili snake_case irakurgarritasun onenerako (adibidez, user_signup).
Parametro-gakoaren luzera Gehienez 64 karaktere gako-izen bakoitzeko (adibidez, transaction_id).
Testu-kateen balioak Testu-parametroak 255 karakterera mozten dira datu-basearen errendimendu egokia ziurtatzeko.
Datuen pribatutasuna Datu pertsonalak (PII), hala nola helbide elektroniko gordinak, benetako izenak edo pasahitzak, ez bidali gertaeren parametro gisa.