Custom Reports

26min

Introduction

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.

Pre-requisites

Before using custom reports, ensure the following:

  1. Contact Your Account Manager:
    Custom reports need to be activated for your account. Please contact your account manager to enable this feature.
  2. Admin Access:
    Only users with "Admin" access can use custom reports. Users with "Manager" or "Analyst" roles don't have access to this feature.
ο»Ώ

ο»Ώ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

  1. A popup will appear after clicking the "Create Report Template" button.
  2. 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:
  • 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 Learn more.ο»Ώο»Ώ
  • Perkswall
    • Description:
      Allows publishers to display several Offers/Perks at once in a branded experience. Learn more about Perkswall.ο»Ώο»Ώ
    • User Interaction:
      Users see multiple Offers in a unified branded interface.
    • ο»ΏSources of Impressions:

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:

  1. Breakdown by Accounts: Groups the report by accounts, adding a new column named "Accounts."
  2. Breakdown by Offer:
    Groups the report by Offers, adding a new column named "Offers."
  3. Breakdown by Units:
    Groups the report by units (e.g., MOU, SOU, Perkswall), adding a new column named "Units."
  4. Breakdown by Device:
    Groups the report by device, adding a new column named "Devices."
  5. 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

Impressions

None

When you select β€œBreakdown by Offer” you will not be able to add the β€œImpressions” column.

Represents each time a collection of Offers is shown.

Impressions (Offers)

None

None

Represents each time an individual Offer is shown.

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" document.ο»Ώο»Ώ

  • 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

ο»Ώ
  1. Run the Template:
    1. Click the Run icon next to the report template you want to generate.
  2. Modify the Date Range:
    1. Set the start and end dates as per your preference.
    2. Ensure the date range does not exceed 31 days; otherwise, an error message will appear.
  3. Add Email Addresses (Optional):
    1. Enter multiple email addresses separated by commas.
    2. The report will be sent to these emails once ready.
  4. Click the Run Button:
    1. Start the report generation process.
  5. Wait for Generation:
    1. The report generation time will vary depending on the data size.
  6. Access the Report:
    1. You will receive an email from "MomentScience Helpdesk" notifying you that the report is ready for download. The email will contain the generated report.
    2. 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:

  1. Delete the Template:
    • Click the delete icon next to the template you want to remove.
  2. 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ο»Ώ

Updated 21 Sep 2024
Did this page help you?
PREVIOUS
Moments and Perkswall API Implementation Checklist
NEXT
Email Reports
Docs powered byΒ Archbee