Playbooks
Serving Moments in Mobile Apps
adspostx is now momentscience! momentscience! 🎉 we have rebranded adspostx to momentscience all the latest documentation and updates can now be found at momentscience documentation https //docs momentscience com/ goal to display a "moment" in a mobile app for reference, a "moment" is either one offer or a series/collection of offers served together at a key time in a user's experience to implement a moment in a mobile app, use the moments api (also known as the native ads api) to retrieve offers from adspostx and then render them as you see fit in your mobile app steps step 1 create an api key to return a collection of offers via the moments api, you will first need to get an api key note that you will need an api key scoped for ads step 2 configure moments settings in the adspostx dashboard the number of offers returned in the moments api response can be configured in the adspostx dashboard to do this, head to settings > configuration and then locate the number of ads setting select the number of ads you would like to have in a given moment then press save configuration this will instruct the moments api to return the selected number of offers in the response step 3 construct your api call to return a moment the api call that returns a collection of offers to be displayed may be implemented in one of two ways directly in your app via a proxy solution wherein your app contacts your own backend endpoint which then "relays" the request to adspostx and returns to your endpoint the api response your endpoint will then send the response to your app if you opt to use a proxy solution, ensure that the end user's user agent and ip address are provided in the moments api request from your proxy server to ensure appropriate geo and platform targeting step 4 ensure that impressions are tracked every offer returned includes an impression beacon (offers\[] pixel ) that needs to be triggered when the offer is displayed to the user this is important to implement to ensure correct reporting failing to implement the impression beacon will result in inaccurate reports as well as the inability to provide ecpm performance on an individual offer basis it also hinders the platform's ability to optimize offer ranking and ultimately revenue yield further recommendations consider using postbacks to get real time events on conversions based on the offers that are served