Set up data connector
Updates [November 2021]:
- The Installs metric in Singular is now mapped from the Installs metric in IronSource.
- To track IronSource's Completions metric in Singular, you can create a conversion event (see instructions).
Quick Details
| Data Connector Technology | API (IronSource API v. 2) |
| Data breakdown (segmentation) | Data is broken down by Campaign, App, Country, Platform, App Site ID ("Title" in IronSource), and Publisher. |
| Time Zone | UTC |
| Is data available on the creative level? | Yes |
| Does Singular show your creative assets? | Yes |
| Known Limitations/ Issues | Sometimes IronSource does not provide platform data. |
Data Mapping
Tips:
- Singular's App corresponds to IronSource's Title.
- Singular's Publisher corresponds to IronSource's Application.
- For descriptions of each field in Singular reporting, see the Singular Metrics and Dimensions Glossary.
| Field in Singular UI | Field in Singular API | Field in IronSource |
| Dimensions | ||
| Account ID | adn_account_id | advertiser_id |
| App Site ID | app_site_id | title_bundle_id |
| Country | country_field | country |
| Date | date_field | day |
| Network Campaign ID | adn_campaign_id | campaign_id |
| Network Campaign Name | adn_campaign_name | campaign_name |
| OS | os | os |
| Platform | platform | device_type |
| Publisher ID | publisher_id | application_id |
| Publisher Site Name | publisher_site_name | application_name |
| Scraped App | app_name | title_name |
| Ad Type | ad_type | adUnit |
| Network Creative ID | adn_creative_id | creative_id |
| Network Creative Name | adn_creative_name | creative_name |
| Creative Format |
creative_format |
Values are: “Video & Carousel”, “Video & Full Screen”, “Video & Interactive End Card”, “Playable”, “Interactive Video” |
| Metrics | ||
| Cost | adn_cost | spend |
| Network Clicks | adn_clicks | clicks |
| Network Impressions | adn_impressions | impressions |
| Network Installs | adn_installs | installs |
Special Setup Instructions
Completions vs. installs
In the new version of the data connector, the "Installs" metric in Singular is based on IronSource's "installs" metric, and there is no default metric that is based on IronSource's "completions". However, you can track IronSource's completions by creating a conversion event in Singular.
To create a conversion event:
- In Singular, go to Settings > Events. If you have both Custom Events and Conversion Events tabs, select the Conversion Events tab.
- Click New Event.
-
In the IronSource dropdown, select "completions".
The next day, when Singular pulls daily data for your account, it will pull completions as well.
- After the new event is populated with some data, run a report in the Reports page, and choose the conversion event you created from Events dropdown.
Ironsource Cost Reporting
Ironsource historically reports installs and cost based on MMP data. With the introduction of SKAN and other hybrid measurement methods they have introduced the concept of “billable installs” and their cost is reflected based on their new modeled installs.
Their cost API offers different granularities - they support date, app, os, campaign, country. To view their modeled installs and reported cost you’ll need to take the following steps:
- Make sure you have an Ironsource data connector set up
- Head to Settings> Events
- Set up a new conversion event (legacy accounts can set up an event)
- Find the ironsource source
- Select any of the billable metrics and/or the cost event
- Hit save
Once this is set up you’ll see the relevant configured billable metrics in your reports. Keep in mind it’s not the same granularity as regular Ironsource data, so if you add a granularity that is not supported you will end up with two rows of data. There will not be any cohort data- only the cohort period: Actual is available.