> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pixalate.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pixalate.com/_mcp/server.

# Mobile app fields

> Field reference for the Pixalate Enrichment API for mobile apps (/api/v2/mrt/apps), organized by widget.

Every Enrichment API lookup returns a `docs` array of records. Each record covers one app in one store (Google Play or the App Store), for one region and one device type. The fields in a record
depend on the widgets you request: if you don't pass `widget`, you get all of them. See the
[Enrichment API guide](/apis/enrichment-api) for how to make requests.

Risk ratings are one of `low`, `medium` or `high`. Some fields can be `null`, as noted in their
descriptions. Fields that appear in a response but aren't listed here can change
without notice, so don't build on them.

For the full request and response schema, see the API reference for
[GET /mrt/apps/\{appId}](/api-reference/enrichment-apps/get-mobile-app-data).

## Record keys

These identify what a record covers.

| Field      | Type                                            | Description                                                                              |
| ---------- | ----------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `appId`    | string                                          | The app's identifier: the package name on Google Play, or the track ID on the App Store. |
| `region`   | string: `GLOBAL`, `NA`, `EMEA`, `LATAM`, `APAC` | The region this record covers. `GLOBAL` is the aggregate of all regions.                 |
| `device`   | string: `GLOBAL`, `smartphone`, `tablet`        | The device. `GLOBAL` indicates an aggregate of all devices.                              |
| `appStore` | string: `ios`, `android`                        | The store: `ios` (App Store) or `android` (Google Play).                                 |

## Widgets

Pass any of these names in the `widget` parameter, comma-separated. Each links to its fields below.

| Widget                                      | What it contains                                                                                                  |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| [`appOverview`](#appoverview)               | Title, description, categories, screenshots and delisting status.                                                 |
| [`appDetails`](#appdetails)                 | Store identifiers, ratings, blocklist status and in-app ad capabilities.                                          |
| [`pixalateAdvisories`](#pixalateadvisories) | Advisory flags: app-ads.txt, delisting, dangerous permissions, blocklisting and developer policies.               |
| [`appAdvisories`](#appadvisories)           | Advisory text for the app.                                                                                        |
| [`riskOverview`](#riskoverview)             | Headline IVT, viewability and brand safety figures, plus Pixalate's overall risk rating with reasons.             |
| [`developerOverview`](#developeroverview)   | The developer's name, contact details, policies and social media risk.                                            |
| [`trafficOverview`](#trafficoverview)       | Spoofing, location masking, IVT and viewability risks, audience size, inventory and ad spend.                     |
| [`brandSafety`](#brandsafety)               | Brand safety risk from the app's descriptive text and from its visual content.                                    |
| [`appPermissions`](#apppermissions)         | The permissions the app requests and the IVT risk they carry.                                                     |
| [`trafficOverlap`](#trafficoverlap)         | How much of the app's audience and inventory overlaps with other apps.                                            |
| [`authorizedSellers`](#authorizedsellers)   | The sell-side platforms selling the app's inventory, with volume, IVT and viewability for each.                   |
| [`invalidTraffic`](#invalidtraffic)         | IVT, GIVT and SIVT percentages, with a breakdown by IVT type.                                                     |
| [`viewability`](#viewability)               | Average viewability and viewability risk, overall and by ad size.                                                 |
| [`inventory`](#inventory)                   | Estimated programmatic impressions by device, region, country, ad size and DMA.                                   |
| [`ctr`](#ctr)                               | Click-through rate, overall and by ad size.                                                                       |
| [`availableCountries`](#availablecountries) | The countries where the app is available.                                                                         |
| [`rankings`](#rankings)                     | Region and category rank, plus grades and scores across several dimensions.                                       |
| [`rankingsByCountry`](#rankingsbycountry)   | Reach and market share rankings by country.                                                                       |
| [`coppa`](#coppa)                           | Signals related to the Children's Online Privacy Protection Act (COPPA): audience, COPPA risk and data practices. |
| [`mfa`](#mfa)                               | Made-for-advertising (MFA) risk and ad refresh rate.                                                              |

## appOverview

Title, description, categories, screenshots and delisting status.

| Field                                 | Type             | Description                                                                                                                     |
| ------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `appOverview.appTitle`                | string           | The app title.                                                                                                                  |
| `appOverview.screenshotUrls`          | array of strings | A list of app screenshot URLs.                                                                                                  |
| `appOverview.description`             | string           | App description.                                                                                                                |
| `appOverview.iabPrimaryCategory`      | array of strings | The IAB primary categories.                                                                                                     |
| `appOverview.iabSubCategory`          | array of strings | The IAB secondary categories.                                                                                                   |
| `appOverview.appStoreCategories`      | array of strings | App store categories.                                                                                                           |
| `appOverview.delistedDate`            | string (date)    | If app has been delisted from the app store, then this property is the date when delisted. The date format is `YYYY-MM-DD`.     |
| `appOverview.delistedApp`             | boolean          | `true` if app has been delisted from the app store.                                                                             |
| `appOverview.hasDangerousPermissions` | boolean          | `true` if the app requests a permission which is dangerous according to the protection level in the Google permission manifest. |

## appDetails

Store identifiers, ratings, blocklist status and in-app ad capabilities.

| Field                                                 | Type             | Description                                                                                                         |
| ----------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
| `appDetails.bundleId`                                 | string           | The app's bundle identifier: the package name on Google Play, or the developer-assigned bundle ID on the App Store. |
| `appDetails.trackId`                                  | string           | The identifier Apple assigns to the app. App Store only; otherwise null.                                            |
| `appDetails.appStoreUrl`                              | string           | The app page on Google Play or App Store.                                                                           |
| `appDetails.appLastUpdatedDate`                       | string (date)    | The date the app information was last updated. Formatted as `YYYY-MM-DD`.                                           |
| `appDetails.trustedSeller`                            | string           | The authorized trusted seller.                                                                                      |
| `appDetails.incentivizedActivity`                     | boolean          | `true` if incentivized activity available in the app.                                                               |
| `appDetails.downloadRange`                            | string           | The estimated number of installs, as a range. Google Play only.                                                     |
| `appDetails.averageUserRating`                        | integer          | The average user rating given by the app store.                                                                     |
| `appDetails.contentRating`                            | string           | The recommended content rating defined by the app store.                                                            |
| `appDetails.blocklisted`                              | boolean          | `true` if the app has been placed on Pixalate risk blocklist.                                                       |
| `appDetails.blocklistedReasons`                       | array of strings | Reasons the app is blocklisted. See [Blocklist reasons](#blocklist-reasons).                                        |
| `appDetails.adCapabilities`                           | object           | The ad capabilities of the app.                                                                                     |
| `appDetails.adCapabilities.topDevice`                 | string           | The most commonly reported device in use by the app.                                                                |
| `appDetails.adCapabilities.displayTopAdsize`          | string           | The display ad size most commonly trafficked in programmatic advertising.                                           |
| `appDetails.adCapabilities.videoTopAdsize`            | string           | The video ad size most commonly trafficked in programmatic advertising.                                             |
| `appDetails.adCapabilities.displayContribution`       | number           | The percentage of display ads trafficked on the app.                                                                |
| `appDetails.adCapabilities.videoContribution`         | number           | The percentage of video ads trafficked on the app.                                                                  |
| `appDetails.adCapabilities.hyperLocationAvailability` | number           | The percentage of advertising transactions containing the user's latitude and longitude.                            |
| `appDetails.adCapabilities.mraidVersion`              | string           | The most recent version of MRAID for which the app is compliant.                                                    |
| `appDetails.adCapabilities.adsDetected`               | boolean          | `true` if ads were detected in the app. Apps without ads may be at risk of spoofing.                                |
| `appDetails.interactiveELements`                      | array of strings | What the app has access to or lets users do. See [Interactive elements](#interactive-elements).                     |

## pixalateAdvisories

Advisory flags: app-ads.txt, delisting, dangerous permissions, blocklisting and developer policies.

| Field                                        | Type          | Description                                                                                                                     |
| -------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `pixalateAdvisories.hasAppAdsTxt`            | boolean       | `true` if AppAds.txt is enabled for the app's domain.                                                                           |
| `pixalateAdvisories.delistedApp`             | boolean       | `true` if app has been delisted from the app store.                                                                             |
| `pixalateAdvisories.delistedDate`            | string (date) | If app has been delisted from the app store, then this property is the date when delisted. The date format is `YYYY-MM-DD`.     |
| `pixalateAdvisories.hasDangerousPermissions` | boolean       | `true` if the app requests a permission which is dangerous according to the protection level in the Google permission manifest. |
| `pixalateAdvisories.blocklisted`             | boolean       | `true` if app has been placed on Pixalate risk blocklist.                                                                       |
| `pixalateAdvisories.privateDomain`           | boolean       | `true` if app's domain is privately registered.                                                                                 |
| `pixalateAdvisories.hasTermsAndConditions`   | boolean       | `true` if app has terms and conditions.                                                                                         |
| `pixalateAdvisories.hasPrivacyPolicy`        | boolean       | `true` if app has privacy policy.                                                                                               |

## appAdvisories

Advisory text for the app.

| Field           | Type             | Description     |
| --------------- | ---------------- | --------------- |
| `appAdvisories` | array of strings | App advisories. |

## riskOverview

Headline IVT, viewability and brand safety figures, plus Pixalate's overall risk rating with reasons.

| Field                                     | Type                                            | Description                                                                                                                                |
| ----------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `riskOverview.ivt`                        | number                                          | Percentage of invalid traffic associated with advertising transactions for the app.                                                        |
| `riskOverview.ivtRisk`                    | string: `low`, `medium`, `high`                 | The invalid traffic risk.                                                                                                                  |
| `riskOverview.viewability`                | number                                          | The average viewability for all display ad impressions in the app.                                                                         |
| `riskOverview.viewabilityRisk`            | string: `low`, `medium`, `high`                 | The risk of IAB viewability standards not being met for ad impressions on the app.                                                         |
| `riskOverview.descriptionBrandSafetyRisk` | string: `low`, `medium`, `high`                 | The overall description risk to advertiser brand safety from the app.                                                                      |
| `riskOverview.contentBrandSafetyRisk`     | string: `low`, `medium`, `high`                 | The overall content risk to advertiser brand safety from the app.                                                                          |
| `riskOverview.overallIvtPermissionRisk`   | string: `low`, `medium`, `high`                 | The overall IVT risk for the app based on its permissions. See `appPermissions`.                                                           |
| `riskOverview.risk`                       | array of objects                                | Pixalate's overall advertising risk rating, blending brand safety, invalid traffic and inventory risk factors, with the reasons behind it. |
| `riskOverview.risk[].region`              | string: `GLOBAL`, `NA`, `EMEA`, `LATAM`, `APAC` | A geographic region. `GLOBAL` indicates an aggregate of all regions.                                                                       |
| `riskOverview.risk[].device`              | string: `GLOBAL`, `smartphone`, `tablet`        | The device. `GLOBAL` indicates an aggregate of all devices.                                                                                |
| `riskOverview.risk[].pixalateRisk`        | string: `low`, `medium`, `high`                 | Pixalate's overall risk rating.                                                                                                            |
| `riskOverview.risk[].pixalateRiskReasons` | array of strings                                | Reasons for the rating. See [Risk reasons](#risk-reasons).                                                                                 |

## developerOverview

The developer's name, contact details, policies and social media risk.

| Field                                     | Type                            | Description                                                                      |
| ----------------------------------------- | ------------------------------- | -------------------------------------------------------------------------------- |
| `developerOverview.developerName`         | string                          | The business name of the app's developer.                                        |
| `developerOverview.developerLocation`     | string                          | The business address of the app's developer.                                     |
| `developerOverview.developerEmail`        | string                          | The contact email address of the app's developer.                                |
| `developerOverview.developerCountry`      | string                          | The country of the app's developer.                                              |
| `developerOverview.developerWebsite`      | string                          | The website of the app's developer.                                              |
| `developerOverview.developerTotalApps`    | integer                         | The total number of apps available from the developer.                           |
| `developerOverview.privateDomain`         | boolean                         | `true` if app's domain is privately registered.                                  |
| `developerOverview.hasTermsAndConditions` | boolean                         | `true` if app has terms and conditions.                                          |
| `developerOverview.hasPrivacyPolicy`      | boolean                         | `true` if app has privacy policy.                                                |
| `developerOverview.facebookRisk`          | string: `low`, `medium`, `high` | The Facebook risk. Low social media engagement on Facebook can be a risk factor. |
| `developerOverview.linkedInRisk`          | string: `low`, `medium`, `high` | The LinkedIn risk. Low social media engagement on LinkedIn can be a risk factor. |
| `developerOverview.twitterRisk`           | string: `low`, `medium`, `high` | The Twitter risk. Low social media engagement on Twitter can be a risk factor.   |

## trafficOverview

Spoofing, location masking, IVT and viewability risks, audience size, inventory and ad spend.

| Field                                         | Type                            | Description                                                                                                      |
| --------------------------------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `trafficOverview.spoofingRisk`                | string: `low`, `medium`, `high` | The risk the app may be misrepresented in advertising transactions and ads delivered to a different app or site. |
| `trafficOverview.locationMaskingRisk`         | string: `low`, `medium`, `high` | The risk that location data is inaccurate for advertising transactions involving the app.                        |
| `trafficOverview.advertisingIvtRisk`          | string: `low`, `medium`, `high` | The risk of advertising impressions delivered to the app being due to invalid traffic.                           |
| `trafficOverview.clickIvtRisk`                | string: `low`, `medium`, `high` | The risk that clicks originating from ads on the app are fraudulent.                                             |
| `trafficOverview.viewabilityRisk`             | string: `low`, `medium`, `high` | The risk of IAB viewability standards not being met for ad impressions on the app.                               |
| `trafficOverview.estimatedDailyActiveUsers`   | integer                         | The estimated daily active users of the app.                                                                     |
| `trafficOverview.estimatedMonthlyActiveUsers` | integer                         | The estimated monthly active users of the app.                                                                   |
| `trafficOverview.inventory`                   | integer                         | The estimated number of monthly impressions this app makes available programmatically.                           |
| `trafficOverview.adSpend`                     | number                          | Total estimated monthly ad spend on this app.                                                                    |

## brandSafety

Brand safety risk from the app's descriptive text and from its visual content.

| Field                                                           | Type                            | Description                                                                                                                                                   |
| --------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `brandSafety.descriptionBrandSafety`                            | object                          | App descriptive text is processed through natural language algorithms and comprehensive categorical dictionaries to predict the advertiser brand safety risk. |
| `brandSafety.descriptionBrandSafety.descriptionBrandSafetyRisk` | string: `low`, `medium`, `high` | The overall description risk to advertiser brand safety from the app.                                                                                         |
| `brandSafety.descriptionBrandSafety.advisoriesRisk`             | string: `low`, `medium`, `high` | The risk to brand safety derived from the app's content advisories.                                                                                           |
| `brandSafety.descriptionBrandSafety.adultContentRisk`           | string: `low`, `medium`, `high` | The risk to brand safety from adult themed content based on textual analysis of the app and its descriptive content.                                          |
| `brandSafety.descriptionBrandSafety.drugContentRisk`            | string: `low`, `medium`, `high` | The risk to brand safety from drug themed content based on textual analysis of the app and its descriptive content.                                           |
| `brandSafety.descriptionBrandSafety.alcoholContentRisk`         | string: `low`, `medium`, `high` | The risk to brand safety from Alcohol themed content based on textual analysis of the app and its descriptive content.                                        |
| `brandSafety.descriptionBrandSafety.hateSpeechRisk`             | string: `low`, `medium`, `high` | The risk to brand safety from hate speech content based on textual analysis of the app and its descriptive content.                                           |
| `brandSafety.descriptionBrandSafety.offensiveContentRisk`       | string: `low`, `medium`, `high` | The risk to brand safety from content with offensive language based on textual analysis of the app and its descriptive content.                               |
| `brandSafety.descriptionBrandSafety.gamblingContentRisk`        | string: `low`, `medium`, `high` | The risk to brand safety from gambling focused content based on textual analysis of the app and its descriptive content.                                      |
| `brandSafety.descriptionBrandSafety.violenceContentRisk`        | string: `low`, `medium`, `high` | The risk to brand safety from violence-themed content, based on textual analysis of the app and its descriptive content.                                      |
| `brandSafety.contentBrandSafety`                                | object                          | In-app visual content is processed through an advanced machine learning algorithm and evaluated for risk to advertiser brand safety.                          |
| `brandSafety.contentBrandSafety.contentBrandSafetyRisk`         | string: `low`, `medium`, `high` | The overall content risk to advertiser brand safety from the app.                                                                                             |
| `brandSafety.contentBrandSafety.adultRisk`                      | string: `low`, `medium`, `high` | The risk to brand safety from potential adult images and content detected within the app.                                                                     |
| `brandSafety.contentBrandSafety.violenceRisk`                   | string: `low`, `medium`, `high` | The risk to brand safety from potential violent imagery and content detected within the app.                                                                  |
| `brandSafety.contentBrandSafety.imageData`                      | array of objects                | The image by image breakdown of brand safety risk factors based on advanced image processing and machine learning.                                            |
| `brandSafety.contentBrandSafety.imageData[].url`                | string                          | A URL to the image.                                                                                                                                           |
| `brandSafety.contentBrandSafety.imageData[].text`               | string                          | The extracted text.                                                                                                                                           |
| `brandSafety.contentBrandSafety.imageData[].violenceRisk`       | string: `low`, `medium`, `high` | The risk to brand safety from potential violence images and any extracted text.                                                                               |
| `brandSafety.contentBrandSafety.imageData[].spoofRisk`          | string: `low`, `medium`, `high` | The risk to brand safety from potential spoofing based on images and any extracted text.                                                                      |
| `brandSafety.contentBrandSafety.imageData[].medicalRisk`        | string: `low`, `medium`, `high` | The risk to brand safety from potential medical images and any extracted text.                                                                                |
| `brandSafety.contentBrandSafety.imageData[].adultRisk`          | string: `low`, `medium`, `high` | The risk to brand safety from potential adult images and any extracted text.                                                                                  |

## appPermissions

The permissions the app requests and the IVT risk they carry.

| Field                                           | Type                            | Description                                                                                                                                                                                                                                                    |
| ----------------------------------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `appPermissions.ivtPermissionRisk`              | string: `low`, `medium`, `high` | The IVT Risk based on the combined risk of the permissions.                                                                                                                                                                                                    |
| `appPermissions.permissions`                    | array of objects                | List of permissions.                                                                                                                                                                                                                                           |
| `appPermissions.permissions[].name`             | string                          | The permission name.                                                                                                                                                                                                                                           |
| `appPermissions.permissions[].description`      | string                          | The permission description.                                                                                                                                                                                                                                    |
| `appPermissions.permissions[].isDangerous`      | boolean                         | `true` if this is a dangerous permission: one that touches the user's private information or could affect the user's stored data or other apps, so the user must grant it explicitly. Normal permissions carry little privacy risk and are granted at install. |
| `appPermissions.permissions[].ivtPermissonRisk` | string: `low`, `medium`, `high` | The IVT Risk for the permission.                                                                                                                                                                                                                               |

## trafficOverlap

How much of the app's audience and inventory overlaps with other apps.

| Field                             | Type   | Description                                                                                           |
| --------------------------------- | ------ | ----------------------------------------------------------------------------------------------------- |
| `trafficOverlap.userOverlap`      | number | The percentage of users of the given app that also visit the app.                                     |
| `trafficOverlap.inventoryOverlap` | number | The percentage of impressions of the given app that were generated by the users that visited the app. |

## authorizedSellers

The sell-side platforms selling the app's inventory, with volume, IVT and viewability for each.

| Field                                     | Type             | Description                                                                                           |
| ----------------------------------------- | ---------------- | ----------------------------------------------------------------------------------------------------- |
| `authorizedSellers`                       | array of objects | The contribution of various sell side platforms to programmatic ad impressions sold on the app.       |
| `authorizedSellers[].exchange`            | string           | The name of the exchange.                                                                             |
| `authorizedSellers[].paymentType`         | string           | How the seller is categorized, for example `Direct`.                                                  |
| `authorizedSellers[].inventory`           | integer          | The estimated number of monthly impressions this app makes available programmatically by this seller. |
| `authorizedSellers[].inventoryRatio`      | number           | The average inventory ratio for ad impressions on the app by this seller.                             |
| `authorizedSellers[].ivt`                 | number           | The average IVT for ad impressions on the app by this seller.                                         |
| `authorizedSellers[].videoInventoryRatio` | number           | The average video inventory ratio for ad impressions on the app by this seller.                       |
| `authorizedSellers[].viewability`         | number           | The average viewability for ad impressions on the app by this seller.                                 |

## invalidTraffic

IVT, GIVT and SIVT percentages, with a breakdown by IVT type.

| Field                                  | Type             | Description                                                                                                                                                                  |
| -------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalidTraffic.ivt`                   | number           | The total percentage of non-human traffic measured on the app.                                                                                                               |
| `invalidTraffic.givt`                  | number           | GIVT refers to General Invalid Traffic - Deterministically judged to be non-human traffic; high to very high risk.                                                           |
| `invalidTraffic.sivt`                  | number           | SIVT refers to Sophisticated Invalid Traffic - Probabilistically judged to be non-human traffic using advanced statistical detection methods; moderate to high risk traffic. |
| `invalidTraffic.givtTypes`             | array of objects | The percentage of invalid traffic associated with each Pixalate's taxonomy of GIVT invalid traffic types.                                                                    |
| `invalidTraffic.givtTypes[].fraudType` | string           | The GIVT type.                                                                                                                                                               |
| `invalidTraffic.givtTypes[].givt`      | number           | GIVT refers to General Invalid Traffic - Deterministically judged to be non-human traffic; high to very high risk.                                                           |
| `invalidTraffic.sivtTypes`             | array of objects | The percentage of invalid traffic associated with each Pixalate's taxonomy of SIVT invalid traffic types.                                                                    |
| `invalidTraffic.sivtTypes[].fraudType` | string           | The type of SIVT fraud.                                                                                                                                                      |
| `invalidTraffic.sivtTypes[].sivt`      | number           | SIVT refers to Sophisticated Invalid Traffic - Probabilistically judged to be non-human traffic using advanced statistical detection methods; moderate to high risk traffic. |

## viewability

Average viewability and viewability risk, overall and by ad size.

| Field                                    | Type                            | Description                                                                        |
| ---------------------------------------- | ------------------------------- | ---------------------------------------------------------------------------------- |
| `viewability.viewability`                | number                          | The average viewability for all display ad impressions in the app.                 |
| `viewability.viewabilityRisk`            | string: `low`, `medium`, `high` | The risk of IAB viewability standards not being met for ad impressions on the app. |
| `viewability.byAdSizes`                  | array of objects                | Viewability broken down by ad size.                                                |
| `viewability.byAdSizes[].adSize`         | string                          | The size of the ad.                                                                |
| `viewability.byAdSizes[].inventory`      | integer                         | The estimated volume of programmatic ad impressions by ad size.                    |
| `viewability.byAdSizes[].inventoryRatio` | number                          | The estimated percentage of inventory by ad size.                                  |
| `viewability.byAdSizes[].viewability`    | number                          | The average viewability for impressions by ad size.                                |

## inventory

Estimated programmatic impressions by device, region, country, ad size and DMA.

| Field                                 | Type             | Description                                                                 |
| ------------------------------------- | ---------------- | --------------------------------------------------------------------------- |
| `inventory.byDevice`                  | array of objects | The estimated volume of programmatic ad impressions broken down by device.  |
| `inventory.byDevice[].device`         | string           | The device.                                                                 |
| `inventory.byDevice[].inventory`      | integer          | The estimated volume of programmatic ad impressions by device.              |
| `inventory.byDevice[].inventoryRatio` | number           | The estimated percentage of inventory by device.                            |
| `inventory.byDevice[].ivt`            | number           | The total percentage of non-human traffic measured on the app by device.    |
| `inventory.byDevice[].viewability`    | number           | The average viewability for impressions by device.                          |
| `inventory.byRegion`                  | array of objects | The estimated volume of programmatic ad impressions broken down by region.  |
| `inventory.byRegion[].region`         | string           | The region.                                                                 |
| `inventory.byRegion[].inventory`      | integer          | The estimated volume of programmatic ad impressions by region.              |
| `inventory.byRegion[].inventoryRatio` | number           | The estimated percentage of inventory by region.                            |
| `inventory.byRegion[].ivt`            | number           | The total percentage of non-human traffic measured on the app by region.    |
| `inventory.byRegion[].viewability`    | number           | The average viewability for impressions by region.                          |
| `inventory.byCounty`                  | array of objects | The estimated volume of programmatic ad impressions broken down by country. |
| `inventory.byCounty[].countryName`    | string           | The country name.                                                           |
| `inventory.byCounty[].inventory`      | integer          | The estimated volume of programmatic ad impressions by country.             |
| `inventory.byCounty[].inventoryRatio` | number           | The estimated percentage of inventory by country.                           |
| `inventory.byCounty[].ivt`            | number           | The total percentage of non-human traffic measured on the app by country.   |
| `inventory.byCounty[].viewability`    | number           | The average viewability for impressions by country.                         |
| `inventory.byAdsize`                  | array of objects | The estimated volume of programmatic ad impressions broken down by ad size. |
| `inventory.byAdsize[].adSize`         | string           | The ad size.                                                                |
| `inventory.byAdsize[].inventory`      | integer          | The estimated volume of programmatic ad impressions by ad size.             |
| `inventory.byAdsize[].inventoryRatio` | number           | The estimated percentage of inventory by ad size.                           |
| `inventory.byAdsize[].ivt`            | number           | The total percentage of non-human traffic measured on the app by ad size.   |
| `inventory.byAdsize[].viewability`    | number           | The average viewability for impressions by ad size.                         |
| `inventory.byDma`                     | array of objects | The estimated volume of programmatic ad impressions broken down by DMA.     |
| `inventory.byDma[].dmaName`           | string           | The DMA name.                                                               |
| `inventory.byDma[].inventory`         | integer          | The estimated volume of programmatic ad impressions by DMA.                 |
| `inventory.byDma[].inventoryRatio`    | number           | The estimated percentage of inventory by DMA.                               |
| `inventory.byDma[].ivt`               | number           | The total percentage of non-human traffic measured on the app by DMA.       |
| `inventory.byDma[].viewability`       | number           | The average viewability for impressions by DMA.                             |

## ctr

Click-through rate, overall and by ad size.

| Field                   | Type             | Description                                  |
| ----------------------- | ---------------- | -------------------------------------------- |
| `ctr.ctr`               | number           | The overall average CTR for this app.        |
| `ctr.byAdSize`          | array of objects | The CTR for this app broken down by ad size. |
| `ctr.byAdSize[].adSize` | string           | The ad size.                                 |
| `ctr.byAdSize[].ctr`    | number           | The Click Through Rate.                      |

## availableCountries

The countries where the app is available.

| Field                | Type             | Description                    |
| -------------------- | ---------------- | ------------------------------ |
| `availableCountries` | array of strings | A list of available countries. |

## rankings

Region and category rank, plus grades and scores across several dimensions.

| Field                           | Type    | Description                                       |
| ------------------------------- | ------- | ------------------------------------------------- |
| `rankings.regionRank`           | integer | The rank of the app within the requested region.  |
| `rankings.categoryRank`         | integer | The rank of the app within its category.          |
| `rankings.category`             | string  | The category of the app.                          |
| `rankings.final`                | object  | The final grade and score for the app.            |
| `rankings.final.grade`          | string  | The final grade for the app.                      |
| `rankings.final.score`          | string  | The final score for the app.                      |
| `rankings.ivt`                  | object  | The IVT grade and score for the app.              |
| `rankings.ivt.grade`            | string  | The IVT grade for the app.                        |
| `rankings.ivt.score`            | string  | The IVT score for the app.                        |
| `rankings.adsTxt`               | object  | The ads.txt grade and score for the app.          |
| `rankings.adsTxt.grade`         | string  | The ads.txt grade for the app.                    |
| `rankings.adsTxt.score`         | string  | The ads.txt score for the app.                    |
| `rankings.brandSafety`          | object  | The brand safety grade and score for the app.     |
| `rankings.brandSafety.grade`    | string  | The brand safety grade for the app.               |
| `rankings.brandSafety.score`    | string  | The brand safety score for the app.               |
| `rankings.viewability`          | object  | The viewability grade and score for the app.      |
| `rankings.viewability.grade`    | string  | The viewability grade for the app.                |
| `rankings.viewability.score`    | string  | The viewability score for the app.                |
| `rankings.permissions`          | object  | The permissions grade and score for the app.      |
| `rankings.permissions.grade`    | string  | The permissions grade for the app.                |
| `rankings.permissions.score`    | string  | The permissions score for the app.                |
| `rankings.popularity`           | object  | The popularity grade and score for the app.       |
| `rankings.popularity.grade`     | string  | The popularity grade for the app.                 |
| `rankings.popularity.score`     | string  | The popularity score for the app.                 |
| `rankings.globalPopularityRank` | string  | The overall global popularity ranking of the app. |

## rankingsByCountry

Reach and market share rankings by country.

| Field                                            | Type             | Description                                                  |
| ------------------------------------------------ | ---------------- | ------------------------------------------------------------ |
| `rankingsByCountry.reach`                        | array of objects | The reach of the app broken down by country.                 |
| `rankingsByCountry.reach[].countryCode`          | string           | The ISO ALPHA-2 standard country code.                       |
| `rankingsByCountry.reach[].countryName`          | string           | The country name.                                            |
| `rankingsByCountry.reach[].mauRank`              | string           | The current MAU ranking for the app for this country.        |
| `rankingsByCountry.reach[].mauRankChange`        | string           | The change in MAU rank since last assessment.                |
| `rankingsByCountry.marketShare`                  | array of objects | The market share of the app broken down by country.          |
| `rankingsByCountry.marketShare[].countryCode`    | string           | The ISO ALPHA-2 standard country code.                       |
| `rankingsByCountry.marketShare[].countryName`    | string           | The country name.                                            |
| `rankingsByCountry.marketShare[].impressionRank` | string           | The current impression ranking for the app for this country. |
| `rankingsByCountry.marketShare[].impsRankChange` | string           | The change in impression ranking since last assessment.      |

## coppa

Signals related to the Children's Online Privacy Protection Act (COPPA): audience, COPPA risk and data practices.

| Field                             | Type                            | Description                                                                                                                                                                                                               |
| --------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `coppa.coppaAudience`             | string                          | Assesses the likely intended audience of an app based on a variety of factors including app store categories, content ratings, and keywords, etc.                                                                         |
| `coppa.coppaAudienceReason`       | array of strings                | Describes the specific variables considered when making the audience assessment.                                                                                                                                          |
| `coppa.storeCategory`             | array of strings                | The associated category of an app according to the Google Play Store & Apple’s App Store.                                                                                                                                 |
| `coppa.storeSubCategory`          | array of strings                | The associated subcategory from Google Play Store & Apple’s App Store.                                                                                                                                                    |
| `coppa.contentRating`             | string                          | The recommended age rating defined by the Apple's app store or the content rating provided by Google play store.                                                                                                          |
| `coppa.isApprovedByTeacher`       | boolean                         | Google Play’s program in which apps are evaluated by teachers and other specialists and for age and content appropriateness.                                                                                              |
| `coppa.ageGroupApprovedByTeacher` | string                          | The recommended age group as approved by teachers.                                                                                                                                                                        |
| `coppa.coppaViolationRisk`        | string: `low`, `medium`, `high` | Pixalate analyzes multiple signals and produces a risk score (low, medium, or high) that captures the potential COPPA risk.                                                                                               |
| `coppa.coppaViolationRiskReason`  | array of strings                | Describes the specific variables considered when making the overall COPPA risk rating assessment.                                                                                                                         |
| `coppa.privacyPolicyDetected`     | boolean                         | Pixalate determines whether an app has a privacy policy based on information provided in the app stores. Additionally, Pixalate uses crawlers to scan developer websites for privacy policies.                            |
| `coppa.sensitivePermissions`      | boolean                         | Detects mobile device permissions granted to the app such as camera, microphone, contacts, etc. which allow for sensitive personal information collection.                                                                |
| `coppa.transmitsResidentialIP`    | boolean                         | Pixalate examines the traffic associated with an app and determines if the end-user IP is transmitted through the advertising pipeline that can expose granular information about the user’s location.                    |
| `coppa.passesLocation`            | boolean                         | Pixalate examines the traffic associated with an app and determines if the end-users’ GPS coordinates are being transmitted through the advertising pipeline that exposes granular information about the user’s location. |
| `coppa.permissions`               | array of objects                | Lists the device permissions granted to the app, reports those considered sensitive permissions related to COPPA.                                                                                                         |
| `coppa.permissions[].name`        | string                          | The name of the permission.                                                                                                                                                                                               |
| `coppa.permissions[].description` | string                          | The permissions description.                                                                                                                                                                                              |

## mfa

Made-for-advertising (MFA) risk and ad refresh rate.

| Field               | Type                            | Description                                                                                                                                                                                                                                            |
| ------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `mfa.mfaRisk`       | string: `low`, `medium`, `high` | Pixalate's made-for-advertising risk rating for the app.                                                                                                                                                                                               |
| `mfa.adRefreshRate` | number, nullable                | Pixalate's ad refresh rate signal: the volume of ad impressions observed per device over time, not how often an individual ad slot refreshes. See [MFA methodology](/compliance/mfa-methodology#ad-refresh-rate). Null when it couldn't be determined. |

## Risk reasons

Values that can appear in `riskOverview.risk[].pixalateRiskReasons`.

* Significantly Elevated IVT Percentage
* Publisher Maintains Non-corporate Email Address
* Moderately Elevated IVT Percentage
* Publisher Does Not Publish a Privacy Policy
* The Publisher Hides their Corporate Details in the Domain Registry
* The Publisher's Email Address Doesn't Match Their Domain
* Adult Content Has Been Detected in the app
* The Publisher Does Not Publish Terms and Conditions
* The Publisher Domain is Invalid
* Gambling Content Has Been Detected in the app
* Programmatic Ads Not Detected Leads to High Spoofing Risk
* Violent Content Has Been Detected in the app
* Alcohol Based Content Has Been Detected in the app
* Ad Traffic Shows Some Suspicious Characteristics
* Profanity and Offensive Language Has Been Detected in the app
* App Description Uses Some Brand Unsafe Language
* App Has a High Frequency of Invalid Clicks

## Blocklist reasons

Values that can appear in `appDetails.blocklistedReasons`. Both capitalizations of "App is No Longer in Active Use" are listed because both are declared values.

* Ad Inventory from the app is Frequently Spoofed
* App is No Longer in Active Use
* Variety of Suspicious app Characteristics
* High Volumes of Datacenter Traffic Detected
* Limited History of Low Risk Advertising Traffic
* The app is a VPN
* Location Coordinates from the app are Commonly Inaccurate or Spoofed
* An app that belongs to a developer that has created one or more blacklisted apps
* App is No Longer in Active use
* Significantly Elevated IVT Percentage

## Interactive elements

Values that can appear in `appDetails.interactiveELements`.

* Shares Info
* Shares Location
* Users Interact
* Digital Purchases
* Unrestricted Internet
* In-app Purchases
* In-Game Purchases