Integrating Bing Ads on Clarisights
Connect your Microsoft Advertising accounts (formerly Bing Ads) to Clarisights to track campaign, ad group, ad, and keyword performance across Microsoft Search alongside the rest of your marketing stack.
At a glance
| Authentication | OAuth 2.0 (Microsoft / Azure AD) plus a Microsoft Advertising Developer Token |
| Permissions needed | Super Admin, Standard User, Advertiser Campaign Manager, or Viewer role on each ad account |
| Account discovery | Automatic on credential validation |
| Data freshness | Hourly account-object updates; performance reports refreshed daily |
| Lookback window | Rolling daily window with conversion-attribution backfill |
| Backfill on connect | Last 30 days |
| Timezone | Account timezone (configured in Microsoft Advertising; mapped to IANA timezones by Clarisights) |
| Currency | Account native currency (auto-converted via Currency Conversion) |
| Levels supported | Account · Campaign · Ad Group · Ad · Keyword |
| Limited rollout | Yes — beta |
Prerequisites
An active Microsoft Advertising account
A Microsoft user role on the ad account: Super Admin, Standard User, Advertiser Campaign Manager, or Viewer
A Microsoft Advertising Developer Token. You can request one from the Microsoft Advertising Developer Account page. Use the universal token tied to your account.
Permission to authorize third-party apps on your Microsoft account
Steps to Connect
Step 1 — Start the connection from Clarisights
In Clarisights, go to Integrations, find the Bing tile, and click + Connect.
[TODO: Screenshot needed — Integrations page with Bing tile and Connect button]
Step 2 — Get your Microsoft Advertising Developer Token
Open the Microsoft Advertising Developer Account page and copy the Developer Token assigned to your account. If you don't have one yet, request a token from this page — the universal token works for both production and sandbox calls.
[TODO: Screenshot needed — Microsoft Advertising Developer Account page with Developer Token highlighted]
Step 3 — Paste the Developer Token into Clarisights
Paste the Developer Token into the Request Token field on the Bing integration screen and click OK.
[TODO: Screenshot needed — Clarisights Bing integration screen with Developer Token field]
Step 4 — Sign in to Microsoft and authorize Clarisights
You'll be redirected to Microsoft's sign-in page. Sign in with the Microsoft account that has access to the ad accounts you want to connect, and approve the requested permissions (read & manage scope on Microsoft Advertising). Verify the password if prompted.
Common error: "AADSTS50020: User account does not exist in tenant" → You signed in with a Microsoft account that isn't a user on this Microsoft Advertising account. Sign out, sign back in with the correct account, and retry.
Common error: "Invalid developer token" → The token you pasted is incorrect or expired. Re-copy it from the Developer Account page and paste it again.
Step 5 — Select ad accounts
After authorization, Clarisights automatically lists every Microsoft Advertising account your user has access to. Tick the accounts you want to connect and confirm.
[TODO: Screenshot needed — Account selection screen]
Step 6 — Confirm
You'll land on the integrations page with each connected account listed. From here you can enable / disable accounts and refresh the OAuth token.
[TODO: Screenshot needed — Integrations page after Bing is connected]
Verify the connection
Go to Integrations → Bing. Each connected account should show as Active.
Account-level objects (campaigns, ad groups, ads, keywords) start syncing within an hour. Performance reports populate within 24 hours.
Quick start: create a report, add Bing as the data source, and add Account · Campaign · Impressions · Clicks · Spend.
Data available
Hierarchy
How Microsoft Advertising's native levels map to standard Clarisights levels:
Native level (Microsoft Advertising) | Clarisights level |
Account (Customer / Customer Account) | Account |
Campaign | Campaign |
Ad Group | Ad Group |
Ad | Ad |
Keyword | Keyword (under the Ad Group it belongs to) |
Performance Max ad groups are mapped from the native Asset Group level into the standard Ad Group level for unified reporting.
Dimensions
Account
Dimension | Description |
Account | Microsoft Advertising account name |
Account ID | Customer / Customer Account ID |
Account Currency | Native currency configured on the account |
Account Timezone | Reporting timezone configured on the account |
Campaign
Dimension | Description |
Campaign Status | Active, Paused, Deleted, Suspended |
Campaign Type | Search, Audience, Shopping, Performance Max, etc. |
Daily Budget | Daily budget configured on the campaign |
Bidding Strategy Type | Manual CPC, Enhanced CPC, Maximize Clicks, Target CPA, etc. |
Ad Group
Dimension | Description |
Ad Group Status | Active, Paused, Deleted |
Ad Group Bid | Default bid set at the ad group |
Medium | Search / Audience / Performance Max |
Ad
Dimension | Description |
Ad Status | Active, Paused, Disapproved, etc. |
Ad Type | Expanded Text Ad, Responsive Search Ad, Product Ad, etc. |
Title Part 1 / Title Part 2 | Headline parts |
Ad Text | Ad description copy |
Landing Pages | Final URL configured on the ad |
Keyword
Dimension | Description |
Keyword Status | Active, Paused, Deleted |
Quality Score | Microsoft Advertising quality score (1–10) |
Est. First Page Bid | Estimated bid required to show on the first page |
Est. Mainline Bid | Estimated bid required to show in the mainline |
Est. Best Position Bid | Estimated bid required to show in the best (top) position |
Metrics
Core delivery
Metric | Description |
Impressions | Total ad impressions |
Clicks | Total clicks on the ad |
Spend | Total spend in your reporting currency |
Spend (Local) | Total spend in the account's native currency |
CTR | Clicks / Impressions |
Avg. CPC | Spend / Clicks |
Avg. CPM | Spend / Impressions × 1000 |
Conversions & revenue
Metric | Description |
Conversions | Total reported conversions |
Conv. Rate | Conversions / Clicks |
CPA | Spend / Conversions |
Revenue | Reported revenue (converted to your reporting currency) |
ROAS | Revenue / Spend ("Revenue on ad spend") |
Assists | Assisted conversions |
Custom conversions
Each conversion goal you configure in Microsoft Advertising is also exposed in Clarisights as a separate metric, prefixed with the Bing custom conversion namespace, so you can compare individual conversion goals side-by-side.
Position & visibility
Metric | Description |
Avg. Position | Weighted-by-impressions average position on the SERP |
Quality Score | Weighted-by-impressions average quality score (keyword level) |
Impressions on Top | Impressions served above the search results |
Impressions on Absolute Top | Impressions served as the very first ad above search results |
Total Available Impressions | Total impressions you were eligible for |
Eligible Impressions on Top | Impressions you were eligible to serve on top |
Eligible Impressions on Absolute Top | Impressions you were eligible to serve on absolute top |
Limitations & known constraints
Beta integration: the Bing connector is currently in limited rollout (beta). Available metrics and dimensions may evolve as we expand coverage. Talk to your CSM if a metric or dimension you need isn't listed.
Developer Token required: every Microsoft Advertising API call requires a Developer Token in addition to OAuth, so the token is mandatory at connection time.
Reporting delay: Microsoft Advertising reports can take up to 24 hours to fully reconcile, especially for conversion-attributed metrics.
Quality Score availability: Quality Score is reported at the keyword level and only for keywords with sufficient impressions. It is not available at the ad level.
Avg. Position deprecation: Microsoft Advertising deprecated Avg. Position in line with Google. Use Impressions on Top and Impressions on Absolute Top for current placement reporting.
Keyword limits: Microsoft enforces per-account keyword limits; very large keyword sets may take longer to fully ingest on first connection.
Token revocation: if you revoke Clarisights' access in your Microsoft account, the integration stops syncing until you re-authenticate.
Operating notes
Refresh schedule: account-object metadata (campaigns, ad groups, ads, keywords) is updated hourly. Performance reports are refreshed daily.
Lookback: a rolling daily window with conversion-attribution backfill so late-arriving conversions update past dates correctly.
Adding new ad accounts: when you add a new Microsoft Advertising account, return to Clarisights, re-open the Bing integration, and select the new account from the discovered list.
Currency conversion: native amounts are pulled as-is in
Spend (Local)and converted into your reporting currency inSpendby Clarisights' Currency Conversion service.Timezone mapping: Microsoft Advertising's named timezones (e.g.
PacificTimeUSCanadaTijuana) are mapped to standard IANA timezones (e.g.America/Los_Angeles) automatically.Credential rotation: OAuth tokens refresh automatically. You only need to re-authenticate if your Microsoft password changes, you revoke access, or your Developer Token is rotated.
Need help?
When contacting support from the in-app messenger, please include:
The integration name (Bing) and the Microsoft Advertising account ID
The exact error message or screenshot
The step where the issue occurred (Developer Token, Microsoft sign-in, account selection, or report data missing)
When the issue started and any recent changes (Microsoft password rotation, role change, Developer Token rotation, etc.)