APIs Documentation

Moments API

17min

Overview
The Moments API makes it easy to integrate MomentScience Offers into your app or website. It works with any programming language that can make RESTful API calls.
<iframe style="border:none" width="800" height="450" src="https://whimsical.com/embed/DDn5gm6ic6xqWZotWET6fo"></iframe>
<iframe style="border:none" width="800" height="450" src="https://whimsical.com/embed/DDn5gm6ic6xqWZotWET6fo"></iframe>
﻿
 Pre-requisites 
Before fetching and serving offers, follow these steps:
Obtain Your API Key: Get your API key from the MomentScience dashboard. This key is required to authenticate all requests to the Moments API.Learn how to get your API key﻿ 
Try It Out 
Try our Moments API live now and experience the response in real time! Test it below to see how it works and explore the data it returns.
<iframe src="https://hopp.sh/e/G3RrLqRXm6Qz" title="Hoppscotch Embed" style="width: 100%; height: 480px; border-radius: 4px; border: 1px solid rgba(0, 0, 0, 0.1);"></iframe>
<iframe src="https://hopp.sh/e/G3RrLqRXm6Qz" title="Hoppscotch Embed" style="width: 100%; height: 480px; border-radius: 4px; border: 1px solid rgba(0, 0, 0, 0.1);"></iframe>
﻿
Fetch Offers
Method: POST
Base URL: https://api.adspostx.com/native/v2/offers.json
Header Parameters
Parameter
Description
Type
Example
Content-Type
Required﻿
Should be application/json
string
application/json
Query Parameters
Parameter
Description
Type
Example
api_key
Required﻿
Your API Key. 
Obtain your API Key﻿
Required Permission: Ads/Offers
string
4bbdefc2-b130-424d-8170-54bdcb98e64e
loyaltyboost
Optional
Include LoyaltyBoost offers in response; 
Values: 
0 = None
1 = True
2 = Only
string 
0|1|2
creative
Optional
Returns Offers with at least one creative (image) if set to true. 
string
0|1
campaignId
Optional
Filters the response to return the single offer associated with the specified campaignId
Only one campaign ID can be used per request. 
string 
3110
Body Parameters
Parameter
Description
Type
Example
ua
Recommended﻿
The User-Agent of the end-user required for proper targeting. If proxying requests via a server call, be sure to pass through the User-Agent of the end-user. 
string
Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.43 Mobile Safari/537.36
placement
Highly Recommended﻿
﻿
A highly encouraged attribute that represents the specific page, section, or location where the Offer Unit was triggered 
This parameter enables enhanced reporting, analytics, and traffic segmentation.
string
checkout_confirmation_page
ip
Recommended﻿
IP address of the end user to be passed through. Used for targeting. 
string
﻿
adpx_fp
Recommended﻿
A unique identifier for the end user; Not required but highly recommended.  More information can be found below.
string
1234abcd-5678-efgh-9101-ijklmnopqrst
pub_user_id 
Required when integrating with PerksWallet-as-a-Service (PWaaS) or User Selected Perks﻿
A unique, non-PII identifier for the end user. This value links offers to individual users and must remain consistent across sessions and devices.
You may use the same value as adpx_fp, if available.
Do not use personally identifiable information (PII), such as email addresses or phone numbers.
You can generate this identifier using any method, as long as it guarantees uniqueness per user.
string
1234abcd-5678-efgh-9101-ijklmnopqrst
dev
Optional
Returns a test response. Ignores geo restrictions. No activity is recorded. 
string
0|1
<string>
Optional
Custom Key-Value payload attributes. You can add any number of custom key-value payload attributes to the payload that you want to use to add additional details. 

All payload attributes are passed back on conversion reports and can be reported on in relation to impression and clicks. 
string
membershipID: "A45GRE987343PKD"
The adpx_fpattribute in the body of the Fetch Offers call is a special parameter that aids in overall Offer performance.  It should be populated with a unique end-user identifier as an alpha-numeric string.

MomentScience uses the adpx_fpvalue to frequency cap Offers on a unique user basis as well as exclude Offers from showing again when a user opts-out for a certain Offer. 
Note that the number of Offers is controlled by the Configuration Settings in your publisher dashboard.  Log into your dashboard, click on Settings -> Configuration from the side menu and then select the number of Offers you would like to have returned.
The Response Body
Upon a successful response from the Fetch Offers API request, the body of the reponse will include a data object that contains an array of objects that can be used to construct your Offers. 
Sample Response
Response Example
{
    "data": {
        "offers": [
            {
                "id": 4359,
                "campaign_id": 2282,
                "title": "You Unlocked MomentScience For 90 Days - Free!",
                "description": "MomentScience lets you capture revenue across your user's moments. Delight your users with relevant Offers at the right time. Get 3 months free!",
                "click_url": "https://trk.pubtailer.com/sdk/offer-click?o_id=4359&c_id=1649&p_id=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e",
                "image": "https://adpx.b-cdn.net/campaigns/1649/62a98d93af4e12a3dbbcf247172fadce.png",
                "mini_text": "Enjoy MomentScience Free Trail",
                "terms_and_conditions": "<ul>\n <li>Must be 18 or older.</li>\n  <li>Cancel anytime, subject to terms.</li>\n  <li>Terms apply.</li>\n</ul>",
                "pixel": "https://trk.pubtailer.com/sdk/v2/impression/p.png?o_id=4359&c_id=1649&p_id=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e&cbuster=%7BCBUSTER%7D",
                "cta_yes": "Try out MomentScience!",
                "cta_no": "No, Thanks",
                "useraction_cta": "",
                "useraction_url": "",
                "adv_pixel_url": "",
                "beacons": {
                    "close": "https://trk.pubtailer.com/event/record/close?oid=4359&cid=1649&pid=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e",
                    "no_thanks_click": "https://trk.pubtailer.com/event/record/no_thanks_click?oid=4359&cid=1649&pid=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e"
                },
                "creatives": [
                    {
                        "id": 1436,
                        "url": "https://adpx.b-cdn.net/campaigns/1649/62a98d93af4e12a3dbbcf247172fadce.png",
                        "height": 1530,
                        "width": 1530,
                        "type": "png",
                        "is_primary": true,
                        "aspect_ratio": 1
                    }
                ],
                "offerwall_enabled": true,
                "perkswallet_enabled": false,
                "short_description": "Capture revenue across your user's moments. Get 3 months free!",
                "short_headline": "3 Free Months of MomentScience!",
                "advertiser_name": "MomentScience",
                "is_loyaltyboost": false,
                "loyaltyboost_requirements": "",
                "loyaltyboost_requirements": "",
                "save_for_later_url": "https://api.perkswallet.com/pwaas/save.json?o_id=5738&c_id=3042&p_id=3065&sess_id=b779feeec95272cae3cc3c8fb0f0f1aeff20c12d&pub_user_id=pktw2",
                "offerwall_url": "https://get.perkswall.com/offerwall?accountId=fbe15a0c6f803ef4&offer_count=3&auto_show=1&show_logo=1&show_header=1&show_shadow=0&show_image=1&font_family=Open+Sans&session_id=95868dc0306887060b991e555c8f5057a6b619b0&c_id=2282"
                "qr_code_img": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIQAAACEC..."
            },
            {
                "id": 4586,
                "campaign_id": 2396,
                "title": "You Unlocked MomentScience For 90 Days - Free!",
                "description": "MomentScience lets you capture revenue across your user's moments. Delight your users with relevant Offers at the right time. Get 3 months free!",
                "click_url": "https://trk.pubtailer.com/sdk/offer-click?o_id=4586&c_id=1879&p_id=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e",
                "image": "https://adpx.b-cdn.net/campaigns/1879/d93fbd2662b784b655d430c9ce3789e4.png",
                "mini_text": "",
                "pixel": "https://trk.pubtailer.com/sdk/v2/impression/p.png?o_id=4586&c_id=1879&p_id=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e&cbuster=%7BCBUSTER%7D",
                "cta_yes": "Earn 150 Points",
                "cta_no": "No, Thanks",
                "useraction_cta": "",
                "useraction_url": "",
                "adv_pixel_url": "",
                "beacons": {
                    "close": "https://trk.pubtailer.com/event/record/close?oid=4586&cid=1879&pid=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e",
                    "no_thanks_click": "https://trk.pubtailer.com/event/record/no_thanks_click?oid=4586&cid=1879&pid=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e"
                },
                "creatives": [
                    {
                        "id": 1769,
                        "url": "https://adpx.b-cdn.net/campaigns/1879/d93fbd2662b784b655d430c9ce3789e4.png",
                        "height": 1530,
                        "width": 1530,
                        "type": "png",
                        "is_primary": true,
                        "aspect_ratio": 1
                    }
                ],
                "offerwall_enabled": true,
                "perkswallet_enabled": false,
                "short_description": "Capture revenue across your user's moments. Get 3 months free!",
                "short_headline": "3 Free Months of MomentScience!",
                "advertiser_name": "MomentScience",
                "is_loyaltyboost": true,
                "loyaltyboost_requirements": "User must finish integrating MomentScience to qualify. You must click “Allow” if tracking permission is requested within the app.""offerwall_url": "https://get.perkswall.com/offerwall?accountId=fbe15a0c6f803ef4&offer_count=3&auto_show=1&show_logo=1&show_header=1&show_shadow=0&show_image=1&font_family=Open+Sans&session_id=95868dc0306887060b991e555c8f5057a6b619b0&c_id=2396"
                "save_for_later_url": "https://api.perkswallet.com/pwaas/save.json?o_id=5738&c_id=3042&p_id=3065&sess_id=b779feeec95272cae3cc3c8fb0f0f1aeff20c12d&pub_user_id=pktw2",
                "offerwall_url": "https://get.perkswall.com/offerwall?accountId=fbe15a0c6f803ef4&offer_count=3&auto_show=1&show_logo=1&show_header=1&show_shadow=0&show_image=1&font_family=Open+Sans&session_id=95868dc0306887060b991e555c8f5057a6b619b0&c_id=2282"
                "qr_code_img": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIQAAACEC..."
            }
        ],
        "count": 2,
        "privacy_url": "https://www.momentscience.com/privacy-policy"
    }
}
{
    "data": {
        "offers": [
            {
                "id": 4359,
                "campaign_id": 2282,
                "title": "You Unlocked MomentScience For 90 Days - Free!",
                "description": "MomentScience lets you capture revenue across your user's moments. Delight your users with relevant Offers at the right time. Get 3 months free!",
                "click_url": "https://trk.pubtailer.com/sdk/offer-click?o_id=4359&c_id=1649&p_id=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e",
                "image": "https://adpx.b-cdn.net/campaigns/1649/62a98d93af4e12a3dbbcf247172fadce.png",
                "mini_text": "Enjoy MomentScience Free Trail",
                "terms_and_conditions": "<ul>\n <li>Must be 18 or older.</li>\n  <li>Cancel anytime, subject to terms.</li>\n  <li>Terms apply.</li>\n</ul>",
                "pixel": "https://trk.pubtailer.com/sdk/v2/impression/p.png?o_id=4359&c_id=1649&p_id=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e&cbuster=%7BCBUSTER%7D",
                "cta_yes": "Try out MomentScience!",
                "cta_no": "No, Thanks",
                "useraction_cta": "",
                "useraction_url": "",
                "adv_pixel_url": "",
                "beacons": {
                    "close": "https://trk.pubtailer.com/event/record/close?oid=4359&cid=1649&pid=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e",
                    "no_thanks_click": "https://trk.pubtailer.com/event/record/no_thanks_click?oid=4359&cid=1649&pid=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e"
                },
                "creatives": [
                    {
                        "id": 1436,
                        "url": "https://adpx.b-cdn.net/campaigns/1649/62a98d93af4e12a3dbbcf247172fadce.png",
                        "height": 1530,
                        "width": 1530,
                        "type": "png",
                        "is_primary": true,
                        "aspect_ratio": 1
                    }
                ],
                "offerwall_enabled": true,
                "perkswallet_enabled": false,
                "short_description": "Capture revenue across your user's moments. Get 3 months free!",
                "short_headline": "3 Free Months of MomentScience!",
                "advertiser_name": "MomentScience",
                "is_loyaltyboost": false,
                "loyaltyboost_requirements": "",
                "loyaltyboost_requirements": "",
                "save_for_later_url": "https://api.perkswallet.com/pwaas/save.json?o_id=5738&c_id=3042&p_id=3065&sess_id=b779feeec95272cae3cc3c8fb0f0f1aeff20c12d&pub_user_id=pktw2",
                "offerwall_url": "https://get.perkswall.com/offerwall?accountId=fbe15a0c6f803ef4&offer_count=3&auto_show=1&show_logo=1&show_header=1&show_shadow=0&show_image=1&font_family=Open+Sans&session_id=95868dc0306887060b991e555c8f5057a6b619b0&c_id=2282"
                "qr_code_img": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIQAAACEC..."
            },
            {
                "id": 4586,
                "campaign_id": 2396,
                "title": "You Unlocked MomentScience For 90 Days - Free!",
                "description": "MomentScience lets you capture revenue across your user's moments. Delight your users with relevant Offers at the right time. Get 3 months free!",
                "click_url": "https://trk.pubtailer.com/sdk/offer-click?o_id=4586&c_id=1879&p_id=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e",
                "image": "https://adpx.b-cdn.net/campaigns/1879/d93fbd2662b784b655d430c9ce3789e4.png",
                "mini_text": "",
                "pixel": "https://trk.pubtailer.com/sdk/v2/impression/p.png?o_id=4586&c_id=1879&p_id=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e&cbuster=%7BCBUSTER%7D",
                "cta_yes": "Earn 150 Points",
                "cta_no": "No, Thanks",
                "useraction_cta": "",
                "useraction_url": "",
                "adv_pixel_url": "",
                "beacons": {
                    "close": "https://trk.pubtailer.com/event/record/close?oid=4586&cid=1879&pid=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e",
                    "no_thanks_click": "https://trk.pubtailer.com/event/record/no_thanks_click?oid=4586&cid=1879&pid=1854&sess_id=51267da82f8e1a6c2900c5c051c1648a63f8410e"
                },
                "creatives": [
                    {
                        "id": 1769,
                        "url": "https://adpx.b-cdn.net/campaigns/1879/d93fbd2662b784b655d430c9ce3789e4.png",
                        "height": 1530,
                        "width": 1530,
                        "type": "png",
                        "is_primary": true,
                        "aspect_ratio": 1
                    }
                ],
                "offerwall_enabled": true,
                "perkswallet_enabled": false,
                "short_description": "Capture revenue across your user's moments. Get 3 months free!",
                "short_headline": "3 Free Months of MomentScience!",
                "advertiser_name": "MomentScience",
                "is_loyaltyboost": true,
                "loyaltyboost_requirements": "User must finish integrating MomentScience to qualify. You must click “Allow” if tracking permission is requested within the app.""offerwall_url": "https://get.perkswall.com/offerwall?accountId=fbe15a0c6f803ef4&offer_count=3&auto_show=1&show_logo=1&show_header=1&show_shadow=0&show_image=1&font_family=Open+Sans&session_id=95868dc0306887060b991e555c8f5057a6b619b0&c_id=2396"
                "save_for_later_url": "https://api.perkswallet.com/pwaas/save.json?o_id=5738&c_id=3042&p_id=3065&sess_id=b779feeec95272cae3cc3c8fb0f0f1aeff20c12d&pub_user_id=pktw2",
                "offerwall_url": "https://get.perkswall.com/offerwall?accountId=fbe15a0c6f803ef4&offer_count=3&auto_show=1&show_logo=1&show_header=1&show_shadow=0&show_image=1&font_family=Open+Sans&session_id=95868dc0306887060b991e555c8f5057a6b619b0&c_id=2282"
                "qr_code_img": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIQAAACEC..."
            }
        ],
        "count": 2,
        "privacy_url": "https://www.momentscience.com/privacy-policy"
    }
}
﻿
Response Parameters
Upon making an API call, the following attributes are returned in the response to construct your Offers with.
﻿
offers array of offer objects
Contains the copy, creatives, and resources to construct each Offer. Each offer object has the following attributes:
offers[].id int
The unique ID that represents the Offer.
﻿
offers[].campaign_id int
The unique ID of the campaign that this Offer belongs to.
﻿
offers[].title string
Recommended to implemen﻿t for larger formats﻿
The title of the Offer. To be used to construct the headline of the Offer. 
Maximum length: 90 characters.
﻿
offers[].advertiser_name string
The name of the advertiser offering the Offer.
﻿
offers[].description string
Recommended to implemen﻿t for larger formats﻿
The description of the Offer.
Maximum length: 220 characters.
﻿
offers[].click_url URL
Required to implement﻿
URL the Offer should direct to when the user clicks on the positive CTA button.
﻿
offers[].image URL
Recommended to implement﻿
URL for the Offer's primary image.
﻿
offers[].mini_text string 
Recommended to implement﻿
Additional sub-description for the Offer. Used for disclaimers. 
Maximum length: 160 characters.
﻿
﻿offers[].terms_and_conditions string
﻿Required to implement﻿
Contains the offer's terms and conditions in HTML format, typically as an unordered list (<ul>). Some offers may not include this field. Render as HTML to maintain formatting; if empty, assume no specific terms apply.
﻿
offers[].pixel URL
Required to implement 
The Impression Beacon URL to be fired when the Offer is displayed to the user for impression tracking. A successful GET call to the pixel URL is required to successfully record delivery on the MomentScience Dashboard.
﻿
offers[].cta_yes string 
Recommended to implement﻿
Suggested copy for implementing a postitive CTA button for the User to accept the Offer. 
Maximum length: 25 characters.
﻿
offers[].cta_no string 
Recommended to implement﻿
Suggested copy for implementing a negative CTA button for the User to reject an Offer. 
Maximum length: 25 characters.
﻿
offers[].adv_pixel_url URL 
Required to implement if available﻿
Advertiser may provide their own impression tracking URL, fire this along with the pixel Impression Beacon URL.  A successful GET call to adv_pixel_url is required.
﻿
offers[].beacons object
Contains beacon URLs for a variety of actions. The beacons object contains the following attributes:
Attribute
Type
Description
offers[].beacons.close 
URL
To be fired when closer closes the Offer container or when the user has browsed through all available Offers. For reporting purposes. A successful GET call to beacons.close is required if implemented. 

recommended to implement if Offers are presented in a dismissable container﻿
offers[].beacons.no_thanks_click
URL
To  be fired when user clicks the Negative CTA element. For reporting purposes. A successful GET call to beacons.no_thanks_clicks is required if implemented. 

recommended to implement if a negative CTA is implemented﻿
﻿
﻿offers[].creatives array of creative objects
Contains additional creative images that can be used to construct the Offers unit. Each creative object contains the following attributes
Attribute
Type
Description
offers[].creatives[].id
Int
Unique ID of the creative.
offers[].creatives[].url
URL 
URL location for the creative.
offers[].creatives[].height
double
Height of the image in pixels.
offers[].creatives[].width
double
Width of the image in pixels.
offers[].creatives[].type
string
File type of the image. 
offers[].creatives[].is_primary
boolean
Indicates whether the image is primary or not.
offers[].creatives[].aspect_ratio

number
The aspect ratio of the image.
a value of 1 = square image
a value < 1 signifies generally portrait
a value > 1 signifies generally landscape
﻿
offers[].offerwall_enabled boolean
Boolean value to indicate whether the Offer has an Offerwall feature enabled or not.
﻿
offers[].perkswallet_enabled boolean
Boolean value to indicate if the PerksWallet feature that enables user to save Offers into their accounts is enabled or not
﻿
offers[].save_for_later_url string 
Required to implement when integrating with PerksWallet-as-a-Service (PWaaS)﻿
The URL your system should use to save the offer to the user's wallet when they click the Save for later button.
When pub_user_idis present in the request:
save_for_later_urlcontains a valid POSTendpoint. Trigger this URL when the user clicks Save for later.
When pub_user_id is not present in the request:
This field is null. Skip rendering or disabling the Save for later action.
﻿
offers[].offerwall_url URL
The url that the user will be redirected to when clicking on the "More Offers" button that takes him to the Offerwall page.
﻿
﻿offers[].qr_code_img string ﻿
A Base64-encoded PNG image of a QR Code that encodes the value of the campaign’s click_url. The string is returned in Data URI format, beginning with data:image/png;base64, ordata:image/jpeg;base64,. 
Use this image to provide a quick, scannable link to claim the Offer , especially in cross-device or offline scenarios.
QR Code Guidelines:
Format: PNG or JPEG
Color Scheme: Black foreground on white background (no gradients or color inversions)
Dimensions: 228x228 pixels 
﻿
offers[].short_description string 
Recommended to implemen﻿t for smaller formats﻿
Alternative shorter text to use for the Offer's description if the context of the Offer is in a smaller format like on mobile or if you're implementing the Offer in a smaller element. Maximum length: 140 characters.
﻿
offers[].short_headline string 
Recommended to implemen﻿t for smaller formats﻿
Alternative shorter text to use for the Offer's headline if the context of the Offer is in a smaller format like on mobile or if you're implementing the Offer in a smaller element. 
Maximum length: 60 characters.
﻿
offers[].is_loyaltyboost boolean 
Indicates if an Offer is eligible to be used in an incentive manner. 
﻿
offers[].loyaltyboost_requirements string 
Specifies the requirements for a LoyaltyBoost Offer. It outlines the actions for which rewards will be granted to users. These requirements define the criteria that the user must meet to qualify for rewards associated with the LoyaltyBoost Offer.
Maximum length: 160 characters.
﻿
count integer
Number of Offers returned from the call. 
﻿
privacy_url URL
Recommended to implement﻿
URL to MomentScience's current end-user privacy policy page. 
﻿
Parsing the Response and Displaying Offers
Upon a successful response from the Fetch Offer's API request, generate Offers using the Offer fragments provided for each returned Offer.
Remember to implement impression tracking using the pixel attribute for each displayed Offer. A successful GET call to the Pixel URL is required to successfully record delivery on the MomentScience Dashboard.
This allows MomentScience to: 
Accurately calculate and present performance statistics such as click-through rate (CTR), eCPM and other metrics.
Use performance data to optimize Offer delivery on future traffic.
Generate and display first Offer using the fragments of the Offer returned in the response.
Implement the Impression Beacon URL (pixel) for the first Offer
If user engages with the negative call-to-action, implement the Negative CTA Beacon URL (no_thanks_click) 
Render the second Offer (and implement the Impression Beacon URL for this Offer)
Continue through the sequence based on user engagement
Using Creatives
When retrieving Offer, we provide a creatives attribute with each returned Offer, which lists creatives available for use in your Offers. 
Included with each creative is an is_primary boolean attribute. You can use any of the creatives available depending on the platform you are rendering or default to the primary creative if you are unsure.
The Moments API also supports on-the-fly image transformations: by simply adding the query parameter "width=XXX" into the image url (replace XXX with a suitable integer value for width, depending on the device resolution). The query parameters "height=XXX" or "?aspect_ratio=X:Y" are also available as on-the-fly image processing directives on images.
We also provide an aspect_ratio attribute for each creative which can be helpful in selecting an image for the Offer.  
An aspect_ratio with:
a value of 1 = square image
a value < 1 signifies generally portrait
a value > 1 signifies generally landscape
Implementing Event Beacons
In addition to tracking impressions, the Offers response also provides a beacons object, containing the tracking URLs for events no_thanks_click (to be fired when user clicks the Negative CTA element) and close (to be fired when user closes the Offer container or when the user has browsed through all the available Offers).
Integration Checklist
We recommend you go through our Moments API integration checklist﻿ to ensure that you have not missed any integration steps. This will help you gain the full advantage of the features provided by MomentScience.
﻿
📢 If you're running into any issues while going through the integration process, feel free to contact us at [email protected] 

Parameter	Description	Type	Example
Content-Type Required	Should be application/json	string	application/json

Parameter	Description	Type	Example
api_key Required	Your API Key. Obtain your API Key Required Permission: Ads/Offers	string	4bbdefc2-b130-424d-8170-54bdcb98e64e
loyaltyboost Optional	Include LoyaltyBoost offers in response; Values: 0 = None 1 = True 2 = Only	string	0\|1\|2
creative Optional	Returns Offers with at least one creative (image) if set to true.	string	0\|1
campaignId Optional	Filters the response to return the single offer associated with the specified campaignId Only one campaign ID can be used per request.	string	3110

Parameter	Description	Type	Example
ua Recommended	The User-Agent of the end-user required for proper targeting. If proxying requests via a server call, be sure to pass through the User-Agent of the end-user.	string	Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.43 Mobile Safari/537.36
placement Highly Recommended	A highly encouraged attribute that represents the specific page, section, or location where the Offer Unit was triggered This parameter enables enhanced reporting, analytics, and traffic segmentation.	string	checkout_confirmation_page
ip Recommended	IP address of the end user to be passed through. Used for targeting.	string
adpx_fp Recommended	A unique identifier for the end user; Not required but highly recommended. More information can be found below.	string	1234abcd-5678-efgh-9101-ijklmnopqrst
pub_user_id Required when integrating with PerksWallet-as-a-Service (PWaaS) or User Selected Perks	A unique, non-PII identifier for the end user. This value links offers to individual users and must remain consistent across sessions and devices. You may use the same value as adpx_fp, if available. Do not use personally identifiable information (PII), such as email addresses or phone numbers. You can generate this identifier using any method, as long as it guarantees uniqueness per user.	string	1234abcd-5678-efgh-9101-ijklmnopqrst
dev Optional	Returns a test response. Ignores geo restrictions. No activity is recorded.	string	0\|1
<string> Optional	Custom Key-Value payload attributes. You can add any number of custom key-value payload attributes to the payload that you want to use to add additional details. All payload attributes are passed back on conversion reports and can be reported on in relation to impression and clicks.	string	membershipID: "A45GRE987343PKD"

Attribute	Type	Description
offers[].beacons.close	URL	To be fired when closer closes the Offer container or when the user has browsed through all available Offers. For reporting purposes. A successful GET call to beacons.close is required if implemented. recommended to implement if Offers are presented in a dismissable container
offers[].beacons.no_thanks_click	URL	To be fired when user clicks the Negative CTA element. For reporting purposes. A successful GET call to beacons.no_thanks_clicks is required if implemented. recommended to implement if a negative CTA is implemented

Attribute	Type	Description
offers[].creatives[].id	Int	Unique ID of the creative.
offers[].creatives[].url	URL	URL location for the creative.
offers[].creatives[].height	double	Height of the image in pixels.
offers[].creatives[].width	double	Width of the image in pixels.
offers[].creatives[].type	string	File type of the image.
offers[].creatives[].is_primary	boolean	Indicates whether the image is primary or not.
offers[].creatives[].aspect_ratio	number	The aspect ratio of the image. a value of 1 = square image a value < 1 signifies generally portrait a value > 1 signifies generally landscape

APIs Documentation

Offer Anatomy

Moments API

Overview

Pre-requisites

Try It Out

Fetch Offers

Header Parameters

Query Parameters

Body Parameters

The Response Body

Sample Response

Response Parameters

offer Attributes

Parsing the Response and Displaying Offers

Using Creatives

Implementing Event Beacons

Integration Checklist