Microsoft Advertising (Bing) - Reference for reports metrics and dimensions
Based on API version v13
Reports (34)
| Report | Description | # fields |
|---|---|---|
| Account Performance | Use this report to observe long-term account performance and trends. | 88 |
| Ad Dynamic Text Performance | Use this report to identify which dynamic text strings are performing well and which strings you should consider changing. | 54 |
| Ad Extension By Ad | Use this report to compare how well different versions of your ad extensions are performing with each ad. | 53 |
| Ad Extension By Keyword | Use this report to compare how well different versions of your ad extensions are performing for each keyword. | 49 |
| Ad Extension Detail | Use this report to discover the effectiveness of individual ad extension items, for example each link of a sitelink extension. | 48 |
| Ad Group Performance | Use this report to more broadly compare delivery performance statistics by ad group, campaign, or account attributes rather than at the keyword level. | 103 |
| Ad Performance | Use this report to help you determine which ads lead to clicks and conversions, and which are not performing. | 91 |
| Age Gender Audience | To discover how your campaigns and ad groups are resonating with different age groups and genders. | 33 |
| Asset Group Performance | Use this report to analyze the performance of your asset groups within your campaigns. | 17 |
| Audience Performance | Use this report to compare delivery performance statistics by audience, ad group, campaign, or account attributes. | 47 |
| Budget Summary | Use this report to discover how your campaign's budget is performing for the month. | 10 |
| Call Detail | Use this report to discover which accounts, campaigns, or ad groups are driving the most completed phone calls. | 15 |
| Campaign Performance | Use this report to view high-level performance statistics and quality attributes for each campaign or account. | 109 |
| Conversion Performance | Use this report to understand which campaigns and keywords are leading an audience to complete a purchase or other conversion action. | 41 |
| D S A Auto Target Performance | To understand how your dynamic ad targets are performing and where bid adjustments may be useful. | 56 |
| D S A Category Performance | Use this report to check the performance of your existing category targets or to find new categories worth targeting. | 52 |
| D S A Search Query Performance | Use this report see how your ads perform against search terms. | 57 |
| Destination Url Performance | Use this report to identify landing pages that met audience expectations and potentially resulted in high click-through or conversion rates. | 61 |
| Geographic Performance | Use this report to see which locations your traffic is coming from. | 67 |
| Goals And Funnels | Use this report to discover whether your audience completes each step through the land, browse, prospect, and conversion pages of your website. | 25 |
| Keyword Performance | Use this report to find out which keywords are performing well and those that are not. | 79 |
| Negative Keyword Conflict | Use this report to discover which keywords and negative keywords are in conflict. | 21 |
| Product Dimension Performance | Use this report to find out which product dimensions are performing well and those that are not. | 99 |
| Product Match Count | Use this report to see if you are covering and bidding across your Microsoft Shopping Campaigns inventory. | 18 |
| Product Negative Keyword Conflict | Use this report to identify conflicts between negative keywords and products within your campaigns. | 23 |
| Product Partition Performance | Use this report to find out which product partitions are performing well and those that are not. | 77 |
| Product Partition Unit Performance | Use this report to find out which product partition units are performing well and those that are not. | 63 |
| Product Search Query Performance | Use this report to get insight into what your audience is searching for when your ads are shown. | 54 |
| Professional Demographics Audience | Use this report to discover how your campaigns and ad groups are resonating with different companies, industries, and job functions. | 33 |
| Publisher Usage Performance | Use this report to see if any website URLs aren't performing well enough for your campaign or ad group target settings. | 55 |
| Search Campaign Change History | Use this report to discover when changes to an account were made, as well as which user made the changes. | 21 |
| Search Query Performance | Use this report to see what your audience is searching for when your ads are shown. | 57 |
| Share Of Voice | Use this report to view impression share (%) of successful bids for each keyword, and identify opportunities to increase impression share. | 60 |
| User Location Performance | Use this report to see which locations your traffic is coming from. | 68 |
Dimensions (186)
| Field | Type | Description | Reports |
|---|---|---|---|
| Accountid (accountid) | text | The Microsoft Advertising assigned identifier of an account. | 33/34 |
| Accountname (accountname) | text | The account name. | 34/34 |
| Accountnumber (accountnumber) | text | The Microsoft Advertising assigned number of an account. | 31/34 |
| Accountstatus (accountstatus) | text | The account status. | 29/34 |
| Addescription (addescription) | text | The first ad description that appears below the path in your ad. | 3/34 |
| Addescription2 (addescription2) | text | The second ad description that appears below the path in your ad. Ad description 2 might not appear in your ad. | 2/34 |
| Addistribution (addistribution) | text | The network where you want your ads to show.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 18/34 |
| Adextensionid (adextensionid) | text | The Microsoft Advertising assigned identifier of an ad extension. | 3/34 |
| Adextensionpropertyvalue (adextensionpropertyvalue) | text | The value of a specific property of an ad extension. | 1/34 |
| Adextensiontype (adextensiontype) | text | The type name that corresponds to the AdExtensionTypeId column. | 3/34 |
| Adextensiontypeid (adextensiontypeid) | text | The system identifier that corresponds to the AdExtensionType column. | 1/34 |
| Adextensionversion (adextensionversion) | text | The version attribute of an ad extension. | 3/34 |
| Adgroupcriterionid (adgroupcriterionid) | text | The Microsoft Advertising assigned identifier of an ad group criterion. | 6/34 |
| Adgroupid (adgroupid) | text | The Microsoft Advertising assigned identifier of an ad group. | 30/34 |
| Adgrouplabels (adgrouplabels) | text | The labels applied to the ad group. Labels are delimited by a semicolon (;) in the report download. | 1/34 |
| Adgroupname (adgroupname) | text | The ad group name. | 30/34 |
| Adgroupstatus (adgroupstatus) | text | The ad group status. | 25/34 |
| Adgrouptype (adgrouptype) | text | The ad group type. In a Search campaign, the possible values are 'SearchDynamic' and 'SearchStandard'. | 1/34 |
| Adid (adid) | text | The Microsoft Advertising assigned identifier of an ad.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 14/34 |
| Adlabels (adlabels) | text | The labels applied to the ad. Labels are delimited by a semicolon (;) in the report download. | 2/34 |
| Adrelevance (adrelevance) | text | How closely related your ads is to the customer's search query or other input. | 4/34 |
| Adstatus (adstatus) | text | The ad status.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 11/34 |
| Adstrength (adstrength) | text | The strength of the ad based on various factors such as relevance and quality. | 1/34 |
| Adstrengthactionitems (adstrengthactionitems) | text | Action items suggested to improve the ad strength. | 1/34 |
| Adtitle (adtitle) | text | The ad title. | 5/34 |
| Adtype (adtype) | text | The ad type. | 4/34 |
| Agegroup (agegroup) | text | The age group of the audience who might have viewed the ad, if known. | 1/34 |
| Areacode (areacode) | text | The area code where the user was physically located when they clicked the ad. | 1/34 |
| Assetgroupid (assetgroupid) | text | The Microsoft Advertising assigned identifier of an asset group. | 10/34 |
| Assetgroupname (assetgroupname) | text | The asset group name. | 10/34 |
| Assetgroupstatus (assetgroupstatus) | text | The asset group status. | 7/34 |
| Associationid (associationid) | text | The Microsoft Advertising assigned identifier of the association between the audience and either an ad group or campaign. | 1/34 |
| Associationlevel (associationlevel) | text | The level of the audience's association. | 1/34 |
| Associationstatus (associationstatus) | text | The status of the association between the audience and either an ad group or campaign. | 1/34 |
| Attributechanged (attributechanged) | text | Identifies the attribute or property of the entity from the ItemChanged column that changed. | 1/34 |
| Audienceid (audienceid) | text | The Microsoft Advertising assigned identifier of an audience, for example the remarketing list ID. | 1/34 |
| Audiencename (audiencename) | text | The audience name. | 1/34 |
| Audiencetype (audiencetype) | text | The type of audience targeted by the ad campaign. | 1/34 |
| Basecampaignid (basecampaignid) | text | The Microsoft Advertising assigned identifier of an experiment campaign. | 8/34 |
| Bidadjustment (bidadjustment) | text | This attribute reflects the current value of your ad group's audience bid adjustment. | 1/34 |
| Bidmatchtype (bidmatchtype) | text | The keyword bid match type.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 17/34 |
| Bidstrategytype (bidstrategytype) | text | The bid strategy type. | 6/34 |
| Brand (brand) | text | The brand of the product listed in your catalog. | 1/34 |
| Budgetassociationstatus (budgetassociationstatus) | text | Indicates whether or not the campaign is currently spending from the budget mentioned in the BudgetName column.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 1/34 |
| Budgetname (budgetname) | text | The name of the budget.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 1/34 |
| Budgetstatus (budgetstatus) | text | The budget status.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 1/34 |
| Businessname (businessname) | text | The name of the business being advertised. | 1/34 |
| Campaignid (campaignid) | text | The Microsoft Advertising assigned identifier of a campaign. | 32/34 |
| Campaignlabels (campaignlabels) | text | The labels applied to the campaign. Labels are delimited by a semicolon (;) in the report download. | 1/34 |
| Campaignname (campaignname) | text | The campaign name. | 32/34 |
| Campaignstatus (campaignstatus) | text | The campaign status. | 27/34 |
| Campaigntype (campaigntype) | text | The campaign type. | 13/34 |
| Category0 (category0) | text | The top level category that Bing matched to your website. | 1/34 |
| Category1 (category1) | text | The mid level category that Bing matched to your website. | 1/34 |
| Category2 (category2) | text | The low level category that Bing matched to your website. | 1/34 |
| Categorylist (categorylist) | text | The list of categories that Bing matched to your website. | 1/34 |
| Changedby (changedby) | text | The user name of the user that made the change to settings within the account. | 1/34 |
| City (city) | text | The city where the user was physically located when they clicked the ad. | 3/34 |
| Clicktype (clicktype) | text | Click type refers to each component of an ad that a customer can click.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 5/34 |
| Clicktypeid (clicktypeid) | text | The click type ID.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 3/34 |
| Collectionid (collectionid) | text | The identifier of the product collection in your catalog.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 1/34 |
| Companyname (companyname) | text | With company targeting, you can show your ads only to people who work at specific companies. | 1/34 |
| Condition (condition) | text | The condition of the product listed in your catalog, such as new or used. | 1/34 |
| Conflictlevel (conflictlevel) | text | The entity level where the keyword and negative keyword conflict occurs. | 2/34 |
| Conflicttype (conflicttype) | text | The type of negative keyword conflict encountered. | 1/34 |
| Country (country) | text | The country or region where the user was physically located when they clicked the ad. | 2/34 |
| Countryofsale (countryofsale) | text | The country or region of sale for the product catalog. | 2/34 |
| County (county) | text | The county where the user was physically located when they clicked the ad. | 2/34 |
| Currencycode (currencycode) | text | The account currency type. | 14/34 |
| Currentmaxcpc (currentmaxcpc) | text | The maximum cost per click bid that was in effect at the time the report was generated. | 4/34 |
| Customerid (customerid) | text | The Microsoft Advertising assigned identifier of a customer.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 9/34 |
| Customername (customername) | text | The customer name.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 9/34 |
| Customlabel0 (customlabel0) | text | The value of the Custom_label_0 field in your Microsoft Merchant Center catalog. | 1/34 |
| Customlabel1 (customlabel1) | text | The value of the Custom_label_1 field in your Microsoft Merchant Center catalog. | 1/34 |
| Customlabel2 (customlabel2) | text | The value of the Custom_label_2 field in your Microsoft Merchant Center catalog. | 1/34 |
| Customlabel3 (customlabel3) | text | The value of the Custom_label_3 field in your Microsoft Merchant Center catalog. | 1/34 |
| Customlabel4 (customlabel4) | text | The value of the Custom_label_4 field in your Microsoft Merchant Center catalog. | 1/34 |
| Customparameters (customparameters) | text | Depending on which report you submit, this value represents the current custom parameter set of the campaign, ad group, ad, keyword, or criterion. | 8/34 |
| Date (date) | date | The date for the downloaded report records. | 1/34 |
| Datetime (datetime) | timestamp | The date and time of the change. | 1/34 |
| Deliveredmatchtype (deliveredmatchtype) | text | The match type used to deliver an ad.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 16/34 |
| Description (description) | text | The dynamic search ad text automatically generated by Microsoft Advertising when DynamicDescriptionEnabled is set to true. | 1/34 |
| Destinationurl (destinationurl) | text | The destination URL attribute of the ad, keyword, or ad group criterion. | 8/34 |
| Deviceos (deviceos) | text | The operating system of the device reported in the DeviceType column.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 18/34 |
| Devicetype (devicetype) | text | The device name attribute of a device OS target bid. | 24/34 |
| Displayurl (displayurl) | text | The ad display URL. | 2/34 |
| Dynamicadtarget (dynamicadtarget) | text | The dynamic ad target or webpage condition that Bing matched to your website. | 2/34 |
| Dynamicadtargetid (dynamicadtargetid) | text | The Microsoft Advertising assigned identifier of the dynamic ad target. | 2/34 |
| Dynamicadtargetstatus (dynamicadtargetstatus) | text | The current status of the dynamic ad target. | 1/34 |
| Endtime (endtime) | timestamp | The end time of the call. | 1/34 |
| Entityid (entityid) | text | The Microsoft Advertising system identifier of the entity that was updated. | 1/34 |
| Entityname (entityname) | text | The name of the entity that was updated. | 1/34 |
| Expectedctr (expectedctr) | text | How well your keyword competes against other keywords targeting the same traffic. | 4/34 |
| Feedurl (feedurl) | text | The feed URL will appear either as 'True' or 'False'. | 1/34 |
| Finalappurl (finalappurl) | text | Reserved for future use. | 4/34 |
| Finalmobileurl (finalmobileurl) | text | Depending on which report you submit, this value represents the Final Mobile URL of the ad, keyword, or criterion. | 4/34 |
| Finalurl (finalurl) | text | Depending on which report you submit, this value represents the Final URL of the ad, keyword, or criterion. | 5/34 |
| Finalurlsuffix (finalurlsuffix) | text | A place in your final URL where you can add parameters that will be attached to the end of your landing page URL. | 5/34 |
| Gender (gender) | text | The gender of the audience who might have viewed the ad, if known. | 1/34 |
| Goal (goal) | text | The name of the goal you set for the conversions you want.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 27/34 |
| Goalid (goalid) | text | The Microsoft Advertising assigned identifier of a conversion goal.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 8/34 |
| Goaltype (goaltype) | text | The type of conversion goal.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 27/34 |
| Gtin (gtin) | text | Global Trade Item Number (GTIN) is a unique numerical value for commercial products.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 1/34 |
| Headline (headline) | text | For Dynamic Search Ads campaigns, Headline is the Dynamic Search Ad headline that was dynamically generated by Microsoft Advertising. | 2/34 |
| Historicaladrelevance (historicaladrelevance) | text | Historical average of ad relevance scores back as far as 18 months from the current date. | 3/34 |
| Historicalexpectedctr (historicalexpectedctr) | text | Historical average of expected click-through rate scores going back as far as 18 months from the current date. | 3/34 |
| Historicallandingpageexperience (historicallandingpageexperience) | text | Historical average of landing page experience scores back as far as 18 months from the current date. | 3/34 |
| Historicalqualityscore (historicalqualityscore) | text | The historical quality score of the keyword. | 3/34 |
| Howchanged (howchanged) | text | The value that indicates whether the element was added, updated, or deleted. | 1/34 |
| Industryname (industryname) | text | With industry targeting, you can show your ads only to people who work in specific industries. | 1/34 |
| Itemchanged (itemchanged) | text | The value that identifies the entity that changed. | 1/34 |
| Jobfunctionname (jobfunctionname) | text | With job function targeting, you can show your ads only to people who have specific kinds of jobs. | 1/34 |
| Keyword (keyword) | text | The keyword text. | 9/34 |
| Keywordid (keywordid) | text | The Microsoft Advertising assigned identifier of a keyword. | 7/34 |
| Keywordlabels (keywordlabels) | text | The labels applied to the keyword. | 2/34 |
| Keywordstatus (keywordstatus) | text | The keyword status. | 8/34 |
| Landingpageexperience (landingpageexperience) | text | An aggregate quality assessment of all landing pages on your site. | 4/34 |
| Landingpagetitle (landingpagetitle) | text | The title of your webpage where the search user landed. | 1/34 |
| Language (language) | text | The language of the publisher where the ad was shown.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 19/34 |
| Localstorecode (localstorecode) | text | An alphanumeric identifier defined by the merchant to uniquely identify each local store.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 3/34 |
| Locationid (locationid) | text | The Microsoft Advertising identifier of the location where the user was physically located when they clicked the ad. | 2/34 |
| Locationtype (locationtype) | text | The location type used to deliver ads. | 1/34 |
| Longheadline (longheadline) | text | For Audience campaigns, LongHeadline is the longer of two possible responsive ad headlines. | 1/34 |
| Merchantproductid (merchantproductid) | text | The unique identifier provided by a merchant for each product offer. | 3/34 |
| Metroarea (metroarea) | text | The metro area (Microsoft Market Area in the United States) where the user was physically located when they clicked the ad. | 2/34 |
| Mostspecificlocation (mostspecificlocation) | text | The most specific location used to deliver ads. | 1/34 |
| Mpn (mpn) | text | Manufacturer Part Number (MPN) is a unique number that identifies the product to its manufacturer.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 1/34 |
| Negativekeyword (negativekeyword) | text | The negative keyword text. | 2/34 |
| Negativekeywordid (negativekeywordid) | text | The Microsoft Advertising assigned identifier of a negative keyword. | 2/34 |
| Negativekeywordlist (negativekeywordlist) | text | The name of the negative keyword list. | 1/34 |
| Negativekeywordlistid (negativekeywordlistid) | text | The Microsoft Advertising assigned identifier of a negative keyword list. | 2/34 |
| Negativekeywordmatchtype (negativekeywordmatchtype) | text | The type of match to compare the negative keyword and the user's search term. | 2/34 |
| Neighborhood (neighborhood) | text | The neighborhood where the user was physically located when they clicked the ad. | 2/34 |
| Network (network) | text | The entire Microsoft Advertising Network.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 21/34 |
| Newvalue (newvalue) | text | The value after the change. | 1/34 |
| Offerlanguage (offerlanguage) | text | The language for the product offer.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 2/34 |
| Oldvalue (oldvalue) | text | The value before the change. | 1/34 |
| Param1 (param1) | text | The first dynamic substitution parameter (Param1) of a keyword or biddable ad group criterion. | 1/34 |
| Param2 (param2) | text | The second dynamic substitution parameter (Param2) of a keyword or biddable ad group criterion. | 1/34 |
| Param3 (param3) | text | The third dynamic substitution parameter (Param3) of a keyword or biddable ad group criterion. | 1/34 |
| Partitiontype (partitiontype) | text | The product partition type. | 3/34 |
| Path1 (path1) | text | The path 1 attribute of an ad. | 2/34 |
| Path2 (path2) | text | The path 2 attribute of an ad. | 2/34 |
| Postalcode (postalcode) | text | The postal code where the user was physically located when they clicked the ad. | 2/34 |
| Productbought (productbought) | text | The product purchased from your catalog or via your retail partner. | 1/34 |
| Productboughttitle (productboughttitle) | text | The title associated with the purchased product.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 1/34 |
| Productcategory1 (productcategory1) | text | The first level value of the Product_category field in your Microsoft Merchant Center catalog. | 1/34 |
| Productcategory2 (productcategory2) | text | The second level value of the Product_category field in your Microsoft Merchant Center catalog. | 1/34 |
| Productcategory3 (productcategory3) | text | The third level value of the Product_category field in your Microsoft Merchant Center catalog. | 1/34 |
| Productcategory4 (productcategory4) | text | The fourth level value of the Product_category field in your Microsoft Merchant Center catalog. | 1/34 |
| Productcategory5 (productcategory5) | text | The fifth level value of the Product_category field in your Microsoft Merchant Center catalog. | 1/34 |
| Productgroup (productgroup) | text | The backward slash ('\') delimited list of product conditions, reported as Operand = Attribute. | 5/34 |
| Producttype1 (producttype1) | text | The first level value of the Product_type field in your Microsoft Merchant Center catalog. | 1/34 |
| Producttype2 (producttype2) | text | The second level value of the Product_type field in your Microsoft Merchant Center catalog. | 1/34 |
| Producttype3 (producttype3) | text | The third level value of the Product_type field in your Microsoft Merchant Center catalog. | 1/34 |
| Producttype4 (producttype4) | text | The fourth level value of the Product_type field in your Microsoft Merchant Center catalog. | 1/34 |
| Producttype5 (producttype5) | text | The fifth level value of the Product_type field in your Microsoft Merchant Center catalog. | 1/34 |
| Proximitytargetlocation (proximitytargetlocation) | text | The radius target bid name. | 2/34 |
| Publisherurl (publisherurl) | text | The URL of the website that displayed the ad. | 1/34 |
| Qualityimpact (qualityimpact) | text | The numeric score that indicates the possible increase in the number of impressions that the keyword could receive if the corresponding QualityScore column would rise above underperforming. | 1/34 |
| Qualityscore (qualityscore) | text | The numeric score shows you how competitive your ads are in the marketplace by measuring how relevant your keywords and landing pages are to customers' search terms. | 4/34 |
| Queryintentcity (queryintentcity) | text | The name of a city if the user's geographical intent can be determined. | 1/34 |
| Queryintentcountry (queryintentcountry) | text | The name of a country or region if the user's geographical intent can be determined. | 1/34 |
| Queryintentcounty (queryintentcounty) | text | The name of a county if the user's geographical intent can be determined. | 1/34 |
| Queryintentdma (queryintentdma) | text | The name of a metro area (Microsoft Market Area in the United States) if the user's geographical intent can be determined. | 1/34 |
| Queryintentlocationid (queryintentlocationid) | text | The location identifier if the user's geographical intent can be determined. | 1/34 |
| Queryintentneighborhood (queryintentneighborhood) | text | The neighborhood the user intended with their search query. | 1/34 |
| Queryintentpostalcode (queryintentpostalcode) | text | The name of a postal code if the user's geographical intent can be determined. | 1/34 |
| Queryintentstate (queryintentstate) | text | The name of a state if the user's geographical intent can be determined. | 1/34 |
| Radius (radius) | text | The radius of a radius target bid. | 2/34 |
| Searchquery (searchquery) | text | The search term used by your potential audience. | 3/34 |
| Sellername (sellername) | text | The merchant or store name that offers the product. | 1/34 |
| Starttime (starttime) | timestamp | The start time of the call. | 1/34 |
| State (state) | text | The state where the user was physically located when they clicked the ad. | 3/34 |
| Status (status) | text | The current entity status. | 1/34 |
| Storeid (storeid) | text | The identifier of the store where the product is sold. | 1/34 |
| Targetingsetting (targetingsetting) | text | This attribute reflects the current value of your ad group's audience targeting setting. | 1/34 |
| Title (title) | text | The title of the product listed in your catalog. | 3/34 |
| Titlepart1 (titlepart1) | text | The title part 1 attribute of an ad. | 3/34 |
| Titlepart2 (titlepart2) | text | The title part 2 attribute of an ad. | 3/34 |
| Titlepart3 (titlepart3) | text | The title part 3 attribute of an ad. | 3/34 |
| Tool (tool) | text | The tool used to make changes in the search campaign. | 1/34 |
| Topvsother (topvsother) | text | Indicates whether the ad impression appeared in a top position or elsewhere.Incompatible fields (22)AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, AbsoluteTopImpressionSharePercent, AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent, BenchmarkBid, BenchmarkCtr, ClickSharePercent, ConversionRate, Ctr, ExactMatchImpressionSharePercent, ImpressionLostToBudgetPercent, ImpressionLostToRankAggPercent, ImpressionLostToRankPercent, ImpressionSharePercent, RelativeCtr, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, TopImpressionSharePercent | 19/34 |
| Totalclicksonadelements (totalclicksonadelements) | text | The number of clicks when this ad element was present in the ad copy, whether this or another ad element was clicked on. | 3/34 |
| Trackingtemplate (trackingtemplate) | text | Depending on which report you submit, this value represents the current tracking template of the campaign, ad group, ad, keyword, or criterion. | 8/34 |
| Websitecoverage (websitecoverage) | text | A score from 0.0 to 1.0 that indicates the percentage of pages in the requested language that belong to a particular domain out of all the pages that Bing has indexed for the same language your website's domain. | 1/34 |
Metrics (93)
| Field | Type | Description | Reports |
|---|---|---|---|
| Absolutetopimpressionratepercent (absolutetopimpressionratepercent) | float | How often your ad was in the first position of all results, as a percentage of your total impressions. A higher number indicates your ad is frequently showing in the best ad position. The value of this column is empty if the data is not available. Neither Hourly nor HourOfDay aggregation are supported.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 22/34 |
| Absolutetopimpressionsharelosttobudgetpercent (absolutetopimpressionsharelosttobudgetpercent) | float | The estimated percentage of how often your ad missed showing in the very top ad position due to insufficient budget. Indicates where increasing your budget might improve your chances at the top ad position. The value of this column is empty if the data is not available. Neither Hourly nor HourOfDay aggregation are supported.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 4/34 |
| Absolutetopimpressionsharelosttorankpercent (absolutetopimpressionsharelosttorankpercent) | float | The estimated percentage of how often poor ad rank kept your ad from showing in the first ad position at the top of search results. Helps assess reasons your ads are missing out on the top ad position. The value of this column is empty if the data is not available. Neither Hourly nor HourOfDay aggregation are supported.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 4/34 |
| Absolutetopimpressionsharepercent (absolutetopimpressionsharepercent) | float | The number of times your ad is shown in the top position as a percentage of the total available impressions in the market you were targeting. Provides insights about making changes to get more impressions and increase the likelihood of clicks and sales. The value of this column is empty if the data is not available. Neither Hourly nor HourOfDay aggregation are supported.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 6/34 |
| Allconversionrate (allconversionrate) | float | The conversion rate as a percentage. The number of conversions, divided by the total number of clicks. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. Available for accounts using Microsoft Advertising Universal Event Tracking. | 24/34 |
| Allconversions (allconversions) | float | The number of conversions. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. Deprecated as of 2022, use AllConversionsQualified instead. | 27/34 |
| Allconversionsqualified (allconversionsqualified) | float | The number of conversions including all conversion goals regardless of ExcludeFromBidding setting. Available for accounts using Microsoft Advertising Universal Event Tracking. | 27/34 |
| Allcostperconversion (allcostperconversion) | float | The cost per conversion. Calculated as Spend / Conversions. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. Available for accounts using Microsoft Advertising Universal Event Tracking. | 24/34 |
| Allreturnonadspend (allreturnonadspend) | float | The return on ad spend (ROAS). Calculated as Revenue / Spend. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. Available for accounts using Microsoft Advertising Universal Event Tracking. | 21/34 |
| Allrevenue (allrevenue) | float | The revenue reported as a result of conversions. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. Available for accounts using Microsoft Advertising Universal Event Tracking. | 25/34 |
| Allrevenueperconversion (allrevenueperconversion) | float | The revenue per conversion. Calculated as Revenue / Conversions. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. Available for accounts using Microsoft Advertising Universal Event Tracking. | 22/34 |
| Assistedclicks (assistedclicks) | float | Clicks on your ads that received co-bids from manufacturer partners. Available only for Sponsored Products in Microsoft Shopping Campaigns. | 4/34 |
| Assistedconversions (assistedconversions) | float | Conversions resulting from clicks on your ads that received co-bids from manufacturer partners. Available only for Sponsored Products in Microsoft Shopping Campaigns. | 4/34 |
| Assistedimpressions (assistedimpressions) | float | The number of times an ad co-bid by manufacturer partners was displayed. Available only for Sponsored Products in Microsoft Shopping Campaigns. | 4/34 |
| Assists (assists) | float | The number of conversions from other ads within the same account preceded by one or more clicks from this ad. Available for accounts using Microsoft Advertising Universal Event Tracking. | 23/34 |
| Audienceimpressionlosttobudgetpercent (audienceimpressionlosttobudgetpercent) | float | The percentage of impression share lost due to insufficient budget on the Microsoft Audience Network. Empty if the data is not available. Data updated 14-18 hours after UTC day ends.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 3/34 |
| Audienceimpressionlosttorankpercent (audienceimpressionlosttorankpercent) | float | The percentage of impression share lost due to low rank on the Microsoft Audience Network. Empty if the data is not available. Data updated 14-18 hours after UTC day ends.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 3/34 |
| Audienceimpressionsharepercent (audienceimpressionsharepercent) | float | The estimated percentage of impressions out of the total available impressions on the Microsoft Audience Network. Empty if the data is not available. Data updated 14-18 hours after UTC day ends.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 3/34 |
| Averagecpc (averagecpc) | float | The average cost per click (CPC). Calculated as Spend / Clicks. | 24/34 |
| Averagecpm (averagecpm) | float | The total advertising cost divided by the number of impressions (in thousands). | 23/34 |
| Averagecpv (averagecpv) | float | The average cost per video view. | 4/34 |
| Averageposition (averageposition) | float | The average position of the ad on a webpage. Deprecated as of March 31st, 2021. | 17/34 |
| Averagewatchtimeperimpression (averagewatchtimeperimpression) | float | The average amount of time viewers spent watching the video per impression. | 4/34 |
| Averagewatchtimepervideoview (averagewatchtimepervideoview) | float | The average amount of time viewers spent watching the video per view. | 4/34 |
| Benchmarkbid (benchmarkbid) | float | Shows how much other advertisers are bidding on average on similar products. Helps compare your bidding strategy.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 2/34 |
| Benchmarkctr (benchmarkctr) | float | Shows how other product ads for similar products are performing on average based on click-through rates.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 2/34 |
| Clicks (clicks) | float | The number of clicks on your ads. Includes clicks from various sources like spiders, robots, and test servers. | 27/34 |
| Clicksharepercent (clicksharepercent) | float | The percentage of clicks that went to your ads. Indicates share of prospective customer's mindshare and buying intent.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 6/34 |
| Completedvideoviews (completedvideoviews) | float | The number of times a video was watched to completion. | 4/34 |
| Conversionrate (conversionrate) | float | The conversion rate as a percentage. Calculated as Conversions / Clicks x 100. Excludes data for any conversion goal with the ExcludeFromBidding property set to true.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 24/34 |
| Conversions (conversions) | float | The number of conversions. Deprecated as of 2022, use ConversionsQualified instead. | 27/34 |
| Conversionsqualified (conversionsqualified) | float | The number of conversions including all conversion goals regardless of ExcludeFromBidding setting. | 26/34 |
| Costperassist (costperassist) | float | The cost per assist. Calculated as Spend / Assists. | 20/34 |
| Costperconversion (costperconversion) | float | The cost per conversion. Calculated as Spend / Conversions. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. | 24/34 |
| Costperinstall (costperinstall) | float | The cost incurred for each app install generated from the product listing. | 4/34 |
| Costpersale (costpersale) | float | The cost incurred for each sale generated from the product listing. | 4/34 |
| Ctr (ctr) | float | The click-through rate (CTR). Calculated as Clicks / Impressions x 100.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 25/34 |
| Dailyspend (dailyspend) | float | The average amount of campaign budget spent per day. | 1/34 |
| Duration (duration) | float | The duration of each forwarded call from a call ad extension. | 1/34 |
| Exactmatchimpressionsharepercent (exactmatchimpressionsharepercent) | float | The estimated percentage of impressions for searches that exactly matched your keyword out of total available exact match impressions.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 4/34 |
| Extendedcost (extendedcost) | float | The extended cost, including any additional fees or expenses associated with ad placements. | 1/34 |
| Firstpagebid (firstpagebid) | float | The bid amount required to appear on the first page of search results. | 1/34 |
| Impressionlosttobudgetpercent (impressionlosttobudgetpercent) | float | The estimated percentage of impressions your ad did not receive due to budget issues. Data updated 14-18 hours after UTC day ends.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 6/34 |
| Impressionlosttorankaggpercent (impressionlosttorankaggpercent) | float | The estimated percentage of impressions your ad did not receive due to ad ranking issues. Data updated 14-18 hours after UTC day ends.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 4/34 |
| Impressionlosttorankpercent (impressionlosttorankpercent) | float | The estimated percentage of impressions your ad did not receive due to issues with your ad ranking. Data updated 14-18 hours after UTC day ends.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 2/34 |
| Impressions (impressions) | float | The number of times an ad has been displayed on search results pages. | 27/34 |
| Impressionsharepercent (impressionsharepercent) | float | The estimated percentage of impressions out of the total available impressions in the targeted market.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 6/34 |
| Installs (installs) | float | The number of times an app was installed as a result of the product listing. | 4/34 |
| Lowqualityclicks (lowqualityclicks) | float | Clicks that exhibit a low likelihood of commercial intent. Not billed for these clicks. | 2/34 |
| Lowqualityclickspercent (lowqualityclickspercent) | float | The low-quality clicks as a percentage. Calculated as LowQualityClicks / (Clicks + LowQualityClicks ) x 100. | 2/34 |
| Lowqualityconversionrate (lowqualityconversionrate) | float | The low-quality conversion rate as a percentage. Calculated as LowQualityConversions / LowQualityClicks x 100. | 2/34 |
| Lowqualityconversions (lowqualityconversions) | float | The number of conversions originating from low-quality clicks. Deprecated as of March 31st, 2022, use LowQualityConversionsQualified instead. | 2/34 |
| Lowqualityconversionsqualified (lowqualityconversionsqualified) | float | The number of conversions originating from low-quality clicks. | 2/34 |
| Lowqualitygeneralclicks (lowqualitygeneralclicks) | float | Clicks filtered by general methods, such as deny lists and activity-based detection, exhibiting low commercial intent. Not billed for these clicks. | 2/34 |
| Lowqualityimpressions (lowqualityimpressions) | float | The number of impressions resulting from low-quality keyword searches. | 2/34 |
| Lowqualityimpressionspercent (lowqualityimpressionspercent) | float | The low-quality impressions as a percentage. Calculated as LowQualityImpressions / (Impressions + LowQualityImpressions ) x 100. | 2/34 |
| Lowqualitysophisticatedclicks (lowqualitysophisticatedclicks) | float | Invalid clicks using sophisticated means to appear valid. Not billed for these clicks. | 2/34 |
| Mainline1Bid (mainline1bid) | float | The bid amount required to achieve the first position in the mainline of search results. | 1/34 |
| Mainlinebid (mainlinebid) | float | The bid amount required to appear in the mainline of search results. | 1/34 |
| Matchedproductsatadgroup (matchedproductsatadgroup) | float | The number of products per ad group matching product group targets. For Performance max campaigns, this is MatchedProductsAtAssetGroup. | 1/34 |
| Matchedproductsatcampaign (matchedproductsatcampaign) | float | The number of products per campaign matching product group targets. | 1/34 |
| Matchedproductsatproductgroup (matchedproductsatproductgroup) | float | The number of products per product group matching product group targets. For Performance max campaigns, this is MatchedProductsAtListingGroup. | 1/34 |
| Monthlybudget (monthlybudget) | float | The anticipated maximum monthly budget amount calculated on the date of the most recent budget change. Calculated as Spend-to-date + (daily budget x days remaining). | 1/34 |
| Monthtodatespend (monthtodatespend) | float | The amount of money spent to date for the month. | 1/34 |
| Phonecalls (phonecalls) | float | The number of total calls to the tracked phone number. | 3/34 |
| Phoneimpressions (phoneimpressions) | float | The number of times your tracked number was shown on all devices. | 3/34 |
| Price (price) | float | The price of the product listed in your catalog. (Generated by AI based on documentation) | 1/34 |
| Ptr (ptr) | float | The phone-through rate (Ptr). Calculated as PhoneCalls / PhoneImpressions x 100. | 3/34 |
| Quantitybought (quantitybought) | float | The quantity of the product purchased from your catalog or via your retail partner. | 1/34 |
| Relativectr (relativectr) | float | Your click-through rate divided by the average click-through rate of all ads in the same sections of websites showing your ads. Helps understand campaign and ad group performance.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 2/34 |
| Returnonadspend (returnonadspend) | float | The return on ad spend (ROAS). Calculated as Revenue / Spend. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. | 22/34 |
| Revenue (revenue) | float | The revenue reported as a result of conversions. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. | 25/34 |
| Revenueperassist (revenueperassist) | float | The revenue per assist. Calculated as Revenue / Assists. | 20/34 |
| Revenueperconversion (revenueperconversion) | float | The revenue per conversion. Calculated as Revenue / Conversions. Excludes data for any conversion goal with the ExcludeFromBidding property set to true. | 22/34 |
| Revenueperinstall (revenueperinstall) | float | The revenue generated per app install from the product listing. | 4/34 |
| Revenuepersale (revenuepersale) | float | The revenue generated per sale from the product listing. | 4/34 |
| Sales (sales) | float | The number of sales generated from the product listing. | 4/34 |
| Spend (spend) | float | The cost per click (CPC) summed for each click. | 27/34 |
| Topimpressionratepercent (topimpressionratepercent) | float | The percentage of times your ad showed in the mainline, the top placement where ads appear above the search results, out of your total impressions. Indicates how changes in ad position can impact performance.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 18/34 |
| Topimpressionsharelosttobudgetpercent (topimpressionsharelosttobudgetpercent) | float | The estimated percentage of mainline impressions lost due to insufficient budget. Indicates where increasing your budget might help improve ad position.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 4/34 |
| Topimpressionsharelosttorankpercent (topimpressionsharelosttorankpercent) | float | A percentage estimate of how often poor ad rank kept your ad from showing in the mainline. Helps assess why your ads are missing out on the best ad positions.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 4/34 |
| Topimpressionsharepercent (topimpressionsharepercent) | float | The percentage of impressions for your ad in the mainline, out of the estimated number of mainline impressions you were eligible to receive.Incompatible fields (25)AdDistribution, AdId, AdStatus, BidMatchType, BudgetAssociationStatus, BudgetName, BudgetStatus, ClickType, ClickTypeId, CollectionId, CustomerId, CustomerName, DeliveredMatchType, Device, DeviceOS, GTIN, Goal, GoalId, GoalType, Language, LocalStoreCode, MPN, Network, OfferLanguage, TopVsOther | 4/34 |
| Totalclicks (totalclicks) | float | The number of billable and non-billable times that the ad extension was clicked. | 2/34 |
| Totalwatchtimeinms (totalwatchtimeinms) | float | The total amount of time viewers spent watching the video ad, measured in milliseconds. | 4/34 |
| Videocompletionrate (videocompletionrate) | float | The rate at which viewers watched the video to completion, calculated as CompletedVideoViews / VideoViews x 100. | 4/34 |
| Videoviews (videoviews) | float | The number of views your video ad received. | 4/34 |
| Videoviewsat25Percent (videoviewsat25percent) | float | The number of video views where the viewer watched 25% of the video. | 4/34 |
| Videoviewsat50Percent (videoviewsat50percent) | float | The number of video views where the viewer watched 50% of the video. | 4/34 |
| Videoviewsat75Percent (videoviewsat75percent) | float | The number of video views where the viewer watched 75% of the video. | 4/34 |
| Viewthroughconversions (viewthroughconversions) | float | Conversions made after seeing your ad, without clicking it. Only counted for ads in the Microsoft Audience network. Deprecated as of 2022, use ViewThroughConversionsQualified instead. | 21/34 |
| Viewthroughconversionsqualified (viewthroughconversionsqualified) | float | Conversions made after seeing your ad, without clicking it. Only counted for ads in the Microsoft Audience network. | 21/34 |
| Viewthroughrate (viewthroughrate) | float | The rate at which view-through conversions occur, calculated as ViewThroughConversions / Impressions x 100. | 4/34 |
| Viewthroughrevenue (viewthroughrevenue) | float | Revenue attributed to view-through conversions, where conversions happen after seeing the ad without clicking it. Applicable to ads in the Microsoft Audience network. | 21/34 |
Frequently asked questions
What does the Microsoft Advertising reference page cover?▼
It lists all reports, metrics and dimensions of the Microsoft Advertising (Bing) data source supported by Kondado. Use it to plan which fields you want to replicate before configuring the pipeline.
Which Microsoft Advertising reports can I replicate with Kondado?▼
The data source supports campaign, ad group, ad, keyword and conversion reports. The complete field list per report is in the reference embedded on this page.
Can I combine any metric with any dimension?▼
No. Microsoft Advertising enforces compatibility rules — some metrics cannot be queried together with certain dimensions in the same report. Check the reference before configuring the pipeline.
Which destinations can I replicate Microsoft Advertising data to?▼
You can replicate to Power BI, Looker Studio, Google Sheets, Excel, BigQuery, PostgreSQL, MySQL, SQL Server, Redshift, S3, Supabase and Neon. See the full list on the destinations page.
How often is Microsoft Advertising data refreshed?▼
Kondado runs the pipeline at the frequency you choose when scheduling it (for example, hourly or daily).
