MomentPerks Integration Checklist
Who is this for: Developers finalizing a MomentPerks API integration who need to verify all required tracking and display requirements before going live.
Outcome: Confirm that impression pixels, advertiser pixels, close beacons, no-thanks beacons, and fingerprint parameters are all correctly implemented.
This checklist serves as a final verification tool for your Moments API integration. Use it to confirm your implementation meets all requirements for optimal functionality and performance tracking.
When an Offer is shown
Fire a GET call to the provided offers[].pixel URL.
- Importance: Records offer impressions for performance reporting and yield optimization.
Fire a GET call to the provided offers[].adv_pixel_url URL if available.
- Importance: Meets advertiser requirements for impression tracking.
Render the offers[].terms_and_conditions string as HTML.
- Importance: Presents offer terms as formatted HTML. If missing, no specific terms apply.
When a user dismisses an Offer Unit
Fire a GET call to the currently displayed Offer's offers[].beacons.close URL.
- Importance: Enables behavioral performance reporting to track user interaction within Moments.
When a user indicates disinterest in a certain Offer
Fire a GET call to the Offer's offers[].beacons.no_thanks_click URL.
- Importance: Helps exclude Offer from future display when a user opts out.
Pass a value as the adpx_fp attribute in payload parameters for unique user identification.
- Importance: Enables frequency capping and exclusion of Offers based on user preference.
When Using a Proxy Server
Send the User's IP address as the ip attribute in the payload parameters.
- Importance: MomentScience uses the userβs IP address to determine the userβs geography for valid Offers.
Send User Agent as the ua attribute in the payload parameters.
- Importance: MomentScience uses the User-Agent value to determine the userβs platform for valid Offers.
When Implementing LoyaltyBoost (Rewarded Offers)
Only implement if you can identify your users to reward them with your Loyalty currency.
Request LoyaltyBoost Offers by passing the query parameter loyaltyboost with values 1 | 2.
- Importance: Ensures that offers returned are valid for incentivized use.
ο»ΏSetup a Postback URL with MomentScienceSetup a Postback URL with MomentScienceο»Ώ
- Importance: Enables notifications when users convert on LoyaltyBoost Offers to reward them with Loyalty currency and determine the amount.
Pass a value as the adpx_fp attribute in payload parameters to represent a unique user.
- Importance: Prevents showing a user a LoyaltyBoost Offer they've already converted on.
Pass a custom key-value attribute in payload parameters to identify where to credit the user's Loyalty currency (e.g., loyaltyid=12345566).
- Importance: When a user converts on a LoyaltyBoost Offer, our postback will contain this information along with the conversion's payout amount (in USD). Use this to identify which account to credit and calculate the reward amount.
Need assistance? Contact our support team at [email protected]ο»Ώ