Microsoft Ads: Most-used fields

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 impressions that appeared in the absolute top position of the search results page. (first search)

metric

AbsoluteTopImpressionShareLostToBudgetPercent

AbsoluteTopImpressionShareLostToBudgetPercent

The estimated percentage of how often your ad missed showing in the first position at the top of search results due to insufficient budget.

metric

AbsoluteTopImpressionShareLostToRankPercent

AbsoluteTopImpressionShareLostToRankPercent

The estimated percentage of how often poor ad rank kept your ad from showing in the first ad position at the top of search results.

metric

AbsoluteTopImpressionSharePercent

AbsoluteTopImpressionSharePercent

How often your ad was in the first position of all results, as a percentage of your total impressions.

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

Measures the relevance of an ad and its landing page to potential customers.

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

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

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

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

AdRotation.EndDate

AdRotation.EndDate

Reserved for future use; this field is typically null.

dimension

AdRotation.StartDate

AdRotation.StartDate

Reserved for future use; this field is typically null.

dimension

AdRotation.Type

AdRotation.Type

The method used to rotate multiple ads within an ad group, such as optimizing for clicks or rotating evenly.

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

AdStrength

AdStrength

Measures the relevance of an ad and its landing page to potential customers.

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 network where you want your ads to show. This can be the entire Microsoft Advertising Network, Microsoft sites and select traffic, cross-network traffic, or only partner traffic.

dimension

Age Ranges

Age Ranges

The demographic age ranges targeted by the ad.

dimension

AgeGroup

AgeGroup

The range of ages of the search users to whom the ad was delivered.

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 values for conversions, including those not selected to be included in the ‘Conversions’ column. Qualified indicates conversions that meet specific criteria.

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

The unique identifier (client ID) for an application registered with Microsoft Advertising.

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 installations of an application, often tracked as a conversion metric.

metric

Asset Group

Asset Group

A named collection of assets used in an advertising campaign.

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

AssetId

AssetId

The unique Microsoft Advertising identifier for an asset within an account.

metric

AssetType

AssetType

The classification of an asset, indicating its content or purpose.

dimension

AssistedConversions

AssistedConversions

Conversions that resulted from the clicks on your ads that have received co-bids from your manufacturer partners.

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

The attribute that was modified by a user.

dimension

Attribution Model Type

Attribution Model Type

The model used to assign credit for conversions (e.g., last click, data-driven).

dimension

Audience

Audience

Groups of people who have something in common, like specific interests or online activity, targeted by the ad.

dimension

Audience Group Id

Audience Group Id

The system-generated identifier for an audience group.

dimension

Audience Group Name

Audience Group Name

The name of the audience group, which must be unique within the account.

dimension

Audience Id

Audience Id

The unique identifier for an audience.

dimension

AudienceAdsBidAdjustment

AudienceAdsBidAdjustment

The bid adjustment percentage for audience ads.

dimension

AudienceId

AudienceId

The unique identifier for an audience.

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

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

Total spend divided by video views (calculated).

dimension

AverageCpc

AverageCpc

The average cost per click (CPC) on your ads.

metric

AverageCpm

AverageCpm

The average amount you are charged every 1,000 times your ad is displayed.

metric

AveragePosition

AveragePosition

The average position of your ad on the search results page.

metric

AverageWatchTimePerImpression

AverageWatchTimePerImpression

Total watch time divided by impressions (calculated).

metric

AverageWatchTimePerVideoView

AverageWatchTimePerVideoView

Total watch time divided by video views (calculated).

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 amount you are charged every 1,000 times your ad is displayed.

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

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 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

The selected strategy or setting that determines how bids are managed for advertising campaigns.

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

The status of the campaign’s budget.

dimension

BudgetId

BudgetId

The unique system identifier of the shared budget.

metric

BudgetName

BudgetName

The name you assign to the shared budget.

dimension

BudgetStatus

BudgetStatus

This column tells you whether the shared budget is Sufficient or Budget paused.

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

The top level category that Bing matched to your website.

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

Cost per install. The total spend divided by the number of app installs.

dimension

CPP

CPP

The average cost per phone call.

dimension

CPS

CPS

The total cost of sales divided by the number of sales during this period.

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 intent behind an advertising campaign, such as brand awareness or website visits.

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

These are the labels you applied to campaigns.

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

The name of the person who made a specific change to the campaign, ad group, ad, or keyword.

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 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

The color, often represented by a hex code, used in branding or ad creatives.

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

Number of times a user completed the full video (measured directly).

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

A conversion is a click that results in a sale or another measure of success. Qualified indicates conversions that meet specific criteria.

metric

Cost

Cost

The total cost incurred for the advertising activity. (first search)

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 where an ad was physically served, or the country or region that your customer had shown interest in.

dimension

CountryOfSale

CountryOfSale

This is the country or region where the products in this campaign are sold.

dimension

CountryOrRegion

CountryOrRegion

The country or region used for targeting ads to specific geographical locations.

dimension

County

County

The county where your customer was physically located when they viewed your ad.

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

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 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

The date and time when the change was made.

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

The operating system of the device reported in the DeviceType column. Possible values include Android, Blackberry, iOS, Other, Unknown, and Windows.

dimension

DeviceType

DeviceType

The type of device used by the customer when the impression occurred (e.g., Computers, Smartphones, Tablets).

dimension

Display Url

Display Url

The URL shown in an ad, which may be different from the actual landing page 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

End

The date when an ad group or campaign is scheduled to stop running.

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

The name of the entity that was changed (e.g., campaign name, ad group name).

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

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

Exchange Rate

Exchange Rate

The currency conversion rate, typically sourced daily in UTC.

metric

ExpectedCtr

ExpectedCtr

A component of Quality Score, measuring the expected click-through rate of an ad.

metric

Experiment Campaign Id

Experiment Campaign Id

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.

dimension

Experiment Id

Experiment Id

The unique identifier for an advertising experiment.

dimension

ExperimentId

ExperimentId

The unique identifier for an advertising experiment.

dimension

ExtendedCost

ExtendedCost

Cost information that is optionally provided by advertisers, including non-advertising costs, taxes, and shipping.

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

Your App URL is the page where people go after clicking on your ad on an app.

dimension

FinalAppUrls

FinalAppUrls

A list of final URLs for app installations.

dimension

FinalMobileUrl

FinalMobileUrl

Your Mobile URL is the page where people go after clicking on your ad on a mobile device.

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

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.

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 starting hour for a scheduled ad delivery or report aggregation.

dimension

From Minute

From Minute

The starting minute for a scheduled ad delivery or report aggregation.

dimension

Gender

Gender

The gender (male or female) of the search users to whom the ad was delivered.

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 campaign analytics goal for tracking potential land, browse, prospect, and conversion steps.

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 or category of a conversion goal (e.g., purchase, lead, sign-up).

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

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 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

The description of a change to your campaign.

dimension

Id

Id

A unique system-generated identifier for an entity (e.g., ad group, ad, keyword).

dimension

Impression Share

Impression Share

How often your ad is shown, as a percentage of the total available impressions in the market you were targeting.

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

The percentage of impression share lost due to low rank.

metric

ImpressionLostToRankPercent

ImpressionLostToRankPercent

The estimated percentage of impressions lost due to a low ad rank.

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

Is Deal Campaign

Is Deal Campaign

Indicates whether a campaign is a deal campaign.

dimension

ItemChanged

ItemChanged

The specific item or setting that was modified.

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

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 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 system-generated identifier for a customer associated with a linked agency.

metric

LinkedAgencies.CustomerInfo.Name_1

LinkedAgencies.CustomerInfo.Name_1

The name of a customer associated with a linked agency.

dimension

Location

Location

The geographical location where the impression, click, or conversion occurred.

dimension

LocationId

LocationId

The number Microsoft Advertising uses to identify your customer’s physical location when they were shown your ad.

metric

LocationTargeting

LocationTargeting

The specific geographical targeting settings for a campaign or ad group.

dimension

LocationType

LocationType

This report column displays whether an ad was served based on physical location or location of interest.

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

Clicks that exhibit a low likelihood of commercial intent and for which customers are not billed.

metric

LowQualityClicksPercent

LowQualityClicksPercent

The number of low-quality clicks, divided by the total number of clicks.

metric

LowQualityConversionRate

LowQualityConversionRate

The conversion rate of clicks that originate from low-quality clicks.

metric

LowQualityConversions

LowQualityConversions

Conversions that originate from low-quality clicks.

metric

LowQualityGeneralClicks

LowQualityGeneralClicks

Clicks that are filtered by general methods, such as blocked or safe programs and activity-based detection, and that suggest a low likelihood of commercial intent.

metric

LowQualityImpressions

LowQualityImpressions

Impressions that result from low-quality keyword searches.

metric

LowQualityImpressionsPercent

LowQualityImpressionsPercent

The number of low-quality impressions, divided by the total number of impressions.

metric

LowQualitySophisticatedClicks

LowQualitySophisticatedClicks

Invalid clicks that use sophisticated means to appear valid.

metric

MainlineBid

MainlineBid

Based on campaign performance and marketplace dynamics, this estimate is the bid amount that Microsoft Advertising calculates will place your ad at the top of search results, also known as “mainline.”

dimension

ManualCalls

ManualCalls

Calls made to a call extension number by dialing the number, rather than clicking the number. Only data from manual calls made to a metered number is reported.

metric

Marketing Channel

Marketing Channel

The platform or medium through which ads are distributed and reach the target audience.

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

The method of ad distribution, such as email, Search ad, or display ad.

dimension

MerchantProductId

MerchantProductId

A unique identifier for each item in your Microsoft Merchant Center feed.

dimension

MetroArea

MetroArea

The metropolitan area where the user was physically located when they clicked the ad. This is part of the Microsoft Market Area for US targeting.

dimension

Microsoft Click Id

Microsoft Click Id

A unique 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

After a change is made to your campaign, this shows the current value of the changed attribute.

dimension

OldValue

OldValue

This shows the previous value of a changed attribute.

dimension

PLACEMENT

PLACEMENT

The name of the publisher ad 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

Either the destination URL used when a keyword match occurs, or the text that replaces {param1} in an ad.

dimension

Param2

Param2

The text that replaces {param2} in an ad when a keyword match occurs.

dimension

Param3

Param3

The text that replaces {param3} in an ad when a keyword match occurs.

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

Defines the possible types of product partition, either unit or subdivision.

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

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 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

The number of calls made to the call forwarding number shown in your call extension.

metric

PhoneImpressions

PhoneImpressions

The number of times your metered (call forwarding) number was shown on all devices.

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

The postal code or zip code where an ad was physically served, or that your customer had shown interest in.

dimension

Potential Impressions

Potential Impressions

The estimated total available impressions in the market you were targeting.

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

The top-level category of a product from the product feed.

dimension

ProductCategory2

ProductCategory2

The second level category of a product from the product feed.

dimension

ProductCategory3

ProductCategory3

The third level category of a product from the product feed.

dimension

ProductCategory4

ProductCategory4

The fourth level of a product’s hierarchical category in a product catalog.

dimension

ProductCategory5

ProductCategory5

The fifth level of a product’s hierarchical category in a product catalog.

dimension

ProductGroup

ProductGroup

The ID Microsoft Advertising uses to identify the product target.

dimension

ProductType1

ProductType1

The first level of product type classification from the product feed.

dimension

ProductType2

ProductType2

The second level of product type classification from the product feed.

dimension

ProductType3

ProductType3

The third level of product type classification from the product feed.

dimension

ProductType4

ProductType4

The fourth level of an advertiser-defined product type in a product catalog.

dimension

ProductType5

ProductType5

The fifth level of an advertiser-defined product type in a product catalog.

dimension

ProximityTargetLocation

ProximityTargetLocation

Proximity to business or other locations used for targeting.

dimension

Publisher

Publisher

The top-level URL of a website that is not in the Bing, AOL, Yahoo, and partner sites network.

dimension

PublisherUrl

PublisherUrl

The top-level URL of a website that is not in the Bing, AOL, Yahoo, and partner sites network.

dimension

Purchases

Purchases

The number of completed purchase conversions.

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

The impact on impressions an improved quality score would make. This metric is calculated only if the keyword quality score is between 1 and 5.

metric

QualityScore

QualityScore

An estimate of the quality of your ads, keywords, and landing pages.

metric

Quarter

Quarter

The date range for the quarter that your data is from.

dimension

QueryIntentCountry

QueryIntentCountry

The name of a country if the user’s geographical intent can be determined from their search query.

dimension

QueryIntentDMA

QueryIntentDMA

The name of a metro area if the user’s geographical intent can be determined from their search query.

dimension

QueryIntentLocationId

QueryIntentLocationId

The location ID based on the user’s geographical search intent.

metric

Radius

Radius

Distance from the target location (in miles).

metric

Remarketing

Remarketing

A targeting strategy to re-engage users who have previously interacted with ads or websites.

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

Revenue divided by the number of assists.

dimension

RevenuePerConversion

RevenuePerConversion

The revenue generated for each conversion.

dimension

RevenuePerInstall

RevenuePerInstall

The revenue generated per application installation, calculated as total revenue divided by app installs.

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

The origin of the advertising traffic and the method of ad distribution combined (e.g., Bing / cpc).

dimension

Spend

Spend

The total cost of clicks on an ad.

metric

Start

Start

The date when a report, campaign, or ad group is scheduled to begin running.

dimension

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

The state or province code where the user was physically located when they clicked the ad, or that your customer had shown interest in.

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.

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

A more specific classification within a broader ad or campaign type.

dimension

SubType

SubType

A more specific classification within a broader ad or campaign type.

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

A key representing a specific type of tax information.

dimension

TaxInformation.value_1

TaxInformation.value_1

The value associated with a specific tax information key.

dimension

Text

Text

The text content of an ad or other entity.

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

The UTC timestamp when an event occurred or an entity was last modified.

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

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 for a scheduled ad delivery or report aggregation.

dimension

To Minute

To Minute

The ending minute for a scheduled ad delivery or report aggregation.

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

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 times users clicked on an ad. (first search)

metric

TotalWatchTimeInMS

TotalWatchTimeInMS

Total amount of time users have spent watching the video (measured directly).

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

The URL of the webpage associated with the ad 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

Completed video views divided by total number of impressions.

metric

VideoViews

VideoViews

The number of times a potential customer watched the video in its entirety.

metric

VideoViewsAt25Percent

VideoViewsAt25Percent

Number of times a user completed at least 25% of the video (measured directly).

metric

VideoViewsAt50Percent

VideoViewsAt50Percent

Number of times a user completed at least 50% of the video (measured directly).

metric

VideoViewsAt75Percent

VideoViewsAt75Percent

Number of times a user completed at least 75% of the video (measured directly).

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

Conversions that people make after they have seen your ad, even though they did not click the ad. Qualified indicates conversions that meet specific criteria.

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

The date range for your data, as a week (e.g., Sunday through Saturday or Monday through Sunday).

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

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

campaign

campaign

The name of the advertising campaign.

dimension

campaign_day

campaign_day

The specific day of the month for which campaign data is reported.

metric

campaign_id

campaign_id

The unique identifier for a campaign. (first search, CampaignManagementService search)

dimension

campaign_month

campaign_month

The specific month for which campaign data is reported.

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 which campaign data is reported.

metric

clicks

clicks

The number of times users clicked on an ad. (first search)

metric

conversions

conversions

A conversion is a click that results in a sale or another measure of success.

metric

country

country

The country where the impression, click, or conversion occurred.

dimension

created_date

created_date

dimension

date

date

The specific date for which the data is reported.

dimension

day

day

The date that your data was logged.

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

A number that tells you which hour of the day your data is from for the entire date range (0-23).

dimension

impressions

impressions

The number of times an ad was displayed to users. (first search)

metric

marketing_channel

marketing_channel

The platform or medium through which ads are distributed and reach the target audience.

dimension

modified_time

modified_time

The date and time, in Coordinated Universal Time (UTC), when an entity was last updated.

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*

The brand of a product, typically provided in a product catalog for Shopping campaigns.

dimension

publisher_name*

publisher_name*

The name of the publisher or website where the ad was displayed.

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

spend

spend

The total cost incurred for the advertising activity. (first search)

metric

week

week

The date range for your data, as a week (e.g., Sunday through Saturday or Monday through Sunday).

metric

week_day

week_day

The day of the week when the impression, click, or conversion occurred.

metric

week_start_date

week_start_date

The start date of the week for which the data is reported.

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

”AccountId”

”AccountId”

The unique identifier for a Microsoft Advertising account.

metric