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. |
dimension |
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 |
Ad Strength Action Items |
Ad Strength Action Items |
Suggestions based on the ad strength of responsive search ads to help improve performance and maximize opportunities. |
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. |
metric |
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. |
metric |
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). |
metric |
App Id |
App Id |
The unique identifier of an application. |
dimension |
App Platform |
App Platform |
The platform of the application, such as iOS or Android. |
dimension |
App Status |
App Status |
The status of the application. |
dimension |
AppInstalls |
AppInstalls |
The number of times customers install apps through your ads. |
dimension |
Asset Group |
Asset Group |
The entity representing a collection of assets for Performance Max campaigns. |
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. |
metric |
Audience Group Id |
Audience Group Id |
The unique identifier of an audience group. |
dimension |
Audience Group Name |
Audience Group Name |
The name of the audience group. |
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 |
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 Apply Recommendations |
Auto Apply Recommendations |
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 |
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. |
dimension |
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. |
dimension |
Bid Adjustment |
Bid Adjustment |
The percentage by which to adjust a bid for specific targeting criteria. |
metric |
Bid Option |
Bid Option |
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 |
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. |
dimension |
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 |
dimension |
|
Bid Strategy TargetCostPerSale |
Bid Strategy TargetCostPerSale |
dimension |
|
Bid Strategy TargetCpa |
Bid Strategy TargetCpa |
The target Cost Per Acquisition (CPA) for the TargetCpa bid strategy. |
dimension |
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. |
dimension |
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 |
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 |
CPI |
CPI |
The cost per install for app campaigns. |
dimension |
CPP |
CPP |
The cost per purchase. |
dimension |
CPS |
CPS |
The cost per sale. |
dimension |
CTR |
CTR |
The click-through rate, calculated as the number of clicks divided by the number of impressions. |
metric |
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 |
Indicates if call tracking is enabled to measure calls from ads. |
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 |
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. |
dimension |
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 |
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. |
dimension |
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). |
dimension |
Cpv Bid |
Cpv Bid |
The Cost Per View (CPV) bid amount, typically for video ads. |
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). |
dimension |
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 |
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 |
Disclaimer Ads Enabled |
Disclaimer Ads Enabled |
Indicates if disclaimer ads are enabled for the campaign or account. |
dimension |
Display Url |
Display Url |
The URL shown in the ad, which may differ from the final landing page URL. |
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. |
dimension |
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 |
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. |
dimension |
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 |
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 |
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 headline or title part of an ad. |
dimension |
Header 2 |
Header 2 |
The second headline or title part of an ad. |
dimension |
Header 3 |
Header 3 |
The third headline or title part of an ad. |
dimension |
Header 4 |
Header 4 |
The fourth headline or title part of an ad. |
dimension |
Header 5 |
Header 5 |
The fifth headline or title part of an ad. |
dimension |
Header 6 |
Header 6 |
The sixth headline or title part of an ad. |
dimension |
Header 7 |
Header 7 |
The seventh headline or title part of an ad. |
dimension |
Header 8 |
Header 8 |
The eighth headline or title part of an ad. |
dimension |
Headline |
Headline |
The main headline text of the ad. |
dimension |
Headlines |
Headlines |
The main titles or headlines of the ad. |
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 |
Hour |
Hour |
The hour component of a time, used for scheduling or report aggregation (0-23 for start, 0-24 for end). |
dimension |
Id |
Id |
The unique Microsoft Advertising identifier for the entity. |
dimension |
Impression Tracking Urls |
Impression Tracking Urls |
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 |
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 |
dimension |
|
Job Function |
Job Function |
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 |
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 used in certain ad formats, such as Responsive Search Ads. |
dimension |
Long Headlines |
Long Headlines |
An array of longer headline texts for an ad. |
dimension |
LongHeadline |
LongHeadline |
A longer headline text variant for responsive search ads. |
dimension |
Longitude |
Longitude |
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. |
metric |
LowQualityConversions |
LowQualityConversions |
The number of low-quality conversions recorded. |
metric |
LowQualityGeneralClicks |
LowQualityGeneralClicks |
The number of generally low-quality clicks on ads. |
metric |
LowQualityImpressions |
LowQualityImpressions |
The number of low-quality ad impressions. |
metric |
LowQualityImpressionsPercent |
LowQualityImpressionsPercent |
The percentage of low-quality impressions. |
metric |
LowQualitySophisticatedClicks |
LowQualitySophisticatedClicks |
The number of sophisticated but low-quality clicks on ads. |
metric |
Match Type |
Match Type |
The keyword match type, such as Broad, Exact, or Phrase. |
dimension |
Maximum Bid |
Maximum Bid |
The maximum amount allowed for a bid. |
dimension |
Mcpa Bid |
Mcpa Bid |
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 |
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 |
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. |
dimension |
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 |
The percentage of Cost Per Click (CPC) used for bidding, typically for hotel campaigns. |
dimension |
Phone Number |
Phone Number |
The phone number displayed in a call ad or call extension. |
dimension |
PhoneCalls |
PhoneCalls |
The number of phone calls generated by ads or ad extensions. |
metric |
PhoneImpressions |
PhoneImpressions |
The number of impressions for phone numbers displayed in ads or extensions. |
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 component or value associated with a product or service in an ad. |
dimension |
Price 2 |
Price 2 |
The second price component or value associated with a product or service in an ad. |
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 |
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. |
dimension |
RevenuePerInstall |
RevenuePerInstall |
The average revenue generated for each app install. |
dimension |
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 |
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 |
dimension |
|
Settings.Details.TargetSettingDetail_2 |
Settings.Details.TargetSettingDetail_2 |
dimension |
|
Settings.Details.TargetSettingDetail_3 |
Settings.Details.TargetSettingDetail_3 |
dimension |
|
Settings.DisclaimerAdsEnabled_1 |
Settings.DisclaimerAdsEnabled_1 |
A setting indicating if disclaimer ads are enabled. |
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 |
dimension |
|
Settings.Type_2 |
Settings.Type_2 |
dimension |
|
Settings.Type_3 |
Settings.Type_3 |
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 |
The order in which Sitelink Extensions are expected to be displayed within 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 |
A unique code identifying a physical store location, typically used in local campaigns. |
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 |
A version number that tracks updates made to an entity, typically an ad extension. |
dimension |
Video Id |
Video Id |
The unique identifier for a video asset. |
dimension |
Video Url |
Video Url |
The URL of a video asset. |
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. |
dimension |
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 |
account_id |
account_id |
The unique identifier for the advertising account. |
dimension |
account_name |
account_name |
The name of the advertising account. |
dimension |
ad_group_id |
ad_group_id |
The unique identifier for the ad group. |
dimension |
ad_group_name |
ad_group_name |
The name of the ad group. |
dimension |
ad_network |
ad_network |
The advertising network where ads are eligible to be displayed (e.g., Microsoft Audience Network, search partners). |
dimension |
campaign_day |
campaign_day |
The day component of a campaign’s performance data, typically used for report aggregation. |
dimension |
campaign_id |
campaign_id |
The unique identifier for the advertising campaign. |
dimension |
campaign_month |
campaign_month |
The month component of a campaign’s performance data, typically used for report aggregation. |
dimension |
campaign_name |
campaign_name |
The name of the advertising campaign. |
dimension |
campaign_type |
campaign_type |
The classification of an advertising campaign (e.g., Search, Shopping, Audience, Performance Max). |
dimension |
campaign_year |
campaign_year |
The year component of a campaign’s performance data, typically used for report aggregation. |
dimension |
clicks |
clicks |
The number of times users clicked on an ad. |
metric |
conversions |
conversions |
The number of desired actions (e.g., purchases, leads) completed by users after clicking an ad. |
metric |
date |
date |
The date for which performance data is reported. |
dimension |
day |
day |
The day component of a date for which performance data is reported. |
dimension |
device_type |
device_type |
The type of device (e.g., Computer, Smartphone, Tablet) on which an ad was displayed. |
dimension |
hour |
hour |
The hour component of a time for which performance data is reported. |
dimension |
impressions |
impressions |
The number of times an ad was displayed to users. |
metric |
network |
network |
The advertising network where ads are eligible to be displayed (e.g., Microsoft Audience Network, search partners). |
dimension |
spend |
spend |
The total cost incurred for advertising campaigns in the account’s currency. |
metric |