Media Ratings Terminal Quota System

This article details how the MRT quota system works and when deductions to the quota are done.

Upon signing up for access to the MRT, your Sales representative may give you the option to allocate monthly quotas for website and app lookups, as well as for leveraging the Pixalate MRT Enrichment API

The overall monthly quota can be allocated across three supply types that the MRT currently supports:

  • Websites
  • Mobile Apps
  • CTV Apps

To avoid disruption in case monthly allocations are consumed prior to the next quota refresh cycle, your Sales representative may include overage allocations to your subscription. These overage allowances allow you to keep using the MRT for website and app lookups when the base quota has been consumed but note that overage allowance use comes with an overage fee. 

When it comes to how quota is deducted from the monthly allocation, the following actions apply:

  • Accessing insights pages for Websites, Mobile, and CTV
  • Import CSV
  • Downloading search results
  • Downloading results from the Discovery page (excluding Import CSV downloads, those are already deducted when returned to the UI)
  • API events including outputs

Tip: Refer to the section below on how combinations of devices and regions selected can impact your quota deduction)

Managing UI Upload Results or API Outputs

The MRT UI and API allow our clients to define the combinations of results they get back from the MRT platform. 

In the MRT Discovery section prior to importing a CSV file for processing, you will be presented with options of Region and Device combinations. 

Each combination returned will be deducted from your quota.

In most cases, setting the Region and Device as "GLOBAL" will satisfy most user requirements and this will return one combination (ie. one deduction per store). 

When using the MRT Enrichment API, you can set the Region and Device as parameters in the API request: 

 

Viewing Current Quota Usage via the MRT UI

The MRT also provides users with a quota usage page to track their remaining quota, and view usage logs directly on their account page in the MRT.

This is useful to prevent any overage charges and gives you agency on managing your MRT usage. 

The quota usage page can be accessed by hovering over your name in the upper right-hand corner of any Pixalate page when logged in, and selecting "Quota Usage" from the drop-down. 

Viewing Current Quota Usage via the MRT Enrichment API

Below is a sample cURL command you can run to get your current API quota and all you need is your API key, which you can get from your account page or through your customer success representative. 

#! /bin/bash

KEY="<INSERT YOUR API KEY HERE>"
echo $KEY
echo '***************** ANALYTICS *****************'
curl -v -H "x-api-key: $KEY" 'https://api.pixalate.com/api/v2/analytics/reports?pretty=true'
echo '*****************APPS *****************'
curl -v -H "x-api-key: $KEY" 'https://api.pixalate.com/api/v2/mrt/apps?pretty=true'
echo '*****************CTV *****************'
curl -v -H "x-api-key: $KEY" 'https://api.pixalate.com/api/v2/mrt/ctv?pretty=true'
echo '*****************DOMAINS *****************'
curl -v -H "x-api-key: $KEY" 'https://api.pixalate.com/api/v2/mrt/domains?pretty=true'
echo '*****************FRAUD *****************'
curl -v -H "x-api-key: $KEY" 'https://fraud-api.pixalate.com/api/v2/fraud?pretty=true'

For any questions, please reach out to your customer success representative.