JavaScript API

mp.js က ကိုယ်ပိုင်ကုဒ်အတွက် ပေးသည့်အရာအားလုံး: သဘောတူညီချက်၊ ဖောက်သည် ID၊ စိတ်ကြိုက်ဖြစ်ရပ်၊ လိပ်စာမပြောင်းသောအဆင့်၊ ချိတ်ဆက်မှတ်နှင့် HTML ဂုဏ်သတ္တိများ။ ဤနေရာရှိ ဘာမျှမဖြစ်မနေ မလိုပါ - ကုဒ်အပိုင်းတစ်ခုတည်းက မှတ်တမ်းတင်သည်။

1. ခေါ်ဆိုရန် နည်းနှစ်မျိုး

mp.js သည် အချိန်မတူညီစွာတင်သည်။ မတင်ပြီးမီ လုပ်သောကုဒ်က ခေါ်ဆိုမှုများကို အောက်ပါတန်းစီစာရင်းထဲ ထည့်သည်: window.mp_q။ mp.js ရောက်သည်နှင့် အစဉ်လိုက်လုပ်သည်။ ထို့နောက် တူညီလုပ်ဆောင်ချက်များ ရနိုင်သည့်နေရာမှာ window.MousePlayerဖြစ်သည်။

// Before mp.js has loaded - the queue keeps every call: (window.mp_q = window.mp_q || []).push(['consent', true]); // After mp.js has loaded - the same, directly: MousePlayer.setConsent(true);

အမြဲရေးပါ: window.mp_q = window.mp_q || []၊ အောက်ပါပုံစံ လုံးဝမရေးပါနှင့်: window.mp_q = []။ mp.js က ထိုအာရေးကို ဆက်နားထောင်သည် - အသစ်တစ်ခုက နောက်ခေါ်ဆိုမှုတိုင်းနှင့် သဘောတူညီချက်ရုပ်သိမ်းမှုပါ ပျောက်စေမည်။

ထည့်သွင်းကုဒ်အပိုင်းက ယာယီလုပ်ဆောင်ချက်လည်း သတ်မှတ်သည်၊ ၎င်းမှာ mp(...) ဖြစ်ပြီး အလားတူတန်းစီပေးသည်။ ပုံစံနှစ်ခုလုံးက တူညီအမိန့်များ ယူသည်: consent၊ set၊ event၊ step၊ get၊ on နှင့် off။

2. သဘောတူညီချက်

သဘောတူညီချက်မရှိဘဲ ဘာမျှမမှတ်တမ်းတင်ပါ။ သဘောတူညီချက်ကိရိယာကို MousePlayer သိရှိပါက ဤအရာများမလိုပါ။ မသိပါက ဆုံးဖြတ်ချက်ကို ကိုယ်တိုင်ပို့ပါ။

MousePlayer.setConsent(true); // the visitor agreed MousePlayer.setConsent(false); // withdrawn: recording stops on this page MousePlayer.getConsentState(); // e.g. 'WAITING', 'GRANTED', 'GRANTED_LATE', 'DENIED', 'WITHDRAWN'

ရုပ်သိမ်းမှုသည် စာမျက်နှာပေါ်တွင် ချက်ချင်းသက်ရောက်သည်: listener များဖယ်ရှား၊ ကြားခံဒေတာပယ်၊ ချိတ်ဆက်မှုပိတ်သည်။ ကြည့်ပါ: MousePlayer နှင့် သဘောတူညီချက်။

3. ကိုယ်ပိုင်ဖောက်သည် ID

ကိုယ်ပိုင် ID ဖြင့် လူတစ်ဦး၏စက်အားလုံးသည် စာရင်းတွင် ဧည့်သည်တစ်ဦးဖြစ်လာပြီး သိသောနံပါတ်ဖြင့် အကူအညီကိစ္စ ရှာနိုင်သည်။ ID ကို လွန်ခဲ့သော 30 ရက်အတွင်း တူညီဘရောက်ဇာ၏ ယခင်ဝင်ကြည့်မှုများအတွက်လည်း သုံးသည်။

// After login - your own customer number, not an e-mail address: MousePlayer.setUserId('customer-4711'); // or through the queue (window.mp_q = window.mp_q || []).push(['set', 'user_id', 'customer-4711']);

အီးမေးလ် သို့မဟုတ် အမည်အစား အတွင်းနံပါတ် သုံးပါ။ ဧည့်သည်ပေါ်ရာနေရာတိုင်းတွင် MousePlayer က ID ပြသည်။

ID များ ပြန်ဖတ်ခြင်း

MousePlayer.getSessionUrl(); // replay link of the running session MousePlayer.getSessionId(); MousePlayer.getVisitorId(); // null without consent // Through the queue, with a callback: (window.mp_q = window.mp_q || []).push(['get', 'session_url', function (url) { // e.g. attach it to a support ticket }]);

4. စိတ်ကြိုက်ဖြစ်ရပ်များ

ပို့သောဖြစ်ရပ်များသည် ပြန်ဖွင့်အချိန်လိုင်းတွင် ပေါ်ပြီး ပန်းတိုင်နှင့် ဖန်နယ်အဆင့် ဖြစ်နိုင်ကာ webhook နှင့် ချိတ်ကိရိယာများသို့ သွားသည်။ ပါရာမီတာများသည် တိုသောတန်ဖိုးဖြစ်သည်: ဂဏန်း၊ အက္ခရာ 255 လုံးအထိစာသား၊ အက္ခရာ 64 လုံးအထိသော့များ။

MousePlayer.trackEvent('newsletter_signup', { source: 'footer' }); MousePlayer.trackEvent('purchase', { value: 129.90, currency: 'EUR' }); (window.mp_q = window.mp_q || []).push(['event', 'add_to_cart', { sku: 'SKU-123' }]);
  • အမည်များ: အောက်မျဉ်းပါသော စာလုံးအသေး၊ အများဆုံး အက္ခရာ 128 လုံး။ နေရာတိုင်း အရာတူအတွက် အမည်တူသုံးပါ - ပန်းတိုင်က အမည်ကို အတိအကျကိုက်ညီစေသည်။
  • ပါရာမီတာထဲ ကိုယ်ရေးဒေတာ မထည့်ပါနှင့်။ အခြားဖြစ်ရပ်ကဲ့သို့ပင် သိမ်းဆည်းပြသသည်။

5. လိပ်စာမပြောင်းသောအဆင့်များ

မျက်နှာပြင်ပြောင်းသော်လည်း လိပ်စာမပြောင်းသော ငွေရှင်းမှု သို့မဟုတ် အဆင့်ဆင့်လမ်းညွှန်သည် MousePlayer အတွက် စာမျက်နှာတစ်ခုဖြစ်သည်။ step() က မျက်နှာပြင်တစ်ခုစီကို ကိုယ်ပိုင်စာမျက်နှာကြည့်မှု ဖြစ်စေသည် - ကိုယ်ပိုင်ပုံရိပ်၊ အပူပြမြေပုံအတန်းနှင့် ဖန်နယ်အဆင့် ပါသည်။

// A wizard that keeps its address: MousePlayer.step('shipping'); MousePlayer.step('payment'); MousePlayer.step(''); // back to the page itself (window.mp_q = window.mp_q || []).push(['step', 'payment']);

အမည်သည် a-z, 0-9, _ နှင့် - တို့မှ အက္ခရာ 1 မှ 40 အထိဖြစ်သည်။ နေရာလွတ်ကို မျဉ်းတိုပြောင်းပြီး အခြားအရာအားလုံးကို ကွန်ဆိုးလ်သတိပေးချက်ဖြင့် ငြင်းပယ်သည်။ တကယ့်သွားလာမှုက အဆင့်ကို အဆုံးသတ်သည်။

6. ကုန်ပစ္စည်းအကြောင်းအရာ

ကုန်ပစ္စည်းစာမျက်နှာပေါ်တွင် ဘာကြည့်နေသည်ကို MousePlayer ထံ ပြောပါ။ ဤသော့များသာ လက်ခံပြီး ဖောက်သည်ဒေတာ မတော်တဆမဝင်စေရန် အခြားအားလုံးပယ်သည်။

MousePlayer.setContext({ page_type: 'product', product_id: 'SKU-123', variant_id: 'SKU-123-42', price: 89.90, currency: 'EUR', category: 'running-shoes', in_stock: true, cart_value: 0, cart_items: 0 });

7. ချိတ်ဆက်မှတ်များ

ကုဒ်က MousePlayer စာမျက်နှာပေါ် တိုင်းတာချက်ကို တုံ့ပြန်နိုင်သည်။ ပထမအချိန်မလွတ်ရပါက တန်းစီစာရင်းမှ မှတ်ပုံတင်ပါ။

// Register early - exit_risk fires once, a few seconds after the visit starts: (window.mp_q = window.mp_q || []).push(['on', 'exit_risk', function (e) { console.log(e.risk, e.reasons, e.session); }]); function onAnswer(e) { /* e.survey, e.value, e.sentiment */ } MousePlayer.on('survey_answer', onAnswer); MousePlayer.off('survey_answer', onAnswer);
အမည်အချိန်အကွက်များ
exit_riskထွက်ခွာမော်ဒယ်က ပထမစာမျက်နှာကြည့်မှု ရမှတ်ပေးပြီး (ဝင်ကြည့်မှုတစ်ကြိမ်လျှင် တစ်ကြိမ်)risk, reasons, session
churn_riskပြန်လာဧည့်သည်ကို ပြန်မလာတော့နိုင်ခြေရှိဟု မှတ်သားသည်risk, reasons, session
offer_shownထွက်ခွာကမ်းလှမ်းချက် ပြသည်art, risk, grund, session
offer_click၎င်းခလုတ်ကို နှိပ်သည်art, risk, grund, session, fehler
offer_dismiss၎င်းကို ပိတ်သည်art, risk, grund, session
survey_shownစစ်တမ်း ဖွင့်သည်survey, trigger, session
survey_answerဧည့်သည်က ဖြေသည်survey, type, value, option, sentiment, session
survey_textနောက်ဆက်တွဲစာသား ပို့သည် (စစ်ထုတ်ပြီးဖြစ်သည်)survey, text, session
survey_dismissအဖြေမပေးဘဲ စစ်တမ်းပိတ်သည်survey, step, session

GTM တံတားဖွင့်ထားပါက တူညီဖြစ်ရပ်များသည် dataLayer ထဲလည်း သွားသည် (mp_exit_risk နှင့် အလားတူများ)။ MousePlayer.exitRisk() သည် လက်ရှိထွက်ခွာနိုင်ခြေကို ပြန်ပေးသည်၊ မသိသေးမီ null ဖြစ်သည်။

8. HTML ဂုဏ်သတ္တိများ

<!-- Nothing typed in here leaves the browser as text --> <section data-mp-mask> ... </section> <!-- The value of this field is never recorded --> <input name="voucher" data-mp-ignore> <!-- Tell MousePlayer what an element is --> <span class="amount" data-mp-role="price">89,90 EUR</span>
  • data-mp-mask (သို့မဟုတ် အတန်း mp-masked): အစိတ်အပိုင်းအတွင်း စာသားနှင့် ထည့်သွင်းချက်ကို ဘရောက်ဇာမှမထွက်မီ အစားထိုးသည် - ပုံရိပ်၊ ပြောင်းလဲမှုနှင့် ကလစ်ဖော်ပြချက်များတွင် ဖြစ်သည်။
  • data-mp-ignore (သို့မဟုတ် mp-ignore) ကို ဖောင်အကွက်၌သုံးပါက ၎င်းတန်ဖိုးကို လုံးဝမမှတ်တမ်းတင်ပါ။
  • data-mp-role: price, price_old, cta_cart, cta_checkout, product_image, variant, shipping_info, returns_info, reviews, rating, stock, coupon, payment_methods, search, filter, heading, article_body, nav, media, form_field, contact_info တို့မှ တစ်ခု။ အခြားတန်ဖိုးများကို လျစ်လျူရှုသည်။

9. ကိုယ်ပိုင်ဝင်ကြည့်မှုများ ဖယ်ထုတ်ခြင်း

ဝဘ်ဆိုက်ကို တစ်ကြိမ်ဖွင့်ရာတွင် ထည့်ပါ: ?mp_exclude=1 ၊ ထို့နောက် ဤဘရောက်ဇာကို ဆက်မမှတ်တမ်းတင်တော့ပါ။ ?mp_exclude=0 က ပြန်ဖျက်ပေးသည်။ ရုံးကွန်ရက်တစ်ခုလုံးအတွက် ပရောဂျက်သတ်မှတ်ချက်များတွင် IP လိပ်စာများ အစားထိုးထည့်ပါ။

https://www.your-shop.com/?mp_exclude=1 <!-- this browser is not recorded any more --> https://www.your-shop.com/?mp_exclude=0 <!-- recorded again -->

10. ကိုယ်ရေးလုံခြုံမှုမူဝါဒအတွက် လင့်ခ်

ဧည့်သည်များသည် ၎င်းတို့အကြောင်း မှတ်တမ်းတင်ထားသည်ကို ကြည့်၍ ဖျက်နိုင်သည်။ privacyUrl() က ဤဘရောက်ဇာ ID ပါသော အသင့်လင့်ခ် ပြန်ပေးသည် - မရှိပါက null ဖြစ်သည်၊ သဘောတူညီချက်မရှိဘဲ ဘာမျှမမှတ်တမ်းတင်သောကြောင့်ဖြစ်သည်။

var link = MousePlayer.privacyUrl(); // language from <html lang>, or e.g. privacyUrl('de') if (link) document.getElementById('my-data').href = link;