Strežniški CAPI in sledenje dogodkom

Obidite blokatorje oglasov in omejitve ITP z usmerjanjem prometa MousePlayer prek lastnega strežniškega vsebnika GTM prve osebe ter spremljajte podrobno analitiko e-trgovine.

1. Pregled načinov sledenja

MousePlayer V2 uvaja zmogljiv usmerjevalnik dogodkov, s katerim nadzirate tok podatkov iz brskalnika uporabnika na naše strežnike. Izbirate med tremi načini:

  • Samo splet (privzeto): Vse podatke prenaša prek WebSockets neposredno v MousePlayer. Najboljše za ogled v realnem času, vendar občutljivo na močne blokatorje oglasov.
  • Hibridni način: Najboljše iz obeh svetov. Majhne koordinate miške in pomikanja pošilja prek WebSockets za gladek ogled v živo, velike spremembe DOM in prilagojene dogodke pa združuje v pakete in varno usmerja prek strežniškega GTM z HTTP POST.
  • Samo CAPI: 100-odstotno paketno pošiljanje HTTP POST. Največja zasebnost, brez WebSockets, v celoti lastna domena. Opomba: ogled v živo je v tem načinu onemogočen.

2. Nastavitev Google Tag Manager (priporočeno)

Najlažja uvedba hibridnega načina ali načina samo CAPI je z našimi uradnimi predlogami skupnosti GTM. Prenesite spodnje datoteke .tpl in jih uvozite v delovne prostore GTM.

Prenesite predloge:

↓ Spletni GTM: oznaka SDK MousePlayer

↓ Strežniški GTM: odjemalec za sprejem MousePlayer

↓ Strežniški GTM: povezovalna oznaka MousePlayer

Korak 1: nastavite strežniškega odjemalca in oznako

V strežniškem vsebniku GTM uvozite predlogo odjemalca za sprejem. Nastavite poslušanje na poti po meri (npr. /mp_capi). Nato uvozite povezovalno oznako in jo nastavite za sprožitev ob dogodku mouseplayer_batch ter uvedite vsebnik.

Korak 2: nastavite spletno oznako GTM

V spletnem vsebniku GTM uvozite oznako SDK. Kot vrsto oznake izberite „Konfiguracija in inicializacija“, vnesite svoj Channel ID, izberite hibridni način in prilepite URL končne točke ssGTM (npr. https://metrics.yourdomain.com/mp_capi).

3. Ročna namestitev (brez GTM)

Če želite skript zapisati neposredno v kodo, morate določiti objekt window.mp_config pred nalaganjem delčka kode za sledenje.

<!-- 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. Sledenje lijaku e-trgovine

Spremljajte celotno pot stranke. S standardiziranimi imeni dogodkov MousePlayer v delovnem prostoru samodejno ustvarja pregledna poročila o lijakih e-trgovine. Vsi dogodki so v celoti združljivi z načini CAPI in samo splet.

1. view_item

Sprožite ta dogodek, ko si uporabnik ogleda stran določenega izdelka.

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

2. add_to_cart

Sprožite ta dogodek, ko uporabnik doda izdelek v košarico.

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

3. begin_checkout

Sprožite ta dogodek, ko uporabnik nadaljuje na zaslon za zaključek nakupa.

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

4. purchase

Sprožite ta dogodek ob uspešnem plačilu ali potrditvi naročila.

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

5. Prilagojeni dogodki in pridobivanje potencialnih strank

Niste omejeni na e-trgovino. Sledite oddajam obrazcev, prijavam na e-novice ali interakcijam, značilnim za vašo spletno aplikacijo.

Pridobivanje potencialnih strank (oddaja obrazca)

Sprožite ta dogodek, ko uporabnik uspešno odda kontaktni obrazec ali zahteva ponudbo.

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

Prilagojena interakcija vmesnika

Razumite uporabo kompleksnih elementov, kot so kalkulatorji, pogovorna okna ali preklopi zavihkov.

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

6. Omejitve parametrov in smernice

Tipi podatkov: MousePlayer samodejno zazna tipe parametrov. Številke pošljite kot cela ali decimalna števila (npr. 150.00, ne "150.00"), da omogočite napredno številsko filtriranje (npr. „Cena > 100“) na nadzorni plošči.

Pravilo Opis
Dolžina imena dogodka Največ 128 znakov. Za najboljšo berljivost uporabite snake_case (npr. user_signup).
Dolžina ključa parametra Največ 64 znakov na ime ključa (npr. transaction_id).
Besedilne vrednosti Besedilni parametri se skrajšajo na 255 znakov za optimalno zmogljivost zbirke podatkov.
Zasebnost podatkov Osebnih podatkov, kot so neobdelani e-poštni naslovi, prava imena ali gesla, ne pošiljajte kot parametre dogodkov.