Bedienerkant-CAPI en gebeurtenisnasporing

Omseil advertensieblokkers en ITP-beperkings deur MousePlayer-verkeer deur u eie eersteparty-GTM-houer aan die bedienerkant te stuur en spoor gedetailleerde e-handelsontleding na.

1. Oorsig van nasporingsmodusse

MousePlayer V2 stel 'n kragtige gebeurtenisroeteerder bekend waarmee u datavloei van die gebruiker se blaaier na ons bedieners beheer. U kan uit drie verskillende modusse kies:

  • Slegs web (verstek): Stroom alle data deur WebSockets direk na MousePlayer. Beste vir intydse regstreekse aansig, maar kwesbaar vir sterk advertensieblokkers.
  • Hibriede modus: Die beste van albei wêrelde. Stuur ligte muis-/rolkoördinate deur WebSockets vir gladde regstreekse aansig, terwyl swaar DOM-wysigings en pasgemaakte gebeure gegroepeer en veilig deur u bedienerkant-GTM via HTTP POST gestuur word.
  • Suiwer CAPI: 100% HTTP POST-groepversending. Maksimum privaatheid, geen WebSockets nie, volledig eersteparty. Let wel: regstreekse aansig is in hierdie modus gedeaktiveer.

2. Google Tag Manager-opstelling (aanbeveel)

Die maklikste implementering van hibriede of suiwer CAPI-modus is met ons amptelike GTM Community Templates. Laai die .tpl lêers hieronder af en voer hulle in u GTM-werkruimtes in.

Laai sjablone af:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

Stap 1: stel die bedienerkantkliënt en etiket op

Voer in u bedienerkant-GTM-houer die Ingest Client sjabloon in. Stel dit om op 'n pasgemaakte pad te luister (bv. /mp_capi). Voer dan die Connector Tagin, stel dit om op die mouseplayer_batch gebeurtenis te aktiveer en ontplooi u houer.

Stap 2: stel die Web GTM-etiket op

Voer in u Web GTM-houer die SDK Tagin. Kies “Configuration & Initialization” as etikettipe, voer u Channel IDin, kies Hybrid Modeen plak u ssGTM-eindpunt-URL (bv. https://metrics.yourdomain.com/mp_capi).

3. Handmatige installasie (sonder GTM)

As u die skrip liewer direk in die kode plaas, moet u die window.mp_config objek definieer voordat u die nasporingskodebrokkie laai.

<!-- 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. Nasporing van e-handelstregters

Spoor die volledige klantreis na. Gestandaardiseerde gebeurtenisname laat MousePlayer outomaties duidelike e-handelstregterverslae in u projekwerkruimte skep. Alle gebeure is volledig met CAPI- en slegs-webmodusse versoenbaar.

1. view_item

Aktiveer dit wanneer 'n gebruiker 'n bepaalde produkbladsy bekyk.

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

2. add_to_cart

Aktiveer dit wanneer 'n gebruiker 'n item by die mandjie voeg.

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

3. begin_checkout

Aktiveer dit wanneer 'n gebruiker na die betaalskerm gaan.

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

4. purchase

Aktiveer dit ná suksesvolle betaling of bestellingsbevestiging.

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

5. Pasgemaakte gebeure en werwing van potensiële klante

U is nie tot e-handel beperk nie. Spoor vormindienings, nuusbriefintekenings of pasgemaakte interaksies eie aan u webtoepassing na.

Werwing van potensiële klante (vormindiening)

Aktiveer dit wanneer 'n gebruiker 'n kontakvorm suksesvol indien of 'n kwotasie vra.

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

Pasgemaakte koppelvlakinteraksie

Verstaan hoe gebruikers met ingewikkelde elemente soos sakrekenaars, dialoë of oortjiewisselaars omgaan.

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

6. Parameterlimiete en riglyne

Datatipes: MousePlayer bespeur parametertipes outomaties. Stuur getalle as heelgetalle of drywende-kommagetalle (bv. 150.00, nie "150.00"nie) om gevorderde numeriese filtrering (bv. “Prys > 100”) in die kontroleskerm moontlik te maak.

Reël Beskrywing
Gebeurtenisnaamlengte Hoogstens 128 karakters. Gebruik snake_case vir leesbaarheid (bv. user_signup).
Parametersleutellengte Hoogstens 64 karakters per sleutelnaam (bv. transaction_id).
Tekswaardes Teksparameters word tot 255 karakters afgekap vir optimale databasisprestasie.
Dataprivaatheid Stuur nie persoonlik identifiseerbare inligting (PII) soos rou e-posadresse, werklike name of wagwoorde as gebeurtenisparameters nie.