CAPI gama sarvarii fi hordoffii taatee

Tiraafikii MousePlayer container GTM gama sarvarii first-party mataa keessanii karaa qajeelchuun uggura beeksisaa fi daangaa ITP darbaa, xiinxala daldala elektirooniksii gadi fageenyaan hordofaa.

1. Cuunfaa haalawwan hordoffii

MousePlayer V2 kan humna qabu Event Router dhiyeessa, kan deetaan biraawzarii fayyadamaa keessanii irraa gara sarvaroota keenyaatti akkamitti akka yaa'u to'achuuf isin dandeessisu. Haala adda addaa sadii keessaa filachuu dandeessu:

  • Webii qofa (Durtii): Deetaa hunda WebSocket tiin kallattiin gara MousePlayer tti dabarsa. Mul'ata kallattii yeroo dhugaaf isa gaarii, garuu uggurri beeksisaa cimaan miidhuu danda'a.
  • Haala Walmakaa: Gama lamaanii isa gaarii. Qindeessitoota maawusii/sakkatta'uu salphaa WebSocket tiin mul'ata kallattii sirriif erga, jijjiiramoota DOM ulfaataa fi taatee dhuunfaa immoo baachiitti walitti qabuun HTTP POST tiin karaa GTM gama sarvarii keessanii nageenyaan qajeelcha.
  • CAPI qofa: Baachii HTTP POST 100%. Iccitii olaanaa, WebSocket zeeroo, guutumaan first-party. Hubannoo: mul'anni kallattii haala kana keessatti cufama.

2. Qindaa'ina Google Tag Manager (Gorfama)

Karaan salphaan haala Walmakaa yookaan CAPI qofa hojiirra oolchuuf ndeebiiwwan GTM Community rasmii keenya fayyadamuudha. Faayiloota .tpl armaan gadii buusaatii iddoowwan hojii GTM keessan keessatti galchaa.

Ndeebiiwwan buusaa:

↓ Web GTM: Tagii MousePlayer SDK

↓ Server GTM: Maamila galchuu MousePlayer

↓ Server GTM: Tagii walqabsiisaa MousePlayer

Tarkaanfii 1: Maamilaa fi tagii gama sarvarii qindeessaa

Container GTM gama sarvarii keessanii keessatti ndeebii Maamila galchuu galchaa. Karaa dhuunfaa (fkn., /mp_capi) irratti akka dhaggeeffatu saagaa. Sana booda, Tagii walqabsiisaagalchaa, taatee mouseplayer_batch irratti akka kaka'u qindeessaa, container keessan hojiirra oolchaa.

Tarkaanfii 2: Tagii Web GTM qindeessaa

Container Web GTM keessanii keessatti Tagii SDKgalchaa. “Configuration & Initialization” akka Gosa Tagiitti filadhaa, Channel IDkeessan galchaa, Haala Walmakaafiladhaa, URL bakka xumuraa ssGTM keessanii maxxansaa (fkn., https://metrics.yourdomain.com/mp_capi).

3. Fe'umsa harkaan (GTM malee)

Iskiriiptii koodii keessatti galchuu yoo filattan, wanta window.mp_config kutaa koodii hordoffii fe'uu dura ibsuu qabdu.

<!-- 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. Hordoffii ujummoo daldala elektirooniksii

Imala maamilaa guutuu hordofaa. Maqaa taatee idilee fayyadamuun MousePlayer gabaasa ujummoo daldala elektirooniksii bareedaa iddoo hojii pirojektii keessan keessatti ofumaan akka uumu taasisa. Taateewwan hundi haalawwan CAPI fi Webii qofa waliin guutumaan walsimu.

1. view_item

Fayyadamaan fuula oomishaa murtaa'e yeroo ilaalu taatee kana kakaasaa.

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

2. add_to_cart

Fayyadamaan meeshaa gaarii bittaa isaatti yeroo dabalu taatee kana kakaasaa.

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

3. begin_checkout

Fayyadamaan gara iskiriinii kaffaltii xumuruutti yeroo deemu taatee kana kakaasaa.

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

4. purchase

Kaffaltiin yeroo milkaa'u yookaan ajajni yeroo mirkanaa'u taatee kana kakaasaa.

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

5. Taateewwan dhuunfaa fi namoota fedhii qaban argachuu

Daldala elektirooniksii qofatti hin daangeffamtan. Erguu unkaa, galmee oduu yookaan walitti dhufeenya dhuunfaa appilikeeshinii webii keessaniif adda ta'e hordofaa.

Namoota fedhii qaban argachuu (Unkaa erguu)

Fayyadamaan unkaa quunnamtii milkaa'inaan yeroo ergu yookaan gatii gaafatu taatee kana kakaasaa.

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

Walitti dhufeenya UI dhuunfaa

Fayyadamtoonni wantoota walxaxaa akka shallagduu, modal yookaan jijjiirtuu gabatee waliin akkamitti akka walitti dhufan hubadhaa.

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

6. Daangaa parametarii fi qajeelfama

Gosa deetaa: MousePlayer gosa parametarii ofumaan adda baasa. Lakkoofsota akka integer yookaan float ergaa (fkn., 150.00, kana miti "150.00") calallii lakkoofsaa sadarkaa olaanaa (fkn. “Gatii > 100”) daashboordii keessatti dandeessisuuf.

Seera Ibsa
Dheerina maqaa taatee Baay'inaan qubee 128. Dubbifamuu gaariif snake_case fayyadamaa (fkn., user_signup).
Dheerina furtuu parametarii Maqaa furtuu tokkoon baay'inaan qubee 64 (fkn., transaction_id).
Gatii string Parametaroonni barruu raawwii kuusaa deetaa gaarii mirkaneessuuf hanga qubee 255 tti gabaabbatu.
Iccitii deetaa Odeeffannoo nama adda baasuu danda'u (PII) akka teessoo imeelii jalqabaa, maqaa dhugaa yookaan jecha darbii akka parametarii taateetti hin erginaa.