Reference
Dimensions & Metrics
Every dimension and metric AskYourAds.app can pull, per platform. Use this when you're not sure what to ask, or when the chat couldn't match a term you used.
Loading…
Show
click to toggle
211 of 211 fields
| Name | Description | Type | Additive | Synonyms |
|---|---|---|---|---|
| AccountId | The unique identifier for the account associated with the ad group. | Dimension | — | — |
| AccountName | The name of the account to which the campaign belongs. | Dimension | — | — |
| AccountNumber | The account number associated with the Bing Ads account. | Dimension | — | — |
| AccountStatus | The status of the account associated with the ad group. | Dimension | — | — |
| AdDescription | The text of the first description line in the ad | Dimension | — | — |
| AdDescription2 | The text of the second description line in the ad | Dimension | — | — |
| AdDistribution | The distribution network where the ad was displayed (search, display, etc.). | Dimension | — | — |
| AdGroupCriterionId | The unique identifier of the ad group criterion. | Dimension | — | — |
| AdGroupId | The unique identifier for the ad group to which the keyword belongs. | Dimension | — | — |
| AdGroupLabels | Labels associated with the ad group. | Dimension | — | ad group label, ads groups labels, ad group labels |
| AdGroupName | The name of the ad group to which the keyword belongs. | Dimension | — | — |
| AdGroupStatus | The status of the ad group (active, paused, etc.). | Dimension | — | — |
| AdGroupType | The type of ad group (standard, dynamic, remarketing, etc.). | Dimension | — | ad group type, ad group types, ads groups types |
| AdId | The unique identifier for the ad responsible for the keyword's performance. | Dimension | — | — |
| AdStatus | The status of the ad. | Dimension | — | — |
| AdType | The type of ad (text ad, responsive ad, etc.). | Dimension | — | — |
| AgeGroup | The age group of the audience targeted by the ad campaign. | Dimension | — | age, ages, age bracket, ages brackets, age brackets, age group, age groups, ages groups |
| AssetGroupId | The unique identifier for the asset group. | Dimension | — | — |
| AssetGroupName | The name of the asset group. | Dimension | — | asset group, asset groups, assets groups, asset group name, asset groups names, asset group names, assets groups names |
| AssetGroupStatus | The status of the asset group. | Dimension | — | asset groups status, asset group status, asset groups statuses, asset group statuses, assets groups statuses |
| AssociationId | The unique identifier for the association. | Dimension | — | — |
| AssociationLevel | The level of association for the data. | Dimension | — | — |
| AssociationStatus | The status of the association. | Dimension | — | — |
| AudienceId | The unique identifier for the audience. | Dimension | — | — |
| AudienceName | The name of the audience. | Dimension | — | — |
| AudienceType | The type of the audience | Dimension | — | audience type, audience types, audiences types |
| BaseCampaignId | The unique identifier of the base campaign to which the data belongs. | Dimension | — | — |
| BidMatchType | The type of keyword match (e.g., Broad, Phrase, Exact) for the bid. Allowed values: Exact, Phrase, Broad. | Dimension | — | — |
| BidStrategyType | keyword_performance_report_hourly.BidStrategyType | Dimension | — | — |
| Brand | The brand associated with the product. | Dimension | — | — |
| BudgetAssociationStatus | The status of the campaign's budget association. | Dimension | — | — |
| BudgetName | The name of the budget associated with the campaign. | Dimension | — | budgets, budget names, budgets names |
| BudgetStatus | The status of the budget associated with the campaign. | Dimension | — | budget status, budget statuses, budgets statuses |
| CampaignId | The unique identifier for the campaign associated with the ad group. | Dimension | — | — |
| CampaignLabels | Any labels associated with the campaign. | Dimension | — | — |
| CampaignName | The name of the campaign associated with the ad group. | Dimension | — | — |
| CampaignStatus | The status of the campaign associated with the ad group. | Dimension | — | — |
| CampaignType | The type of the campaign associated with the ad group. | Dimension | — | — |
| City | The city where the ad interactions occurred. | Dimension | — | — |
| ClickType | The type of click. | Dimension | — | — |
| ClickTypeId | The unique identifier for the click type. | Dimension | — | — |
| Condition | The condition of the product. | Dimension | — | — |
| Country | The country where the ad interactions occurred. | Dimension | — | — |
| CountryOfSale | The country where the purchase was made | Dimension | — | country of sale, countries of sale, sale country, sales countries, sale countries |
| County | The county where the ad interactions occurred. | Dimension | — | — |
| CurrencyCode | The currency code used for monetary values in the data. | Dimension | — | — |
| CustomerId | The unique identifier of the customer. | Dimension | — | — |
| CustomerName | The name of the customer. | Dimension | — | — |
| CustomLabel0 | Custom label 0 for product categorization. | Dimension | — | — |
| CustomLabel1 | Custom label 1 for product categorization. | Dimension | — | — |
| CustomLabel2 | Custom label 2 for product categorization. | Dimension | — | — |
| CustomLabel3 | Custom label 3 for product categorization. | Dimension | — | — |
| CustomLabel4 | Custom label 4 for product categorization. | Dimension | — | — |
| CustomParameters | Any custom parameters associated with the campaign. | Dimension | — | — |
| Date | Date of the data record | Dimension | — | dates, day, days |
| DeliveredMatchType | The match type of the keyword that was matched to deliver the ad. Allowed values: Exact, Phrase, Broad. | Dimension | — | — |
| DestinationUrl | The URL where the user is directed when clicking the ad | Dimension | — | destination urls, destinations urls, click url, click urls, clicks urls |
| DeviceOS | The operating system on the device where the ad was interacted with. Allowed values: Windows, Windows Phone, iOS, Android, BlackBerry, Others, Unknown. | Dimension | — | — |
| DeviceType | The type of device (desktop, mobile, tablet) on which the ad was displayed. Allowed values: Computers, Smartphones, Tablets, Other device types, Unknown. | Dimension | — | — |
| ExpectedCtr | The expected click-through rate for the keyword based on historical data. | Dimension | — | — |
| FinalAppUrl | The final URL shown in the ad for app installations | Dimension | — | — |
| FinalMobileUrl | keyword_performance_report_hourly.FinalMobileUrl | Dimension | — | — |
| FinalUrl | keyword_performance_report_hourly.FinalUrl | Dimension | — | — |
| FinalUrlSuffix | The suffix added to the final URL for tracking purposes. | Dimension | — | — |
| FirstPageBid | The bid needed to appear on the first page of search results. | Dimension | — | first page bid, first-page bid |
| Gender | The gender of the audience targeted by the ad campaign. | Dimension | — | genders, sex |
| Goal | The objective or goal set for the campaign. | Dimension | — | — |
| GoalId | The unique identifier for the goal. | Dimension | — | — |
| GoalType | The type of goal set for the campaign (e.g., clicks, conversions). Allowed values: Url, Event, Duration, PagesViewedPerVisit, AppInstall, OfflineConversion, InStoreTransaction, InStoreVisit. | Dimension | — | — |
| GTIN | The Global Trade Item Number for the product. | Dimension | — | — |
| Keyword | The keyword that triggered the ad and is being reported. | Dimension | — | — |
| KeywordId | The unique identifier for the keyword being reported. | Dimension | — | — |
| KeywordLabels | keyword_performance_report_hourly.KeywordLabels | Dimension | — | — |
| KeywordStatus | The status of the keyword (e.g., active, paused). | Dimension | — | — |
| Language | The language setting of the user interacting with the ad. | Dimension | — | — |
| LocalStoreCode | The local store code of the product. | Dimension | — | — |
| LocationId | The unique identifier for the location where the ad was displayed | Dimension | — | — |
| LocationType | The type of location where the ad interactions occurred. | Dimension | — | — |
| Mainline1Bid | The bid needed to appear in the first mainline position. | Dimension | — | mainline 1 bid, first mainline bid |
| MainlineBid | The bid needed to appear in the mainline positions. | Dimension | — | mainline bid, mainline position bid |
| MerchantProductId | The unique identifier of the product set by the merchant. | Dimension | — | — |
| MetroArea | The metropolitan area where the ad interactions occurred. | Dimension | — | — |
| MostSpecificLocation | The most specific location where the ad interactions occurred. | Dimension | — | — |
| MPN | The Manufacturer Part Number of the product. | Dimension | — | — |
| Neighborhood | The neighborhood where the ad interactions occurred. | Dimension | — | — |
| Network | The network where the ad was displayed (Bing, Syndicated search partners). Allowed values: Bing and Yahoo! search, Content, Microsoft Audience Network, Microsoft sites and select traffic, Syndicated search partners. | Dimension | — | — |
| OfferLanguage | The language used in the product offer. | Dimension | — | — |
| PartitionType | Type of the partition | Dimension | — | — |
| PostalCode | The postal code of the location where the ad interactions occurred. | Dimension | — | — |
| ProductBought | The product purchased. | Dimension | — | — |
| ProductBoughtTitle | The title of the purchased product. | Dimension | — | — |
| ProductGroup | Grouping of products | Dimension | — | product group, products groups, product groups |
| ProductType1 | Product type level 1 for categorization. | Dimension | — | — |
| ProductType2 | Product type level 2 for categorization. | Dimension | — | — |
| ProductType3 | Product type level 3 for categorization. | Dimension | — | — |
| ProductType4 | Product type level 4 for categorization. | Dimension | — | — |
| ProductType5 | Product type level 5 for categorization. | Dimension | — | — |
| ProximityTargetLocation | The target location for proximity targeting. | Dimension | — | proximity target location, proximity location |
| QuantityBought | The quantity of the purchased product. | Dimension | — | — |
| QueryIntentCity | The city from query intent | Dimension | — | — |
| QueryIntentCountry | The country from query intent | Dimension | — | — |
| QueryIntentCounty | The county from query intent | Dimension | — | — |
| QueryIntentDMA | The Designated Market Area from query intent | Dimension | — | — |
| QueryIntentLocationId | The unique identifier for the location from query intent | Dimension | — | — |
| QueryIntentNeighborhood | The neighborhood from query intent | Dimension | — | — |
| QueryIntentPostalCode | The postal code from query intent | Dimension | — | — |
| QueryIntentState | The state from query intent | Dimension | — | — |
| Radius | The radius used for proximity targeting. | Dimension | — | — |
| SearchQuery | The search query that triggered the ad. | Dimension | — | — |
| SellerName | The name of the product seller. | Dimension | — | — |
| State | The state where the ad interactions occurred. | Dimension | — | — |
| Status | The status of the ad (active, paused, etc.). | Dimension | — | — |
| StoreId | The unique identifier for the store. | Dimension | — | — |
| TargetingSetting | The targeting setting used for the data. | Dimension | — | — |
| TimePeriod | The time period for which the performance data is reported. | Dimension | — | — |
| Title | The title of the ad or product. | Dimension | — | — |
| TopVsOther | Comparison of the top positions with other positions in displaying the ad. Allowed values: Bing and Yahoo! search – top, Bing and Yahoo! search – other, Syndicated search partners – top, Syndicated search partners – other, Content network, Unknown. | Dimension | — | — |
| TrackingTemplate | The tracking template URL used for campaign tracking. | Dimension | — | tracking templates |
| AbsoluteTopImpressionRatePercent | The percentage of impressions that are shown in the absolute top position above the organic search results | Metric |
No
ratio
|
absolute top impression rate, absolute top rate |
| AbsoluteTopImpressionShareLostToBudgetPercent | The percentage of absolute top impressions lost due to budget constraints. | Metric |
No
ratio
|
— |
| AbsoluteTopImpressionShareLostToRankPercent | The percentage of absolute top impressions lost due to rank constraints. | Metric |
No
ratio
|
— |
| AbsoluteTopImpressionSharePercent | The percentage of absolute top impressions achieved by the ad compared to the total available absolute top impressions. | Metric |
No
ratio
|
— |
| AdRelevance | The relevance score of the ad in relation to the target audience. | Metric |
No
ratio
|
— |
| AllConversionRate | Overall conversion rate for all actions taken as a result of the ad. | Metric |
No
ratio
|
— |
| AllConversions | The total number of all types of conversions. | Metric | Yes | — |
| AllConversionsQualified | Total number of all types of conversions that meet specified criteria. | Metric | Yes | — |
| AllCostPerConversion | The average cost per conversion for all types of conversions. | Metric |
No
ratio
|
— |
| AllReturnOnAdSpend | All-conversions ROAS — return on ad spend. Return on investment for all actions taken as a result of the ad. Also called: all ROAS, all-conversions return on ad spend. | Metric |
No
ratio
|
— |
| AllRevenue | All conversion value. The total revenue generated from all types of conversions. Also called: all conversions revenue, total revenue including assist conversions. | Metric | Yes | — |
| AllRevenuePerConversion | All conversion value per conversion. The average revenue generated per conversion for all conversion types. Also called: all-conversions revenue per conversion. | Metric |
No
ratio
|
— |
| AssistedClicks | Number of clicks in which the ad appeared in a measured position on the search results page but wasn't clicked | Metric | Yes | — |
| AssistedConversions | Number of conversions in which the ad appeared in a measured position on the search results page but wasn't clicked | Metric | Yes | — |
| AssistedConversionsQualified | Number of conversions that meet certain criteria in which the ad appeared in a measured position on the search results page but wasn't clicked | Metric | Yes | — |
| AssistedImpressions | Number of times the ad appeared in a measured position on the search results page but wasn't clicked | Metric | Yes | — |
| Assists | The number of times this ad appeared in a conversion path but was not the last click before the conversion. | Metric | Yes | — |
| AudienceImpressionLostToBudgetPercent | The percentage of audience impressions lost due to budget restrictions | Metric |
No
ratio
|
audience impression lost to budget, audience impression share lost to budget |
| AudienceImpressionLostToRankPercent | The percentage of audience impressions lost due to rank constraints. | Metric |
No
ratio
|
— |
| AudienceImpressionSharePercent | The percentage of audience impressions achieved by the ad compared to the total available audience impressions. | Metric |
No
ratio
|
— |
| AverageCpc | The average cost per click for the keyword. | Metric |
No
ratio
|
— |
| AverageCpm | The average cost per thousand impressions for the keyword. | Metric |
No
ratio
|
— |
| AverageCPV | The average cost-per-view for video ads. | Metric |
No
ratio
|
— |
| AveragePosition | The average position where the ad appeared on the search results page | Metric |
No
ratio
|
— |
| AverageWatchTimePerImpression | The average watch time per impression for video ads. | Metric |
No
duration_avg
|
— |
| AverageWatchTimePerVideoView | The average watch time per video view for video ads. | Metric |
No
duration_avg
|
— |
| BidAdjustment | The bid adjustment value. | Metric | No | — |
| Clicks | The total number of times the ad was clicked on. | Metric | Yes | — |
| ClickSharePercent | The percentage of eligible clicks the ad received out of the total available clicks. | Metric |
No
ratio
|
— |
| CompletedVideoViews | The total number of completed video views for video ads. | Metric | Yes | — |
| ConversionRate | Conversion rate for specific actions taken as a result of the ad. | Metric |
No
ratio
|
— |
| Conversions | Total number of conversions for specific actions from the ad. | Metric | Yes | — |
| ConversionsQualified | The number of qualified conversions for a specific type of conversions | Metric | Yes | — |
| CostPerAssist | Cost per assist where the ad assisted in converting a customer | Metric |
No
ratio
|
— |
| CostPerConversion | The cost per conversion for a specific type of conversion | Metric |
No
ratio
|
— |
| CostPerInstall | The cost per install for the campaign. | Metric |
No
ratio
|
— |
| CostPerSale | The cost per sale for the campaign. | Metric |
No
ratio
|
— |
| Ctr | The click-through rate for the campaign. | Metric |
No
ratio
|
— |
| CurrentMaxCpc | The current maximum cost per click bid for the keyword. | Metric |
No
ratio
|
current max cpc, max cpc, current maximum cpc, maximum cpc |
| DailySpend | Amount spent on the campaign on a daily basis | Metric | Yes | daily spend, daily cost, daily ad spend |
| ExactMatchImpressionSharePercent | The percentage of exact match impressions divided by the total available exact match impressions. | Metric |
No
ratio
|
— |
| ExtendedCost | The total cost of running the ad campaign including all associated costs. | Metric | Yes | — |
| HistoricalAdRelevance | Historical relevance score of the ad. | Metric |
No
ratio
|
— |
| HistoricalExpectedCtr | The historical expected click-through rate score. | Metric |
No
ratio
|
historical expected ctr, expected ctr history |
| HistoricalLandingPageExperience | The historical landing page experience score. | Metric |
No
ratio
|
historical landing page experience, landing page experience history |
| HistoricalQualityScore | The historical quality score of the ad. | Metric |
No
ratio
|
historical quality score, quality score history, historical quality |
| ImpressionLostToBudgetPercent | The percentage of impressions lost due to budget constraints. | Metric |
No
ratio
|
— |
| ImpressionLostToRankAggPercent | Percentage of impressions lost due to aggregated rank constraints. | Metric |
No
ratio
|
— |
| Impressions | The total number of times the ad was displayed to users. | Metric | Yes | — |
| ImpressionSharePercent | The percentage of impressions achieved by the ad compared to the total available impressions. | Metric |
No
ratio
|
— |
| Installs | The total number of installations linked to the ads | Metric | Yes | install, installs, installation, installations, app install, app installs, apps installs |
| LandingPageExperience | The evaluation of the landing page experience for the keyword. | Metric |
No
ratio
|
— |
| LowQualityClicks | Number of clicks on low-quality traffic sources. | Metric | Yes | — |
| LowQualityClicksPercent | Percentage of low-quality clicks compared to total clicks. | Metric |
No
ratio
|
— |
| LowQualityConversionRate | The conversion rate attributed to low-quality clicks | Metric |
No
ratio
|
low quality conversion rate, low-quality conversion rate |
| LowQualityConversions | The total number of conversions from low-quality clicks. | Metric | Yes | — |
| LowQualityConversionsQualified | The number of qualified conversions from low-quality clicks. | Metric | Yes | — |
| LowQualityGeneralClicks | The total number of general clicks from low-quality sources. | Metric | Yes | — |
| LowQualityImpressions | The number of low-quality impressions generated by the ad | Metric | Yes | — |
| LowQualityImpressionsPercent | Percentage of low-quality impressions compared to total impressions. | Metric |
No
ratio
|
— |
| LowQualitySophisticatedClicks | The total number of sophisticated clicks from low-quality sources. | Metric | Yes | — |
| MonthlyBudget | Budget amount set for the campaign for the entire month | Metric | No | monthly budget, monthly budgets |
| MonthToDateSpend | Total amount spent on the campaign from the beginning of the month | Metric |
No
ratio
|
month to date spend, mtd spend, month-to-date spend |
| PhoneCalls | The number of phone calls made as a result of the ad. | Metric | Yes | — |
| PhoneImpressions | The number of impressions that included a phone number | Metric | Yes | — |
| Price | The price of the product. | Metric | No | — |
| Ptr | The phone through rate (PTR) for phone calls. | Metric |
No
ratio
|
— |
| QualityImpact | The impact of quality score changes on ad performance. | Metric |
No
ratio
|
quality impact |
| QualityScore | A score reflecting the quality of the ad and landing page experience. | Metric |
No
ratio
|
— |
| RelativeCtr | The relative click-through rate performance compared to other ads. | Metric |
No
ratio
|
relative ctr, relative click-through rate |
| ReturnOnAdSpend | ROAS — return on ad spend. Revenue generated for each unit of currency spent on ads. Also called: return on ad spend, ROAS. | Metric |
No
ratio
|
— |
| Revenue | Conversion value. Total revenue generated from specific actions as a result of the ad. Also called: conversion revenue, total revenue from conversions. | Metric | Yes | — |
| RevenuePerAssist | Average revenue per assist where the ad assisted in converting a customer | Metric |
No
ratio
|
— |
| RevenuePerConversion | Conversion value per conversion. The revenue generated per conversion for a specific type of conversion. Also called: revenue per conversion, revenue per goal completion. | Metric |
No
ratio
|
— |
| RevenuePerInstall | The average revenue generated per installation | Metric |
No
ratio
|
revenue per install, revenue per installation |
| RevenuePerSale | The average revenue generated per sale. | Metric |
No
ratio
|
— |
| Sales | The total number of sales attributed to the ads | Metric | Yes | sale |
| Spend | The total cost spent on displaying the ad for the keyword. | Metric | Yes | — |
| TopImpressionRatePercent | The percentage of top impressions divided by the total impressions in the search result page. | Metric |
No
ratio
|
— |
| TopImpressionShareLostToBudgetPercent | The percentage of top impressions lost due to budget constraints. | Metric |
No
ratio
|
— |
| TopImpressionShareLostToRankPercent | The percentage of top impressions lost due to rank constraints. | Metric |
No
ratio
|
— |
| TopImpressionSharePercent | The percentage of top impressions achieved by the ad compared to the total available top impressions. | Metric |
No
ratio
|
— |
| TotalClicksOnAdElements | Total number of clicks on elements within the ad | Metric | Yes | — |
| TotalWatchTimeInMS | The total watch time in milliseconds for video ads. | Metric | Yes | — |
| VideoCompletionRate | The rate of video completions divided by video views. | Metric |
No
ratio
|
— |
| VideoViews | The total number of views of video ads | Metric | Yes | video view, videos views, video views, video play, videos plays, video plays |
| VideoViewsAt25Percent | The total number of video views at 25% completion. | Metric | Yes | — |
| VideoViewsAt50Percent | The total number of video views at 50% completion. | Metric | Yes | — |
| VideoViewsAt75Percent | The total number of video views at 75% completion. | Metric | Yes | — |
| ViewThroughConversions | The number of times users saw but did not interact with this ad and later converted. | Metric | Yes | — |
| ViewThroughConversionsQualified | The number of view-through conversions that meet specific qualification criteria. | Metric | Yes | — |
| ViewThroughRate | The percentage of view-through conversions out of total viewable impressions. | Metric |
No
ratio
|
— |
| ViewThroughRevenue | The revenue generated from conversions that occurred after a view-through of the ad | Metric | Yes | — |