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'

திரும்பப்பெறுதல் பக்கத்தில் உடனடியாகச் செயல்படும்: நிகழ்வுக் கேட்பிகள் அகற்றப்படும், இடையகத் தரவு கைவிடப்படும், இணைப்பு மூடப்படும். பார்க்க: MousePlayer மற்றும் ஒப்புதல்.

3. உங்கள் வாடிக்கையாளர் ID

உங்கள் சொந்த ID மூலம், ஒரே நபரின் எல்லாச் சாதனங்களும் பட்டியல்களில் ஒரே பார்வையாளராக இணைகின்றன. உங்களுக்குத் தெரிந்த எண்ணால் ஆதரவு விவகாரத்தைத் தேடலாம். அதே உலாவியின் கடந்த 30 நாட்களுக்கான முந்தைய வருகைகளுக்கும் ID பயன்படுத்தப்படும்.

// 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. தனிப்பயன் நிகழ்வுகள்

நீங்கள் அனுப்பும் நிகழ்வுகள் பதிவின் காலவரிசையில் தோன்றும்; இலக்குகளாகவும் ஃபனல் படிகளாகவும் அமையலாம்; உங்கள் வெப்ஹுக்குகளுக்கும் இணைக்கப்பட்ட கருவிகளுக்கும் செல்லும். அளவுருக்கள் குறுகிய மதிப்புகள்: எண்கள், 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']);

பெயர் 1 முதல் 40 எழுத்துகள் வரை இருக்கலாம்; அனுமதிக்கப்பட்டவை a-z, 0-9, _ மற்றும் -. இடைவெளிகள் இணைப்புக்கோடுகளாக மாறும்; மற்றவை பணியக எச்சரிக்கையுடன் நிராகரிக்கப்படும். உண்மையான பக்க வழிசெலுத்தல் படியை முடிக்கும்.

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 உடனான தயாரான இணைப்பை வழங்கும். ID இல்லையெனில் null வழங்கும்; ஒப்புதல் இல்லாததால் எதுவும் பதிவாகியிருக்காது.

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