Bing Ads API Reports

How to link your Bing Ads credentials, reports, and parameter blacklist/restrictions in the Cognetik Cloud Connector.

How to link Bing Ads credentials in the Cognetik Cloud Connector

After accessing the connector and creating a Cognetik account, you need to link your Bing Ads (Microsoft) credentials in order to bring your data into Tableau.

Here’s how you do that:

  1. Go to 'Link a new credential' and then select Bing Ads from the data source list
  2. Enter your Bing Ads (Microsoft) credentials and click ‘Next.’
  3. The query page is displayed and you can now query the data you need.

Read more about how to link your credentials here.

Bing Ads reports available in Cognetik

  1. Account
  2. Ad Group
  3. Campaign
  4. Destination URL

1. Account

Defines an account performance report request. Use this report to observe long-term account performance and trends. You can request impressions, impression share (%), clicks, spend, and average cost per click for individual accounts.

For a complete list of the parameters (metrics and dimensions) supported by this report, please refer to Bing ads API technical documentation.

Parameter Restrictions

For reports that include impression share performance metrics, you cannot include constrained dimensions in the same report request. If you include any of the impression share performance metrics, then you must exclude all of the below dimensions. Likewise, if you include any of the below dimensions, then you must exclude all of the impression share performance metrics.

The following dimensions and impression share performance metrics are mutually exclusive when submitting the AccountPerformanceReportRequest.

1-10

2. Ad Group Report

Defines an ad performance report request. Use this report to help you determine which ads lead to clicks and conversions, and which are not performing. Having underperforming ads in your account can pull down the quality of your campaigns.

You can request impressions, clicks, spend, and average cost per click for each ad. Once downloaded, this data can be sorted by ad ID, ad status, ad title, display URL, and destination URL.

For a complete list of the parameters (metrics and dimensions) supported by this report, please refer to Bing ads API technical documentation.

Parameter Restrictions

For reports that include impression share performance metrics you cannot include constrained dimensions in the same report request. If you include any of the impression share performance metrics, then you must exclude all of the below dimensions. Likewise, if you include any of the below dimensions, then you must exclude all of the impression share performance metrics.

The following dimensions and impression share performance metrics are mutually exclusive when submitting the AdGroupPerformanceReportRequest.

2-4

3. Campaign

Defines a campaign performance report request. Use this report to view high-level performance metrics and quality dimensions for each campaign or account. This is also a quick way to flag any major campaign or account problems.

You can request impressions, impression share (%), clicks, spend, and average cost per click for each campaign or account. Once downloaded, this data can be sorted by campaign, campaign status, and quality score.

For a complete list of the parameters (metrics and dimensions) supported by this report, please refer to Bing ads API technical documentation

Parameter Restrictions

For reports that include impression share performance metrics you cannot include constrained dimensions in the same report request. If you include any of the impression share performance metrics, then you must exclude all of the below dimensions. Likewise, if you include any of the below dimensions, then you must exclude all of the impression share performance metrics.

The following dimensions and impression share performance metrics are mutually exclusive when submitting the CampaignPerformanceReportRequest.

3-2

4. Destination URL

Defines a destination URL performance report request. Use this report to identify landing pages that met audience expectations and potentially resulted in high click-through or conversion rates.

You can request impressions, clicks, spend, and average cost per click for your landing pages. Once downloaded, this data can be sorted by destination URL, account, campaign, and ad group.

For a complete list of the parameters (metrics and dimensions) supported by this report, please refer to Bing ads API technical documentation.

Granularity API limitations

To see how far back hourly, daily, weekly, monthly, yearly and summary aggregated data can be retrieved for a report, please refer to Bing's documentation.