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