Setting Up IronSource
Cost Aggregation
Set up data connector
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
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.
