Bing Ads (Microsoft Advertising) Data Connector

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:

  • Country (Default)
  • Keyword
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
Account ID
Account Name
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
Platform platform DeviceOS
Tracking URL tracking_url TrackingTemplate
Quality Score quality_score HistoricalQualityScore
Creative ID
Creative Name
ad.Title/ad.path/TitlePart1 (depends on the Creative type)
Creative Reported URL
Text creative_text
Network Clicks adn_clicks Clicks
Network Impressions adn_impressions Impressions
Network Installs adn_installs Conversions
Original Cost adn_original_cost Spend


Special Setup Instructions

Microsoft dashboard setup

Singular will be making reporting API calls to Microsoft on your behalf, so you need to ensure two settings have been enabled to allow Singular to retrieve your marketing data:

1. Under Overview, make sure that Supported account type is set to All Microsoft account users

2. Under Authentication, ensure you have enabled the mobile and desktop redirect URIs as shown in the screenshot below:

3. 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.