Custom Reports

who is this for partners who need tailored, on demand reporting across one or multiple accounts outcome create reusable report templates and generate detailed account statistics in csv or json, with configurable date ranges, breakdown options, and metric selections overview this document explains how to create and run custom report templates to generate account statistics customizing your reports helps you gain deeper insights into your data, allowing you to track performance and make informed decisions by following the steps outlined here, you can tailor your reports to suit your specific needs and requirements prerequisites before using custom reports, ensure the following contact your account manager custom reports need to be activated for your account please contact your account manager to enable this feature admin access only users with "admin" access can use custom reports users with "manager" or "analyst" roles don't have access to this feature click take a tour on the dashboard to start a 10 step walkthrough covering template setup, offer units, report type, date quantum, breakdowns, kpi columns, custom attributes, saved templates, and csv/json downloads; creating a template you have the option to create any number of report templates that you can run to generate your reports follow the demo below to create a template selecting account (s) step 1 select accounts choose up to 10 accounts to include in your report by default, if no accounts are selected, the report will include all accounts related to your main account step 2 create report template after selecting the accounts, click on the "create report template" button specify report name a popup will appear after clicking the "create report template" button enter a clear and descriptive name for your report template specify report range in days enter the number of days for the report (e g , 2 days will include the day before yesterday and yesterday) the maximum allowed range is 31 days we allow a maximum report range of 31 days if you enter a number greater than 31, the range will be automatically reset to 31 days select offer units choose the offer units to include in the report you can select multiple units single offer unit (sou) description displays one offer at a time in a carousel modal popup user interaction users can engage with each offer by selecting the positive or negative call to action (cta) buttons sources of impressions moments js sdk when using sou mode docid 9ukjgfqbk0fvd1qahw51l momentperks api docid\ zpol4dx0bohl2aooyzrlq directperks docid\ tfmiieuoey3lliyizfdet multi offer unit (mou) description displays all available offers simultaneously in a tile format user interaction users can view and consider multiple offers at once each tile represents a distinct offer sources of impressions moments js sdk when using mou mode docid 9ukjgfqbk0fvd1qahw51l perkswall description allows publishers to display several offers/perks at once in a branded experience learn more about perskwall docid\ haewinaedvvpp8yqa3 dp user interaction users see multiple offers in a unified branded interface sources of impressions perkswall direct offers docid\ s6w 8e l 5uknah688s7d perkswall api docid 2un6uwr7 uyb7ctvyhyy if you select offer units that are not active for your account (e g , perkswall), the report will still include these units but with empty values for those columns specify your report type choose the type of report you want dashboard (action based) this report tracks actions based on when they occurred, regardless of the original impression for instance, if an impression happens today and its conversion occurs the following day, the impression will be recorded for today, while the conversion will be attributed to tomorrow downstream (based on the originating event) this report tracks actions based on the original impression for example, if an impression occurs today and a conversion from that impression happens tomorrow, both the impression and the conversion will be attributed to today specify date quantum select date options for your report, either by day or by month this groups the report data accordingly by month displays a row with each month in the selected date range and their corresponding report values by day displays a row with each day in the selected date range and their corresponding report values if you choose a date range of less than 28 days, the monthly quantum will still apply if the dates span different months choose your breakdown method select one or more methods to break down your report breakdown by accounts groups the report by accounts, adding a new column named "accounts " breakdown by offer groups the report by offers, adding a new column named "offers " breakdown by units groups the report by units (e g , mou, sou, perkswall), adding a new column named "units " breakdown by device groups the report by device, adding a new column named "devices " breakdown by os groups the report by operating system, adding a new column named "os " if you choose to break down by offer, you will not be able to include the following columns to your report impressions ctr rpm these columns represent unit wise numbers (mou/sou/perkswall), not offer wise numbers choose your report columns select the columns for your report note that some columns depend on others being included title needed items disabling items description placements none none the placement through which the offer was served (e g , homepage, checkout, mobile app) use this column to break down performance by the specific surface or page in your integration where the impression occurred themes none none the theme applied to the offer at the time of the impression use this column to compare performance across different theme configurations, which is useful for a/b testing and creative analysis views n one when you select “breakdown by offer” you will not be able to add the “impressions” column the total number of times an offer unit (sou, mou, or perkswall) was loaded one impression represents one unit load, regardless of how many individual offers were displayed inside it (labeled views on the dashboard ) impressions none none represents each time an individual offer is shown (labeled impressions on the dashboard ) clicks none none counts each time a user clicks on an offer conversions revenue none a conversion is recorded each time a customer converts on an offer available only to selected accounts and must be enabled by your account manager revenue none none the total revenue generated from customer engagement with momentscience offers, excluding commissions ctr clicks, impressions when you select “breakdown by offer” you will not be able to add “ctr” column calculated as the number of clicks divided by the number of unit impressions ctr (offers) clicks, impressions (offers) none click through rate for offers, calculated as the number of clicks divided by the number of impressions (offers) cvr clicks, conversions none conversion rate, defined as the number of conversions per click available only to selected accounts and must be enabled by your account manager rpm impressions when you select “breakdown by offer” you will not be able to add “rpm” column measures the revenue generated per 1000 impressions rpm = revenue / impressions x 1000 rpm (offers) impressions (offers) none measures the revenue generated per 1000 individual offer impressions rpm (offers) = (revenue / impressions (offers)) 1000 rpc revenue, clicks none the revenue per click is the revenue generated for the specified account(s) divided by the number of clicks insert attributes payload values are parameters sent with the momentscience integration to provide additional information about the user or session specify attribute names to include in conversion reports, aiding in the analysis of impressions and clicks for more information on passing payload values, please refer to the passing payload values docid\ yz38zu4 miummwtnnsg98 add multiple attributes, separated by commas ensure the attributes are correct, as they come to momentscience as payloads if you insert an incorrect attribute, the report will still include a column with the attribute name, but it will contain empty values preview your report preview the look of your report columns once you're done with the preview, click on "save report template" button the numbers shown are placeholders and not real data they are random numbers meant to demonstrate the general appearance of the report updating a template once you've created a template, you can still modify it as needed here are the needed steps modify the template click the update icon next to the template you want to modify edit details a popup will appear similar to the one used for creating the template make your changes in this popup save changes click the "update" button to apply your edits running a template run the template click the run icon next to the report template you want to generate modify the date range set the start and end dates as per your preference ensure the date range does not exceed 31 days; otherwise, an error message will appear add email addresses (optional) enter multiple email addresses separated by commas the report will be sent to these emails once ready click the run button start the report generation process wait for generation the report generation time will vary depending on the data size access the report you will receive an email from "momentscience helpdesk" notifying you that the report is ready for download the email will contain the generated report you can also find the report in the "latest report runs" section within the dashboard where you can download the report in csv or json format based on your preference to find a report in the latest report runs section, use the search function with the report id or run uuid deleting a template deleting a template does not remove its associated reports only the template itself is deleted here are the needed steps delete the template click the delete icon next to the template you want to remove confirm deletion a confirmation popup will appear click "confirm" to proceed with the deletion 📢 if you're running into any issues while going through the integration process, feel free to contact us at help\@momentscience com mailto\ help\@momentscience com