Szerveroldali CAPI és eseménykövetés

Kerülje meg a reklámblokkolókat és ITP-korlátokat: a MousePlayer forgalmát saját, első féltől származó szerveroldali GTM-konténerén vezetheti át, és részletes e-kereskedelmi analitikát követhet.

1. Követési módok áttekintése

A MousePlayer V2 hatékony eseményútválasztót vezet be, amellyel szabályozhatja az adatáramlást a felhasználó böngészője és szervereink között. Három külön mód közül választhat:

  • Csak web (alapértelmezett): Minden adatot WebSocketen át közvetlenül a MousePlayerhez továbbít. Valós idejű élő nézethez a legjobb, de az erős reklámblokkolókkal szemben sérülékeny.
  • Hibrid mód: A két megoldás előnyeit egyesíti. A kis méretű egér- és görgetési koordinátákat WebSocketen küldi a folyamatos élő nézethez, a nagy DOM-módosításokat és egyedi eseményeket pedig kötegelve, biztonságosan, HTTP POST-tal továbbítja a szerveroldali GTM-en át.
  • Csak CAPI: 100%-ban kötegelt HTTP POST. Maximális adatvédelem, WebSocket nélkül, teljes egészében első féltől származó adatforgalom. Megjegyzés: ebben a módban az élő nézet kikapcsolt.

2. Google Tag Manager beállítása (ajánlott)

A Hibrid és Csak CAPI mód legegyszerűbben hivatalos GTM közösségi sablonjainkkal valósítható meg. Töltse le az alábbi .tpl fájlokat, és importálja őket GTM-munkaterületeire.

Sablonok letöltése:

↓ Web GTM: MousePlayer SDK-címke

↓ Server GTM: MousePlayer adatfogadó kliens

↓ Server GTM: MousePlayer összekötőcímke

1. lépés: szerveroldali kliens és címke beállítása

Szerveroldali GTM-konténerébe importálja az Adatfogadó kliens sablont. Állítson be egyedi figyelt útvonalat (például /mp_capi). Ezután importálja az Összekötőcímkét, állítsa be aktiválását a mouseplayer_batch eseményre, és tegye közzé a konténert.

2. lépés: webes GTM-címke beállítása

Webes GTM-konténerébe importálja az SDK-címkét. Címketípusnak válassza a „Konfiguráció és inicializálás” lehetőséget, adja meg a Channel ID értéket, válassza a Hibrid módot, majd illessze be ssGTM-végpontja URL-jét (például https://metrics.yourdomain.com/mp_capi).

3. Kézi telepítés (GTM nélkül)

Ha a szkriptet közvetlenül a kódba írja, a követőkódrészlet betöltése előtt meg kell adnia a window.mp_config objektumot.

<!-- 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-kereskedelmi tölcsérkövetés

Kövesse a teljes ügyfélútvonalat. Szabványos eseménynevekkel a MousePlayer automatikusan látványos e-kereskedelmi tölcsérjelentéseket készíthet projektje munkaterületén. Minden esemény teljesen kompatibilis a CAPI és a Csak web móddal.

1. view_item

Akkor váltsa ki ezt az eseményt, amikor a felhasználó egy adott termékoldalt néz meg.

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

2. add_to_cart

Akkor váltsa ki ezt az eseményt, amikor a felhasználó terméket tesz a kosarába.

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

3. begin_checkout

Akkor váltsa ki ezt az eseményt, amikor a felhasználó a pénztár képernyőjére lép.

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

4. purchase

Sikeres fizetés vagy rendelés-visszaigazolás esetén váltsa ki ezt az eseményt.

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

5. Egyedi események és érdeklődőszerzés

Nem korlátozódik az e-kereskedelemre. Kövesse az űrlapbeküldéseket, hírlevél-feliratkozásokat vagy webalkalmazása sajátos egyedi interakcióit.

Érdeklődőszerzés (űrlapbeküldés)

Akkor váltsa ki ezt az eseményt, amikor a felhasználó sikeresen beküld egy kapcsolatfelvételi űrlapot vagy ajánlatot kér.

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

Egyedi felületi interakció

Értse meg a felhasználók interakcióit az olyan összetett elemekkel, mint a kalkulátorok, párbeszédablakok vagy lapváltók.

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

6. Paraméterkorlátok és útmutatás

Adattípusok: A MousePlayer automatikusan felismeri a paramétertípusokat. A számokat egészként vagy lebegőpontos számként küldje (például 150.00, ne "150.00"), hogy az irányítópulton fejlett numerikus szűrés (például „Ár > 100”) legyen használható.

Szabály Leírás
Eseménynév hossza Legfeljebb 128 karakter. Az olvashatósághoz használjon snake_case formát (például user_signup).
Paraméterkulcs hossza Kulcsnévenként legfeljebb 64 karakter (például transaction_id).
Szöveges értékek A szöveges paramétereket 255 karakterre csonkoljuk az adatbázis optimális teljesítményéhez.
Adatvédelem Eseményparaméterként ne küldjön személyazonosításra alkalmas adatokat (PII), például nyers e-mail-címet, valódi nevet vagy jelszót.