مۇلازىمېتىر تەرەپ CAPI ۋە ھادىسە ئىز قوغلاش

MousePlayer قاتنىشىنى ئۆز بىرىنچى تەرەپ Server-Side GTM قاچىڭىز ئارقىلىق يوللاپ، ئېلان توسقۇچ ۋە ITP چەكلىرىدىن ئۆتۈڭ، چوڭقۇر ئېلېكترونلۇق سودا ئانالىزىنى ئىز قوغلاڭ.

1. ئىز قوغلاش ھالەتلىرىنىڭ ئومۇمىي كۆرۈنۈشى

MousePlayer V2 كۈچلۈك ھادىسە يوللىغۇچ تونۇشتۇرىدۇ، ئۇ ئىشلەتكۈچى توركۆرگۈچىدىن مۇلازىمېتىرلىرىمىزغىچە سانلىق مەلۇمات ئېقىمىنى كونترول قىلىش ئىمكانىنى بېرىدۇ. ئۈچ پەرقلىق ھالەتنى تاللىيالايسىز:

  • پەقەت تور (سۈكۈتتىكى): بارلىق سانلىق مەلۇماتنى WebSocket ئارقىلىق بىۋاسىتە MousePlayer غا ئاققۇزىدۇ. دەل ۋاقتىدىكى نەق مەيدان كۆرۈنۈشى ئۈچۈن ئەڭ ياخشى، ئەمما كۈچلۈك ئېلان توسقۇچلارغا ئاجىز.
  • Hybrid ھالىتى: ئىككى يولنىڭ ئەۋزەللىكى. راۋان نەق مەيدان كۆرۈنۈشى ئۈچۈن يېنىك چاشقىنەك/سىيرىش كوئوردېناتلىرىنى WebSocket ئارقىلىق ئەۋەتىدۇ، ئېغىر DOM ئۆزگىرىشلىرى ۋە خاس ھادىسىلەرنى توپلاپ، HTTP POST ئارقىلىق Server-Side GTM ڭىزدىن بىخەتەر يوللايدۇ.
  • Pure CAPI: 100% HTTP POST توپلاش. ئەڭ يۇقىرى مەخپىيەتلىك، WebSocket يوق، پۈتۈنلەي بىرىنچى تەرەپ. ئەسكەرتىش: بۇ ھالەتتە نەق مەيدان كۆرۈنۈشى تاقاق.

2. Google Tag Manager تەڭشەش (تەۋسىيە)

Hybrid ياكى Pure CAPI ھالىتىنى يولغا قويۇشنىڭ ئەڭ ئاسان يولى رەسمىي GTM مەھەللە قېلىپلىرىمىزنى ئىشلىتىش. تۆۋەندىكى .tpl ھۆججەتلەرنى چۈشۈرۈپ GTM خىزمەت بوشلۇقىڭىزغا ئەكىرىڭ.

قېلىپلارنى چۈشۈرۈش:

↓ Web GTM: MousePlayer SDK بەلگىسى

↓ Server GTM: MousePlayer قوبۇل قىلىش خېرىدارى

↓ Server GTM: MousePlayer ئۇلىغۇچى بەلگىسى

1-قەدەم: مۇلازىمېتىر تەرەپ خېرىدارى ۋە بەلگىسىنى تەڭشەڭ

Server-Side GTM قاچىڭىزغا قوبۇل قىلىش خېرىدارى قېلىپىنى ئەكىرىڭ. ئۇنى خاس يولدا ئاڭلاشقا تەڭشەڭ (مەسىلەن /mp_capi). ئاندىن ئۇلىغۇچى بەلگىسى نى ئەكىرىپ، ئۇنى mouseplayer_batch ھادىسىسىدە قوزغىلىشقا تەڭشەڭ ۋە قاچىڭىزنى ئورنىتىڭ.

2-قەدەم: Web GTM بەلگىسىنى تەڭشەڭ

Web GTM قاچىڭىزغا SDK بەلگىسى نى ئەكىرىڭ. بەلگە تىپى قىلىپ «تەڭشەش ۋە دەسلەپلەشتۈرۈش» نى تاللاپ، Channel ID نى كىرگۈزۈڭ، Hybrid ھالىتى نى تاللاپ، ssGTM ئاخىرقى نۇقتا URL ڭىزنى چاپلاڭ (مەسىلەن https://metrics.yourdomain.com/mp_capi).

3. قولدا ئورنىتىش (GTM سىز)

سكرىپتنى كودقا مۇقىم يازماقچى بولسىڭىز، ئىز قوغلاش كود پارچىسىنى يۈكلەشتىن بۇرۇن window.mp_config ئوبيېكتىنى بەلگىلىشىڭىز كېرەك.

<!-- 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. ئېلېكترونلۇق سودا ۋارونكىسىنى ئىز قوغلاش

خېرىدارنىڭ پۈتۈن يولىنى ئىز قوغلاڭ. ئۆلچەملەشتۈرۈلگەن ھادىسە ناملىرى MousePlayer نىڭ تۈر خىزمەت بوشلۇقىڭىزدا چىرايلىق ئېلېكترونلۇق سودا ۋارونكا دوكلاتلىرىنى ئاپتوماتىك ھاسىل قىلىشىغا يول قويىدۇ. بارلىق ھادىسىلەر CAPI ۋە پەقەت تور ھالىتىگە تولۇق ماس.

1. view_item

ئىشلەتكۈچى مەلۇم مەھسۇلات بېتىنى كۆرگەندە بۇ ھادىسىنى قوزغىتىڭ.

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

2. add_to_cart

ئىشلەتكۈچى سېۋىتىگە مال قوشقاندا بۇ ھادىسىنى قوزغىتىڭ.

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

3. begin_checkout

ئىشلەتكۈچى ھېسابات قىلىش ئېكرانىغا ئۆتكەندە بۇ ھادىسىنى قوزغىتىڭ.

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

4. purchase

چىقىم مۇۋەپپەقىيەتلىك بولغاندا ياكى زاكاز جەزملەشتۈرۈلگەندە بۇ ھادىسىنى قوزغىتىڭ.

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

5. خاس ھادىسىلەر ۋە يوشۇرۇن خېرىدار توپلاش

ئېلېكترونلۇق سودا بىلەن چەكلەنمەيسىز. جەدۋەل يوللاش، خەۋەرنامىگە تىزىملىتىش ياكى تور ئەپىڭىزگە خاس ئۆزئارا ھەرىكەتلەرنى ئىز قوغلاڭ.

يوشۇرۇن خېرىدار توپلاش (جەدۋەل يوللاش)

ئىشلەتكۈچى ئالاقىلىشىش جەدۋىلىنى مۇۋەپپەقىيەتلىك يوللىغاندا ياكى باھا سورىغاندا بۇ ھادىسىنى قوزغىتىڭ.

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

خاس UI ئۆزئارا ھەرىكىتى

ئىشلەتكۈچىلەرنىڭ ھېسابلىغۇچ، كۆزنەك ياكى بەتكۈچ ئالماشتۇرغۇچقا ئوخشاش مۇرەككەپ ئېلېمېنتلار بىلەن قانداق ھەرىكەت قىلىدىغانلىقىنى چۈشىنىڭ.

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

6. پارامېتىر چەكلىرى ۋە كۆرسەتمىلەر

سانلىق مەلۇمات تىپى: MousePlayer پارامېتىر تىپلىرىنى ئاپتوماتىك بايقايدۇ. باشقۇرۇش تاختىسىدا ئىلغار سانلىق سۈزۈش (مەسىلەن «باھا > 100») ئىشلىتىش ئۈچۈن، سانلارنى پۈتۈن ياكى كەسىر سان قىلىپ ئەۋەتىڭ (مەسىلەن 150.00، "150.00" ئەمەس).

قائىدە چۈشەندۈرۈش
ھادىسە نامىنىڭ ئۇزۇنلۇقى ئەڭ كۆپ 128 ھەرپ. ئەڭ ئوقۇشلۇق بولۇشى ئۈچۈن snake_case ئىشلىتىڭ (مەسىلەن user_signup).
پارامېتىر ئاچقۇچىنىڭ ئۇزۇنلۇقى ھەر ئاچقۇچ نامى ئەڭ كۆپ 64 ھەرپ (مەسىلەن transaction_id).
ھەرپ تىزمىسى قىممەتلىرى سانداننىڭ ئەڭ ياخشى ئىقتىدارىغا كاپالەتلىك قىلىش ئۈچۈن تېكىست پارامېتىرلىرى 255 ھەرپكە قىسقارتىلىدۇ.
سانلىق مەلۇمات مەخپىيەتلىكى خام خەت ئادرېسى، ھەقىقىي ئىسىم ياكى پارولغا ئوخشاش شەخسنى تونۇغىلى بولىدىغان ئۇچۇر (PII) نى ھادىسە پارامېتىرى قىلىپ ئەۋەتمەڭ .