Unmapped Data FAQ

Learn about what "unmapped data" is, why it happens, and how you can view it in your reports. To learn about all your reporting options and settings, see the Reports FAQ.


General Questions

What is unmapped data?

Unmapped data is data that is not mapped to an app and platform.

When Singular pulls data from ad networks, it tries to map every piece of campaign or ad monetization data to the app and platform it belongs to. The goal is for you to be able to view and analyze the performance of each of your apps.

By default, unmapped data is not included in your report. You can check the Show unmapped data checkbox to include it in the report.

Why does unmapped data occur?

Many networks do include the app and platform information in their reports, or even better - the App Site ID, which encapsulates both the app and the platform in the most accurate way.

However, some networks do not provide these fields or provide them in a problematic way, e.g. the app name may be spelled differently than in Singular. In these cases, Singular tries to map the data to the app and platform on its own in several ways. If all the mapping efforts fail, you get unmapped data.

How does Singular auto-map data to an app and platform?

When a network doesn’t provide the App Site ID or the app/network, Singular tries several methods of automatic mapping, including:

For example:


What does the “Show Unmapped Data” checkbox do?

If you check this box, your report will include unmapped data. Mostly, this means you will see some "N/A" values in the App and/or Platform fields.

You can use the Show Unmapped Data functionality to troubleshoot the source of unexpected or missing data. For example, if you don’t see any campaign performance data for one of your apps, it may be because that app's campaign data is unmapped.

I have unmapped data - what do I do?
  1. As a best practice, we encourage you to talk to your network about providing the App Site ID in its reports.
  2. It is also good practice to keep your app name consistent:
    • When you set up a campaign with an ad network, make sure to name your app the same way you named it in Singular (in the App Configuration page) - in the same language, and with the same spelling, spacing, etc.
    • Then, make sure your campaign name includes the app name correctly (and also the platform). This way, Singular will be able to map the campaign data to the app.

      Note: Beware of using different languages. For example, if you set up your app in Singular in Japanese, but then work with an ad network that only accepts app/campaign names in English, Singular will not be able to auto-map the data to the app.

  3. Singular also provides the option to add mapping keys to your app sites. A mapping key is a unique code, typically shorter and simpler than the app name, that you can define for an app site in Singular and then add it to your campaign names. Learn more about mapping keys.
Was this article helpful?