Playbooks
Serving Moments in Mobile Apps
11min
overview this playbook provides a detailed guide for implementing a moment via the moments api in your mobile app a "moment" is defined as a single offer or a collection of offers presented at key times in the user's experience by using the moments api, you can retrieve offers from momentscience and render them as you see fit within your app, enhancing user engagement and generating additional revenue steps step 1 create an api key to return a collection of offers via the moments api, you first need to obtain an api key ensure you obtain an api key specifically scoped for ads step 2 configure moments settings in the dashboard the number of offers returned in the moments api response can be configured in the momentscience dashboard configure the number of offers go to settings > configuration locate the " number of ads " setting select the desired number of ads to be included in a moment press save configuration this setting instructs 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 can be implemented in one of two ways directly in your app make the api call directly from your mobile app to retrieve the offers via a proxy solution your app contacts your backend endpoint, which then relays the request to momentscience your backend processes the response and sends it back to your app if using a proxy solution, ensure the end user's user agent and ip address are included in the moments api request from your proxy server this ensures appropriate geo and platform targeting step 4 ensure 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 implementing this correctly ensures accurate reporting and the ability to optimize offer ranking and revenue yield trigger impression beacons ensure your app triggers the impression beacon each time an offer is displayed to the user failure to implement the impression beacon will result in inaccurate reports and hinder the platform's ability to optimize performance metrics such as ecpm further recommendations use postbacks implement postbacks to get real time events on conversions based on the offer served this provides immediate feedback and helps in refining targeting and effectiveness 📢 if you're running into any issues while going through the integration process, feel free to contact us at help\@m omentscience com