Learn how Singular pulls advertising cost data from Bing Ads and displays it in your reports. Microsoft Advertising is a pay-per-click (PPC) advertising platform used to display ads based on the keywords used in a user's search query. See more here.
More details to come on Microsoft Store Ads. Learn more here. Singular is working on pulling campaign cost data for these campaigns. Microsoft does not support tracking links to allow MMPs to attribute Store Ads. Please talk to your Microsoft rep about using their SDK to track and attribute installs.
Quick Details
| Data connector technology | API |
| Data breakdown (segmentation) |
The following breakdowns are available:
|
| How far back we pull data | No limit |
| Time zone | Account timezone |
| Does the partner offer data for today? | Yes |
| Is data available on the creative level? | Yes |
| Does Singular show your creative assets? | Yes |
| Known limitations and issues | N/A |
Data Mapping
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 Bing |
| Dimensions | ||
| Account ID |
adn_account_id |
AdvertiserAccountId |
| Account Name |
adn_account_name |
AdvertiserAccountName |
| Country | country_field | Country |
| Keyword | keyword | Keyword |
| Keyword ID | keyword_id | KeywordId |
| Keyword Match Type | keyword_match_type | BidMatchType |
| Network Campaign ID | adn_campaign_id | campaignId |
| Network Campaign Name | adn_campaign_name | campaignName |
| Network Sub Campaign ID | adn_sub_campaign_id | adgroupid |
| Network Sub Campaign Name | adn_sub_campaign_name | adgroupname |
| Original Currency |
adn_original_currency |
currencycode |
| Platform | platform | DeviceOS |
| Tracking URL | tracking_url | TrackingTemplate |
| Quality Score | quality_score | HistoricalQualityScore |
| Creative ID |
creative_id |
adid |
| Creative Name |
creative_name |
ad.Title/ad.path/TitlePart1 (depends on the Creative type) |
| Creative Reported URL |
creative_reported_url |
ad.FinalUrls/ad.DestinationUrl |
| Text | creative_text |
ad.text |
| Metrics | ||
| Network Clicks | adn_clicks | Clicks |
| Network Impressions | adn_impressions | Impressions |
| Network Installs | adn_installs | Conversions |
| Original Cost | adn_original_cost | Spend |
Special Setup Instructions
Singular will make reporting API calls to Microsoft on your behalf. To ensure we can successfully fetch your Microsoft Ads performance data, please follow the configuration steps below in your Microsoft Entra (Azure AD) dashboard.
- Go to Microsoft Entra Admin Center (formerly Azure Active Directory).
- Sign in using the Microsoft account that manages your advertising app.
- Important: This must be the same tenant/account that owns the app used for API integration.
- Once logged in, go to App Registrations and open the relevant app.
- Under Overview, confirm that Supported account types is set to: All Microsoft account users.
- Go to Authentication. Under Platform configurations, ensure Mobile and desktop applications has the following URI configured:
- https://login.microsoftonline.com/common/oauth2/nativeclient
- https://login.live.com/oauth20_desktop.srf
- Check the settings for the Microsoft user credentials you will use to enter into Singular's Data Connector setup page and ensure that the user profile is set to "personal account".
Reporting Conversion Events from Microsoft in Singular
Based on your available events in Microsoft's platform, Singular can pull conversion events from Microsoft which will give you either conversion or revenue values. These are known as "Goals" in your Microsoft Account. The image below shows an example of events that could be available to connect within Singular. See more about Conversion Events here.