CAPI ar Ochr y Gweinydd a Thracio Digwyddiadau

Osgoi atalwyr hysbysebion a chyfyngiadau ITP drwy lwybro traffig MousePlayer drwy eich cynhwysydd GTM Parti Cyntaf eich hun ar Ochr y Gweinydd, a thracio dadansoddeg e-fasnach fanwl.

1. Trosolwg o’r Moddau Tracio

Mae MousePlayer V2 yn cyflwyno Llwybrydd Digwyddiadau pwerus sy’n gadael i chi reoli sut mae data’n llifo o borwr eich defnyddiwr i’n gweinyddion. Gallwch ddewis o dri modd gwahanol:

  • Gwe yn Unig (Rhagosodiad): Yn ffrydio’r holl ddata drwy WebSockets yn uniongyrchol i MousePlayer. Gorau ar gyfer Golwg Fyw amser real, ond yn agored i atalwyr hysbysebion cryf.
  • Modd Hybrid: Y gorau o’r ddau fyd. Yn anfon cyfesurynnau llygoden/sgrolio ysgafn drwy WebSockets ar gyfer Golwg Fyw llyfn, tra caiff newidiadau DOM trwm a Digwyddiadau Personol eu sypynnu a’u llwybro’n ddiogel drwy eich GTM ar Ochr y Gweinydd drwy HTTP POST.
  • CAPI Pur: Sypynnu HTTP POST 100%. Preifatrwydd mwyaf posibl, dim WebSockets, parti cyntaf yn llwyr. Sylwer: Mae Golwg Fyw wedi’i hanalluogi yn y modd hwn.

2. Gosod Google Tag Manager (Argymhellir)

Y ffordd hawsaf o weithredu moddau Hybrid neu CAPI Pur yw defnyddio ein Templedi Cymunedol GTM swyddogol. Lawrlwythwch y ffeiliau .tpl isod a’u mewnforio i’ch gweithleoedd GTM.

Lawrlwytho Templedi:

↓ Web GTM: Tag SDK MousePlayer

↓ Server GTM: Cleient Derbyn MousePlayer

↓ Server GTM: Tag Cysylltydd MousePlayer

Cam 1: Ffurfweddu’r Cleient a’r Tag ar Ochr y Gweinydd

Yn eich cynhwysydd GTM ar Ochr y Gweinydd, mewnforiwch y templed Ingest Client. Gosodwch ef i wrando ar lwybr personol (e.e., /mp_capi). Yna mewnforiwch y Connector Tag, ei ffurfweddu i danio ar y digwyddiad mouseplayer_batch a gosodwch eich cynhwysydd.

Cam 2: Ffurfweddu Tag GTM y We

Yn eich cynhwysydd Web GTM, mewnforiwch y SDK Tag. Dewiswch ‘Configuration & Initialization’ fel y Math o Dag, rhowch eich Channel ID, dewiswch Hybrid Mode a gludwch URL eich Pwynt Terfyn ssGTM (e.e., https://metrics.yourdomain.com/mp_capi).

3. Gosod â Llaw (Heb GTM)

Os yw’n well gennych ysgrifennu’r sgript yn uniongyrchol yn y cod, rhaid diffinio’r gwrthrych window.mp_config cyn llwytho’r pyt tracio.

<!-- 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. Tracio Twndisau E-fasnach

Traciwch daith gyfan y cwsmer. Mae defnyddio enwau digwyddiadau safonol yn caniatáu i MousePlayer gynhyrchu adroddiadau Twndis E-fasnach hardd yn awtomatig yng ngweithle eich prosiect. Mae pob digwyddiad yn gwbl gydnaws â moddau CAPI a Gwe yn Unig.

1. view_item

Sbardunwch y digwyddiad hwn pan fydd defnyddiwr yn gweld tudalen cynnyrch benodol.

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

2. add_to_cart

Sbardunwch y digwyddiad hwn pan fydd defnyddiwr yn ychwanegu eitem at ei fasged siopa.

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

3. begin_checkout

Sbardunwch y digwyddiad hwn pan fydd defnyddiwr yn mynd ymlaen i’r sgrin dalu.

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

4. purchase

Sbardunwch y digwyddiad hwn ar ôl taliad llwyddiannus neu gadarnhad archeb.

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

5. Digwyddiadau Personol a Chynhyrchu Cysylltiadau

Nid ydych wedi’ch cyfyngu i e-fasnach. Traciwch gyflwyniadau ffurflenni, cofrestriadau cylchlythyr neu ryngweithiadau personol sy’n unigryw i’ch rhaglen we.

Cynhyrchu Cysylltiadau (Cyflwyno Ffurflen)

Sbardunwch y digwyddiad hwn pan fydd defnyddiwr yn cyflwyno ffurflen gyswllt yn llwyddiannus neu’n gofyn am ddyfynbris.

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

Rhyngweithio UI Personol

Deallwch sut mae defnyddwyr yn rhyngweithio ag elfennau cymhleth fel cyfrifianellau, ffenestri moddol neu newidiadau tab.

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

6. Terfynau Paramedrau a Chanllawiau

Teipio Data: Mae MousePlayer yn canfod mathau paramedrau yn awtomatig. Anfonwch rifau fel cyfanrifau neu rifau pwynt arnawf (e.e., 150.00, nid "150.00") i alluogi hidlo rhifiadol datblygedig (e.e. ‘Pris > 100’) yn y dangosfwrdd.

Rheol Disgrifiad
Hyd Enw Digwyddiad Hyd at 128 nod. Defnyddiwch snake_case i’w ddarllen orau (e.e., user_signup).
Hyd Allwedd Paramedr Hyd at 64 nod fesul enw allwedd (e.e., transaction_id).
Gwerthoedd Llinynnol Cwtogir paramedrau testun i 255 nod i sicrhau perfformiad cronfa ddata gorau posibl.
Preifatrwydd Data Peidiwch byth ag anfon Gwybodaeth Bersonol Adnabyddadwy (PII) fel cyfeiriadau e-bost crai, enwau go iawn neu gyfrineiriau fel paramedrau digwyddiadau.