Microsoft Ads: Most-used fields#
The table below gives information about most-used fields that you can import from Microsoft Ads. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
AbsoluteTopImpressionRatePercent Metric
The percentage of times an ad appeared in the absolute top position (the very first position) of all search results, relative to the total number of impressions.
AbsoluteTopImpressionShareLostToBudgetPercent Metric
The estimated percentage of times an ad failed to show in the absolute top position due to an insufficient budget.
AbsoluteTopImpressionShareLostToRankPercent Metric
The estimated percentage of times an ad missed showing in the very top ad position (above search results) due to a poor ad rank. This helps assess reasons for missing out on top ad positions.
AbsoluteTopImpressionSharePercent Metric
How often your ad was in the first position of all results, as a percentage of your total impressions.
Account Id Dimension
The unique Microsoft Advertising identifier of the account.
Account Name Dimension
The name of the account.
AccountId Dimension
The unique system-generated identifier of the account.
AccountName Dimension
The name of the account.
AccountNumber Dimension
The unique identification number of the advertiser account.
AccountStatus Dimension
The status of the advertiser account (e.g., Active, Closed).
Ad Click Parallel Tracking Dimension
Determines whether parallel tracking is enabled for ad clicks. Parallel tracking improves user experience by sending users directly to the landing page while click measurement runs in the background.
Ad Format Preference Dimension
Indicates whether an ad copy is preferred to be shown as a search ad or an audience ad. Possible values include 'AudienceAd' for audience ad format only, or 'All' for eligibility in both search and audience ad formats. This helps optimize messaging for native delivery.
Ad Group Dimension
The name of the ad group.
Ad Group Type Dimension
The type of the ad group, e.g., 'SearchStandard' or 'SearchDynamic'.
Ad Rotation Dimension
The setting that determines how often Microsoft Advertising selects which ads to serve within an ad group.
Ad Schedule Dimension
The schedule that defines when ads are eligible to be shown.
Ad Schedule Use Searcher Time Zone Dimension
Indicates whether the ad schedule uses the searcher's time zone.
Ad Strength Dimension
The ad strength score of responsive search ads, indicating their effectiveness and relevance.
Ad Sub Type Dimension
Defines the specific sub-type of an ad, such as Display, HTML5, or Video. This categorization helps in managing different ad formats within campaigns.
AdDescription Dimension
The primary descriptive text for the ad.
AdDescription2 Dimension
The secondary descriptive text for the ad, if available.
AdDistribution Dimension
The distribution network where the ad is shown (e.g., search network, audience network).
AdExtension Header Type Dimension
This field specifies the type of header used in certain ad extensions, such as Structured Snippet Extensions, where the header precedes a list of values.
AdExtensionId Metric
The system-generated identifier of the ad extension.
AdExtensionType Dimension
The type of ad extension (e.g., Sitelink, Callout, Call).
AdExtensionTypeId Metric
This field is a system-assigned identifier that categorizes the type of an ad extension, such as Sitelink, Location, or Call extensions.
AdExtensionVersion Metric
A version number that tracks updates made to an ad extension.
AdGroupCriterionId Dimension
The unique Microsoft Advertising identifier for a criterion applied to an ad group.
AdGroupId Dimension
The unique system-generated identifier of the ad group.
AdGroupLabels Dimension
Labels applied to ad groups for organization and reporting.
AdGroupName Dimension
The name of the ad group.
AdGroupStatus Dimension
The status of the ad group (e.g., Active, Paused, Deleted).
AdId Dimension
The system-generated identifier of the ad.
AdLabels Dimension
Labels applied to ads for organization and reporting.
AdRelevance Metric
A component of Quality Score, measuring how relevant an ad is to the keyword.
AdScheduleUseSearcherTimeZone Dimension
Determines whether ad schedules use the searcher's local time zone or the account's time zone for ad delivery, impacting when ads are shown to specific users.
AdStatus Dimension
The status of the ad (e.g., Active, Paused, Deleted).
AdStrength Dimension
A score indicating the effectiveness and relevance of responsive search ads, ranging from Poor to Excellent.
AdTitle Dimension
The title of the ad.
AdType Dimension
The type of ad (e.g., Text Ad, Product Ad, Responsive Search Ad).
Address Line 1 Dimension
The first line of a physical street address, typically associated with a customer or account entity.
Adjustment Currency Code Dimension
The currency code used for restating an offline conversion. This field is applied when adjusting a previously recorded conversion's value.
Adjustment Time Dimension
The date and time when an offline conversion adjustment occurred. This value must be in Coordinated Universal Time (UTC) and cannot be earlier than the original conversion time.
Adjustment Type Dimension
This field specifies the type of adjustment being made, which can include retracting or restating an offline conversion [cite:Adjustment Type:1], or adjusting booked revenue and media cost values in reporting, with types like advertiser revenue, advertiser credit, or publisher adjustments [cite:Adjustment Type:2].
Adjustment Value Dimension
The adjusted value for an offline conversion. This field is used when restating a conversion to correct its reported value.
Age Ranges Dimension
The age groups targeted by the ad.
AgeGroup Dimension
Audience targeting criterion specifying age demographic (e.g., 18-24, 25-34) for ad delivery.
AllConversionRate Metric
The percentage of clicks that resulted in any conversion, including cross-device and from all conversion goals.
AllConversions Metric
Deprecated by Microsoft in 2022. Performance reports return 0 in this column. Use AllConversionsQualified instead, which reports the total number of conversions including cross-device conversions and conversions from all goals.
AllConversionsQualified Metric
The total number of all conversions recorded, including those where the conversion goal's "ExcludeFromBidding" property is set to true.
AllCostPerConversion Dimension
The average cost for all conversions, regardless of their 'ExcludeFromBidding' setting.
AllReturnOnAdSpend Metric
The total revenue generated for every unit of currency spent on advertising, including all conversions. (first search)
AllRevenue Metric
The total revenue generated from all conversions, including cross-device and from all conversion goals.
AllRevenuePerConversion Dimension
The revenue generated per conversion, including all conversions (cross-device and from all conversion goals).
Alternative Text Dimension
An alternative text description for image media used in ads or ad extensions. This text is displayed if the image cannot be loaded and is used by screen readers for accessibility purposes. The maximum length is 90 characters.
App Id Dimension
The unique identifier for the mobile app, as supplied by the app store, used in app install ads and app ad extensions.
App Platform Dimension
The platform or app store where the mobile application is distributed, such as AppleAppStore, GoogleAppStore, or MicrosoftAppStore.
App Status Dimension
The status of an app ad extension, indicating whether it is active or deleted.
App Store Dimension
This field indicates the application store where a mobile app is distributed, such as Apple App Store, Google Play Store, or Microsoft App Store.
AppInstalls Metric
The number of times customers install apps through your ads.
Aspect Ratio Dimension
Refers to the proportional relationship between an image's width and height for image assets used in ads, especially for responsive ads and image ad extensions. Supported aspect ratios (e.g., 1.91:1, 1:1) are crucial for proper ad display across various placements.
Asset Context Dimension
Refers to the context in which an asset (like an image or text) is used within an ad campaign.
Asset Group Dimension
The entity representing a collection of assets for Performance Max campaigns.
Asset Group Search Theme Dimension
The type of search theme associated with an asset group, which helps define what search queries the asset group's ads are eligible to show for.
Asset Group Strength Dimension
The strength score of an asset group, indicating its effectiveness.
AssetEditorialStatusSummary Dimension
Provides a summary of the editorial review status for an asset or asset group, indicating whether it is pending review, approved, disapproved, or active with limitations.
AssetGroupId Dimension
The system-generated unique identifier of the asset group.
AssetGroupName Dimension
The name of the asset group.
AssetGroupStatus Dimension
The current status of the asset group, such as Active, Deleted, Expired, or Paused.
AssetId Metric
The unique Microsoft Advertising identifier for an asset, which can be shared across multiple ads.
AssetType Dimension
This field specifies the type of advertising asset, indicating its role within an ad. Examples include TextAsset (for headlines or descriptions), ImageAsset, or VideoAsset.
Assists Metric
The number of assists attributed to an ad, where an ad contributed to a conversion but wasn't the last click.
Attribution Model Type Dimension
The model used to attribute conversions to ad interactions, such as LastClick or DataDriven.
Audience Metric
The audience entity that defines a group of users to target.
Audience Group Id Dimension
The system-generated identifier for an audience group, used to uniquely identify the audience segment in the account.
Audience Group Name Dimension
The name of the audience group. This name must be unique among all audience groups within the account and can contain a maximum of 256 characters.
Audience Id Dimension
The unique Microsoft Advertising identifier for the audience.
Audience Network Size Dimension
The total count of active individuals within a specific audience who are available for targeting on the Microsoft Audience Network. A minimum of 300 people is required for the audience to be used for optimizations.
Audience Optimization Opt Out Dimension
This setting allows advertisers to control or limit where their ads are displayed within the Microsoft Audience Network, often managed through website exclusions or ad distribution settings to optimize audience targeting.
Audience Search Size Dimension
The total count of active individuals within a specific audience who are available for targeting on the Microsoft Search Network. A minimum of 300 people is required for the audience to be used for optimizations.
Audience Size Dimension
The total number of people who are active members of a specific audience in the Search or Audience network. This helps estimate how many users can be targeted.
AudienceAdsBidAdjustment Metric
The percentage by which to adjust bids for audience ads, allowing advertisers to optimize their spend for audience network placements.
AudienceId Dimension
The unique identifier for an audience.
AudienceImpressionLostToRankPercent Dimension
The estimated percentage of impressions your ad did not receive due to issues with your ad ranking. For Microsoft Shopping Campaigns, this data is only available with the campaign and ad group performance reports.
AudienceName Dimension
The name of the audience targeted.
AudienceType Dimension
The type of audience (e.g., remarketing list, in-market audience).
Audiences Dimension
A collection of audience entities.
Auto Generated Image Assets Opt Out Dimension
Specifies if image assets should be dynamically generated by Microsoft Advertising for Performance Max campaigns. Setting it to true opts out of dynamic image asset generation.
Auto Generated Text Assets Opt Out Dimension
Specifies if text assets should be dynamically generated by Microsoft Advertising. Setting it to true opts out of dynamic text asset generation.
Automated Call To Action Opt Out Dimension
If set to true, this indicates that the automatic selection of call-to-action assets for multimedia ads in a campaign is opted out, meaning individual ad call-to-action settings will be honored.
AverageCPV Dimension
The average cost per video view.
AverageCpc Metric
The average cost per click (CPC) on your ads.
AverageCpm Metric
The average cost per thousand impressions (CPM).
AveragePosition Metric
The average position of your ad on the search results page.
AverageWatchTimePerImpression Metric
The average watch time of a video per impression.
AverageWatchTimePerVideoView Dimension
The average watch time of a video per video view.
Avg CPC Dimension
The average cost per click (CPC).
Avg CPM Dimension
The average cost per thousand impressions (CPM).
Avg position Dimension
The average position of the ad on the search results page.
Base Campaign Id Dimension
The unique identifier of the original campaign used as the base for an experiment campaign.
BaseCampaignId Metric
For experimental campaigns, this is the ID of the campaign the experiment was based on. For all other campaigns, this is identical to campaign ID.
Bid Dimension
The bid amount for a keyword or criterion.
Bid Adjustment Metric
The percentage by which to adjust a bid for specific targeting criteria.
Bid Boost Value Dimension
A value that allows amplification of bids for specific targeting criteria or audiences, to increase or decrease the bid amount by a percentage.
Bid Multiplier Source Dimension
The source that determines the multiplier used to adjust the base bid for a criterion (e.g., device, location).
Bid Option Dimension
A setting that defines how bids are managed for a campaign, ad group, or keyword, such as manual bidding or automated strategies.
Bid Strategy CommissionRate Dimension
The commission rate for the Commission bid strategy, used for hotel campaigns.
Bid Strategy Id Dimension
The unique system-generated identifier of a portfolio bid strategy that this campaign shares with other campaigns in the account.
Bid Strategy ManualCpc Dimension
ManualCpc (manual cost per click) is a bid strategy where the advertiser manually sets ad group and keyword bids, which Microsoft Advertising uses for every impression.
Bid Strategy ManualCpi Dimension
A manual bidding strategy where the advertiser sets the bid amount to optimize for a specific Cost Per Install (CPI).
Bid Strategy MaxCpc Dimension
The maximum cost per click (CPC) bid for campaigns using a bid strategy that optimizes for clicks within a budget.
Bid Strategy MaxCpm Dimension
This field specifies the maximum Cost Per Mille (CPM) that can be set as part of a bid strategy.
Bid Strategy Name Dimension
The name of the bid strategy.
Bid Strategy PercentMaxCpc Dimension
The percentage of the maximum Cost Per Click (CPC) for the PercentCpc bid strategy, used for hotel campaigns.
Bid Strategy Scope Dimension
This field defines the scope of a bid strategy, indicating whether it applies at the customer level (across all accounts) or the account level (to a specific account).
Bid Strategy TargetAdPosition Dimension
The desired target ad position in search results where you want your ads to appear, used in conjunction with bid strategies like Target Impression Share.
Bid Strategy TargetCostPerSale Dimension
The target cost per sale (CPS) that Microsoft Advertising aims to achieve by optimizing bids to maximize conversions.
Bid Strategy TargetCpa Dimension
The target Cost Per Acquisition (CPA) for the TargetCpa bid strategy.
Bid Strategy TargetImpressionShare Dimension
The target impression share percentage for campaigns using a bid strategy to optimize for visibility on the search results page.
Bid Strategy TargetRoas Dimension
The target return on ad spend (ROAS) for campaigns using a bid strategy to achieve a specific return on advertising investment.
Bid Strategy Type Dimension
The type of bidding strategy used for a campaign or ad group, such as ManualCpc, MaxClicks, or TargetCpa.
BidMatchType Dimension
The match type of the keyword that was bid on (e.g., Exact, Phrase, Broad).
BidStrategyId Metric
The unique identifier for a bidding strategy applied to a campaign or ad group, determining how bids are managed to achieve advertising goals.
BidStrategyType Dimension
The type of bidding strategy used for a campaign or ad group (e.g., Manual CPC, Enhanced CPC, Maximize Conversions).
BiddingScheme.MaxCpc Dimension
Represents a bidding scheme where the system aims to get as many clicks as possible within the budget, without exceeding a specified maximum cost-per-click.
BiddingScheme.MaxCpc.Amount Metric
The specific maximum cost-per-click amount set within a MaxCpc bidding scheme.
BiddingScheme.TargetCpa Metric
Represents a bidding scheme focused on achieving a specific average cost-per-acquisition (CPA), optimizing bids to get as many conversions as possible within that target CPA.
BiddingScheme.TargetRoas Dimension
Represents a bidding scheme designed to maximize conversion value by targeting a specific return on ad spend (ROAS).
BiddingScheme.Type Dimension
The type of bidding scheme employed for a campaign or ad group, such as manual CPC, enhanced CPC, maximize conversions, target CPA, or target ROAS.
Brand Id Dimension
A unique identifier assigned to a brand or brand kit within the Microsoft Advertising platform, used to reference specific brand entities for advertising purposes.
Brand Name Dimension
The brand name associated with a product or entity, often used in product feeds for shopping campaigns.
Budget Metric
The daily budget amount for a campaign.
Budget Id Dimension
The unique system identifier of the shared budget.
Budget Name Dimension
The name of the budget.
Budget Type Dimension
The type of budget, determining how the allocated amount is spent throughout the day, e.g., DailyBudgetStandard.
BudgetAssociationStatus Dimension
Indicates the status of a shared budget's association with a campaign, for example, 'Sufficient' or 'Budget paused'.
BudgetId Metric
The unique identifier of a budget, which can be shared across multiple campaigns or dedicated to a single campaign.
BudgetName Dimension
The name of the budget.
BudgetSpent Metric
The amount of money spent on a campaign, ad group, or ad. It represents the actual cost incurred for advertising activities.
BudgetStatus Dimension
The status of the budget, such as Active or Deleted.
BudgetType Dimension
Defines how a campaign's budget is spent throughout the day or over its lifetime. Examples include DailyBudgetStandard or DailyBudgetAccelerated.
Business Name Dimension
The name of the business associated with an ad or account.
BusinessName Dimension
The name of the business associated with the ad or account.
CPA Dimension
The cost per acquisition or conversion.
CTR Metric
The click-through rate, calculated as the number of clicks divided by the number of impressions.
Call To Action Dimension
A phrase in an ad that encourages users to take a specific action, such as 'Shop Now' or 'Learn More'.
Call To Action Opt Out Dimension
Indicates whether the account or campaign is opted out of specific call-to-action features or automatic call-to-action generation.
Call To Action Text Dimension
The specific text content of the call to action.
Call Tracking Enabled Dimension
Determines whether call tracking is enabled for the call ad extension, allowing phone calls generated from ads to be tracked and reported as conversions.
Callout Text Dimension
Additional descriptive text that can be displayed with an ad as an extension.
Campaign Dimension
The name of the campaign.
Campaign Frequency Cap Dimension
Defines settings to limit the number of times a creative can be shown to a given user within a specified period, preventing overexposure or ad burnout.
Campaign Goal Dimension
The specific goal or objective for the campaign, e.g., increasing website traffic or conversions.
Campaign Id Dimension
The unique Microsoft Advertising identifier for the campaign.
Campaign Objective Type Dimension
Represents the primary goal or intent of an advertising campaign, which influences available ad formats, bidding strategies, and optimization settings. Examples include Brand Awareness, Website Visit, Engagement, Video View, Lead Generation, and Website Conversion.
Campaign Type Dimension
The type of campaign, such as Search, Audience, Shopping, Hotel Ads, or Performance Max.
CampaignId Dimension
The unique Microsoft Advertising identifier of the campaign.
CampaignLabels Dimension
User-defined labels applied to a campaign, used for organizing and filtering campaign data in reports.
CampaignName Dimension
The name of the campaign.
CampaignStatus Dimension
The status of the campaign (e.g., Active, Paused, Deleted).
CampaignType Dimension
The type of campaign (e.g., Search, Audience, Shopping).
Campaign_Type Dimension
The classification of an advertising campaign, determining its primary objective and features. Examples include Search, Shopping, Dynamic Search Ads, Audience, App, Hotel, and Performance Max campaigns.
Category Id Dimension
This field represents a unique identifier for a category, which can be used to classify products or content.
Channel Dimension
The advertising network or platform where ads are displayed, such as the entire Microsoft Advertising Network or specific Microsoft sites and select partner traffic. This setting determines the reach and placement of advertising campaigns.
Channel Optimization Opt Out Dimension
This setting allows advertisers to manage or restrict the advertising channels or networks where their ads are distributed, such as opting out of specific search partners or limiting exposure on the Microsoft Audience Network via ad group-level distribution settings.
Channels Dimension
Channels refer to the ad distribution options where advertisements can appear, such as the entire Microsoft Advertising Network, Microsoft sites, or select partner traffic.
City Dimension
The city where the impression, click, or conversion occurred.
ClickSharePercent Metric
The percentage of estimated available clicks that an ad received.
ClickType Dimension
The specific part of an ad that a user clicked (e.g., ad title, sitelink, phone number).
Clicks Metric
The number of times an ad was clicked.
Client Id Dimension
A custom identifier provided by the client, used to associate records in bulk operations.
Color Dimension
The color code associated with a label, used for visual organization.
Commission Rate Dimension
The commission rate charged for Commission bid strategies.
CompletedVideoViews Metric
The number of times a video ad was played to 100% completion.
Conversion Currency Code Dimension
The three-digit ISO 4217 currency code used for reporting conversion revenue, which can be specified for offline conversions or conversion goal revenue.
Conversion Name Dimension
The name of the conversion goal.
Conversion Time Dimension
The date and time when a conversion occurred.
Conversion Value Dimension
The value attributed to a conversion.
Conversion Window In Minutes Dimension
The length of time in minutes, ranging from 1 to 129,600 (90 days), after an ad click during which a conversion event will be tracked and attributed to that click.
ConversionRate Metric
The percentage of clicks that resulted in a conversion.
Conversions Metric
Deprecated by Microsoft in 2022. Performance reports return 0 in this column. Use ConversionsQualified instead, which reports the number of conversions attributed to an ad based on your conversion tracking settings.
ConversionsQualified Metric
The total number of conversions recorded. A conversion represents a completed action by a customer after interacting with your ad.
CostPerAssist Dimension
Spend divided by the number of times an entity contributed to a conversion that is associated with a different entity.
CostPerConversion Metric
The cost incurred for each conversion.
Country Dimension
The country where the impression, click, or conversion occurred.
Country Code Dimension
The country or region code for a geographical target.
CountryOfSale Dimension
The country code specifying the market where products are offered for sale from a Microsoft Merchant Center store, used for filtering product catalogs.
County Dimension
The county associated with the user's physical location at the time of the ad interaction.
Cpc Bid Dimension
The Cost Per Click (CPC) bid amount.
Cpm Bid Dimension
The bid amount specified for an ad group, representing the cost an advertiser is willing to pay for 1,000 viewed impressions (Cost Per Mille).
Cpv Bid Dimension
The cost per view (CPV) bid amount, which is the highest amount an advertiser is willing to pay per view or per click on a video ad.
Ctr Metric
The click-through rate, calculated as (Clicks / Impressions) * 100.
Currency Code Dimension
The currency type used for the account.
CurrencyCode Dimension
The currency in which the account operates (e.g., USD, EUR).
CurrentMaxCpc Metric
The current maximum cost per click that is charged to the advertiser's account when a search user clicks an ad.
Custom Parameter Dimension
A key-value pair used for URL tracking or dynamic content in ads.
CustomLabel0 Dimension
A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns.
CustomLabel1 Dimension
The value of the Custom_label_1 field from your Microsoft Merchant Center catalog, used for product grouping and filtering.
CustomLabel2 Dimension
A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns.
CustomLabel3 Dimension
A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns.
CustomLabel4 Dimension
A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns.
CustomParameters Dimension
Custom key-value pairs that can be used in tracking templates.
CustomerId Metric
The unique Microsoft Advertising identifier of the customer (manager account).
CustomerName Dimension
The name of the customer (manager account).
DailyBudget Metric
The maximum amount an advertiser is willing to spend per day for a campaign.
DailySpend Metric
The average amount of campaign budget spent per day.
Date Dimension
The calendar date, specified by month, day, and year, used for reporting purposes to filter or aggregate performance data.
DateTime Dimension
DateTime specifies the date and time for which performance data is collected and aggregated in reports, allowing users to analyze trends over various time periods.
DeliveredMatchType Dimension
The actual match type of the keyword that triggered the ad (e.g., Exact, Phrase, Broad).
Description Dimension
The descriptive text of an ad or entity.
Descriptions Dimension
Multiple descriptive texts for an ad or entity.
Destination Url Dimension
The URL to which the ad directs the user after a click.
DestinationUrl Dimension
The URL that users are directed to after clicking an ad.
Device Preference Dimension
Determines the device preference for showing the ad.
Device Type Dimension
The type of device an impression or click originated from (e.g., desktop, mobile, tablet).
DeviceOS Dimension
The operating system of the device reported in the DeviceType column. Possible values include Android, Blackberry, iOS, Other, Unknown, and Windows.
DeviceType Dimension
The type of device used by the customer when the impression occurred (e.g., Computers, Smartphones, Tablets).
Disclaimer Ads Enabled Dimension
Indicates whether disclaimer ads are enabled for campaigns, allowing businesses to include legal, regulatory, or promotional fine print within ads.
Display Url Dimension
The URL that is displayed in the ad to the user.
DisplayUrl Dimension
The URL displayed in the ad.
Domain Language Dimension
This field specifies the language of the website domain, which can influence ad delivery, particularly for Dynamic Search Ads.
Domain Name Dimension
The domain name associated with an ad, campaign, or website.
Dynamic Ad Target Condition 1 Dimension
The first condition that determines whether a webpage property (e.g., URL, content, title) matches the dynamic ad target.
Dynamic Ad Target Condition 2 Dimension
The second condition that determines whether a webpage property (e.g., URL, content, title) matches the dynamic ad target.
Dynamic Ad Target Condition 3 Dimension
The third condition that determines whether a webpage property (e.g., URL, content, title) matches the dynamic ad target.
Dynamic Ad Target Condition Operator 1 Dimension
The operator used with the first dynamic ad target condition (e.g., 'contains', 'equals').
Dynamic Ad Target Condition Operator 2 Dimension
The operator used with the second dynamic ad target condition (e.g., 'contains', 'equals').
Dynamic Ad Target Condition Operator 3 Dimension
The operator used with the third dynamic ad target condition (e.g., 'contains', 'equals').
Dynamic Ad Target Value 1 Dimension
The value used with the first dynamic ad target condition to target webpages (e.g., a specific URL, category, page title, or page content).
Dynamic Ad Target Value 2 Dimension
The value used with the second dynamic ad target condition to target webpages.
Dynamic Ad Target Value 3 Dimension
The value used with the third dynamic ad target condition to target webpages.
Dynamic Description Enabled Dimension
Indicates whether dynamic descriptions are enabled for an ad. This allows the system to automatically generate descriptive text.
Editorial Appeal Status Dimension
This field indicates the status of an ad's or keyword's editorial rejection, determining whether the issue can be appealed and if an appeal has already been submitted.
Editorial Location Dimension
This field identifies the specific component or property of an ad or ad extension that failed the editorial review process.
Editorial Reason Code Dimension
A code that defines the reason why an ad, keyword, or ad extension failed editorial review.
Editorial Status Dimension
The editorial review status of the ad, indicating whether it's pending review, approved, or disapproved.
Editorial Term Dimension
A specific word or phrase within an ad or ad extension that has been identified during editorial review as potentially violating advertising policies.
End Date Dimension
The date when the campaign or other scheduled entity will stop running.
EndDate Dimension
The scheduled end date for an entity or the end date for reported data.
Entity Type Dimension
The type of advertising entity, such as Campaign, AdGroup, Ad, or Keyword, used to filter label associations or other entity-specific data.
Error Dimension
An error message or code from an API operation.
Error Detail Dimension
Additional details describing an error.
Error Number Dimension
A numeric code associated with an error.
ExactMatchImpressionSharePercent Metric
The estimated percentage of impressions from searches that exactly matched your keyword, out of the total available exact match impressions it was eligible to receive.
Exclude From Bidding Dimension
Indicates if the conversion goal is excluded from bidding optimization calculations.
Excluded Location Intent Dimension
This field specifies the intent option for excluded geographical locations, such as preventing ads from being shown to people physically located in, or searching for/viewing pages about, a specific excluded area.
Excluded Locations Dimension
This field represents geographical locations that are explicitly excluded from ad targeting, meaning ads will not be shown to users in or interested in these areas.
ExpectedCtr Metric
A component of Quality Score, measuring the expected click-through rate of an ad.
Experiment Campaign Id Dimension
The unique identifier of the campaign created as a copy of the base campaign for an experiment.
Experiment Campaign Type Dimension
This field indicates the type of an advertising campaign that is part of an experiment, such as Search, Audience, or Shopping. It helps identify the original campaign type used as a base for A/B testing.
Experiment Id Dimension
The unique identifier for an advertising experiment.
Experiment Type Dimension
Defines an A/B test conducted on an advertising campaign, where a duplicate campaign receives a split of the original's budget and ad traffic. This allows advertisers to test changes (e.g., bid strategies, targeting) and compare performance before full implementation.
ExperimentId Dimension
The unique identifier for an experiment, used to track and analyze the performance of changes made to campaigns or ad groups.
ExtendedCost Metric
The total cost incurred for advertising, representing the spend for a specific period or entity.
Feed Id Dimension
A unique identifier assigned by Microsoft Advertising to a specific data feed. Feeds contain items used to dynamically insert information into ads (e.g., product details for shopping campaigns) or define pages for dynamic search ads.
FeedLabel Dimension
A label used to group and advertise products from a product catalog within Shopping or Performance Max campaigns.
Final Mobile Url 1 Dimension
The first mobile landing page URL where users are directed after clicking an ad.
Final Mobile Url 2 Dimension
The second mobile landing page URL where users are directed after clicking an ad.
Final Mobile Url 3 Dimension
The third mobile landing page URL where users are directed after clicking an ad.
Final Mobile Url 4 Dimension
The fourth mobile landing page URL where users are directed after clicking an ad.
Final Mobile Url 5 Dimension
The fifth mobile landing page URL where users are directed after clicking an ad.
Final Mobile Url 6 Dimension
The sixth mobile landing page URL where users are directed after clicking an ad.
Final Mobile Url 7 Dimension
The seventh mobile landing page URL where users are directed after clicking an ad.
Final Mobile Url 8 Dimension
The eighth mobile landing page URL where users are directed after clicking an ad.
Final Url Dimension
The last or final URL where a user is ultimately taken after clicking an ad.
Final Url 1 Dimension
The first final URL where users are ultimately taken after clicking an ad.
Final Url 2 Dimension
The second final URL where users are ultimately taken after clicking an ad.
Final Url 3 Dimension
The third final URL where users are ultimately taken after clicking an ad.
Final Url 4 Dimension
The fourth final URL where users are ultimately taken after clicking an ad.
Final Url 5 Dimension
The fifth final URL where users are ultimately taken after clicking an ad.
Final Url 6 Dimension
The sixth final URL where users are ultimately taken after clicking an ad.
Final Url 7 Dimension
The seventh final URL where users are ultimately taken after clicking an ad.
Final Url 8 Dimension
The eighth final URL where users are ultimately taken after clicking an ad.
Final Url Suffix Dimension
Tracking parameters appended to the end of the landing page URL.
FinalAppUrl Dimension
Your App URL is the page where people go after clicking on your ad on an app.
FinalMobileUrl Dimension
Your Mobile URL is the page where people go after clicking on your ad on a mobile device.
FinalUrl Dimension
The landing page URL where customers are taken after clicking the ad.
FinalUrlSuffix Dimension
Additional tracking parameters appended to the final URL.
FirstPageBid Dimension
Based on campaign performance and marketplace dynamics, this estimate is the bid amount that Microsoft Advertising calculates for your ad to be placed on the first page sidebar in the search results.
Frequency Cap Settings Dimension
Settings that limit the number of times an ad or creative is shown to a unique user over a specified period (e.g., per day, week, or month) to prevent overexposure.
FridayHours Dimension
The scheduled hours during which ads are eligible to be shown on Fridays.
From Hour Dimension
The starting hour for an ad schedule time range.
From Minute Dimension
The starting minute for an ad schedule time range.
Gender Dimension
Audience targeting criterion specifying gender (Male, Female) for ad delivery.
Gender Types Dimension
The gender types targeted by the ad.
Goal Dimension
The name of the campaign analytics goal for tracking potential land, browse, prospect, and conversion steps.
Goal Id Dimension
The unique identifier of a conversion goal.
GoalId Dimension
The unique identifier of a conversion goal.
GoalIds Dimension
A list of identifiers for conversion goals associated with a campaign or account, used to track desired actions (e.g., purchases, sign-ups).
GoalType Dimension
The type or category of a conversion goal (e.g., purchase, lead, sign-up).
HTML5Assets Dimension
Refers to HTML5 creative assets used in advertising campaigns, which can be managed via specific API operations.
Header 1 Dimension
The first header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters.
Header 2 Dimension
The second header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters.
Header 3 Dimension
The third header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters.
Header 4 Dimension
The fourth header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters.
Header 5 Dimension
The fifth header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters.
Header 6 Dimension
The sixth header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters.
Header 7 Dimension
The seventh header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters.
Header 8 Dimension
The eighth header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters.
Headline Dimension
The main headline text of the ad.
Headlines Dimension
The primary text components of an ad, especially prominent in responsive search ads, designed to capture user attention.
HistoricalAdRelevance Metric
The historical measure of how relevant an ad is to the keyword and user's search query.
HistoricalExpectedCtr Metric
A historical prediction of the click-through rate for an ad or keyword, used for campaign optimization.
HistoricalLandingPageExperience Metric
The historical measure of how relevant and useful an ad's landing page is to people who click your ad.
HistoricalQualityScore Metric
The historical overall quality score of a keyword, determining ad rank and cost per click.
Hotel Ad Group Type Dimension
The specific type of ad group used for Hotel Ads, primarily for organizing hotel listings.
Hotel Attribute Dimension
A specific amenity or characteristic of a hotel, such as 'air conditioning' or 'swimming pool', used in hotel property feeds.
Hotel Attribute Value Dimension
The specific value associated with a hotel attribute, indicating whether the hotel offers a particular amenity or its status (e.g., 'Yes' or 'No').
Id Dimension
The unique Microsoft Advertising identifier for the entity.
Impression Tracking Url Dimension
A URL used to track when an ad creative is displayed to a user. This is particularly relevant for tracking impressions from third-party ad servers, allowing for external reporting of ad views.
Impression Tracking Urls Dimension
URLs used by third-party ad servers to track impressions for creatives, allowing for performance measurement across external tools.
ImpressionLostToBudgetPercent Metric
The estimated percentage of impressions lost due to an insufficient budget.
ImpressionLostToRankAggPercent Metric
The estimated percentage of potential ad impressions that were not achieved due to a low ad rank, which is influenced by factors like bid, quality, and ad formats.
ImpressionSharePercent Metric
How often your ad is shown, as a percentage of the total available impressions in the market you were targeting.
Impressions Metric
The number of times an ad was displayed.
Include View Through Conversions Dimension
A setting that determines whether view-through conversions are included in conversion metrics. A view-through conversion occurs when a user sees an ad but does not click it, yet later completes a conversion on the website within a defined timeframe.
Included Location Intent Dimension
This field specifies the intent option for included geographical locations, such as targeting people physically in the location, or people searching for/viewing pages about the location.
Included Locations Dimension
This field lists the specific geographical locations, such as countries, regions, cities, or postal codes, where ads are targeted to be shown.
Industry Dimension
Industry allows advertisers to target audiences based on the industries they work in (e.g., as identified by LinkedIn data), or to segment performance data by industry in reports.
Inherited Bid Strategy Type Dimension
The bid strategy type inherited from a higher-level entity, such as the campaign.
Is Deal Campaign Dimension
Indicates whether the campaign is designated as a deal campaign.
Is Excluded Dimension
This boolean field indicates whether an entity, such as a location or product group, is excluded from targeting.
Job Function Dimension
A targeting criterion that allows ads to be displayed to users based on their professional job function, as inferred from data like LinkedIn profiles.
Keyword Dimension
The keyword text that triggered the ad.
Keyword Relevance Dimension
A measure of how well a keyword competes against other keywords targeting the same traffic.
KeywordId Dimension
The unique system-generated identifier of the keyword.
KeywordLabels Dimension
These are the labels you applied to keywords.
KeywordStatus Dimension
The status of the keyword (e.g., Active, Paused, Deleted).
Label Dimension
A custom tag used to organize campaigns, ad groups, ads, or keywords for filtering and reporting.
Landing Page Relevance Dimension
A measure of how relevant the landing page is to the ad and search query.
Landing Page User Experience Dimension
A measure of the quality of the user experience on the landing page.
LandingPageExperience Metric
A component of Quality Score, measuring the relevance and usefulness of an ad's landing page.
Language Dimension
The language targeted by the campaign or ad group.
Languages Dimension
The languages targeted by a campaign, ensuring ads are shown to users who speak specific languages.
LastModifiedTime Dimension
The date and time when an entity was last modified or when a data record was generated.
LastModifiedTime_Date Dimension
The date component of when an entity was last modified or when a data record was generated.
Latitude Dimension
The latitude coordinate of a geographical location, used for location targeting in ads. Values range from -85 to +85 degrees.
LocationId Dimension
The unique identifier for a geographical location.
LocationType Dimension
The type of geographical location, such as country, state, city, or county.
Long Headline Dimension
A longer headline text variant for responsive ads, providing more descriptive space for ad copy. For Audience campaigns, it is the longer of two possible responsive ad headlines.
Long Headlines Dimension
A list of longer headline text variants used for responsive ads.
LongHeadline Dimension
A longer headline text variant for responsive search ads.
Longitude Dimension
The longitude coordinate of a geographical location, used for location targeting in ads. Values range from -180 to +180 degrees.
LowQualityClicks Metric
The number of low-quality clicks on ads.
LowQualityClicksPercent Metric
The percentage of low-quality clicks.
LowQualityConversionRate Dimension
The rate of conversions determined to be of low quality.
LowQualityConversions Metric
The number of low-quality conversions recorded.
LowQualityGeneralClicks Metric
Represents clicks filtered by general methods (e.g., deny lists, activity-based detection) that have a low likelihood of commercial intent. These clicks are not billed.
LowQualityImpressions Metric
The number of low-quality ad impressions.
LowQualityImpressionsPercent Metric
The percentage of low-quality impressions.
LowQualitySophisticatedClicks Metric
Represents invalid clicks that use sophisticated methods to appear valid. These clicks are not billed.
MSCLKID Auto Tagging Enabled Dimension
A setting that, when enabled, automatically appends a unique Microsoft Click ID (MSCLKID) to the landing page URL when a user clicks on an ad. This ID helps ensure accurate conversion tracking, especially when third-party cookies are restricted.
Marketing Objective Dimension
The primary goal or intent of an advertising campaign, such as brand awareness, website visits, or conversions, which influences available ad formats, bidding strategies, and optimization settings.
Match Type Dimension
The keyword match type, such as Broad, Exact, or Phrase.
Maximum Bid Dimension
The highest bid amount an advertiser is willing to pay, often specified as a maximum cost per click (CPC) within certain bid strategies.
Mcpa Bid Dimension
The maximum Cost Per Acquisition (CPA) bid used in a manual CPA bid strategy. This value helps control the maximum amount spent to acquire a conversion.
Media Ids Dimension
This field contains a list of unique identifiers for media assets, such as images or videos, stored in the media library, used for associating media with ads or extensions.
Media Url Dimension
The direct URL of a single media asset, such as an image or video, used within an ad or ad extension.
Media Urls Dimension
URLs associated with advertising creatives, including landing page URLs (final URLs) for ads and URLs used in page feeds for dynamic search campaigns.
MerchantProductId Metric
The unique identifier for a product within your Microsoft Merchant Center store product catalog. This ID is used for reporting analytics in Microsoft Shopping Campaigns.
MetroArea Dimension
The metropolitan area where the user was physically located when they clicked the ad. This is part of the Microsoft Market Area for US targeting.
Microsoft Click Id Dimension
A unique 32-character GUID (Globally Unique Identifier) automatically appended to landing page URLs when auto-tagging is enabled. It is used to accurately attribute conversions to ad clicks.
Mobile Final Url Dimension
The mobile landing page URL where a user is ultimately taken after clicking an ad.
Modified Time Dimension
The date and time when the entity was last modified.
MondayHours Dimension
The scheduled hours during which ads are eligible to be shown on Mondays.
MonthToDateSpend Metric
The cumulative amount of money spent on a campaign or account from the beginning of the current month up to the reporting date.
MonthlyBudget Metric
The anticipated maximum monthly budget amount, calculated based on the daily budget and days remaining in the month.
MostSpecificLocation Dimension
The most granular geographical location targeted by an ad or campaign.
Multi Media Ad Bid Adjustment Metric
A percentage adjustment applied to bids for multimedia ads at the campaign or ad group level to influence their display frequency.
Name Dimension
The name of the entity.
Negative Audiences Dimension
This field represents a list of audience segments, keywords, or website URLs that are excluded from ad targeting to prevent ads from being shown to irrelevant users or on unsuitable placements.
Network Dimension
The advertising network where the ad was shown (e.g., owned and operated, syndicated search).
Network Distribution Dimension
The network where the ads are shown, such as the Microsoft Advertising Network or partner traffic.
New Customer Acquisition Goal Id Dimension
The unique identifier for a new customer acquisition goal, which helps advertisers optimize campaigns to target or prioritize net-new customers.
OS Names Dimension
The operating system of the device where an ad was displayed, such as Android, iOS, or Windows. This data is available for reporting purposes.
Page Feed Ids Dimension
The identifiers for page feeds used in dynamic ads or Performance Max campaigns.
Param1 Dimension
The first custom parameter used for URL tracking or dynamic content.
Param2 Dimension
The second custom parameter used for URL tracking or dynamic content.
Param3 Dimension
The third custom parameter used for URL tracking or dynamic content.
Parent Account Id Metric
The identifier of the parent account in an account hierarchy.
Parent Criterion Id Dimension
The unique identifier of the parent criterion in a hierarchical targeting structure.
Parent Id Dimension
The identifier of the parent entity, used to establish hierarchical relationships.
Path 1 Dimension
The first optional display path shown in the ad's URL.
Path 2 Dimension
The second optional display path shown in the ad's URL.
Path1 Dimension
A shorter or "friendlier" version of your URL address that appears in your ads, as the first subdirectory.
Path2 Dimension
A shorter or "friendlier" version of your URL address that appears in your ads, as the second subdirectory.
Percent Cpc Bid Dimension
A bidding strategy where the bid is a percentage of the total hotel price per night, including taxes and fees.
Phone Number Dimension
The phone number displayed in a call ad or call extension.
PhoneCalls Metric
A performance metric representing the number of phone calls generated from ads that include a call extension or call-only ad.
PhoneImpressions Metric
A performance metric representing the number of times an ad with a phone number or call extension was displayed.
Placement Dimension
The specific location on a webpage or app where an ad is displayed.
Platform Dimension
Refers to the specific advertising network or system where ads are run and managed, which in this context is the Microsoft Advertising platform.
Postal Code Dimension
The postal code for a geographical target.
PostalCode Metric
The postal code for a geographical target.
Price Metric
The price of a product or service advertised, often appearing in product ads or price extensions.
Price 1 Dimension
The first price point advertised in a price ad extension. Price ad extensions can include up to 8 price columns.
Price 2 Dimension
The second price point advertised in a price ad extension. Price ad extensions can include up to 8 price columns.
Price 3 Dimension
The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.
Price 4 Dimension
The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.
Price 5 Dimension
The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.
Price 6 Dimension
The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.
Price 7 Dimension
The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.
Price 8 Dimension
The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.
Price Description 1 Dimension
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.
Price Description 2 Dimension
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.
Price Description 3 Dimension
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.
Price Description 4 Dimension
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.
Price Description 5 Dimension
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.
Price Description 6 Dimension
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.
Price Description 7 Dimension
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.
Price Description 8 Dimension
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.
Price Extension Type Dimension
The type of price ad extension, determining how prices are displayed (e.g., "From", "Up To", "Average").
Price Qualifier 1 Dimension
The qualifier text (e.g., "From", "Up To", "Average") that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.
Price Qualifier 2 Dimension
The qualifier text (e.g., "From", "Up To", "Average") that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.
Price Qualifier 3 Dimension
The qualifier text (e.g., "From", "Up To", "Average") that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.
Price Qualifier 4 Dimension
The qualifier text (e.g., "From", "Up To", "Average") that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.
Price Qualifier 5 Dimension
The qualifier text (e.g., "From", "Up To", "Average") that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.
Price Qualifier 6 Dimension
The qualifier text (e.g., "From", "Up To", "Average") that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.
Price Qualifier 7 Dimension
The qualifier text (e.g., "From", "Up To", "Average") that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.
Price Qualifier 8 Dimension
The qualifier text (e.g., "From", "Up To", "Average") that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.
Price Unit 1 Dimension
The unit of time or measure (e.g., "Per Day", "Per Hour") associated with the price in a Price Ad Extension.
Price Unit 2 Dimension
The unit of time or measure (e.g., "Per Day", "Per Hour") associated with the price in a Price Ad Extension.
Price Unit 3 Dimension
The unit of time or measure (e.g., "Per Day", "Per Hour") associated with the price in a Price Ad Extension.
Price Unit 4 Dimension
The unit of time or measure (e.g., "Per Day", "Per Hour") associated with the price in a Price Ad Extension.
Price Unit 5 Dimension
The unit of time or measure (e.g., "Per Day", "Per Hour") associated with the price in a Price Ad Extension.
Price Unit 6 Dimension
The unit of time or measure (e.g., "Per Day", "Per Hour") associated with the price in a Price Ad Extension.
Price Unit 7 Dimension
The unit of time or measure (e.g., "Per Day", "Per Hour") associated with the price in a Price Ad Extension.
Price Unit 8 Dimension
The unit of time or measure (e.g., "Per Day", "Per Hour") associated with the price in a Price Ad Extension.
Priority Dimension
The priority of a shopping campaign, determining which campaign serves ads when multiple campaigns target the same product.
Product Ads Opt Out Dimension
Indicates whether an account or campaign is opted out of displaying product ads within certain networks or placements.
Product Condition 1 Dimension
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as "New", "Used", or "Refurbished".
Product Condition 2 Dimension
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as "New", "Used", or "Refurbished".
Product Condition 3 Dimension
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as "New", "Used", or "Refurbished".
Product Condition 4 Dimension
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as "New", "Used", or "Refurbished".
Product Condition 5 Dimension
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as "New", "Used", or "Refurbished".
Product Condition 6 Dimension
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as "New", "Used", or "Refurbished".
Product Condition 7 Dimension
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as "New", "Used", or "Refurbished".
Product Value 1 Dimension
The specific attribute value that a product must match to satisfy a product condition, for example, "Contoso" for the "Brand" operand.
Product Value 2 Dimension
The specific attribute value that a product must match to satisfy a product condition, for example, "Contoso" for the "Brand" operand.
Product Value 3 Dimension
The specific attribute value that a product must match to satisfy a product condition, for example, "Contoso" for the "Brand" operand.
Product Value 4 Dimension
The specific attribute value that a product must match to satisfy a product condition, for example, "Contoso" for the "Brand" operand.
Product Value 5 Dimension
The specific attribute value that a product must match to satisfy a product condition, for example, "Contoso" for the "Brand" operand.
Product Value 6 Dimension
The specific attribute value that a product must match to satisfy a product condition, for example, "Contoso" for the "Brand" operand.
Product Value 7 Dimension
The specific attribute value that a product must match to satisfy a product condition, for example, "Contoso" for the "Brand" operand.
ProductCategory1 Dimension
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.
ProductCategory2 Dimension
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.
ProductCategory3 Dimension
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.
ProductCategory4 Dimension
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.
ProductCategory5 Dimension
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.
ProductType1 Dimension
A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.
ProductType2 Dimension
A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.
ProductType3 Dimension
A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.
ProductType4 Dimension
A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.
ProductType5 Dimension
A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.
Promotion Dimension
This field relates to promotion ad extensions, which highlight special sales, offers, or discount codes within ads to attract potential customers.
Province Name Dimension
This field specifies the name of a province or state used for geographical ad targeting.
ProximityTargetLocation Dimension
A geographical location used as the center point for radius targeting.
Publisher Countries Dimension
The list of countries or regions where Microsoft Advertising is able to publish or serve ads. This field is relevant for understanding the geographical reach and targeting capabilities of advertising campaigns.
PublisherUrl Dimension
This field provides the URL of the website or platform where an ad was displayed, particularly relevant for ads shown on syndicated search partners.
Purchases Metric
The number of purchase conversions recorded from advertising campaigns.
Quality Score Dimension
A metric (1-10) reflecting the relevance and quality of ads, keywords, and landing pages, impacting ad placement and cost.
QualityImpact Metric
A numeric score (0-3) indicating the potential increase in keyword impressions if the Quality Score improves. Higher scores suggest a greater impact on impressions.
QualityScore Metric
An estimate of the quality of your ads, keywords, and landing pages.
RSA Auto Generated Assets Enabled Dimension
A setting for Responsive Search Ads (RSAs) that, when enabled, allows Microsoft Advertising to dynamically create and serve headlines and descriptions using generative AI, thereby helping to scale ad creation and improve ad relevance.
Radius Dimension
The radius around a target location for geographical targeting.
Reach Optimization Goal Dimension
The objective set for a campaign or ad group focused on maximizing the number of unique users exposed to the advertisement.
Remarketing Rule Dimension
A set of conditions that defines how users are added to a remarketing list. These rules determine the criteria for audience segmentation, such as users who visited specific pages or triggered custom events.
Report End Date Dimension
The end date for the report data.
Report Start Date Dimension
The start date for the report data.
ReturnOnAdSpend Metric
The Return on Ad Spend (ROAS), calculated as (Revenue / Spend).
Revenue Metric
The total revenue generated from conversions.
Revenue Value Dimension
The revenue value optionally reported by the advertiser as a result of conversions.
RevenuePerAssist Dimension
Revenue divided by the number of assists.
RevenuePerConversion Metric
The revenue generated for each conversion.
RevenuePerSale Metric
A reporting metric that represents the revenue generated per sale or conversion.
Sales Metric
This field represents the revenue generated from conversions, such as purchases, subscriptions, or other defined conversion actions. It provides insights into the monetary value associated with user interactions with ads.
SaturdayHours Dimension
The scheduled operating hours for Saturday, used for ad extension scheduling.
Schedule Dimension
Defines the calendar date and time ranges when an ad extension is eligible to be shown.
Scope Dimension
Determines whether a conversion goal applies to a single account or across all accounts under a customer, with possible values being 'Account' or 'Customer'.
Search Theme Dimension
A classification or category that defines the subject or intent of search queries to target ads.
SearchQuery Dimension
The search query entered by the user that triggered an ad.
Segment Dimension
Segment refers to a custom audience group defined by specific criteria (e.g., demographics, behavior, keywords) that advertisers can target with their ads or use to analyze performance data.
SellerName Dimension
The name of the seller or merchant associated with a product in shopping campaigns.
Settings.AutoGeneratedAssetsEnabled_1 Dimension
A setting that controls whether the system can automatically generate assets (e.g., headlines, descriptions, images) for ads to improve performance.
Settings.AutoGeneratedAssetsEnabled_2 Dimension
A setting that controls whether the system can automatically generate assets (e.g., headlines, descriptions, images) for ads to improve performance.
Settings.AutoGeneratedImageOptOut_1 Dimension
A setting to opt out of the automatic generation and use of images for ads.
Settings.AutoGeneratedTextOptOut_1 Dimension
A setting to opt out of the automatic generation and use of text content (e.g., headlines, descriptions) for ads.
Settings.AutomatedCallToActionOptOut_1 Dimension
Indicates whether the account or campaign is opted out of automated call-to-action generation within ad settings.
Settings.AutomatedCallToActionOptOut_2 Dimension
Indicates whether the account or campaign is opted out of automated call-to-action generation within ad settings.
Settings.AutomatedCallToActionOptOut_3 Dimension
Indicates whether the account or campaign is opted out of automated call-to-action generation within ad settings.
Settings.CallToActionOptOut_1 Dimension
Indicates whether the account or campaign is opted out of specific call-to-action features within ad settings.
Settings.CallToActionOptOut_2 Dimension
Indicates whether the account or campaign is opted out of specific call-to-action features within ad settings.
Settings.CallToActionOptOut_3 Dimension
Indicates whether the account or campaign is opted out of specific call-to-action features within ad settings.
Settings.CostPerSaleOptOut_1 Dimension
A setting to opt out of campaign optimization or bidding strategies specifically related to Cost Per Sale.
Settings.Details.TargetSettingDetail_1 Dimension
Specific details within a campaign's target settings that define audience criteria, such as demographics, locations, or device types.
Settings.Details.TargetSettingDetail_2 Dimension
Specific details within a campaign's target settings that define audience criteria, such as demographics, locations, or device types.
Settings.Details.TargetSettingDetail_3 Dimension
Specific details within a campaign's target settings that define audience criteria, such as demographics, locations, or device types.
Settings.Details.TargetSettingDetail_4 Dimension
Specific details within a campaign's target settings that define audience criteria, such as demographics, locations, or device types.
Settings.DisclaimerAdsEnabled_1 Dimension
This setting controls whether disclaimer ads are enabled for campaigns, allowing businesses to include legal, regulatory, or promotional disclaimers.
Settings.DomainName_1 Dimension
The domain name associated with a campaign or ad group, used for purposes like URL tracking or final URL expansion.
Settings.FinalUrlExpansionOptOut_1 Dimension
A setting that, when opted out, prevents Microsoft from automatically expanding final URLs to cover the entire domain and dynamically generating assets based on landing page content.
Settings.Language_1 Dimension
Defines the language setting for a campaign or ad group, influencing which language audiences are targeted.
Settings.PageFeedIds.long_1 Dimension
The unique identifiers for page feeds associated with a campaign, used to provide URLs for dynamic search ads.
Settings.PageFeedIds_1 Dimension
The unique identifiers for page feeds associated with a campaign, used to provide URLs for dynamic search ads.
Settings.Source_1 Dimension
A setting that defines the source of URLs for dynamic search ads, such as advertiser-supplied URLs, Bing's index, or a combination.
Settings.Type_1 Dimension
The type of setting being configured, indicating its specific category or function within campaign or account settings.
Settings.Type_2 Dimension
The type of setting being configured, indicating its specific category or function within campaign or account settings.
Settings.Type_3 Dimension
The type of setting being configured, indicating its specific category or function within campaign or account settings.
Settings.Type_4 Dimension
The type of setting being configured, indicating its specific category or function within campaign or account settings.
Sitelink Extension Description1 Dimension
An additional line of descriptive text for a Sitelink Ad Extension, providing more detail about the linked page. Maximum length is 35 characters.
Sitelink Extension Description2 Dimension
An additional line of descriptive text for a Sitelink Ad Extension, providing more detail about the linked page. Maximum length is 35 characters.
Sitelink Extension Destination Url Dimension
The URL where users are directed when they click on a Sitelink Ad Extension.
Sitelink Extension Link Text Dimension
The clickable text displayed for a Sitelink Ad Extension.
Sitelink Extension Order Dimension
Determines the display order of sitelink ad extensions when shown with an ad.
Source Dimension
The source of content for dynamic search ads or the origin of campaign data.
Spend Metric
The total cost of clicks on an ad.
Start Date Dimension
The date when an entity, such as an ad extension or campaign, is scheduled to begin serving.
StartDate Dimension
The scheduled start date for an entity or the start date for reported data.
State Dimension
The state or province where the impression, click, or conversion occurred.
State Or Province Code Dimension
The geographical code for a state or province, used for location targeting in campaigns.
Status Dimension
The current status of the entity (e.g., Active, Paused, Deleted).
Store Id Dimension
The name of the store you created in Microsoft Merchant Center that contains your offers for this campaign.
StoreCode Dimension
The unique identifier for the Microsoft Merchant Center store, which contains a product catalog feed used for the campaign.
Structured Snippet Header Dimension
The header for a Structured Snippet Ad Extension, which categorizes the associated snippet values (e.g., "Brands", "Services").
Structured Snippet Values Dimension
A list of values associated with a Structured Snippet Header, providing specific examples or details (e.g., "Windows, Xbox, Skype" for a "Brands" header).
Sub Channels Dimension
Specific networks, sites, or placements within the broader Microsoft Advertising Network where ads can be displayed, such as Microsoft Edge browsers, Outlook, MSN, or various partner traffic segments.
Sub Type Dimension
A more granular classification for a campaign or ad group, providing additional context beyond the main "Type" field (e.g., "ShoppingSmartAds" for a Shopping campaign).
SubType Dimension
A secondary classification or more granular type for an entity, providing further detail beyond its primary type.
SundayHours Dimension
The scheduled operating hours for Sunday, used for ad extension scheduling.
Target Ad Group Id Dimension
The unique identifier of the ad group that is the target of an action or report.
Target Campaign Id Dimension
The unique identifier of the campaign that is the target of an action or report.
Target Setting Dimension
Defines the targeting options for criteria groups (e.g., Age, Gender), specifying whether to "target and bid" or "bid only" for those audiences.
Text Dimension
The main body text or description of an ad.
Text Part 2 Dimension
This field represents the second part of an ad's description or text, used in ad formats like Expanded Text Ads or Responsive Search Ads.
Third Party Measurement Settings Dimension
Settings that enable integration with third-party measurement providers for advanced verification, reporting, and insights into campaign performance.
ThursdayHours Dimension
The scheduled operating hours for Thursday, used for ad extension scheduling.
Time Zone Dimension
The time zone used for campaign operations, ad scheduling, and report aggregation.
TimePeriod Dimension
The aggregation period for report data, such as daily, weekly, or monthly.
TimeStamp Dimension
The date and time of a data record, often indicating when the data was captured or generated.
TimeZone Dimension
The time zone used for campaign operations, ad scheduling, and report aggregation.
Title Dimension
The title of an ad or asset.
Title Part 1 Dimension
Components of the ad title, allowing for multiple headlines to be displayed in Expanded Text Ads.
Title Part 2 Dimension
Components of the ad title, allowing for multiple headlines to be displayed in Expanded Text Ads.
Title Part 3 Dimension
Components of the ad title, allowing for multiple headlines to be displayed in Expanded Text Ads.
TitlePart1 Dimension
In Expanded Text ads, Ad title 1 is the first line of the most prominent part of your ad that links to your website.
TitlePart2 Dimension
This is the second line of the most prominent part of your ad that links to your website.
TitlePart3 Dimension
This is the third line of the most prominent part of your ad that links to your website.
To Hour Dimension
The ending hour of a scheduled time range for ad delivery, on a 24-hour clock (0-24).
To Minute Dimension
The ending minute of a scheduled time range for ad delivery, ranging from 0 to 60.
TopImpressionRatePercent Metric
The percentage of times an ad appeared in the mainline (top placement above search results) out of its total impressions. This indicates how changes in ad position can impact performance.
TopImpressionShareLostToBudgetPercent Metric
The estimated percentage of times an ad failed to show in the top ad positions (above organic search results) due to an insufficient budget.
TopImpressionShareLostToRankPercent Metric
The estimated percentage of mainline impressions (ads appearing above search results) lost due to poor ad rank. This metric helps assess why ads are missing out on optimal ad positions.
TopImpressionSharePercent Metric
The percentage of estimated available impressions in the top positions that an ad received. (first search)
TopVsOther Dimension
The position (mainline vs. bottom or sidebar) of your ad on a Bing, AOL, or Yahoo search results page.
TotalClicks Metric
The total number of clicks received by an ad or other entity.
TotalWatchTimeInMS Metric
The total watch time of videos in milliseconds.
Tracking Enabled Dimension
This field indicates whether tracking, such as Universal Event Tracking (UET) or offline conversion tracking, is enabled to monitor customer actions and ad performance.
Tracking Template Dimension
A URL template that contains tracking parameters, which are appended to landing page URLs to collect data about ad clicks.
TrackingTemplate Dimension
The URL template used for tracking clicks and other metrics.
TrackingUrlTemplate Dimension
The URL template used for tracking clicks and other interactions with an ad. It often includes placeholders for dynamic values that are replaced at the time of a click.
TuesdayHours Dimension
The scheduled operating hours for Tuesday, used for ad extension scheduling.
Type Dimension
The classification or category of an entity, such as an ad, campaign, or ad extension.
UET Tag Id Dimension
The unique identifier for a Universal Event Tracking (UET) tag, used to track website actions and conversions.
Url Dimension
A web address associated with an advertising entity, such as a landing page or an ad extension.
UrlCustomParameters Dimension
A collection of custom key-value pairs that can be appended to tracking URLs for more granular data collection and reporting.
Use MaxClicks Dimension
Enables a bidding strategy where Microsoft Advertising automatically sets bids in real-time to generate the maximum possible clicks within a specified campaign budget.
Use Searcher Time Zone Dimension
A setting that determines whether ad scheduling should use the searcher's local time zone instead of the account's time zone.
Version Dimension
Indicates the version of an entity or data format. For ad extensions, it tracks the number of updates; for reports, it specifies the data format version.
Video Id Dimension
This field represents the unique Microsoft Advertising identifier for a video asset uploaded to the account. This ID is used to reference and manage specific video content for advertising campaigns.
Video Status Dimension
The current status of a video asset, indicating its processing state, such as active, pending review, or disapproved.
Video Url Dimension
The original URL of the video asset. This URL must be a direct download link for the video file.
VideoCompletionRate Metric
The rate at which video ads are completed by viewers.
VideoViews Metric
The total number of times a video ad was played.
VideoViewsAt25Percent Metric
The number of times a video ad was played to at least 25% of its total duration.
VideoViewsAt50Percent Metric
The number of times a video ad was played to at least 50% of its total duration.
VideoViewsAt75Percent Metric
The number of times a video ad was played to at least 75% of its total duration.
Videos Dimension
This field refers to video assets used in advertising campaigns, including their properties like aspect ratio and associated thumbnail images.
View Through Conversion Window In Minutes Dimension
The length of time in minutes, ranging from 1 to 43,200 (30 days), after an ad impression (without a click) during which a view-through conversion event will be tracked.
ViewThroughConversions Metric
Deprecated by Microsoft in 2022. Performance reports return 0 in this column. Use ViewThroughConversionsQualified instead, which reports view-through conversions, where a user saw an ad but did not click, then converted later.
ViewThroughConversionsQualified Dimension
The number of view-through conversions, which occur when a customer converts after seeing an ad but without clicking it. These are specifically counted for ads on the Microsoft Audience network.
ViewThroughRevenue Metric
The revenue amount optionally reported by the advertiser as a result of view-through conversions (conversions that occur after a user sees an ad but does not click it).
Website Dimension
The landing page URL (Final URL) where users are directed after clicking an ad. This is the ultimate destination website for ad traffic.
WednesdayHours Dimension
The scheduled operating hours for Wednesday, used for ad extension scheduling.
YearMonth Metric
The year and month for the reported data.
campaign_type Dimension
The classification of an advertising campaign (e.g., Search, Shopping, Audience, Performance Max).
channel Dimension
Refers to the advertising channel or network where ads are distributed, such as the Search Network or Audience Network.