Moments
JS SDK (for Websites)

Presentation Options

AdsPostX is now MomentScience! 🎉

We have rebranded AdsPostX to MomentScience. All the latest documentation and updates can now be found at MomentScience Documentation.

Introduction

When adding a Moments Offer Unit placement to your website via the JS SDK, AdsPostX offers multiple presentation solution options. The following documentation aims to walk you through the options available and how to configure your AdsPostX implementation either via runtime code or configuration settings available in the AdsPostX Dashboard.

Available Options

Modal Popup Standard Offer Unit (SOU)

The Modal Popup Standard Offer Unit (SOU) features showing one Offer at a time in a carousel modal popup. Users can engage with each Offer by selecting the positive or negative call-to-action (CTA) buttons.

  • User Interaction:
    • If users click the positive call-to-action button ("Try out AdsPostX!") or the negative call-to-action button ("No, Thanks"), the Offer Unit will display the next Offer.
    • If the user clicks on the positive call-to-action button, the Offer will open in a new tab.
    • Users can navigate through the remaining Offers or go back to a previous Offer using carousel controls.
  • Modal Popup Dismissal:
    • If users click the negative call-to-action on the last Offer or close the popup using the 'x' button, the Modal Popup will be dismissed, and the user will resume their original experience.
SOU Model Example
SOU Model Example


Multi Offer Unit (MOU)

The Multi Offer Unit (MOU) presents a different approach, displaying all available Offers simultaneously in a tile format. Users can consider multiple Offers at once. The MOU Offers a tile-based view where each tile represents a distinct Offer.

MOU Model Example
MOU Model Example


Implementation Options

To configure your implementation with the MOU style, you have two options:

  1. Using The AdsPostX Dashboard Configuration Settings
  2. Using Code Snippet Modification

AdsPostX Dashboard Configuration Settings

  1. Login to your AdsPostX dashboard.
  2. Go to Settings => Configuration.
  3. Under the Configuration section, find "Show Multi Offer Unit."
  4. Toggle the setting to activate the Multi Offer Unit and press "Save Configuration."





Code Snippet Modification

  1. Locate where window.AdpxConfig is defined in the code snippet.
  2. Modify it to include the settings object with the multi_offer_unit parameter set to true.
Enabling Multi Offer Units Using Code


Embedded AdsPostX Unit

The Moments Offer Unit, either in Standard Offer Unit (SOU) or Multi Offer Unit (MOU) style, can be embedded into your webpage rather than appearing as a modal popup. This Offers a more user-friendly experience.

Embedded SOU Example
Embedded MOU Example
Embedded SOU Example
Embedded SOU Example


Embedded Implementation

To embed your Moments Offer Unit, follow these steps:

Step 1: Add Configuration Settings Attribute

The first step in the embedding process is to add the configuration settings attribute to the initialization options

  1. Locate where window.AdpxConfig is defined in the code snippet.
  2. Modify it to include the settingsobject with the embedded parameter and its related sub-parameters.

The embedded setting parameters Offer customization options, providing control over the presence of the Offer Unit's border, header, and footer. Integrate the Offers Unit into your webpage. Adjust the configuration to suit your design preferences.

Setting

Description

Default

enabled

Determines whether the unit will be embedded.

  • When set to true, the unit will be embedded into the div element with id=targetElement.
  • When set to false, the unit will be presented as a modal popup.

false

showBorder

Determines whether the border of the embedded unit will be displayed.

  • When set to true, the border will be displayed.
  • When set to false, the border will not be displayed

true

showHeader

Determines whether the header of the embedded unit will be displayed.

  • When set to true, the header will be displayed.
  • When set to false, the header will not be displayed.

true

showFooter

Determines whether the footer of the embedded unit will be displayed.

  • When set to true, the footer will be displayed.
  • When set to false, the footer will not be displayed.

true

targetElement

Determines where the embedded unit will be placed on your website. AdsPostX will trigger to display in the div element with id=targetElement when it detects the existence of the div element.

  • If this parameter is missing or set to null, AdsPostX defaults to the value 'adpx'.

'adpx'

Add Embedded Parameters


Step 2: Embedding the div unit

Now, include the div unit with id=targetElement for AdsPostX to embed into. AdsPostX will trigger itself to display once it detects a div element with id=targetElement.

HTML


Anatomy of the AdsPostX Offer Unit

The embeddedsetting parameter includes optional sub-parameters that control the presence of the Offer Unit's Border, Header, or Footer.



Document image




A: Border - The border of the Offer Unit

B: Header - The header of the Offer Unit

C: Footer - The footer of the Offer Unit



📢 If you're running into any issues while going through the integration process, feel free to contact us at [email protected].