Solutions
...
JavaScript SDK Guide
Presentation Options
18 min
overview momentscience offers multiple presentation options for displaying offer units on your website this guide explains the available display formats and provides implementation instructions for each option what you'll learn how to implement the standard offer unit (sou), a single offer modal popup how to enable the multi offer unit (mou), a grid based layout showing multiple offers how to embed momentscience offers directly into your webpage how to customize presentation settings via dashboard or code presentation types momentscience offers three main presentation options to match your website design and user experience requirements format description /#standard offer unit sou a carousel style modal popup displaying one offer at a time best for keeping users focused presentation options /#multi offer unit mou a responsive grid based layout showing all available offers simultaneously ideal for letting users compare and choose presentation options /#embedded offer unit offers are placed inline within a specific section of your webpage for a seamless experience standard offer unit (sou) the standard offer unit displays one offer at a time in a modal popup overlay with carousel navigation it is ideal when you want to draw attention to individual offers without overwhelming the user when triggered, the sou appears as a modal popup overlay on your webpage users see one offer at a time in a carousel format users can engage with each offer by selecting positive or negative call to action (cta) buttons clicking the positive cta opens the offer in a new tab and advances to the next offer clicking the negative cta advances to the next offer without claiming users can navigate between offers using carousel controls the modal dismisses when users click the close button or reject the final offer enabling sou via dashboard sou is enabled by default unless the multi offer unit setting is turned on to confirm sou is active log in to your momentscience dashboard https //app momentscience com navigate to settings > configuration ensure βshow multi offer unitβ is disabled click save configuration if any changes are made enabling sou via code if you configure presentation options manually in code, make sure multi offer unit is set to false window\ adpxconfig = { accountid 'your sdk id', autoshow true, settings { multi offer unit false } }; multi offer unit (mou) the multi offer unit presents all available offers at once in a responsive grid layout it allows users to see multiple offers and choose whatβs most relevant when triggered, the mou appears displaying all available offers in a grid layout each offer appears as a tile with its own creative and call to action clicking a cta opens the selected offer in a new tab enabling mou via dashboard log in to your momentscience dashboard https //app momentscience com navigate to settings > configuration enable βshow multi offer unitβ click save configuration enabling mou via code locate where window\ adpxconfig is defined in the code snippet modify it to include the settings object with the multi offer unit parameter set to true window\ adpxconfig = { accountid 'your sdk id', autoshow true, settings { multi offer unit true } }; embedded offer unit both the standard offer unit and multi offer unit can be embedded directly into your webpage instead of appearing as a modal popup this provides a more integrated user experience enabling embedded mode via dashboard log in to your momentscience dashboard https //app momentscience com navigate to integration > moments click on the theme settings tab find the "embedded mode" setting and toggle it on configure the additional embedded settings that appear target element selector specify the html element id where the unit will be embedded (e g , #adpx ) show header toggle to control header visibility show footer toggle to control footer visibility fill container enable to make the unit expand to fill the container height show border toggle to control border visibility click save to apply your changes enabling embedded mode via code you can enable embedded mode by adding the embedded configuration inside the settings object in your window\ adpxconfig this ensures the sdk applies the correct rendering mode window\ adpxconfig = { accountid 'your sdk id', autoshow true, settings { embedded { enabled true, showborder true, showheader true, showfooter true, targetelement 'adpx', fill container true } } }; add a \<div> element where you want the offer unit to appear make sure the id matches the value of targetelement in the configuration ensure the targetelement id in your embedded configuration matches the html container id on your page configuration options the embedded settings provide several customization options parameter type default description enabled boolean false when true , embeds the offer unit in the specified container element fill container boolean false when true , the unit occupies the full height of its parent container showborder boolean true controls the visibility of the unit's border showheader boolean true controls the visibility of the unit's header showfooter boolean true controls the visibility of the unit's footer targetelement string 'adpx' id of the html element where the offer unit will be embedded next steps youβve configured the presentation options for your moments offer unit as the next step, you can customize the user experience to better match your brand and product flow docid\ bcirtahusxtymplxd4mgj use the javascript sdk customization guideto control when offers appear, override styles, configure embedded mode, and track lifecycle events programmatically docid 6pqgxne5kwhdkuyawcvw1 use the momentscience theme customizerto style offer units, adjust layouts, and preview changes instantly, no coding required for assistance with presentation options, contact help\@momentscience com