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. ብሕታዊ ፍጻመታት

እትሰድዱዎም ፍጻመታት ኣብ መስመር ግዜ ቅዳሕ ይርኣዩ፣ ዕላማታትን ስጉምትታት ፈነልን ክኾኑ ይኽእሉ፣ ናብ webhooksኩምን ዝተኣሳሰሩ መሳርሒታትን ድማ ይኸዱ። መለክዒታት ሓጸርቲ ዋጋታት እዮም፣ ቁጽርታት፣ ክሳዕ 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;