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 |
|---|---|---|---|
ACCOUNT_ID |
ACCOUNT_ID |
A unique system-generated identifier for the account. |
dimension |
ACCOUNT_NAME |
ACCOUNT_NAME |
The name of the account. |
dimension |
AbsoluteTopImpressionRatePercent |
AbsoluteTopImpressionRatePercent |
The percentage of impressions that appeared in the absolute top position of the search results page. (first search) |
metric |
AbsoluteTopImpressionShareLostToBudgetPercent |
AbsoluteTopImpressionShareLostToBudgetPercent |
metric |
|
AbsoluteTopImpressionShareLostToRankPercent |
AbsoluteTopImpressionShareLostToRankPercent |
metric |
|
AbsoluteTopImpressionSharePercent |
AbsoluteTopImpressionSharePercent |
metric |
|
Account |
Account |
The name of the advertising account. |
dimension |
Account Id |
Account Id |
The unique system-generated 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. |
metric |
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 ad group (e.g., Search, Dynamic Search Ad, Shopping). |
dimension |
Ad Rotation |
Ad Rotation |
The ad rotation setting, which determines how ads are shown within an ad group (e.g., Optimize for performance, Rotate ads indefinitely). |
dimension |
Ad Schedule |
Ad Schedule |
The schedule for when ads are eligible to run (e.g., specific days and times). |
dimension |
Ad Schedule Use Searcher Time Zone |
Ad Schedule Use Searcher Time Zone |
Indicates whether the ad schedule uses the searcher’s time zone or the account’s time zone. |
dimension |
Ad Strength |
Ad Strength |
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 |
AdExtensionTypeId |
AdExtensionTypeId |
The unique identifier for the type of ad extension used (e.g., sitelink, callout, structured snippet). (CampaignManagementService search) |
metric |
AdExtensionVersion |
AdExtensionVersion |
The version of the ad extension, used to differentiate between multiple versions of an ad extension for performance tracking. |
metric |
AdGroupCriterionId |
AdGroupCriterionId |
The unique identifier for a criterion applied at the ad group level. (first search, CampaignManagementService search) |
dimension |
AdGroupId |
AdGroupId |
The unique system-generated identifier of the ad group. |
metric |
AdGroupLabels |
AdGroupLabels |
dimension |
|
AdGroupName |
AdGroupName |
The name of the ad group. |
dimension |
AdGroupStatus |
AdGroupStatus |
The status of the ad group (e.g., Active, Paused, Deleted). |
dimension |
AdGroupType |
AdGroupType |
The type of ad group (e.g., Search, Dynamic Search Ad, Shopping). |
dimension |
AdGroups.Id |
AdGroups.Id |
The unique system-generated identifier of the ad group. |
metric |
AdGroups.Name |
AdGroups.Name |
The name of the ad group. |
dimension |
AdGroups.StartDate |
AdGroups.StartDate |
The start date of the ad group. |
dimension |
AdId |
AdId |
The system-generated identifier of the ad. |
metric |
AdLabels |
AdLabels |
dimension |
|
AdRelevance |
AdRelevance |
A component of Quality Score, measuring how relevant an ad is to the keyword. |
metric |
AdRotation.EndDate |
AdRotation.EndDate |
dimension |
|
AdRotation.StartDate |
AdRotation.StartDate |
dimension |
|
AdRotation.Type |
AdRotation.Type |
dimension |
|
AdScheduleUseSearcherTimeZone |
AdScheduleUseSearcherTimeZone |
Indicates whether the ad schedule uses the searcher’s time zone or the account’s time zone. |
dimension |
AdStatus |
AdStatus |
The status of the ad (e.g., Active, Paused, Deleted). |
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 |
Advertising_channel |
Advertising_channel |
The advertising channel where the campaign is running (e.g., Search, Audience). |
dimension |
Age Ranges |
Age Ranges |
dimension |
|
AgeGroup |
AgeGroup |
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 |
metric |
|
AllCostPerConversion |
AllCostPerConversion |
The cost per conversion including all conversions (cross-device and from all conversion goals). |
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 |
dimension |
|
App Platform |
App Platform |
The platform of the application (e.g., iOS, Android). |
dimension |
App Status |
App Status |
dimension |
|
AppInstalls |
AppInstalls |
The number of app install conversions recorded. |
metric |
Asset Group |
Asset Group |
A collection of assets (e.g., images, headlines, descriptions) that can be combined to create dynamic ads. |
dimension |
Asset Group Search Theme |
Asset Group Search Theme |
A theme used within an asset group to guide where ads are shown, particularly for Performance Max campaigns. |
dimension |
AssistedConversions |
AssistedConversions |
The number of conversions for which an ad played a role in the conversion path, but was not the final click. |
metric |
Assists |
Assists |
The number of assists attributed to an ad, where an ad contributed to a conversion but wasn’t the last click. |
metric |
AssociationId |
AssociationId |
The unique identifier for an association between two entities, such as an audience with a campaign or ad group. (first search) |
metric |
AssociationStatus |
AssociationStatus |
The current status of an association between two entities. (first search) |
dimension |
AttributeChanged |
AttributeChanged |
dimension |
|
Attribution Model Type |
Attribution Model Type |
dimension |
|
Audience |
Audience |
dimension |
|
Audience Id |
Audience Id |
dimension |
|
AudienceAdsBidAdjustment |
AudienceAdsBidAdjustment |
The bid adjustment percentage for audience ads. |
dimension |
AudienceId |
AudienceId |
metric |
|
AudienceName |
AudienceName |
dimension |
|
AudienceType |
AudienceType |
dimension |
|
Audiences |
Audiences |
Represents a segment of users that can be targeted with ads. This can include remarketing lists or custom audiences based on customer data. |
dimension |
Auto Apply Recommendations |
Auto Apply Recommendations |
Determines whether Microsoft Advertising should automatically apply recommendations to improve ad performance, such as adding responsive search ads or multimedia ads. |
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 |
Determines whether to opt out of the automatic selection of call to action ad assets for multimedia ads within a campaign. |
dimension |
AverageCPV |
AverageCPV |
The average cost per view (CPV) for ads. |
dimension |
AverageCpc |
AverageCpc |
The average cost per click (CPC) on your ads. |
metric |
AverageCpm |
AverageCpm |
The average cost per thousand impressions (CPM) for ads. |
metric |
AveragePosition |
AveragePosition |
The average position of your ad on the search results page. |
metric |
AverageWatchTimePerImpression |
AverageWatchTimePerImpression |
metric |
|
AverageWatchTimePerVideoView |
AverageWatchTimePerVideoView |
dimension |
|
Avg CPC |
Avg CPC |
The average cost per click (CPC) for an ad, keyword, or other entity, available in performance reports. |
dimension |
Avg CPM |
Avg CPM |
The average cost per thousand impressions (CPM), typically available in performance reports. |
dimension |
Avg position |
Avg position |
The average position of your ad on the search results page, available in performance reports. |
dimension |
Base Campaign Id |
Base Campaign Id |
The unique system identifier of the base campaign from which an experiment campaign was created. |
dimension |
BaseCampaignId |
BaseCampaignId |
metric |
|
Bid |
Bid |
The value of the bid, representing the amount you are willing to pay for a click or other billable event. |
metric |
Bid Adjustment |
Bid Adjustment |
The percentage amount by which to adjust your bid for audience ads above or below the base ad group or keyword bid. This can prevent audience ads from showing if set to -100 percent. |
metric |
Bid Option |
Bid Option |
dimension |
|
Bid Strategy CommissionRate |
Bid Strategy CommissionRate |
The commission rate used in a commission-based bid strategy. |
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. |
metric |
Bid Strategy ManualCpi |
Bid Strategy ManualCpi |
The maximum cost per install (CPI) bid for apps, used in a manual CPI bid strategy. |
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, which defines how bids are managed for a campaign. |
dimension |
Bid Strategy PercentMaxCpc |
Bid Strategy PercentMaxCpc |
The percentage of the maximum cost per click (CPC) bid used in a percentage CPC bid strategy. |
dimension |
Bid Strategy TargetAdPosition |
Bid Strategy TargetAdPosition |
The target ad position for campaigns using a bid strategy aimed at achieving a specific ad placement, such as top of page or first page. |
dimension |
Bid Strategy TargetCostPerSale |
Bid Strategy TargetCostPerSale |
The target cost per sale (CPS) for campaigns using a bid strategy optimized for a specific cost for each sale. |
dimension |
Bid Strategy TargetCpa |
Bid Strategy TargetCpa |
The target cost per acquisition (CPA) for campaigns using a bid strategy to achieve a specific average cost for conversions. |
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. |
metric |
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. |
metric |
Bid Strategy Type |
Bid Strategy Type |
The type of bid strategy used for the campaign, determining how bids are managed. Examples include Enhanced CPC, Maximize Clicks, Target CPA, and Target ROAS. |
dimension |
Bid.Amount |
Bid.Amount |
The monetary value of the bid. |
metric |
BidMatchType |
BidMatchType |
The match type of the keyword that was bid on (e.g., Exact, Phrase, Broad). |
dimension |
BidStrategyId |
BidStrategyId |
The unique system-generated identifier of a portfolio bid strategy that this campaign shares with other campaigns in the account. |
metric |
BidStrategyType |
BidStrategyType |
The type of bidding strategy used for a campaign or ad group (e.g., Manual CPC, Enhanced CPC, Maximize Conversions). |
dimension |
BiddingScheme.InheritedBidStrategyType |
BiddingScheme.InheritedBidStrategyType |
The type of bid strategy inherited from a parent entity, such as a campaign, when a child entity does not have a specific bid strategy defined. |
dimension |
BiddingScheme.MaxCpc.Amount |
BiddingScheme.MaxCpc.Amount |
The maximum cost per click (CPC) amount set within the bidding scheme. |
metric |
BiddingScheme.TargetAdPosition |
BiddingScheme.TargetAdPosition |
The target ad position specified within the bidding scheme. |
dimension |
BiddingScheme.TargetCpa |
BiddingScheme.TargetCpa |
The target cost per acquisition (CPA) specified within the bidding scheme. |
metric |
BiddingScheme.TargetImpressionShare |
BiddingScheme.TargetImpressionShare |
The target impression share percentage specified within the bidding scheme. |
metric |
BiddingScheme.TargetRoas |
BiddingScheme.TargetRoas |
The target return on ad spend (ROAS) specified within the bidding scheme. |
metric |
BiddingScheme.Type |
BiddingScheme.Type |
The type of bidding scheme applied to the campaign or ad group, such as Enhanced CPC or Maximize Clicks. |
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 shared budget. |
dimension |
Budget Type |
Budget Type |
The type of budget, such as DailyBudget or MonthlyBudget. |
dimension |
BudgetAssociationStatus |
BudgetAssociationStatus |
dimension |
|
BudgetId |
BudgetId |
The unique system identifier of the shared budget. |
metric |
BudgetName |
BudgetName |
dimension |
|
BudgetStatus |
BudgetStatus |
dimension |
|
BudgetType |
BudgetType |
The type of budget, such as DailyBudget or MonthlyBudget. |
dimension |
Business Name |
Business Name |
The name of the business associated with the ad or account. |
dimension |
BusinessAddress.BusinessName |
BusinessAddress.BusinessName |
The name of the business associated with the ad extension or location. |
dimension |
BusinessAddress.City |
BusinessAddress.City |
The city of the business address. |
dimension |
BusinessAddress.CountryCode |
BusinessAddress.CountryCode |
The country or region code of the business address. |
dimension |
BusinessAddress.Id |
BusinessAddress.Id |
The unique system identifier of the business address. |
metric |
BusinessAddress.Line1 |
BusinessAddress.Line1 |
The first line of the business street address. |
dimension |
BusinessAddress.Line2 |
BusinessAddress.Line2 |
The second line of the business street address. |
dimension |
BusinessAddress.Line3 |
BusinessAddress.Line3 |
dimension |
|
BusinessAddress.Line4 |
BusinessAddress.Line4 |
dimension |
|
BusinessAddress.PostalCode |
BusinessAddress.PostalCode |
The postal code or ZIP code of the business address. |
dimension |
BusinessAddress.StateOrProvince |
BusinessAddress.StateOrProvince |
The state or province of the business address. |
dimension |
BusinessAddress.TimeStamp |
BusinessAddress.TimeStamp |
The date and time that the business address was last modified. |
dimension |
BusinessCategoryName |
BusinessCategoryName |
dimension |
|
BusinessName |
BusinessName |
The name of the business associated with the ad or account. |
dimension |
CPA |
CPA |
The cost per acquisition (CPA), a performance metric indicating the average cost for each conversion. |
dimension |
CPI |
CPI |
The average cost incurred for each app install. |
dimension |
CPP |
CPP |
The average cost incurred for each purchase conversion. |
dimension |
CPS |
CPS |
The average cost incurred for each sale conversion. |
dimension |
CTR |
CTR |
The click-through rate (CTR), calculated as clicks divided by impressions, available in performance reports. |
dimension |
Call To Action |
Call To Action |
The call to action text used in an ad, such as ‘Shop now’ or ‘Learn more’. |
dimension |
Call To Action Text |
Call To Action Text |
The text for the call to action button or link in an ad. |
dimension |
Callout Text |
Callout Text |
Supplemental text that highlights specific features or benefits of products or services in an ad extension. |
dimension |
Campaign |
Campaign |
The name of the advertising campaign. |
dimension |
Campaign Goal |
Campaign Goal |
The primary objective of the campaign, such as increasing website visits, conversions, or brand awareness. |
dimension |
Campaign ID |
Campaign ID |
The unique system-generated identifier of the campaign. |
metric |
Campaign Id |
Campaign Id |
The unique identifier for a campaign. (first search, CampaignManagementService search) |
dimension |
Campaign Objective Type |
Campaign Objective Type |
The primary goal or objective set for the campaign (e.g., sales, leads, website traffic). |
dimension |
Campaign Type |
Campaign Type |
The type of campaign (e.g., Search, Audience, Shopping). |
dimension |
CampaignId |
CampaignId |
The unique Microsoft Advertising identifier of the campaign. |
metric |
CampaignLabels |
CampaignLabels |
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 |
ChangedBy |
ChangedBy |
dimension |
|
City |
City |
The city where the impression, click, or conversion occurred. |
dimension |
ClickCalls |
ClickCalls |
metric |
|
ClickSharePercent |
ClickSharePercent |
The percentage of estimated available clicks that an ad received. |
metric |
ClickType |
ClickType |
The type of click that occurred on an ad, distinguishing between headline clicks, sitelink clicks, etc. |
dimension |
Clicks |
Clicks |
The number of times an ad was clicked. |
metric |
Client Id |
Client Id |
A custom identifier that you can use to associate entities with your own local identifiers. |
dimension |
Color |
Color |
dimension |
|
Commission Rate |
Commission Rate |
The commission rate applied for a commission-based bid strategy. |
dimension |
CommissionRate.RateAmount.Amount |
CommissionRate.RateAmount.Amount |
The specific monetary amount of the commission rate. |
dimension |
CommissionRate.Type |
CommissionRate.Type |
The type of commission rate. |
dimension |
CompletedVideoViews |
CompletedVideoViews |
metric |
|
Conversion Name |
Conversion Name |
The name of the conversion goal, such as ‘Lead Form Submission’ or ‘Purchase’. |
dimension |
Conversion Time |
Conversion Time |
The date and time that the conversion occurred. |
dimension |
Conversion Value |
Conversion Value |
The monetary value associated with a conversion. |
metric |
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 |
metric |
|
Cost |
Cost |
The total cost incurred for the advertising activity. (first search) |
metric |
CostPerAssist |
CostPerAssist |
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 |
dimension |
|
CountryOfSale |
CountryOfSale |
dimension |
|
County |
County |
dimension |
|
Cpc Bid |
Cpc Bid |
The cost per click (CPC) bid amount for a keyword or ad group. |
metric |
CpcBid.Amount |
CpcBid.Amount |
The monetary amount of the cost per click (CPC) bid. |
metric |
Cpm Bid |
Cpm Bid |
The cost per thousand impressions (CPM) bid amount. |
metric |
CpmBid.Amount |
CpmBid.Amount |
The monetary amount of the cost per thousand impressions (CPM) bid. |
dimension |
Cpv Bid |
Cpv Bid |
The cost per view (CPV) bid amount for video ads. |
dimension |
CpvBid.Amount |
CpvBid.Amount |
The monetary amount of the cost per view (CPV) bid. |
dimension |
Ctr |
Ctr |
The click-through rate, calculated as (Clicks / Impressions) * 100. |
metric |
Currency Code |
Currency Code |
The three-character ISO 4217 currency code for the account, for example, USD or GBP. |
dimension |
CurrencyCode |
CurrencyCode |
The currency in which the account operates (e.g., USD, EUR). |
dimension |
CurrentMaxCpc |
CurrentMaxCpc |
metric |
|
Custom Parameter |
Custom Parameter |
A URL parameter that you can define and attach to your tracking template or final URL to track specific information. |
dimension |
CustomLabel0 |
CustomLabel0 |
A custom label for products in shopping campaigns, used for bidding and reporting. (first search) |
dimension |
CustomLabel1 |
CustomLabel1 |
A custom label for products in shopping campaigns, used for bidding and reporting. (first search) |
dimension |
CustomLabel2 |
CustomLabel2 |
A custom label for products in shopping campaigns, used for bidding and reporting. (first search) |
dimension |
CustomLabel3 |
CustomLabel3 |
A custom label for products in shopping campaigns, used for bidding and reporting. (first search) |
dimension |
CustomLabel4 |
CustomLabel4 |
A custom label for products in shopping campaigns, used for bidding and reporting. (first search) |
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 daily budget allocated for a campaign. |
metric |
DailySpend |
DailySpend |
The total amount spent on advertising for a specific day. |
metric |
Date |
Date |
The specific date for which the data is reported. |
dimension |
DateTime |
DateTime |
dimension |
|
DeliveredMatchType |
DeliveredMatchType |
The actual match type of the keyword that triggered the ad (e.g., Exact, Phrase, Broad). |
dimension |
Description |
Description |
A general descriptive text for an ad or other entity. |
dimension |
Descriptions |
Descriptions |
The descriptive text for an ad. |
dimension |
Destination Url |
Destination Url |
The URL of the page that the user is taken to when they click the ad. |
dimension |
DestinationUrl |
DestinationUrl |
The URL that users are directed to after clicking an ad. |
dimension |
Device |
Device |
The type of device used by the customer when the impression occurred (e.g., Computers, Smartphones, Tablets). |
dimension |
Device Preference |
Device Preference |
The device type on which the ad will be preferred, such as ‘Mobile’ or ‘Desktop’. |
dimension |
Device Type |
Device Type |
The type of device used to view the ad, such as ‘Computer’, ‘Tablet’, or ‘Smartphone’. |
dimension |
Device type |
Device type |
The type of device used by the customer when the impression occurred (e.g., Computers, Smartphones, Tablets). |
dimension |
DeviceOS |
DeviceOS |
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 shown in the ad, which may be different from the actual destination URL. |
dimension |
DisplayUrl |
DisplayUrl |
The URL displayed in the ad. |
dimension |
Domain Name |
Domain Name |
The domain name of the website being advertised. |
dimension |
Dynamic Ad Target Condition 1 |
Dynamic Ad Target Condition 1 |
The first condition used to define a dynamic ad target, which helps determine which pages on your website are targeted. |
dimension |
Dynamic Ad Target Condition 2 |
Dynamic Ad Target Condition 2 |
The second condition used to define a dynamic ad target. |
dimension |
Dynamic Ad Target Condition 3 |
Dynamic Ad Target Condition 3 |
The third condition used to define a dynamic ad target. |
dimension |
Dynamic Ad Target Condition Operator 1 |
Dynamic Ad Target Condition Operator 1 |
The operator (e.g., ‘Equals’, ‘Contains’) for the first condition of a dynamic ad target. |
dimension |
Dynamic Ad Target Condition Operator 2 |
Dynamic Ad Target Condition Operator 2 |
The operator for the second condition of a dynamic ad target. |
dimension |
Dynamic Ad Target Condition Operator 3 |
Dynamic Ad Target Condition Operator 3 |
The operator for the third condition of a dynamic ad target. |
dimension |
Dynamic Ad Target Value 1 |
Dynamic Ad Target Value 1 |
The value for the first condition of a dynamic ad target. |
dimension |
Dynamic Ad Target Value 2 |
Dynamic Ad Target Value 2 |
The value for the second condition of a dynamic ad target. |
dimension |
Dynamic Ad Target Value 3 |
Dynamic Ad Target Value 3 |
The value for the third condition of a dynamic ad target. |
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 |
The reason code provided by the editorial review for an entity’s status. |
metric |
Editorial Status |
Editorial Status |
The editorial status of an entity, indicating whether it is Approved, Disapproved, or Under Review. |
dimension |
EditorialStatus |
EditorialStatus |
The editorial status of an entity, indicating whether it is Approved, Disapproved, or Under Review. |
dimension |
End Date |
End Date |
The date when the campaign or other scheduled entity will stop running. |
dimension |
EndDate |
EndDate |
The end date of the entity’s validity or reporting period. |
dimension |
Entity Type |
Entity Type |
The type of entity, such as ‘Campaign’, ‘Ad Group’, or ‘Keyword’. |
dimension |
EntityId |
EntityId |
The unique identifier of the entity that was affected by an action or change. (BulkService search) |
metric |
EntityName |
EntityName |
dimension |
|
Error |
Error |
A general description of an error that occurred during an operation. |
dimension |
Error Detail |
Error Detail |
Additional details about an error, providing more specific information about the issue. |
dimension |
Error Number |
Error Number |
A numeric code that identifies the type of error that occurred. |
metric |
ExactMatchImpressionSharePercent |
ExactMatchImpressionSharePercent |
metric |
|
Exchange Rate |
Exchange Rate |
metric |
|
ExpectedCtr |
ExpectedCtr |
A component of Quality Score, measuring the expected click-through rate of an ad. |
metric |
Experiment Campaign Id |
Experiment Campaign Id |
dimension |
|
ExtendedCost |
ExtendedCost |
metric |
|
Final Mobile Url 1 |
Final Mobile Url 1 |
The first URL that the user is taken to after clicking the ad, specifically for mobile devices. |
dimension |
Final Mobile Url 2 |
Final Mobile Url 2 |
The second URL that the user is taken to after clicking the ad, specifically for mobile devices. |
dimension |
Final Mobile Url 3 |
Final Mobile Url 3 |
The third URL that the user is taken to after clicking the ad, specifically for mobile devices. |
dimension |
Final Mobile Url 4 |
Final Mobile Url 4 |
The fourth URL that the user is taken to after clicking the ad, specifically for mobile devices. |
dimension |
Final Mobile Url 5 |
Final Mobile Url 5 |
The fifth URL that the user is taken to after clicking the ad, specifically for mobile devices. |
dimension |
Final Mobile Url 6 |
Final Mobile Url 6 |
The sixth URL that the user is taken to after clicking the ad, specifically for mobile devices. |
dimension |
Final Mobile Url 7 |
Final Mobile Url 7 |
The seventh URL that the user is taken to after clicking the ad, specifically for mobile devices. |
dimension |
Final Mobile Url 8 |
Final Mobile Url 8 |
The eighth URL that the user is taken to after clicking the ad, specifically for mobile devices. |
dimension |
Final Url |
Final Url |
The URL of the landing page that the user is taken to after clicking the ad. |
dimension |
Final Url 1 |
Final Url 1 |
The first URL that the user is taken to after clicking the ad. |
dimension |
Final Url 2 |
Final Url 2 |
The second URL that the user is taken to after clicking the ad. |
dimension |
Final Url 3 |
Final Url 3 |
The third URL that the user is taken to after clicking the ad. |
dimension |
Final Url 4 |
Final Url 4 |
The fourth URL that the user is taken to after clicking the ad. |
dimension |
Final Url 5 |
Final Url 5 |
The fifth URL that the user is taken to after clicking the ad. |
dimension |
Final Url 6 |
Final Url 6 |
The sixth URL that the user is taken to after clicking the ad. |
dimension |
Final Url 7 |
Final Url 7 |
The seventh URL that the user is taken to after clicking the ad. |
dimension |
Final Url 8 |
Final Url 8 |
The eighth URL that the user is taken to after clicking the ad. |
dimension |
Final Url Suffix |
Final Url Suffix |
Additional parameters that are appended to the end of your final URL. |
dimension |
FinalAppUrl |
FinalAppUrl |
dimension |
|
FinalAppUrls |
FinalAppUrls |
A list of final URLs for app installations. |
dimension |
FinalMobileUrl |
FinalMobileUrl |
dimension |
|
FinalMobileUrls |
FinalMobileUrls |
A list of final URLs for mobile devices. |
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 |
FinalUrls |
FinalUrls |
A list of final URLs that the user is taken to after clicking the ad. |
dimension |
FirstPageBid |
FirstPageBid |
dimension |
|
Frequency Cap Settings |
Frequency Cap Settings |
Settings that limit the number of times an ad is shown to a unique user over a specific period. |
dimension |
FridayHours |
FridayHours |
The hours of operation for Friday for a business location. |
dimension |
From Hour |
From Hour |
The start hour of a time range, typically for ad scheduling or business hours. |
dimension |
From Minute |
From Minute |
The start minute of a time range, typically for ad scheduling or business hours. |
dimension |
Gender |
Gender |
dimension |
|
Gender Types |
Gender Types |
The gender types targeted by an ad group or campaign, such as ‘Male’, ‘Female’, or ‘Unknown’. |
dimension |
Goal |
Goal |
The name of the conversion goal. |
dimension |
Goal Id |
Goal Id |
The unique system identifier of a conversion goal. |
dimension |
GoalId |
GoalId |
The unique Microsoft Advertising identifier of a conversion goal. |
metric |
GoalIds |
GoalIds |
A list of unique system identifiers for conversion goals. |
dimension |
GoalType |
GoalType |
The type of conversion goal (e.g., website visit, purchase, lead). |
dimension |
Header 1 |
Header 1 |
The first headline or title of an ad. |
dimension |
Header 2 |
Header 2 |
The second headline or title of an ad. |
dimension |
Header 3 |
Header 3 |
The third headline or title of an ad. |
dimension |
Header 4 |
Header 4 |
The fourth headline or title of an ad. |
dimension |
Header 5 |
Header 5 |
The fifth headline or title of an ad. |
dimension |
Header 6 |
Header 6 |
The sixth headline or title of an ad. |
dimension |
Header 7 |
Header 7 |
The seventh headline or title of an ad. |
dimension |
Header 8 |
Header 8 |
The eighth headline or title of an ad. |
dimension |
Headline |
Headline |
The main headline text of the ad. |
dimension |
Headlines |
Headlines |
A list of headlines or titles for an ad. |
dimension |
HistoricalAdRelevance |
HistoricalAdRelevance |
The historical measure of how relevant an ad is to the keyword and user’s search query. |
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 type of ad group for Hotel Ads campaigns, such as ‘HotelGroup’ or ‘HotelUnit’. |
dimension |
Hour |
Hour |
The hour of the day when the impression, click, or conversion occurred. |
dimension |
HowChanged |
HowChanged |
dimension |
|
Id |
Id |
A unique system-generated identifier for an entity (e.g., ad group, ad, keyword). |
dimension |
Impression Share |
Impression Share |
The percentage of impressions your ads received compared to the total number of impressions they could have received. |
metric |
Impression Tracking Urls |
Impression Tracking Urls |
A list of URLs used to track impressions for an ad. |
dimension |
ImpressionLostToAdRelevancePercent |
ImpressionLostToAdRelevancePercent |
The estimated percentage of impressions lost due to low ad relevance. |
metric |
ImpressionLostToBidPercent |
ImpressionLostToBidPercent |
The estimated percentage of impressions lost due to a low bid. |
metric |
ImpressionLostToBudgetPercent |
ImpressionLostToBudgetPercent |
The estimated percentage of impressions lost due to an insufficient budget. |
metric |
ImpressionLostToExpectedCtrPercent |
ImpressionLostToExpectedCtrPercent |
The estimated percentage of impressions lost due to a low expected click-through rate. |
metric |
ImpressionLostToRankAggPercent |
ImpressionLostToRankAggPercent |
metric |
|
ImpressionLostToRankPercent |
ImpressionLostToRankPercent |
The estimated percentage of impressions lost due to a low ad rank. |
metric |
ImpressionSharePercent |
ImpressionSharePercent |
The percentage of impressions your ads received compared to the total number of impressions they could have received. |
metric |
Impressions |
Impressions |
The number of times an ad was displayed. |
metric |
Is Deal Campaign |
Is Deal Campaign |
Indicates whether a campaign is a deal campaign. |
dimension |
ItemChanged |
ItemChanged |
dimension |
|
Job Function |
Job Function |
The job function attribute used for audience targeting, often based on professional profiles (e.g., LinkedIn data). (CampaignManagementService search) |
dimension |
Keyword |
Keyword |
The keyword text that triggered the ad. |
dimension |
Keyword Relevance |
Keyword Relevance |
A component of Quality Score that measures how closely your keyword relates to your ad. |
dimension |
KeywordId |
KeywordId |
The unique system-generated identifier of the keyword. |
metric |
KeywordLabels |
KeywordLabels |
dimension |
|
KeywordStatus |
KeywordStatus |
The status of the keyword (e.g., Active, Paused, Deleted). |
dimension |
Label |
Label |
A descriptive tag that can be applied to campaigns, ad groups, ads, or keywords for organization and reporting. |
dimension |
Landing Page Relevance |
Landing Page Relevance |
A component of Quality Score that measures how relevant your landing page content is to your ad and keyword. |
dimension |
Landing Page User Experience |
Landing Page User Experience |
A component of Quality Score that evaluates how user-friendly and valuable your landing page is. |
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 |
Languages |
Languages |
The languages targeted by the campaign or ad group. |
dimension |
LastModifiedTime |
LastModifiedTime |
The date and time when the entity was last modified. |
dimension |
LastModifiedTime_Date |
LastModifiedTime_Date |
The date when the entity was last modified. |
dimension |
Latitude |
Latitude |
The latitude coordinate of a geographical location target. |
dimension |
LinkedAgencies.CustomerInfo.Id_1 |
LinkedAgencies.CustomerInfo.Id_1 |
The ID of the first linked agency’s customer information. This field is typically used in account hierarchy and agency management. |
metric |
LinkedAgencies.CustomerInfo.Name_1 |
LinkedAgencies.CustomerInfo.Name_1 |
The name of the first linked agency’s customer information. This field is typically used in account hierarchy and agency management. |
dimension |
Location |
Location |
The geographical location where the impression, click, or conversion occurred. |
dimension |
LocationId |
LocationId |
metric |
|
LocationTargeting |
LocationTargeting |
The specific geographical targeting settings for a campaign or ad group. |
dimension |
LocationType |
LocationType |
dimension |
|
Long Headline |
Long Headline |
A longer version of the ad’s headline, providing more space for descriptive text. |
dimension |
Long Headlines |
Long Headlines |
A list of longer headlines for a responsive ad. |
dimension |
LongHeadline |
LongHeadline |
A longer headline text variant for responsive search ads. |
dimension |
Longitude |
Longitude |
The longitude coordinate of a geographical location target. |
dimension |
LowQualityClicks |
LowQualityClicks |
metric |
|
LowQualityClicksPercent |
LowQualityClicksPercent |
metric |
|
LowQualityConversionRate |
LowQualityConversionRate |
metric |
|
LowQualityConversions |
LowQualityConversions |
metric |
|
LowQualityGeneralClicks |
LowQualityGeneralClicks |
metric |
|
LowQualityImpressions |
LowQualityImpressions |
metric |
|
LowQualityImpressionsPercent |
LowQualityImpressionsPercent |
metric |
|
LowQualitySophisticatedClicks |
LowQualitySophisticatedClicks |
metric |
|
MainlineBid |
MainlineBid |
dimension |
|
ManualCalls |
ManualCalls |
metric |
|
Marketing Channel |
Marketing Channel |
The marketing channel used for the campaign (e.g., Paid Search, Display). |
dimension |
Match Type |
Match Type |
The match type of the keyword that triggered the ad (e.g., Exact, Phrase, Broad). |
dimension |
MatchType |
MatchType |
The match type of the keyword that triggered the ad (e.g., Exact, Phrase, Broad). |
dimension |
Maximum Bid |
Maximum Bid |
The maximum bid amount set for a keyword, ad group, or other entity. |
dimension |
Mcpa Bid |
Mcpa Bid |
The maximum cost per acquisition (MCPA) bid, often used with automated bidding strategies. |
dimension |
McpaBid.Amount |
McpaBid.Amount |
The monetary amount of the maximum cost per acquisition (MCPA) bid. |
dimension |
Medium |
Medium |
dimension |
|
MerchantProductId |
MerchantProductId |
dimension |
|
MetroArea |
MetroArea |
dimension |
|
Microsoft Click Id |
Microsoft Click Id |
A unique identifier automatically generated by Microsoft Advertising for each click on an ad, used for tracking. |
dimension |
Mobile Final Url |
Mobile Final Url |
The URL of the landing page for mobile devices that the user is taken to after clicking the ad. |
dimension |
Modified Time |
Modified Time |
The date and time that the entity was last modified. |
dimension |
MondayHours |
MondayHours |
The hours of operation for Monday for a business location. |
dimension |
Month |
Month |
The month when the impression, click, or conversion occurred. |
metric |
MonthToDateSpend |
MonthToDateSpend |
The total amount spent on advertising from the beginning of the month up to the current date. |
metric |
MonthlyBudget |
MonthlyBudget |
The budget allocated for the campaign or account for the current month. |
metric |
Name |
Name |
The name of the entity (e.g., campaign name, ad group name). |
dimension |
NegativeKeyword |
NegativeKeyword |
A keyword that prevents an ad from showing for searches containing that term. (CampaignManagementService search) |
dimension |
Network |
Network |
The advertising network where the ad was shown (e.g., owned and operated, syndicated search). |
dimension |
Network Distribution |
Network Distribution |
The distribution channels where the ads can appear, such as the Microsoft Search Network, Audience Network, or partner sites. |
dimension |
NewValue |
NewValue |
dimension |
|
OldValue |
OldValue |
dimension |
|
PLACEMENT |
PLACEMENT |
dimension |
|
Page Feed Ids |
Page Feed Ids |
The unique identifiers for page feeds used in dynamic search ads or Performance Max campaigns. |
dimension |
Param1 |
Param1 |
dimension |
|
Param2 |
Param2 |
dimension |
|
Param3 |
Param3 |
dimension |
|
Parent Account Id |
Parent Account Id |
The unique system identifier of the parent account. |
metric |
Parent Criterion Id |
Parent Criterion Id |
The unique system identifier of the parent criterion. |
dimension |
Parent Id |
Parent Id |
The unique system identifier of the parent entity (e.g., campaign ID for an ad group, ad group ID for an ad). |
metric |
ParentCustomerId |
ParentCustomerId |
The unique system identifier of the customer (manager account) that owns the account. |
metric |
PartitionType |
PartitionType |
The type of partition used within product groups for shopping campaigns (e.g., subdivision, unit). |
dimension |
Path 1 |
Path 1 |
The first optional path that is appended to the display URL to make the ad more descriptive. |
dimension |
Path 2 |
Path 2 |
The second optional path that is appended to the display URL to make the ad more descriptive. |
dimension |
Path1 |
Path1 |
dimension |
|
Path2 |
Path2 |
dimension |
|
Percent Cpc Bid |
Percent Cpc Bid |
The percentage of the maximum cost per click (CPC) bid used in a percentage CPC bid strategy. |
dimension |
PercentCpcBid.RateAmount.Amount |
PercentCpcBid.RateAmount.Amount |
The specific monetary amount of the percentage CPC bid rate. |
dimension |
PercentCpcBid.Type |
PercentCpcBid.Type |
The type of percentage CPC bid. |
dimension |
Phone Number |
Phone Number |
The phone number used in a call extension or location extension. |
dimension |
PhoneCalls |
PhoneCalls |
metric |
|
PhoneImpressions |
PhoneImpressions |
metric |
|
Placement |
Placement |
The location on a webpage or app where an ad is displayed. |
dimension |
Postal Code |
Postal Code |
The postal code or ZIP code of a geographical target. |
dimension |
PostalCode |
PostalCode |
dimension |
|
Potential Impressions |
Potential Impressions |
metric |
|
Price 1 |
Price 1 |
The price of the first item in a price extension. |
dimension |
Price 2 |
Price 2 |
The price of the second item in a price extension. |
dimension |
Price 3 |
Price 3 |
The price of the third item in a price extension. |
dimension |
Price 4 |
Price 4 |
The price of the fourth item in a price extension. |
dimension |
Price 5 |
Price 5 |
The price of the fifth item in a price extension. |
dimension |
Price 6 |
Price 6 |
The price of the sixth item in a price extension. |
dimension |
Price 7 |
Price 7 |
The price of the seventh item in a price extension. |
dimension |
Price 8 |
Price 8 |
The price of the eighth item in a price extension. |
dimension |
Price Description 1 |
Price Description 1 |
The description for the first item in a price extension. |
dimension |
Price Description 2 |
Price Description 2 |
The description for the second item in a price extension. |
dimension |
Price Description 3 |
Price Description 3 |
The description for the third item in a price extension. |
dimension |
Price Description 4 |
Price Description 4 |
The description for the fourth item in a price extension. |
dimension |
Price Description 5 |
Price Description 5 |
The description for the fifth item in a price extension. |
dimension |
Price Description 6 |
Price Description 6 |
The description for the sixth item in a price extension. |
dimension |
Price Description 7 |
Price Description 7 |
The description for the seventh item in a price extension. |
dimension |
Price Description 8 |
Price Description 8 |
The description for the eighth item in a price extension. |
dimension |
Price Extension Type |
Price Extension Type |
The type of price extension, such as ‘Brands’, ‘Events’, or ‘Locations’. |
dimension |
Price Qualifier 1 |
Price Qualifier 1 |
A qualifier for the price of the first item in a price extension, such as ‘From’ or ‘Up to’. |
dimension |
Price Qualifier 2 |
Price Qualifier 2 |
A qualifier for the price of the second item in a price extension. |
dimension |
Price Qualifier 3 |
Price Qualifier 3 |
A qualifier for the price of the third item in a price extension. |
dimension |
Price Qualifier 4 |
Price Qualifier 4 |
A qualifier for the price of the fourth item in a price extension. |
dimension |
Price Qualifier 5 |
Price Qualifier 5 |
A qualifier for the price of the fifth item in a price extension. |
dimension |
Price Qualifier 6 |
Price Qualifier 6 |
A qualifier for the price of the sixth item in a price extension. |
dimension |
Price Qualifier 7 |
Price Qualifier 7 |
A qualifier for the price of the seventh item in a price extension. |
dimension |
Price Qualifier 8 |
Price Qualifier 8 |
A qualifier for the price of the eighth item in a price extension. |
dimension |
Price Unit 1 |
Price Unit 1 |
The unit of the price for the first item in a price extension, such as ‘per day’ or ‘per month’. |
dimension |
Price Unit 2 |
Price Unit 2 |
The unit of the price for the second item in a price extension. |
dimension |
Price Unit 3 |
Price Unit 3 |
The unit of the price for the third item in a price extension. |
dimension |
Price Unit 4 |
Price Unit 4 |
The unit of the price for the fourth item in a price extension. |
dimension |
Price Unit 5 |
Price Unit 5 |
The unit of the price for the fifth item in a price extension. |
dimension |
Price Unit 6 |
Price Unit 6 |
The unit of the price for the sixth item in a price extension. |
dimension |
Price Unit 7 |
Price Unit 7 |
The unit of the price for the seventh item in a price extension. |
dimension |
Price Unit 8 |
Price Unit 8 |
The unit of the price for the eighth item in a price extension. |
dimension |
Priority |
Priority |
The priority of a shopping campaign, determining which campaign serves ads when multiple campaigns target the same product. |
metric |
Product Condition 1 |
Product Condition 1 |
The first condition used to filter products in a shopping campaign or product ad group. |
dimension |
Product Condition 2 |
Product Condition 2 |
The second condition used to filter products in a shopping campaign or product ad group. |
dimension |
Product Condition 3 |
Product Condition 3 |
The third condition used to filter products in a shopping campaign or product ad group. |
dimension |
Product Condition 4 |
Product Condition 4 |
The fourth condition used to filter products in a shopping campaign or product ad group. |
dimension |
Product Condition 5 |
Product Condition 5 |
The fifth condition used to filter products in a shopping campaign or product ad group. |
dimension |
Product Condition 6 |
Product Condition 6 |
The sixth condition used to filter products in a shopping campaign or product ad group. |
dimension |
Product Condition 7 |
Product Condition 7 |
The seventh condition used to filter products in a shopping campaign or product ad group. |
dimension |
Product Type |
Product Type |
The type of product associated with a product ad. |
dimension |
Product Value 1 |
Product Value 1 |
The value for the first product condition, such as a brand name or product category. |
dimension |
Product Value 2 |
Product Value 2 |
The value for the second product condition. |
dimension |
Product Value 3 |
Product Value 3 |
The value for the third product condition. |
dimension |
Product Value 4 |
Product Value 4 |
The value for the fourth product condition. |
dimension |
Product Value 5 |
Product Value 5 |
The value for the fifth product condition. |
dimension |
Product Value 6 |
Product Value 6 |
The value for the sixth product condition. |
dimension |
Product Value 7 |
Product Value 7 |
The value for the seventh product condition. |
dimension |
ProductCategory1 |
ProductCategory1 |
dimension |
|
ProductCategory2 |
ProductCategory2 |
dimension |
|
ProductCategory3 |
ProductCategory3 |
dimension |
|
ProductCategory4 |
ProductCategory4 |
dimension |
|
ProductCategory5 |
ProductCategory5 |
dimension |
|
ProductGroup |
ProductGroup |
A group of products defined for bidding and targeting within shopping campaigns. |
dimension |
ProductType1 |
ProductType1 |
dimension |
|
ProductType2 |
ProductType2 |
dimension |
|
ProductType3 |
ProductType3 |
dimension |
|
ProductType4 |
ProductType4 |
dimension |
|
ProductType5 |
ProductType5 |
dimension |
|
ProximityTargetLocation |
ProximityTargetLocation |
dimension |
|
Publisher |
Publisher |
dimension |
|
PublisherUrl |
PublisherUrl |
dimension |
|
Purchases |
Purchases |
The number of purchase conversions recorded. |
metric |
Quality Score |
Quality Score |
A diagnostic tool that provides a holistic view of the quality of your ads, keywords, and landing pages. |
dimension |
QualityImpact |
QualityImpact |
metric |
|
QualityScore |
QualityScore |
An estimate of the quality of your ads, keywords, and landing pages. |
metric |
Quarter |
Quarter |
dimension |
|
QueryIntentCountry |
QueryIntentCountry |
dimension |
|
QueryIntentDMA |
QueryIntentDMA |
dimension |
|
QueryIntentLocationId |
QueryIntentLocationId |
metric |
|
Radius |
Radius |
metric |
|
Remarketing |
Remarketing |
dimension |
|
Report End Date |
Report End Date |
The end date of the reporting period. |
dimension |
Report Start Date |
Report Start Date |
The start date of the reporting period. |
dimension |
ReturnOnAdSpend |
ReturnOnAdSpend |
The Return on Ad Spend (ROAS), calculated as (Revenue / Spend). |
metric |
Revenue |
Revenue |
The total revenue generated from conversions. |
metric |
RevenuePerAssist |
RevenuePerAssist |
dimension |
|
RevenuePerConversion |
RevenuePerConversion |
The revenue generated for each conversion. |
dimension |
RevenuePerInstall |
RevenuePerInstall |
The average revenue generated for each app install. |
dimension |
RevenuePerSale |
RevenuePerSale |
dimension |
|
Sales |
Sales |
metric |
|
SaturdayHours |
SaturdayHours |
The hours of operation for Saturday for a business location. |
dimension |
Schedule |
Schedule |
The scheduling information for an ad extension, ad, or campaign, including start and end dates, and days/hours of the week. |
dimension |
SearchQuery |
SearchQuery |
The actual search term or query entered by a user that triggered an ad. (first search) |
dimension |
Settings.AutoGeneratedAssetsEnabled_1 |
Settings.AutoGeneratedAssetsEnabled_1 |
Indicates if auto-generated assets are enabled for the first setting. This allows Microsoft Advertising to automatically generate additional assets for ads. |
dimension |
Settings.AutoGeneratedAssetsEnabled_2 |
Settings.AutoGeneratedAssetsEnabled_2 |
Indicates if auto-generated assets are enabled for the second setting. |
dimension |
Settings.AutoGeneratedAssetsEnabled_3 |
Settings.AutoGeneratedAssetsEnabled_3 |
Indicates if auto-generated assets are enabled for the third setting. |
dimension |
Settings.Details.TargetSettingDetail_1 |
Settings.Details.TargetSettingDetail_1 |
Details for the first target setting, defining the audience or location to be targeted. |
dimension |
Settings.Details.TargetSettingDetail_2 |
Settings.Details.TargetSettingDetail_2 |
Details for the second target setting. |
dimension |
Settings.Details.TargetSettingDetail_3 |
Settings.Details.TargetSettingDetail_3 |
Details for the third target setting. |
dimension |
Settings.Details.TargetSettingDetail_4 |
Settings.Details.TargetSettingDetail_4 |
Represents a specific detail within the overall targeting settings for a campaign. |
dimension |
Settings.DisclaimerAdsEnabled_2 |
Settings.DisclaimerAdsEnabled_2 |
Indicates whether disclaimer ads are enabled for the campaign, typically used for regulatory or compliance messaging. (first search) |
dimension |
Settings.DomainName_1 |
Settings.DomainName_1 |
dimension |
|
Settings.DynamicDescriptionEnabled_1 |
Settings.DynamicDescriptionEnabled_1 |
Indicates whether dynamic ad descriptions are enabled, allowing Microsoft Advertising to automatically generate ad text. (first search) |
dimension |
Settings.Language_1 |
Settings.Language_1 |
The language setting for the campaign or ad group, which determines the language used in ads and targets customer language. (first search) |
dimension |
Settings.PageFeedIds_1 |
Settings.PageFeedIds_1 |
Identifiers for page feeds used in campaigns, often for dynamic ad generation or product listings. (first search) |
dimension |
Settings.Source_1 |
Settings.Source_1 |
The source of the dynamic search ads setting. |
dimension |
Settings.Type_1 |
Settings.Type_1 |
The type of the setting being configured. (CampaignManagementService search) |
dimension |
Settings.Type_2 |
Settings.Type_2 |
The type of the setting being configured. |
dimension |
Settings.Type_3 |
Settings.Type_3 |
The type of the setting being configured. |
dimension |
Settings.Type_4 |
Settings.Type_4 |
The type of the setting being configured. |
dimension |
Sitelink Extension Description1 |
Sitelink Extension Description1 |
The first descriptive line for a sitelink ad extension, providing additional information about the linked page. |
dimension |
Sitelink Extension Description2 |
Sitelink Extension Description2 |
The second descriptive line for a sitelink ad extension, offering more context or details. |
dimension |
Sitelink Extension Destination Url |
Sitelink Extension Destination Url |
The final URL that users are directed to when they click on the sitelink extension. |
dimension |
Sitelink Extension Link Text |
Sitelink Extension Link Text |
The clickable text that appears for the sitelink extension in the ad. |
dimension |
Sitelink Extension Order |
Sitelink Extension Order |
The display order or priority of the sitelink extension relative to other sitelinks. |
dimension |
Source |
Source |
The source of traffic or data, such as a search engine or specific network. |
dimension |
SourceMedium |
SourceMedium |
dimension |
|
Spend |
Spend |
The total cost of clicks on an ad. |
metric |
Start Date |
Start Date |
The date when a campaign, ad group, or other entity is scheduled to begin running. (CampaignManagementService search) |
dimension |
StartDate |
StartDate |
The start date of the entity’s validity or reporting period. |
dimension |
State |
State |
The state or province where the impression, click, or conversion occurred. |
dimension |
State Or Province Code |
State Or Province Code |
dimension |
|
Status |
Status |
The current status of the entity (e.g., Active, Paused, Deleted). |
dimension |
Store Id |
Store Id |
metric |
|
Structured Snippet Header |
Structured Snippet Header |
The header for a structured snippet ad extension, categorizing the list of values (e.g., ‘Amenities,’ ‘Destinations’). |
dimension |
Structured Snippet Values |
Structured Snippet Values |
The specific values listed under a structured snippet header (e.g., ‘WiFi,’ ‘Pool,’ ‘Gym’ under ‘Amenities’). |
dimension |
Sub Type |
Sub Type |
dimension |
|
SubType |
SubType |
dimension |
|
SundayHours |
SundayHours |
dimension |
|
Target Ad Group Id |
Target Ad Group Id |
The unique identifier for a specific ad group that is being targeted by certain settings or criteria. |
dimension |
Target Campaign Id |
Target Campaign Id |
The unique identifier for a specific campaign that is being targeted by certain settings or criteria. (first search) |
dimension |
Target Setting |
Target Setting |
Defines the targeting criteria for a campaign, such as location, demographics, or device. (first search) |
dimension |
TargetingSetting |
TargetingSetting |
The targeting settings for a campaign or ad group. |
dimension |
TaxInformation.key_1 |
TaxInformation.key_1 |
dimension |
|
TaxInformation.value_1 |
TaxInformation.value_1 |
dimension |
|
Text |
Text |
dimension |
|
ThursdayHours |
ThursdayHours |
dimension |
|
Time Zone |
Time Zone |
The time zone setting, which can affect ad scheduling and report data timestamps. (first search) |
dimension |
TimePeriod |
TimePeriod |
The aggregation period for report data, such as daily, weekly, or monthly. |
dimension |
TimeStamp |
TimeStamp |
dimension |
|
TimeZone |
TimeZone |
The time zone setting, which can affect ad scheduling and report data timestamps. (first search) |
dimension |
Title |
Title |
The main headline or title for an ad or other advertising element. (first search) |
dimension |
Title Part 1 |
Title Part 1 |
The first section of an ad’s headline or title, used to capture attention. (first search) |
dimension |
Title Part 2 |
Title Part 2 |
The second section of an ad’s headline or title, providing additional information or context. (first search) |
dimension |
Title Part 3 |
Title Part 3 |
The third optional section of an ad’s headline or title, further extending the message. (first search) |
dimension |
TitlePart1 |
TitlePart1 |
dimension |
|
TitlePart2 |
TitlePart2 |
dimension |
|
TitlePart3 |
TitlePart3 |
dimension |
|
To Hour |
To Hour |
dimension |
|
To Minute |
To Minute |
dimension |
|
TopImpressionRatePercent |
TopImpressionRatePercent |
The percentage of impressions that appeared in any of the top positions above the search results. (first search) |
metric |
TopImpressionShareLostToBudgetPercent |
TopImpressionShareLostToBudgetPercent |
The estimated percentage of impressions in the top positions that an ad lost due to an insufficient budget. (first search) |
metric |
TopImpressionShareLostToRankPercent |
TopImpressionShareLostToRankPercent |
The estimated percentage of impressions in the top positions that an ad lost due to low ad rank. (first search) |
metric |
TopImpressionSharePercent |
TopImpressionSharePercent |
The percentage of estimated available impressions in the top positions that an ad received. (first search) |
metric |
TopVsOther |
TopVsOther |
dimension |
|
TotalClicks |
TotalClicks |
The total number of times users clicked on an ad. (first search) |
metric |
TotalWatchTimeInMS |
TotalWatchTimeInMS |
metric |
|
Tracking Template |
Tracking Template |
A URL template used to specify additional tracking parameters for ads. |
dimension |
TrackingTemplate |
TrackingTemplate |
The URL template used for tracking clicks and other metrics. |
dimension |
TrackingUrlTemplate |
TrackingUrlTemplate |
A URL template used to specify additional tracking parameters for ads. |
dimension |
TuesdayHours |
TuesdayHours |
dimension |
|
Type |
Type |
The general type of the record or entity (e.g., Ad Group, Campaign). |
dimension |
UET Tag Id |
UET Tag Id |
The unique identifier for a Universal Event Tracking (UET) tag, used to track conversions and website behavior. |
dimension |
Url |
Url |
A Uniform Resource Locator (URL) associated with an ad, landing page, or other entity. |
dimension |
UrlCustomParameters |
UrlCustomParameters |
Custom parameters appended to URLs for detailed tracking and reporting. |
dimension |
Use Searcher Time Zone |
Use Searcher Time Zone |
Indicates whether ad scheduling should use the time zone of the searcher rather than the account’s time zone. (first search) |
dimension |
Version |
Version |
The version number of a record or entity. (BulkService search) |
dimension |
VideoCompletionRate |
VideoCompletionRate |
metric |
|
VideoViews |
VideoViews |
metric |
|
VideoViewsAt25Percent |
VideoViewsAt25Percent |
metric |
|
VideoViewsAt50Percent |
VideoViewsAt50Percent |
metric |
|
VideoViewsAt75Percent |
VideoViewsAt75Percent |
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 |
dimension |
|
ViewThroughRevenue |
ViewThroughRevenue |
The revenue generated from view-through conversions, where a user sees an ad but doesn’t click, then converts later. |
metric |
WednesdayHours |
WednesdayHours |
dimension |
|
Week |
Week |
dimension |
|
Year |
Year |
The year when the impression, click, or conversion occurred. |
metric |
account_id |
account_id |
The unique identifier for a Microsoft Advertising account. (first search) |
dimension |
account_id* |
account_id* |
A unique system-generated identifier for the account. |
dimension |
account_name |
account_name |
The name of the Microsoft Advertising account. (first search) |
dimension |
account_name* |
account_name* |
The name of the account. |
dimension |
account_number |
account_number |
The unique account number assigned by Microsoft Advertising. (CustomerManagementService search, first search) |
metric |
ad_group_id |
ad_group_id |
The unique identifier for an ad group. (first search, CampaignManagementService search) |
dimension |
ad_group_name |
ad_group_name |
The name of the ad group. (first search) |
dimension |
ad_network |
ad_network |
The network where an ad was shown (e.g., Microsoft Audience Network, search partners). (first search) |
dimension |
ad_type |
ad_type |
The type of ad (e.g., Expanded Text Ad, Responsive Search Ad, Dynamic Search Ad). (CampaignManagementService search) |
dimension |
campaign |
campaign |
The name of the advertising campaign. |
dimension |
campaign_day |
campaign_day |
The specific day of the month for campaign-level reporting. |
metric |
campaign_id |
campaign_id |
The unique identifier for a campaign. (first search, CampaignManagementService search) |
dimension |
campaign_month |
campaign_month |
The specific month for campaign-level reporting. |
metric |
campaign_name |
campaign_name |
The name of the campaign. (first search) |
dimension |
campaign_name* |
campaign_name* |
The name of the advertising campaign. |
dimension |
campaign_type |
campaign_type |
The type of the campaign (e.g., Search, Shopping, Audience). (CampaignManagementService search) |
dimension |
campaign_year |
campaign_year |
The specific year for campaign-level reporting. |
metric |
clicks |
clicks |
The number of times users clicked on an ad. (first search) |
metric |
conversions |
conversions |
The number of conversions recorded for an ad or campaign. Note: This field may be deprecated in favor of more specific conversion metrics. (first search) |
metric |
country |
country |
The country where the impression, click, or conversion occurred. |
dimension |
date |
date |
The specific date for which the data is reported. |
dimension |
day |
day |
The specific day of the month for reporting data. |
dimension |
day of week |
day of week |
The day of the week when the impression, click, or conversion occurred. |
dimension |
device |
device |
The type of device on which the ad was shown (e.g., computer, tablet, smartphone). (first search) |
dimension |
device* |
device* |
The type of device used by the customer when the impression occurred (e.g., Computers, Smartphones, Tablets). |
dimension |
device_type |
device_type |
The type of device on which the ad was shown (e.g., computer, tablet, smartphone). (first search) |
dimension |
end_date |
end_date |
The end date of the entity’s validity or reporting period. |
dimension |
hour |
hour |
The specific hour of the day for reporting data. |
dimension |
impressions |
impressions |
The number of times an ad was displayed to users. (first search) |
metric |
marketing_channel |
marketing_channel |
The marketing channel used for the campaign (e.g., Paid Search, Display). |
dimension |
month |
month |
The month when the impression, click, or conversion occurred. |
metric |
month of year |
month of year |
The month of the year when the impression, click, or conversion occurred. |
dimension |
network |
network |
The network where an ad was shown (e.g., Microsoft Advertising Network, search partners). (first search) |
dimension |
product_brand* |
product_brand* |
dimension |
|
product_id |
product_id |
dimension |
|
publisher_name* |
publisher_name* |
dimension |
|
search_impression_share |
search_impression_share |
The percentage of impressions an ad received compared to the total estimated impressions it was eligible to receive on the search network. (first search) |
metric |
source |
source |
dimension |
|
spend |
spend |
The total cost incurred for the advertising activity. (first search) |
metric |
week |
week |
metric |
|
week_day |
week_day |
The day of the week when the impression, click, or conversion occurred. |
metric |
week_start_date |
week_start_date |
dimension |
|
weekday |
weekday |
The day of the week when the impression, click, or conversion occurred. |
metric |
year |
year |
The year when the impression, click, or conversion occurred. |
metric |