የ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፣ የአንድ ሰው ሁሉም መሣሪያዎች በዝርዝሮቹ አንድ ጎብኚ ይሆናሉ፣ የሚያውቁትንም ቁጥር በመጠቀም የድጋፍ ጉዳይ መፈለግ ይችላሉ። 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. ብጁ ክስተቶች

የሚልኳቸው ክስተቶች በቀረጻው የጊዜ መስመር ይታያሉ፣ ግቦች እና የፋነል እርምጃዎች ሊሆኑ ይችላሉ፣ ወደ ዌብሁኮችዎ እና የተገናኙ መሣሪያዎችም ይሄዳሉ። መለኪያዎች አጭር እሴቶች ናቸው፦ ቁጥሮች፣ እስከ 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 የያዘ ዝግጁ አገናኝ ይመልሳል፣ ወይም ከሌለ null፤ ያለ ፈቃድ ምንም ስላልተቀረጸ።

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