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.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
AbsoluteTopImpressionRatePercent |
AbsoluteTopImpressionRatePercent |
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. |
metric |
AbsoluteTopImpressionShareLostToBudgetPercent |
AbsoluteTopImpressionShareLostToBudgetPercent |
The estimated percentage of times an ad failed to show in the absolute top position due to an insufficient budget. |
metric |
AbsoluteTopImpressionShareLostToRankPercent |
AbsoluteTopImpressionShareLostToRankPercent |
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. |
metric |
AbsoluteTopImpressionSharePercent |
AbsoluteTopImpressionSharePercent |
How often your ad was in the first position of all results, as a percentage of your total impressions. |
metric |
Account Id |
Account Id |
The unique Microsoft Advertising identifier of the account. |
metric |
Account Name |
Account Name |
The name of the account. |
dimension |
AccountId |
AccountId |
The unique system-generated identifier of the account. |
dimension |
AccountName |
AccountName |
The name of the account. |
dimension |
AccountNumber |
AccountNumber |
The unique identification number of the advertiser account. |
dimension |
AccountStatus |
AccountStatus |
The status of the advertiser account (e.g., Active, Closed). |
dimension |
Ad Group |
Ad Group |
The name of the ad group. |
dimension |
Ad Group Type |
Ad Group Type |
The type of the ad group, e.g., ‘SearchStandard’ or ‘SearchDynamic’. |
dimension |
Ad Rotation |
Ad Rotation |
The setting that determines how often Microsoft Advertising selects which ads to serve within an ad group. |
dimension |
Ad Schedule |
Ad Schedule |
The schedule that defines when ads are eligible to be shown. |
dimension |
Ad Schedule Use Searcher Time Zone |
Ad Schedule Use Searcher Time Zone |
Indicates whether the ad schedule uses the searcher’s time zone. |
dimension |
Ad Strength |
Ad Strength |
The ad strength score of responsive search ads, indicating their effectiveness and relevance. |
dimension |
AdDescription |
AdDescription |
The primary descriptive text for the ad. |
dimension |
AdDescription2 |
AdDescription2 |
The secondary descriptive text for the ad, if available. |
dimension |
AdDistribution |
AdDistribution |
The distribution network where the ad is shown (e.g., search network, audience network). |
dimension |
AdExtensionId |
AdExtensionId |
The system-generated identifier of the ad extension. |
metric |
AdExtensionType |
AdExtensionType |
The type of ad extension (e.g., Sitelink, Callout, Call). |
dimension |
AdExtensionVersion |
AdExtensionVersion |
A version number that tracks updates made to an ad extension. |
metric |
AdGroupCriterionId |
AdGroupCriterionId |
The unique Microsoft Advertising identifier for a criterion applied to an ad group. |
dimension |
AdGroupId |
AdGroupId |
The unique system-generated identifier of the ad group. |
dimension |
AdGroupLabels |
AdGroupLabels |
Labels applied to ad groups for organization and reporting. |
dimension |
AdGroupName |
AdGroupName |
The name of the ad group. |
dimension |
AdGroupStatus |
AdGroupStatus |
The status of the ad group (e.g., Active, Paused, Deleted). |
dimension |
AdId |
AdId |
The system-generated identifier of the ad. |
dimension |
AdLabels |
AdLabels |
Labels applied to ads for organization and reporting. |
dimension |
AdRelevance |
AdRelevance |
A component of Quality Score, measuring how relevant an ad is to the keyword. |
metric |
AdStatus |
AdStatus |
The status of the ad (e.g., Active, Paused, Deleted). |
dimension |
AdStrength |
AdStrength |
A score indicating the effectiveness and relevance of responsive search ads, ranging from Poor to Excellent. |
dimension |
AdTitle |
AdTitle |
The title of the ad. |
dimension |
AdType |
AdType |
The type of ad (e.g., Text Ad, Product Ad, Responsive Search Ad). |
dimension |
Age Ranges |
Age Ranges |
The age groups targeted by the ad. |
dimension |
AgeGroup |
AgeGroup |
Audience targeting criterion specifying age demographic (e.g., 18-24, 25-34) for ad delivery. |
dimension |
AllConversionRate |
AllConversionRate |
The percentage of clicks that resulted in any conversion, including cross-device and from all conversion goals. |
metric |
AllConversions |
AllConversions |
The total number of conversions, including cross-device conversions and conversions from all goals. |
metric |
AllConversionsQualified |
AllConversionsQualified |
The total number of all conversions recorded, including those where the conversion goal’s “ExcludeFromBidding” property is set to true. |
metric |
AllCostPerConversion |
AllCostPerConversion |
The average cost for all conversions, regardless of their ‘ExcludeFromBidding’ setting. |
dimension |
AllReturnOnAdSpend |
AllReturnOnAdSpend |
The total revenue generated for every unit of currency spent on advertising, including all conversions. (first search) |
metric |
AllRevenue |
AllRevenue |
The total revenue generated from all conversions, including cross-device and from all conversion goals. |
metric |
AllRevenuePerConversion |
AllRevenuePerConversion |
The revenue generated per conversion, including all conversions (cross-device and from all conversion goals). |
dimension |
App Id |
App Id |
The unique identifier for the mobile app, as supplied by the app store, used in app install ads and app ad extensions. |
dimension |
App Platform |
App Platform |
The platform or app store where the mobile application is distributed, such as AppleAppStore, GoogleAppStore, or MicrosoftAppStore. |
dimension |
App Status |
App Status |
The status of an app ad extension, indicating whether it is active or deleted. |
dimension |
AppInstalls |
AppInstalls |
The number of times customers install apps through your ads. |
metric |
Asset Group |
Asset Group |
The entity representing a collection of assets for Performance Max campaigns. |
dimension |
Asset Group Search Theme |
Asset Group Search Theme |
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. |
dimension |
Asset Group Strength |
Asset Group Strength |
The strength score of an asset group, indicating its effectiveness. |
dimension |
AssetGroupId |
AssetGroupId |
The system-generated unique identifier of the asset group. |
dimension |
AssetGroupName |
AssetGroupName |
The name of the asset group. |
dimension |
AssetGroupStatus |
AssetGroupStatus |
The current status of the asset group, such as Active, Deleted, Expired, or Paused. |
dimension |
AssetId |
AssetId |
The unique Microsoft Advertising identifier for an asset, which can be shared across multiple ads. |
metric |
AssetType |
AssetType |
The type of the asset, for example, TextAsset or ImageAsset. |
dimension |
Assists |
Assists |
The number of assists attributed to an ad, where an ad contributed to a conversion but wasn’t the last click. |
metric |
Attribution Model Type |
Attribution Model Type |
The model used to attribute conversions to ad interactions, such as LastClick or DataDriven. |
dimension |
Audience |
Audience |
The audience entity that defines a group of users to target. |
dimension |
Audience Group Id |
Audience Group Id |
The system-generated identifier for an audience group, used to uniquely identify the audience segment in the account. |
dimension |
Audience Group Name |
Audience Group Name |
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. |
dimension |
Audience Id |
Audience Id |
The unique Microsoft Advertising identifier for the audience. |
dimension |
AudienceId |
AudienceId |
The unique identifier for an audience. |
metric |
AudienceImpressionLostToBudgetPercent |
AudienceImpressionLostToBudgetPercent |
The estimated percentage of impressions your ad did not receive on the Microsoft Audience Network due to an insufficient daily or monthly budget. |
metric |
AudienceName |
AudienceName |
The name of the audience targeted. |
dimension |
AudienceType |
AudienceType |
The type of audience (e.g., remarketing list, in-market audience). |
dimension |
Audiences |
Audiences |
A collection of audience entities. |
dimension |
Auto Generated Image Assets Opt Out |
Auto Generated Image Assets Opt Out |
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. |
dimension |
Auto Generated Text Assets Opt Out |
Auto Generated Text Assets Opt Out |
Specifies if text assets should be dynamically generated by Microsoft Advertising. Setting it to true opts out of dynamic text asset generation. |
dimension |
Automated Call To Action Opt Out |
Automated Call To Action Opt Out |
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. |
dimension |
AverageCPV |
AverageCPV |
The average cost per video view. |
dimension |
AverageCpc |
AverageCpc |
The average cost per click (CPC) on your ads. |
metric |
AverageCpm |
AverageCpm |
The average cost per thousand impressions (CPM). |
metric |
AveragePosition |
AveragePosition |
The average position of your ad on the search results page. |
metric |
AverageWatchTimePerImpression |
AverageWatchTimePerImpression |
The average watch time of a video per impression. |
metric |
AverageWatchTimePerVideoView |
AverageWatchTimePerVideoView |
The average watch time of a video per video view. |
dimension |
Avg CPC |
Avg CPC |
The average cost per click (CPC). |
dimension |
Avg CPM |
Avg CPM |
The average cost per thousand impressions (CPM). |
dimension |
Avg position |
Avg position |
The average position of the ad on the search results page. |
dimension |
Base Campaign Id |
Base Campaign Id |
The unique identifier of the original campaign used as the base for an experiment campaign. |
dimension |
BaseCampaignId |
BaseCampaignId |
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. |
metric |
Bid |
Bid |
The bid amount for a keyword or criterion. |
metric |
Bid Adjustment |
Bid Adjustment |
The percentage by which to adjust a bid for specific targeting criteria. |
metric |
Bid Option |
Bid Option |
A setting that defines how bids are managed for a campaign, ad group, or keyword, such as manual bidding or automated strategies. |
dimension |
Bid Strategy CommissionRate |
Bid Strategy CommissionRate |
The commission rate for the Commission bid strategy, used for hotel campaigns. |
dimension |
Bid Strategy Id |
Bid Strategy Id |
The unique system-generated identifier of a portfolio bid strategy that this campaign shares with other campaigns in the account. |
dimension |
Bid Strategy ManualCpc |
Bid Strategy ManualCpc |
A bid strategy where you manually set ad group and keyword bids. |
dimension |
Bid Strategy ManualCpi |
Bid Strategy ManualCpi |
A manual bidding strategy where the advertiser sets the bid amount to optimize for a specific Cost Per Install (CPI). |
dimension |
Bid Strategy MaxCpc |
Bid Strategy MaxCpc |
The maximum cost per click (CPC) bid for campaigns using a bid strategy that optimizes for clicks within a budget. |
metric |
Bid Strategy Name |
Bid Strategy Name |
The name of the bid strategy. |
dimension |
Bid Strategy PercentMaxCpc |
Bid Strategy PercentMaxCpc |
The percentage of the maximum Cost Per Click (CPC) for the PercentCpc bid strategy, used for hotel campaigns. |
dimension |
Bid Strategy TargetAdPosition |
Bid Strategy TargetAdPosition |
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. |
dimension |
Bid Strategy TargetCostPerSale |
Bid Strategy TargetCostPerSale |
The target cost per sale (CPS) that Microsoft Advertising aims to achieve by optimizing bids to maximize conversions. |
dimension |
Bid Strategy TargetCpa |
Bid Strategy TargetCpa |
The target Cost Per Acquisition (CPA) for the TargetCpa bid strategy. |
metric |
Bid Strategy TargetImpressionShare |
Bid Strategy TargetImpressionShare |
The target impression share percentage for campaigns using a bid strategy to optimize for visibility on the search results page. |
dimension |
Bid Strategy TargetRoas |
Bid Strategy TargetRoas |
The target return on ad spend (ROAS) for campaigns using a bid strategy to achieve a specific return on advertising investment. |
dimension |
Bid Strategy Type |
Bid Strategy Type |
The type of bidding strategy used for a campaign or ad group, such as ManualCpc, MaxClicks, or TargetCpa. |
dimension |
BidMatchType |
BidMatchType |
The match type of the keyword that was bid on (e.g., Exact, Phrase, Broad). |
dimension |
BidStrategyType |
BidStrategyType |
The type of bidding strategy used for a campaign or ad group (e.g., Manual CPC, Enhanced CPC, Maximize Conversions). |
dimension |
Budget |
Budget |
The daily budget amount for a campaign. |
metric |
Budget Id |
Budget Id |
The unique system identifier of the shared budget. |
metric |
Budget Name |
Budget Name |
The name of the budget. |
dimension |
Budget Type |
Budget Type |
The type of budget, determining how the allocated amount is spent throughout the day, e.g., DailyBudgetStandard. |
dimension |
BudgetAssociationStatus |
BudgetAssociationStatus |
Indicates the status of a shared budget’s association with a campaign, for example, ‘Sufficient’ or ‘Budget paused’. |
dimension |
BudgetName |
BudgetName |
The name of the budget. |
dimension |
BudgetStatus |
BudgetStatus |
The status of the budget, such as Active or Deleted. |
dimension |
Business Name |
Business Name |
The name of the business associated with an ad or account. |
dimension |
BusinessName |
BusinessName |
The name of the business associated with the ad or account. |
dimension |
CPA |
CPA |
The cost per acquisition or conversion. |
dimension |
CTR |
CTR |
The click-through rate, calculated as the number of clicks divided by the number of impressions. |
dimension |
Call To Action |
Call To Action |
A phrase in an ad that encourages users to take a specific action, such as ‘Shop Now’ or ‘Learn More’. |
dimension |
Call To Action Text |
Call To Action Text |
The specific text content of the call to action. |
dimension |
Call Tracking Enabled |
Call Tracking Enabled |
Determines whether call tracking is enabled for the call ad extension, allowing phone calls generated from ads to be tracked and reported as conversions. |
dimension |
Callout Text |
Callout Text |
Additional descriptive text that can be displayed with an ad as an extension. |
dimension |
Campaign |
Campaign |
The name of the campaign. |
dimension |
Campaign Goal |
Campaign Goal |
The specific goal or objective for the campaign, e.g., increasing website traffic or conversions. |
dimension |
Campaign Id |
Campaign Id |
The unique Microsoft Advertising identifier for the campaign. |
dimension |
Campaign Objective Type |
Campaign Objective Type |
The type of the campaign, which defines its primary objective. Possible values include Audience, DynamicSearchAds, Hotel, Shopping, Search, and PerformanceMax. |
dimension |
Campaign Type |
Campaign Type |
The type of campaign, such as Search, Audience, Shopping, Hotel Ads, or Performance Max. |
dimension |
CampaignId |
CampaignId |
The unique Microsoft Advertising identifier of the campaign. |
dimension |
CampaignLabels |
CampaignLabels |
User-defined labels applied to a campaign, used for organizing and filtering campaign data in reports. |
dimension |
CampaignName |
CampaignName |
The name of the campaign. |
dimension |
CampaignStatus |
CampaignStatus |
The status of the campaign (e.g., Active, Paused, Deleted). |
dimension |
CampaignType |
CampaignType |
The type of campaign (e.g., Search, Audience, Shopping). |
dimension |
City |
City |
The city where the impression, click, or conversion occurred. |
dimension |
ClickSharePercent |
ClickSharePercent |
The percentage of estimated available clicks that an ad received. |
metric |
ClickType |
ClickType |
The specific part of an ad that a user clicked (e.g., ad title, sitelink, phone number). |
dimension |
Clicks |
Clicks |
The number of times an ad was clicked. |
metric |
Client Id |
Client Id |
A custom identifier provided by the client, used to associate records in bulk operations. |
dimension |
Color |
Color |
The color code associated with a label, used for visual organization. |
dimension |
Commission Rate |
Commission Rate |
The commission rate charged for Commission bid strategies. |
dimension |
CompletedVideoViews |
CompletedVideoViews |
The number of times a video ad was played to 100% completion. |
metric |
Conversion Name |
Conversion Name |
The name of the conversion goal. |
dimension |
Conversion Time |
Conversion Time |
The date and time when a conversion occurred. |
dimension |
Conversion Value |
Conversion Value |
The value attributed to a conversion. |
dimension |
ConversionRate |
ConversionRate |
The percentage of clicks that resulted in a conversion. |
metric |
Conversions |
Conversions |
The number of conversions attributed to an ad, based on your conversion tracking settings. |
metric |
ConversionsQualified |
ConversionsQualified |
The total number of conversions recorded. A conversion represents a completed action by a customer after interacting with your ad. |
metric |
Cost |
Cost |
The total cost incurred for ad interactions. |
metric |
CostPerAssist |
CostPerAssist |
Spend divided by the number of times an entity contributed to a conversion that is associated with a different entity. |
dimension |
CostPerConversion |
CostPerConversion |
The cost incurred for each conversion. |
metric |
CostUSD |
CostUSD |
The total amount of money spent on an advertising entity, such as a campaign or ad group, reported in USD. This is often referred to as ‘Spend’ in reports. |
metric |
Country |
Country |
The country where the impression, click, or conversion occurred. |
dimension |
Country Code |
Country Code |
The country or region code for a geographical target. |
dimension |
CountryOfSale |
CountryOfSale |
The country code specifying the market where products are offered for sale from a Microsoft Merchant Center store, used for filtering product catalogs. |
dimension |
County |
County |
The county associated with the user’s physical location at the time of the ad interaction. |
dimension |
Cpc Bid |
Cpc Bid |
The Cost Per Click (CPC) bid amount. |
metric |
Cpm Bid |
Cpm Bid |
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). |
metric |
Cpv Bid |
Cpv Bid |
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. |
dimension |
Ctr |
Ctr |
The click-through rate, calculated as (Clicks / Impressions) * 100. |
metric |
Currency Code |
Currency Code |
The currency type used for the account. |
dimension |
CurrencyCode |
CurrencyCode |
The currency in which the account operates (e.g., USD, EUR). |
dimension |
CurrentMaxCpc |
CurrentMaxCpc |
The current maximum cost per click that is charged to the advertiser’s account when a search user clicks an ad. |
metric |
Custom Parameter |
Custom Parameter |
A key-value pair used for URL tracking or dynamic content in ads. |
dimension |
CustomLabel0 |
CustomLabel0 |
A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns. |
dimension |
CustomLabel1 |
CustomLabel1 |
The value of the Custom_label_1 field from your Microsoft Merchant Center catalog, used for product grouping and filtering. |
dimension |
CustomLabel2 |
CustomLabel2 |
A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns. |
dimension |
CustomLabel3 |
CustomLabel3 |
A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns. |
dimension |
CustomLabel4 |
CustomLabel4 |
A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns. |
dimension |
CustomParameters |
CustomParameters |
Custom key-value pairs that can be used in tracking templates. |
dimension |
CustomerId |
CustomerId |
The unique Microsoft Advertising identifier of the customer (manager account). |
metric |
CustomerName |
CustomerName |
The name of the customer (manager account). |
dimension |
DailyBudget |
DailyBudget |
The amount allocated to be spent daily on a campaign or shared budget. |
metric |
DailySpend |
DailySpend |
The average amount of campaign budget spent per day. |
metric |
Date |
Date |
The calendar date, specified by month, day, and year, used for reporting purposes to filter or aggregate performance data. |
dimension |
DeliveredMatchType |
DeliveredMatchType |
The actual match type of the keyword that triggered the ad (e.g., Exact, Phrase, Broad). |
dimension |
Description |
Description |
The descriptive text of an ad or entity. |
dimension |
Descriptions |
Descriptions |
Multiple descriptive texts for an ad or entity. |
dimension |
Destination Url |
Destination Url |
The URL to which the ad directs the user after a click. |
dimension |
DestinationUrl |
DestinationUrl |
The URL that users are directed to after clicking an ad. |
dimension |
Device Preference |
Device Preference |
Determines the device preference for showing the ad. |
dimension |
Device Type |
Device Type |
The type of device an impression or click originated from (e.g., desktop, mobile, tablet). |
dimension |
DeviceOS |
DeviceOS |
The operating system of the device reported in the DeviceType column. Possible values include Android, Blackberry, iOS, Other, Unknown, and Windows. |
dimension |
DeviceType |
DeviceType |
The type of device used by the customer when the impression occurred (e.g., Computers, Smartphones, Tablets). |
dimension |
Display Url |
Display Url |
The URL that is displayed in the ad to the user. |
dimension |
DisplayUrl |
DisplayUrl |
The URL displayed in the ad. |
dimension |
Domain Name |
Domain Name |
The domain name associated with an ad, campaign, or website. |
dimension |
Dynamic Ad Target Condition 1 |
Dynamic Ad Target Condition 1 |
The first condition that determines whether a webpage property (e.g., URL, content, title) matches the dynamic ad target. |
dimension |
Dynamic Ad Target Condition 2 |
Dynamic Ad Target Condition 2 |
The second condition that determines whether a webpage property (e.g., URL, content, title) matches the dynamic ad target. |
dimension |
Dynamic Ad Target Condition 3 |
Dynamic Ad Target Condition 3 |
The third condition that determines whether a webpage property (e.g., URL, content, title) matches the dynamic ad target. |
dimension |
Dynamic Ad Target Condition Operator 1 |
Dynamic Ad Target Condition Operator 1 |
The operator used with the first dynamic ad target condition (e.g., ‘contains’, ‘equals’). |
dimension |
Dynamic Ad Target Condition Operator 2 |
Dynamic Ad Target Condition Operator 2 |
The operator used with the second dynamic ad target condition (e.g., ‘contains’, ‘equals’). |
dimension |
Dynamic Ad Target Condition Operator 3 |
Dynamic Ad Target Condition Operator 3 |
The operator used with the third dynamic ad target condition (e.g., ‘contains’, ‘equals’). |
dimension |
Dynamic Ad Target Value 1 |
Dynamic Ad Target Value 1 |
The value used with the first dynamic ad target condition to target webpages (e.g., a specific URL, category, page title, or page content). |
dimension |
Dynamic Ad Target Value 2 |
Dynamic Ad Target Value 2 |
The value used with the second dynamic ad target condition to target webpages. |
dimension |
Dynamic Ad Target Value 3 |
Dynamic Ad Target Value 3 |
The value used with the third dynamic ad target condition to target webpages. |
dimension |
Dynamic Description Enabled |
Dynamic Description Enabled |
Indicates whether dynamic descriptions are enabled for an ad. This allows the system to automatically generate descriptive text. |
dimension |
Editorial Reason Code |
Editorial Reason Code |
A code that defines the reason why an ad, keyword, or ad extension failed editorial review. |
metric |
Editorial Status |
Editorial Status |
The editorial review status of the ad, indicating whether it’s pending review, approved, or disapproved. |
dimension |
End Date |
End Date |
The date when the campaign or other scheduled entity will stop running. |
dimension |
EndDate |
EndDate |
The scheduled end date for an entity or the end date for reported data. |
dimension |
Entity Type |
Entity Type |
The type of advertising entity, such as Campaign, AdGroup, Ad, or Keyword, used to filter label associations or other entity-specific data. |
dimension |
Error |
Error |
An error message or code from an API operation. |
dimension |
Error Detail |
Error Detail |
Additional details describing an error. |
dimension |
Error Number |
Error Number |
A numeric code associated with an error. |
metric |
ExactMatchImpressionSharePercent |
ExactMatchImpressionSharePercent |
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. |
metric |
Exclude From Bidding |
Exclude From Bidding |
Indicates if the conversion goal is excluded from bidding optimization calculations. |
dimension |
ExpectedCtr |
ExpectedCtr |
A component of Quality Score, measuring the expected click-through rate of an ad. |
metric |
Experiment Campaign Id |
Experiment Campaign Id |
The unique identifier of the campaign created as a copy of the base campaign for an experiment. |
dimension |
Experiment Id |
Experiment Id |
The unique identifier for an advertising experiment. |
dimension |
Experiment Type |
Experiment Type |
The type of experiment being run within a campaign to test different ad variations or settings. |
dimension |
ExtendedCost |
ExtendedCost |
The total cost incurred for advertising, representing the spend for a specific period or entity. |
metric |
Feed Id |
Feed Id |
The unique identifier for a feed, such as a product feed or page feed. |
dimension |
Final Mobile Url 1 |
Final Mobile Url 1 |
The first mobile landing page URL where users are directed after clicking an ad. |
dimension |
Final Mobile Url 2 |
Final Mobile Url 2 |
The second mobile landing page URL where users are directed after clicking an ad. |
dimension |
Final Mobile Url 3 |
Final Mobile Url 3 |
The third mobile landing page URL where users are directed after clicking an ad. |
dimension |
Final Mobile Url 4 |
Final Mobile Url 4 |
The fourth mobile landing page URL where users are directed after clicking an ad. |
dimension |
Final Mobile Url 5 |
Final Mobile Url 5 |
The fifth mobile landing page URL where users are directed after clicking an ad. |
dimension |
Final Mobile Url 6 |
Final Mobile Url 6 |
The sixth mobile landing page URL where users are directed after clicking an ad. |
dimension |
Final Mobile Url 7 |
Final Mobile Url 7 |
The seventh mobile landing page URL where users are directed after clicking an ad. |
dimension |
Final Mobile Url 8 |
Final Mobile Url 8 |
The eighth mobile landing page URL where users are directed after clicking an ad. |
dimension |
Final Url |
Final Url |
The last or final URL where a user is ultimately taken after clicking an ad. |
dimension |
Final Url 1 |
Final Url 1 |
The first final URL where users are ultimately taken after clicking an ad. |
dimension |
Final Url 2 |
Final Url 2 |
The second final URL where users are ultimately taken after clicking an ad. |
dimension |
Final Url 3 |
Final Url 3 |
The third final URL where users are ultimately taken after clicking an ad. |
dimension |
Final Url 4 |
Final Url 4 |
The fourth final URL where users are ultimately taken after clicking an ad. |
dimension |
Final Url 5 |
Final Url 5 |
The fifth final URL where users are ultimately taken after clicking an ad. |
dimension |
Final Url 6 |
Final Url 6 |
The sixth final URL where users are ultimately taken after clicking an ad. |
dimension |
Final Url 7 |
Final Url 7 |
The seventh final URL where users are ultimately taken after clicking an ad. |
dimension |
Final Url 8 |
Final Url 8 |
The eighth final URL where users are ultimately taken after clicking an ad. |
dimension |
Final Url Suffix |
Final Url Suffix |
Tracking parameters appended to the end of the landing page URL. |
dimension |
FinalAppUrl |
FinalAppUrl |
Your App URL is the page where people go after clicking on your ad on an app. |
dimension |
FinalMobileUrl |
FinalMobileUrl |
Your Mobile URL is the page where people go after clicking on your ad on a mobile device. |
dimension |
FinalUrl |
FinalUrl |
The landing page URL where customers are taken after clicking the ad. |
dimension |
FinalUrlSuffix |
FinalUrlSuffix |
Additional tracking parameters appended to the final URL. |
dimension |
FirstPageBid |
FirstPageBid |
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. |
metric |
Frequency Cap Settings |
Frequency Cap Settings |
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. |
dimension |
FridayHours |
FridayHours |
The scheduled hours during which ads are eligible to be shown on Fridays. |
dimension |
From Hour |
From Hour |
The starting hour for an ad schedule time range. |
dimension |
From Minute |
From Minute |
The starting minute for an ad schedule time range. |
dimension |
Gender |
Gender |
Audience targeting criterion specifying gender (Male, Female) for ad delivery. |
dimension |
Gender Types |
Gender Types |
The gender types targeted by the ad. |
dimension |
Goal |
Goal |
The name of the campaign analytics goal for tracking potential land, browse, prospect, and conversion steps. |
dimension |
Goal Id |
Goal Id |
The unique identifier of a conversion goal. |
dimension |
GoalId |
GoalId |
The unique identifier of a conversion goal. |
dimension |
GoalType |
GoalType |
The type or category of a conversion goal (e.g., purchase, lead, sign-up). |
dimension |
Header 1 |
Header 1 |
The first header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters. |
dimension |
Header 2 |
Header 2 |
The second header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters. |
dimension |
Header 3 |
Header 3 |
The third header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters. |
dimension |
Header 4 |
Header 4 |
The fourth header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters. |
dimension |
Header 5 |
Header 5 |
The fifth header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters. |
dimension |
Header 6 |
Header 6 |
The sixth header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters. |
dimension |
Header 7 |
Header 7 |
The seventh header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters. |
dimension |
Header 8 |
Header 8 |
The eighth header line of a price ad extension, preceding the pricing data, with a maximum length of 25 characters. |
dimension |
Headline |
Headline |
The main headline text of the ad. |
dimension |
Headlines |
Headlines |
The primary text components of an ad, especially prominent in responsive search ads, designed to capture user attention. |
dimension |
HistoricalAdRelevance |
HistoricalAdRelevance |
The historical measure of how relevant an ad is to the keyword and user’s search query. |
metric |
HistoricalExpectedCtr |
HistoricalExpectedCtr |
A historical prediction of the click-through rate for an ad or keyword, used for campaign optimization. |
metric |
HistoricalLandingPageExperience |
HistoricalLandingPageExperience |
The historical measure of how relevant and useful an ad’s landing page is to people who click your ad. |
metric |
HistoricalQualityScore |
HistoricalQualityScore |
The historical overall quality score of a keyword, determining ad rank and cost per click. |
metric |
Hotel Ad Group Type |
Hotel Ad Group Type |
The specific type of ad group used for Hotel Ads, primarily for organizing hotel listings. |
dimension |
Id |
Id |
The unique Microsoft Advertising identifier for the entity. |
dimension |
Impression Tracking Urls |
Impression Tracking Urls |
URLs used by third-party ad servers to track impressions for creatives, allowing for performance measurement across external tools. |
dimension |
ImpressionLostToBudgetPercent |
ImpressionLostToBudgetPercent |
The estimated percentage of impressions lost due to an insufficient budget. |
metric |
ImpressionLostToRankAggPercent |
ImpressionLostToRankAggPercent |
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. |
metric |
ImpressionSharePercent |
ImpressionSharePercent |
How often your ad is shown, as a percentage of the total available impressions in the market you were targeting. |
metric |
Impressions |
Impressions |
The number of times an ad was displayed. |
metric |
Include View Through Conversions |
Include View Through Conversions |
Indicates whether view-through conversions are included in conversion reporting. |
dimension |
Industry |
Industry |
dimension |
|
Inherited Bid Strategy Type |
Inherited Bid Strategy Type |
The bid strategy type inherited from a higher-level entity, such as the campaign. |
dimension |
Is Deal Campaign |
Is Deal Campaign |
Indicates whether a campaign is classified as a deal campaign, typically represented by a boolean value (true/false). |
dimension |
Job Function |
Job Function |
A targeting criterion that allows ads to be displayed to users based on their professional job function, as inferred from data like LinkedIn profiles. |
dimension |
Keyword |
Keyword |
The keyword text that triggered the ad. |
dimension |
Keyword Relevance |
Keyword Relevance |
A measure of how well a keyword competes against other keywords targeting the same traffic. |
dimension |
KeywordId |
KeywordId |
The unique system-generated identifier of the keyword. |
dimension |
KeywordLabels |
KeywordLabels |
These are the labels you applied to keywords. |
dimension |
KeywordStatus |
KeywordStatus |
The status of the keyword (e.g., Active, Paused, Deleted). |
dimension |
Label |
Label |
A custom tag used to organize campaigns, ad groups, ads, or keywords for filtering and reporting. |
dimension |
Landing Page Relevance |
Landing Page Relevance |
A measure of how relevant the landing page is to the ad and search query. |
dimension |
Landing Page User Experience |
Landing Page User Experience |
A measure of the quality of the user experience on the landing page. |
dimension |
LandingPageExperience |
LandingPageExperience |
A component of Quality Score, measuring the relevance and usefulness of an ad’s landing page. |
metric |
Language |
Language |
The language targeted by the campaign or ad group. |
dimension |
LastModifiedTime |
LastModifiedTime |
The date and time when an entity was last modified or when a data record was generated. |
dimension |
LastModifiedTime_Date |
LastModifiedTime_Date |
The date component of when an entity was last modified or when a data record was generated. |
dimension |
Latitude |
Latitude |
The latitude coordinate of a geographical location, used for location targeting in ads. Values range from -85 to +85 degrees. |
dimension |
LocationId |
LocationId |
The unique identifier for a geographical location. |
metric |
LocationType |
LocationType |
The type of geographical location, such as country, state, city, or county. |
dimension |
Long Headline |
Long Headline |
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. |
dimension |
Long Headlines |
Long Headlines |
A list of longer headline text variants used for responsive ads. |
dimension |
LongHeadline |
LongHeadline |
A longer headline text variant for responsive search ads. |
dimension |
Longitude |
Longitude |
The longitude coordinate of a geographical location, used for location targeting in ads. Values range from -180 to +180 degrees. |
dimension |
LowQualityClicks |
LowQualityClicks |
The number of low-quality clicks on ads. |
metric |
LowQualityClicksPercent |
LowQualityClicksPercent |
The percentage of low-quality clicks. |
metric |
LowQualityConversionRate |
LowQualityConversionRate |
The rate of conversions determined to be of low quality. |
dimension |
LowQualityConversions |
LowQualityConversions |
The number of low-quality conversions recorded. |
metric |
LowQualityGeneralClicks |
LowQualityGeneralClicks |
A metric indicating clicks on ads that are identified as general low-quality or invalid, often excluded from billing. |
metric |
LowQualityImpressions |
LowQualityImpressions |
The number of low-quality ad impressions. |
metric |
LowQualityImpressionsPercent |
LowQualityImpressionsPercent |
The percentage of low-quality impressions. |
metric |
LowQualitySophisticatedClicks |
LowQualitySophisticatedClicks |
A metric indicating clicks on ads that are identified as sophisticated low-quality or invalid, often excluded from billing. |
metric |
Match Type |
Match Type |
The keyword match type, such as Broad, Exact, or Phrase. |
dimension |
Maximum Bid |
Maximum Bid |
The highest bid amount an advertiser is willing to pay, often specified as a maximum cost per click (CPC) within certain bid strategies. |
dimension |
Mcpa Bid |
Mcpa Bid |
A bid amount or strategy related to maximizing conversions at a target cost per acquisition. |
dimension |
MerchantProductId |
MerchantProductId |
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. |
dimension |
MetroArea |
MetroArea |
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. |
dimension |
Microsoft Click Id |
Microsoft Click Id |
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. |
dimension |
Mobile Final Url |
Mobile Final Url |
The mobile landing page URL where a user is ultimately taken after clicking an ad. |
dimension |
Modified Time |
Modified Time |
The date and time when the entity was last modified. |
dimension |
MondayHours |
MondayHours |
The scheduled hours during which ads are eligible to be shown on Mondays. |
dimension |
MonthToDateSpend |
MonthToDateSpend |
The cumulative amount of money spent on a campaign or account from the beginning of the current month up to the reporting date. |
metric |
MonthlyBudget |
MonthlyBudget |
The anticipated maximum monthly budget amount, calculated based on the daily budget and days remaining in the month. |
metric |
MostSpecificLocation |
MostSpecificLocation |
The most granular geographical location targeted by an ad or campaign. |
dimension |
Name |
Name |
The name of the entity. |
dimension |
Network |
Network |
The advertising network where the ad was shown (e.g., owned and operated, syndicated search). |
dimension |
Network Distribution |
Network Distribution |
The network where the ads are shown, such as the Microsoft Advertising Network or partner traffic. |
dimension |
Page Feed Ids |
Page Feed Ids |
The identifiers for page feeds used in dynamic ads or Performance Max campaigns. |
dimension |
Param1 |
Param1 |
The first custom parameter used for URL tracking or dynamic content. |
dimension |
Param2 |
Param2 |
The second custom parameter used for URL tracking or dynamic content. |
dimension |
Param3 |
Param3 |
The third custom parameter used for URL tracking or dynamic content. |
dimension |
Parent Account Id |
Parent Account Id |
The identifier of the parent account in an account hierarchy. |
metric |
Parent Criterion Id |
Parent Criterion Id |
The unique identifier of the parent criterion in a hierarchical targeting structure. |
dimension |
Parent Id |
Parent Id |
The identifier of the parent entity, used to establish hierarchical relationships. |
metric |
Path 1 |
Path 1 |
The first optional display path shown in the ad’s URL. |
dimension |
Path 2 |
Path 2 |
The second optional display path shown in the ad’s URL. |
dimension |
Path1 |
Path1 |
A shorter or “friendlier” version of your URL address that appears in your ads, as the first subdirectory. |
dimension |
Path2 |
Path2 |
A shorter or “friendlier” version of your URL address that appears in your ads, as the second subdirectory. |
dimension |
Percent Cpc Bid |
Percent Cpc Bid |
A bidding strategy where the bid is a percentage of the total hotel price per night, including taxes and fees. |
dimension |
Phone Number |
Phone Number |
The phone number displayed in a call ad or call extension. |
dimension |
PhoneCalls |
PhoneCalls |
A performance metric representing the number of phone calls generated from ads that include a call extension or call-only ad. |
metric |
PhoneImpressions |
PhoneImpressions |
A performance metric representing the number of times an ad with a phone number or call extension was displayed. |
metric |
Placement |
Placement |
The specific location on a webpage or app where an ad is displayed. |
dimension |
Postal Code |
Postal Code |
The postal code for a geographical target. |
dimension |
PostalCode |
PostalCode |
The postal code for a geographical target. |
dimension |
Price 1 |
Price 1 |
The first price point advertised in a price ad extension. Price ad extensions can include up to 8 price columns. |
dimension |
Price 2 |
Price 2 |
The second price point advertised in a price ad extension. Price ad extensions can include up to 8 price columns. |
dimension |
Price 3 |
Price 3 |
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. |
dimension |
Price 4 |
Price 4 |
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. |
dimension |
Price 5 |
Price 5 |
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. |
dimension |
Price 6 |
Price 6 |
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. |
dimension |
Price 7 |
Price 7 |
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. |
dimension |
Price 8 |
Price 8 |
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. |
dimension |
Price Description 1 |
Price Description 1 |
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters. |
dimension |
Price Description 2 |
Price Description 2 |
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters. |
dimension |
Price Description 3 |
Price Description 3 |
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters. |
dimension |
Price Description 4 |
Price Description 4 |
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters. |
dimension |
Price Description 5 |
Price Description 5 |
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters. |
dimension |
Price Description 6 |
Price Description 6 |
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters. |
dimension |
Price Description 7 |
Price Description 7 |
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters. |
dimension |
Price Description 8 |
Price Description 8 |
A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters. |
dimension |
Price Extension Type |
Price Extension Type |
The type of price ad extension, determining how prices are displayed (e.g., “From”, “Up To”, “Average”). |
dimension |
Price Qualifier 1 |
Price Qualifier 1 |
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. |
dimension |
Price Qualifier 2 |
Price Qualifier 2 |
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. |
dimension |
Price Qualifier 3 |
Price Qualifier 3 |
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. |
dimension |
Price Qualifier 4 |
Price Qualifier 4 |
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. |
dimension |
Price Qualifier 5 |
Price Qualifier 5 |
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. |
dimension |
Price Qualifier 6 |
Price Qualifier 6 |
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. |
dimension |
Price Qualifier 7 |
Price Qualifier 7 |
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. |
dimension |
Price Qualifier 8 |
Price Qualifier 8 |
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. |
dimension |
Price Unit 1 |
Price Unit 1 |
The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension. |
dimension |
Price Unit 2 |
Price Unit 2 |
The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension. |
dimension |
Price Unit 3 |
Price Unit 3 |
The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension. |
dimension |
Price Unit 4 |
Price Unit 4 |
The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension. |
dimension |
Price Unit 5 |
Price Unit 5 |
The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension. |
dimension |
Price Unit 6 |
Price Unit 6 |
The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension. |
dimension |
Price Unit 7 |
Price Unit 7 |
The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension. |
dimension |
Price Unit 8 |
Price Unit 8 |
The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension. |
dimension |
Priority |
Priority |
The priority of a shopping campaign, determining which campaign serves ads when multiple campaigns target the same product. |
dimension |
Product Condition 1 |
Product Condition 1 |
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”. |
dimension |
Product Condition 2 |
Product Condition 2 |
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”. |
dimension |
Product Condition 3 |
Product Condition 3 |
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”. |
dimension |
Product Condition 4 |
Product Condition 4 |
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”. |
dimension |
Product Condition 5 |
Product Condition 5 |
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”. |
dimension |
Product Condition 6 |
Product Condition 6 |
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”. |
dimension |
Product Condition 7 |
Product Condition 7 |
A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”. |
dimension |
Product Value 1 |
Product Value 1 |
The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand. |
dimension |
Product Value 2 |
Product Value 2 |
The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand. |
dimension |
Product Value 3 |
Product Value 3 |
The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand. |
dimension |
Product Value 4 |
Product Value 4 |
The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand. |
dimension |
Product Value 5 |
Product Value 5 |
The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand. |
dimension |
Product Value 6 |
Product Value 6 |
The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand. |
dimension |
Product Value 7 |
Product Value 7 |
The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand. |
dimension |
ProductCategory1 |
ProductCategory1 |
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns. |
dimension |
ProductCategory2 |
ProductCategory2 |
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns. |
dimension |
ProductCategory3 |
ProductCategory3 |
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns. |
dimension |
ProductCategory4 |
ProductCategory4 |
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns. |
dimension |
ProductCategory5 |
ProductCategory5 |
A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns. |
dimension |
ProductType1 |
ProductType1 |
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. |
dimension |
ProductType2 |
ProductType2 |
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. |
dimension |
ProductType3 |
ProductType3 |
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. |
dimension |
ProductType4 |
ProductType4 |
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. |
dimension |
ProductType5 |
ProductType5 |
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. |
dimension |
ProximityTargetLocation |
ProximityTargetLocation |
A geographical location used as the center point for radius targeting. |
dimension |
PublisherUrl |
PublisherUrl |
The URL of the publisher associated with impression tracking, particularly for creatives served by third-party ad servers. |
dimension |
Purchases |
Purchases |
The number of purchase conversions recorded from advertising campaigns. |
metric |
Quality Score |
Quality Score |
A metric (1-10) reflecting the relevance and quality of ads, keywords, and landing pages, impacting ad placement and cost. |
dimension |
QualityImpact |
QualityImpact |
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. |
metric |
QualityScore |
QualityScore |
An estimate of the quality of your ads, keywords, and landing pages. |
metric |
RSA Auto Generated Assets Enabled |
RSA Auto Generated Assets Enabled |
Indicates if responsive search ad assets are dynamically generated by the system. |
dimension |
Radius |
Radius |
The radius around a target location for geographical targeting. |
metric |
Report End Date |
Report End Date |
The end date for the report data. |
dimension |
Report Start Date |
Report Start Date |
The start date for the report data. |
dimension |
ReturnOnAdSpend |
ReturnOnAdSpend |
The Return on Ad Spend (ROAS), calculated as (Revenue / Spend). |
metric |
Revenue |
Revenue |
The total revenue generated from conversions. |
metric |
Revenue Value |
Revenue Value |
The revenue value optionally reported by the advertiser as a result of conversions. |
dimension |
RevenuePerAssist |
RevenuePerAssist |
Revenue divided by the number of assists. |
dimension |
RevenuePerConversion |
RevenuePerConversion |
The revenue generated for each conversion. |
metric |
Sales |
Sales |
The number of sales attributed to ad activity. |
metric |
SaturdayHours |
SaturdayHours |
The scheduled operating hours for Saturday, used for ad extension scheduling. |
dimension |
Schedule |
Schedule |
Defines the calendar date and time ranges when an ad extension is eligible to be shown. |
dimension |
SearchQuery |
SearchQuery |
The search query entered by the user that triggered an ad. |
dimension |
Segment |
Segment |
A dimension used in reporting to break down performance data, allowing for more granular analysis of campaign performance. |
dimension |
Settings.AutoGeneratedAssetsEnabled_1 |
Settings.AutoGeneratedAssetsEnabled_1 |
Indicates whether assets are dynamically generated for Performance Max campaigns. |
dimension |
Settings.AutoGeneratedAssetsEnabled_2 |
Settings.AutoGeneratedAssetsEnabled_2 |
Indicates whether assets are dynamically generated for Performance Max campaigns. |
dimension |
Settings.AutoGeneratedImageOptOut_1 |
Settings.AutoGeneratedImageOptOut_1 |
Indicates if auto-generated image assets are opted out for Performance Max campaigns. |
dimension |
Settings.AutoGeneratedTextOptOut_1 |
Settings.AutoGeneratedTextOptOut_1 |
Indicates if auto-generated text assets are opted out for Performance Max campaigns. |
dimension |
Settings.CostPerSaleOptOut_1 |
Settings.CostPerSaleOptOut_1 |
Indicates if bidding is opted out of cost per sale for Performance Max campaigns. |
dimension |
Settings.Details.TargetSettingDetail_1 |
Settings.Details.TargetSettingDetail_1 |
A specific detail within the campaign’s target settings, which defines criteria such as audience type or demographic for ad delivery. |
dimension |
Settings.Details.TargetSettingDetail_2 |
Settings.Details.TargetSettingDetail_2 |
A specific detail within the campaign’s target settings, which defines criteria such as audience type or demographic for ad delivery. |
dimension |
Settings.Details.TargetSettingDetail_3 |
Settings.Details.TargetSettingDetail_3 |
A specific detail within the campaign’s target settings, which defines criteria such as audience type or demographic for ad delivery. |
dimension |
Settings.DisclaimerAdsEnabled_1 |
Settings.DisclaimerAdsEnabled_1 |
Indicates whether disclaimer ads are enabled for a specific campaign setting, making it a disclaimer campaign. |
dimension |
Settings.FinalUrlExpansionOptOut_1 |
Settings.FinalUrlExpansionOptOut_1 |
For Performance Max campaigns, indicates if final URL expansion is opted out, meaning only specified final URLs will be targeted. |
dimension |
Settings.PageFeedIds_1 |
Settings.PageFeedIds_1 |
The identifiers for page feeds used in Performance Max campaigns. |
dimension |
Settings.Type_1 |
Settings.Type_1 |
A specific setting related to the campaign type, such as Audience, Search, or Shopping. |
dimension |
Settings.Type_2 |
Settings.Type_2 |
A specific setting related to the campaign type, such as Audience, Search, or Shopping. |
dimension |
Settings.Type_3 |
Settings.Type_3 |
A specific setting related to the campaign type, such as Audience, Search, or Shopping. |
dimension |
Sitelink Extension Description1 |
Sitelink Extension Description1 |
An additional line of descriptive text for a Sitelink Ad Extension, providing more detail about the linked page. Maximum length is 35 characters. |
dimension |
Sitelink Extension Description2 |
Sitelink Extension Description2 |
An additional line of descriptive text for a Sitelink Ad Extension, providing more detail about the linked page. Maximum length is 35 characters. |
dimension |
Sitelink Extension Destination Url |
Sitelink Extension Destination Url |
The URL where users are directed when they click on a Sitelink Ad Extension. |
dimension |
Sitelink Extension Link Text |
Sitelink Extension Link Text |
The clickable text displayed for a Sitelink Ad Extension. |
dimension |
Sitelink Extension Order |
Sitelink Extension Order |
Determines the display order of sitelink ad extensions when shown with an ad. |
dimension |
Source |
Source |
The source of content for dynamic search ads or the origin of campaign data. |
dimension |
Spend |
Spend |
The total cost of clicks on an ad. |
metric |
Start Date |
Start Date |
The date when an entity, such as an ad extension or campaign, is scheduled to begin serving. |
dimension |
StartDate |
StartDate |
The scheduled start date for an entity or the start date for reported data. |
dimension |
State |
State |
The state or province where the impression, click, or conversion occurred. |
dimension |
State Or Province Code |
State Or Province Code |
The geographical code for a state or province, used for location targeting in campaigns. |
dimension |
Status |
Status |
The current status of the entity (e.g., Active, Paused, Deleted). |
dimension |
Store Id |
Store Id |
The name of the store you created in Microsoft Merchant Center that contains your offers for this campaign. |
dimension |
StoreCode |
StoreCode |
The unique identifier for the Microsoft Merchant Center store, which contains a product catalog feed used for the campaign. |
dimension |
Structured Snippet Header |
Structured Snippet Header |
The header for a Structured Snippet Ad Extension, which categorizes the associated snippet values (e.g., “Brands”, “Services”). |
dimension |
Structured Snippet Values |
Structured Snippet Values |
A list of values associated with a Structured Snippet Header, providing specific examples or details (e.g., “Windows, Xbox, Skype” for a “Brands” header). |
dimension |
Sub Type |
Sub Type |
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). |
dimension |
SundayHours |
SundayHours |
The scheduled operating hours for Sunday, used for ad extension scheduling. |
dimension |
Target Ad Group Id |
Target Ad Group Id |
The unique identifier of the ad group that is the target of an action or report. |
dimension |
Target Campaign Id |
Target Campaign Id |
The unique identifier of the campaign that is the target of an action or report. |
dimension |
Target Setting |
Target Setting |
Defines the targeting options for criteria groups (e.g., Age, Gender), specifying whether to “target and bid” or “bid only” for those audiences. |
dimension |
Text |
Text |
The main body text or description of an ad. |
dimension |
ThursdayHours |
ThursdayHours |
The scheduled operating hours for Thursday, used for ad extension scheduling. |
dimension |
Time Zone |
Time Zone |
The time zone used for campaign operations, ad scheduling, and report aggregation. |
dimension |
TimePeriod |
TimePeriod |
The aggregation period for report data, such as daily, weekly, or monthly. |
dimension |
TimeStamp |
TimeStamp |
The date and time of a data record, often indicating when the data was captured or generated. |
dimension |
TimeZone |
TimeZone |
The time zone used for campaign operations, ad scheduling, and report aggregation. |
dimension |
Title |
Title |
The title of an ad or asset. |
dimension |
Title Part 1 |
Title Part 1 |
Components of the ad title, allowing for multiple headlines to be displayed in Expanded Text Ads. |
dimension |
Title Part 2 |
Title Part 2 |
Components of the ad title, allowing for multiple headlines to be displayed in Expanded Text Ads. |
dimension |
Title Part 3 |
Title Part 3 |
Components of the ad title, allowing for multiple headlines to be displayed in Expanded Text Ads. |
dimension |
TitlePart1 |
TitlePart1 |
In Expanded Text ads, Ad title 1 is the first line of the most prominent part of your ad that links to your website. |
dimension |
TitlePart2 |
TitlePart2 |
This is the second line of the most prominent part of your ad that links to your website. |
dimension |
TitlePart3 |
TitlePart3 |
This is the third line of the most prominent part of your ad that links to your website. |
dimension |
To Hour |
To Hour |
The ending hour of a scheduled time range for ad delivery, on a 24-hour clock (0-24). |
dimension |
To Minute |
To Minute |
The ending minute of a scheduled time range for ad delivery, ranging from 0 to 60. |
dimension |
TopImpressionRatePercent |
TopImpressionRatePercent |
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. |
metric |
TopImpressionShareLostToBudgetPercent |
TopImpressionShareLostToBudgetPercent |
The estimated percentage of times an ad failed to show in the top ad positions (above organic search results) due to an insufficient budget. |
metric |
TopImpressionShareLostToRankPercent |
TopImpressionShareLostToRankPercent |
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. |
metric |
TopImpressionSharePercent |
TopImpressionSharePercent |
The percentage of estimated available impressions in the top positions that an ad received. (first search) |
metric |
TopVsOther |
TopVsOther |
The position (mainline vs. bottom or sidebar) of your ad on a Bing, AOL, or Yahoo search results page. |
dimension |
TotalClicks |
TotalClicks |
The total number of clicks received by an ad or other entity. |
metric |
TotalWatchTimeInMS |
TotalWatchTimeInMS |
The total watch time of videos in milliseconds. |
metric |
Tracking Template |
Tracking Template |
A URL template that contains tracking parameters, which are appended to landing page URLs to collect data about ad clicks. |
dimension |
TrackingTemplate |
TrackingTemplate |
The URL template used for tracking clicks and other metrics. |
dimension |
TrackingUrlTemplate |
TrackingUrlTemplate |
The tracking template used as a default for all landing page URLs. |
dimension |
TuesdayHours |
TuesdayHours |
The scheduled operating hours for Tuesday, used for ad extension scheduling. |
dimension |
Type |
Type |
The classification or category of an entity, such as an ad, campaign, or ad extension. |
dimension |
UET Tag Id |
UET Tag Id |
The unique identifier for a Universal Event Tracking (UET) tag, used to track website actions and conversions. |
dimension |
Url |
Url |
A web address associated with an advertising entity, such as a landing page or an ad extension. |
dimension |
UrlCustomParameters |
UrlCustomParameters |
A collection of key-value custom parameters for URL tracking. |
dimension |
Use MaxClicks |
Use MaxClicks |
Indicates whether the Maximize Clicks bid strategy is employed for a campaign. |
dimension |
Use Searcher Time Zone |
Use Searcher Time Zone |
A setting that determines whether ad scheduling should use the searcher’s local time zone instead of the account’s time zone. |
dimension |
Version |
Version |
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. |
dimension |
Video Id |
Video Id |
The system-generated identifier for a video ad extension or video asset. |
dimension |
Video Url |
Video Url |
The URL from which a video file can be directly downloaded, used when uploading new video assets for online video ads. |
dimension |
VideoCompletionRate |
VideoCompletionRate |
The rate at which video ads are completed by viewers. |
metric |
VideoViews |
VideoViews |
The total number of times a video ad was played. |
metric |
VideoViewsAt25Percent |
VideoViewsAt25Percent |
The number of times a video ad was played to at least 25% of its total duration. |
metric |
VideoViewsAt50Percent |
VideoViewsAt50Percent |
The number of times a video ad was played to at least 50% of its total duration. |
metric |
VideoViewsAt75Percent |
VideoViewsAt75Percent |
The number of times a video ad was played to at least 75% of its total duration. |
metric |
ViewThroughConversions |
ViewThroughConversions |
The number of view-through conversions, where a user saw an ad but did not click, then converted later. |
metric |
ViewThroughConversionsQualified |
ViewThroughConversionsQualified |
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. |
metric |
ViewThroughRevenue |
ViewThroughRevenue |
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). |
metric |
WednesdayHours |
WednesdayHours |
The scheduled operating hours for Wednesday, used for ad extension scheduling. |
dimension |
Year |
Year |
The year for the reported data. |
dimension |
YearMonth |
YearMonth |
The year and month for the reported data. |
metric |
campaign_type |
campaign_type |
The classification of an advertising campaign (e.g., Search, Shopping, Audience, Performance Max). |
dimension |