CAPI li rajekarê û şopandina bûyeran

Bi rêkirina trafîka MousePlayer bi rêya konteynera GTM ya li rajekarê ya aliyê yekem a we bixwe, astengkerên reklaman û sînorên ITP derbas bikin û analîtîka kûr a e-bazirganiyê bişopînin.

1. Pêşdîtina modên şopandinê

MousePlayer V2 Rêkera Bûyeran a bihêz pêşkêş dike ku dihêle hûn kontrol bikin ka dane çawa ji geroka bikarhênerê we diçin rajekarên me. Hûn dikarin ji sê modên cuda hilbijêrin:

  • Tenê Web (destpêkî): Hemû daneyan bi WebSockets rasterast ji MousePlayer re diherikîne. Ji bo dîtina zindî ya di dema rast de herî baş e, lê li hember astengkerên reklaman ên tund bêparastin e.
  • Moda Hîbrîd: Başiya herdu aliyan. Koordînatên sivik ên mişkê/şemitandinê bi WebSockets ji bo dîtina zindî ya herikbar dişîne, lê guhertinên giran ên DOM û bûyerên taybet kom dibin û bi HTTP POST bi ewlehî bi rêya GTM ya li rajekarê ya we tên rêkirin.
  • CAPI ya saf: Komkirina 100% HTTP POST. Nepeniya herî zêde, WebSockets sifir, bi tevahî aliyê yekem. Têbînî: di vê modê de dîtina zindî neçalak e.

2. Sazkirina Google Tag Manager (tê pêşniyarkirin)

Rêya herî hêsan a sepandina modên Hîbrîd an CAPI ya saf bikaranîna şablonên me yên fermî yên GTM Community ye. Pelên .tpl yên li jêr daxînin û wan di qadên xebatê yên GTM yên xwe de bînin hundir.

Şablonan daxînin:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

Gav 1: klîent û tagê li rajekarê veava bikin

Di konteynera GTM ya li rajekarê ya xwe de şablona Ingest Client bînin hundir. Wê saz bikin da li rêyeke taybet guhdarî bike (mînak, /mp_capi). Paşê Connector Tag bînin hundir, wê veava bikin da bi bûyera mouseplayer_batch çalak bibe û konteynera xwe belav bikin.

Gav 2: taga Web GTM veava bikin

Di konteynera Web GTM ya xwe de SDK Tag bînin hundir. Wek Tag Type “Configuration & Initialization” hilbijêrin, nirxa xwe ya Channel ID binivîsin, Hybrid Mode hilbijêrin û URL ya xala dawî ya ssGTM ya xwe pê ve bikin (mînak, https://metrics.yourdomain.com/mp_capi).

3. Sazkirina destan (bê GTM)

Ger hûn dixwazin skrîptê rasterast di kodê de binivîsin, divê berî barkirina parçeya kodê ya şopandinê objeya window.mp_config pênase bikin.

<!-- 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. Şopandina funela e-bazirganiyê

Tevahiya rêwîtiya mişterî bişopînin. Bikaranîna navên bûyerê yên standard dihêle MousePlayer di qada xebatê ya projeya we de raporên xweşik ên funela e-bazirganiyê bixweber çêbike. Hemû bûyer bi modên CAPI û Tenê Web re bi tevahî li hev in.

1. view_item

Dema bikarhênerek li rûpela hilbereke taybet temaşe dike vê bûyerê çalak bikin.

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

2. add_to_cart

Dema bikarhênerek hilberekê li selika kirîna xwe zêde dike vê bûyerê çalak bikin.

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

3. begin_checkout

Dema bikarhênerek diçe dîmena qedandina kirînê vê bûyerê çalak bikin.

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

4. purchase

Piştî dayîna serkeftî an piştrastkirina fermanê vê bûyerê çalak bikin.

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

5. Bûyerên taybet û berhevkirina kesên eleqedar

Hûn bi e-bazirganiyê sînorkirî nînin. Şandina forman, qeydkirina nameyên nûçeyan an danûstandinên taybet ên sepana xwe ya webê bişopînin.

Berhevkirina kesên eleqedar (şandina formê)

Dema bikarhênerek bi serkeftî forma têkiliyê dişîne an daxwaza pêşniyara bihayê dike vê bûyerê çalak bikin.

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

Danûstandina taybet a navrûyê

Fam bikin ka bikarhêner çawa bi hêmanên tevlihev ên wek hesabker, pencereyên modal an guherînên hilpekînan re danûstandinê dikin.

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

6. Sînor û rêberiyên parametreyan

Cureyên daneyan: MousePlayer cureyên parametreyan bixweber nas dike. Hejmaran wek hejmarên tam an bi xalê bibar bişînin (mînak, 150.00, ne "150.00") da di panela kontrolê de parzûnkirina hejmarî ya pêşketî (mînak, “Biha > 100”) çalak bibe.

Rêgez Rave
Dirêjahiya navê bûyerê Herî zêde 128 tîp. Ji bo xwendinbarî ya herî baş snake_case bikar bînin (mînak, user_signup).
Dirêjahiya mifteya parametreyê Herî zêde 64 tîp ji bo her navê mifteyê (mînak, transaction_id).
Nirxên rêzikên nivîsê Ji bo performansa herî baş a danegehê, parametreyên nivîsê bi 255 tîpan tên sînorkirin.
Nepeniya daneyan Qet agahiyên nasandina kesane (PII) yên wek navnîşanên e-nameyê yên xam, navên rastîn an şîfreyan wek parametreyên bûyerê neşînin.