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 times an ad appeared in the absolute top position (the very first position) of all search results, relative to the total number of impressions.

metric

AbsoluteTopImpressionShareLostToBudgetPercent

AbsoluteTopImpressionShareLostToBudgetPercent

The estimated percentage of times an ad failed to show in the absolute top position due to an insufficient budget.

metric

AbsoluteTopImpressionShareLostToRankPercent

AbsoluteTopImpressionShareLostToRankPercent

The estimated percentage of times an ad missed showing in the very top ad position (above search results) due to a poor ad rank. This helps assess reasons for missing out on top ad positions.

metric

AbsoluteTopImpressionSharePercent

AbsoluteTopImpressionSharePercent

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

metric

Account Id

Account Id

The unique Microsoft Advertising identifier of the account.

dimension

Account Name

Account Name

The name of the account.

dimension

AccountId

AccountId

The unique system-generated identifier of the account.

dimension

AccountName

AccountName

The name of the account.

dimension

AccountNumber

AccountNumber

The unique identification number of the advertiser account.

dimension

AccountStatus

AccountStatus

The status of the advertiser account (e.g., Active, Closed).

dimension

Ad Group

Ad Group

The name of the ad group.

dimension

Ad Group Type

Ad Group Type

The type of the ad group, e.g., ‘SearchStandard’ or ‘SearchDynamic’.

dimension

Ad Rotation

Ad Rotation

The setting that determines how often Microsoft Advertising selects which ads to serve within an ad group.

dimension

Ad Schedule

Ad Schedule

The schedule that defines when ads are eligible to be shown.

dimension

Ad Schedule Use Searcher Time Zone

Ad Schedule Use Searcher Time Zone

Indicates whether the ad schedule uses the searcher’s time zone.

dimension

Ad Strength

Ad Strength

The ad strength score of responsive search ads, indicating their effectiveness and relevance.

dimension

Ad Strength Action Items

Ad Strength Action Items

Suggestions based on the ad strength of responsive search ads to help improve performance and maximize opportunities.

dimension

AdDescription

AdDescription

The primary descriptive text for the ad.

dimension

AdDescription2

AdDescription2

The secondary descriptive text for the ad, if available.

dimension

AdDistribution

AdDistribution

The distribution network where the ad is shown (e.g., search network, audience network).

dimension

AdExtensionId

AdExtensionId

The system-generated identifier of the ad extension.

metric

AdExtensionType

AdExtensionType

The type of ad extension (e.g., Sitelink, Callout, Call).

dimension

AdExtensionVersion

AdExtensionVersion

A version number that tracks updates made to an ad extension.

metric

AdGroupCriterionId

AdGroupCriterionId

The unique Microsoft Advertising identifier for a criterion applied to an ad group.

dimension

AdGroupId

AdGroupId

The unique system-generated identifier of the ad group.

dimension

AdGroupLabels

AdGroupLabels

Labels applied to ad groups for organization and reporting.

dimension

AdGroupName

AdGroupName

The name of the ad group.

dimension

AdGroupStatus

AdGroupStatus

The status of the ad group (e.g., Active, Paused, Deleted).

dimension

AdId

AdId

The system-generated identifier of the ad.

metric

AdLabels

AdLabels

Labels applied to ads for organization and reporting.

dimension

AdRelevance

AdRelevance

A component of Quality Score, measuring how relevant an ad is to the keyword.

metric

AdStatus

AdStatus

The status of the ad (e.g., Active, Paused, Deleted).

dimension

AdStrength

AdStrength

A score indicating the effectiveness and relevance of responsive search ads, ranging from Poor to Excellent.

dimension

AdTitle

AdTitle

The title of the ad.

dimension

AdType

AdType

The type of ad (e.g., Text Ad, Product Ad, Responsive Search Ad).

dimension

Age Ranges

Age Ranges

The age groups targeted by the ad.

dimension

AgeGroup

AgeGroup

Audience targeting criterion specifying age demographic (e.g., 18-24, 25-34) for ad delivery.

dimension

AllConversionRate

AllConversionRate

The percentage of clicks that resulted in any conversion, including cross-device and from all conversion goals.

metric

AllConversions

AllConversions

The total number of conversions, including cross-device conversions and conversions from all goals.

metric

AllConversionsQualified

AllConversionsQualified

The total number of all conversions recorded, including those where the conversion goal’s “ExcludeFromBidding” property is set to true.

metric

AllCostPerConversion

AllCostPerConversion

The average cost for all conversions, regardless of their ‘ExcludeFromBidding’ setting.

metric

AllReturnOnAdSpend

AllReturnOnAdSpend

The total revenue generated for every unit of currency spent on advertising, including all conversions. (first search)

metric

AllRevenue

AllRevenue

The total revenue generated from all conversions, including cross-device and from all conversion goals.

metric

AllRevenuePerConversion

AllRevenuePerConversion

The revenue generated per conversion, including all conversions (cross-device and from all conversion goals).

metric

App Id

App Id

The unique identifier of an application.

dimension

App Platform

App Platform

The platform of the application, such as iOS or Android.

dimension

App Status

App Status

The status of the application.

dimension

AppInstalls

AppInstalls

The number of times customers install apps through your ads.

dimension

Asset Group

Asset Group

The entity representing a collection of assets for Performance Max campaigns.

dimension

Asset Group Strength

Asset Group Strength

The strength score of an asset group, indicating its effectiveness.

dimension

AssetGroupId

AssetGroupId

The system-generated unique identifier of the asset group.

dimension

AssetGroupName

AssetGroupName

The name of the asset group.

dimension

AssetGroupStatus

AssetGroupStatus

The current status of the asset group, such as Active, Deleted, Expired, or Paused.

dimension

AssetId

AssetId

The unique Microsoft Advertising identifier for an asset, which can be shared across multiple ads.

metric

AssetType

AssetType

The type of the asset, for example, TextAsset or ImageAsset.

dimension

Assists

Assists

The number of assists attributed to an ad, where an ad contributed to a conversion but wasn’t the last click.

metric

Attribution Model Type

Attribution Model Type

The model used to attribute conversions to ad interactions, such as LastClick or DataDriven.

dimension

Audience

Audience

The audience entity that defines a group of users to target.

metric

Audience Group Id

Audience Group Id

The unique identifier of an audience group.

dimension

Audience Group Name

Audience Group Name

The name of the audience group.

dimension

Audience Id

Audience Id

The unique Microsoft Advertising identifier for the audience.

dimension

AudienceId

AudienceId

The unique identifier for an audience.

metric

AudienceImpressionLostToBudgetPercent

AudienceImpressionLostToBudgetPercent

metric

AudienceName

AudienceName

The name of the audience targeted.

dimension

AudienceType

AudienceType

The type of audience (e.g., remarketing list, in-market audience).

dimension

Audiences

Audiences

A collection of audience entities.

dimension

Auto Apply Recommendations

Auto Apply Recommendations

dimension

Auto Generated Image Assets Opt Out

Auto Generated Image Assets Opt Out

Specifies if image assets should be dynamically generated by Microsoft Advertising for Performance Max campaigns. Setting it to true opts out of dynamic image asset generation.

dimension

Auto Generated Text Assets Opt Out

Auto Generated Text Assets Opt Out

Specifies if text assets should be dynamically generated by Microsoft Advertising. Setting it to true opts out of dynamic text asset generation.

dimension

Automated Call To Action Opt Out

Automated Call To Action Opt Out

dimension

AverageCPV

AverageCPV

The average cost per video view.

dimension

AverageCpc

AverageCpc

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

metric

AverageCpm

AverageCpm

The average cost per thousand impressions (CPM).

metric

AveragePosition

AveragePosition

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

metric

AverageWatchTimePerImpression

AverageWatchTimePerImpression

The average watch time of a video per impression.

dimension

AverageWatchTimePerVideoView

AverageWatchTimePerVideoView

The average watch time of a video per video view.

dimension

Avg CPC

Avg CPC

The average cost per click (CPC).

dimension

Avg CPM

Avg CPM

The average cost per thousand impressions (CPM).

dimension

Avg position

Avg position

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

dimension

Base Campaign Id

Base Campaign Id

The unique identifier of the original campaign used as the base for an experiment campaign.

dimension

BaseCampaignId

BaseCampaignId

For experimental campaigns, this is the ID of the campaign the experiment was based on. For all other campaigns, this is identical to campaign ID.

metric

Bid

Bid

The bid amount for a keyword or criterion.

dimension

Bid Adjustment

Bid Adjustment

The percentage by which to adjust a bid for specific targeting criteria.

metric

Bid Option

Bid Option

dimension

Bid Strategy CommissionRate

Bid Strategy CommissionRate

The commission rate for the Commission bid strategy, used for hotel campaigns.

dimension

Bid Strategy Id

Bid Strategy Id

The unique system-generated identifier of a portfolio bid strategy that this campaign shares with other campaigns in the account.

dimension

Bid Strategy ManualCpc

Bid Strategy ManualCpc

A bid strategy where you manually set ad group and keyword bids.

dimension

Bid Strategy ManualCpi

Bid Strategy ManualCpi

dimension

Bid Strategy MaxCpc

Bid Strategy MaxCpc

The maximum cost per click (CPC) bid for campaigns using a bid strategy that optimizes for clicks within a budget.

dimension

Bid Strategy Name

Bid Strategy Name

The name of the bid strategy.

dimension

Bid Strategy PercentMaxCpc

Bid Strategy PercentMaxCpc

The percentage of the maximum Cost Per Click (CPC) for the PercentCpc bid strategy, used for hotel campaigns.

dimension

Bid Strategy TargetAdPosition

Bid Strategy TargetAdPosition

dimension

Bid Strategy TargetCostPerSale

Bid Strategy TargetCostPerSale

dimension

Bid Strategy TargetCpa

Bid Strategy TargetCpa

The target Cost Per Acquisition (CPA) for the TargetCpa bid strategy.

dimension

Bid Strategy TargetImpressionShare

Bid Strategy TargetImpressionShare

The target impression share percentage for campaigns using a bid strategy to optimize for visibility on the search results page.

dimension

Bid Strategy TargetRoas

Bid Strategy TargetRoas

The target return on ad spend (ROAS) for campaigns using a bid strategy to achieve a specific return on advertising investment.

dimension

Bid Strategy Type

Bid Strategy Type

The type of bidding strategy used for a campaign or ad group, such as ManualCpc, MaxClicks, or TargetCpa.

dimension

BidMatchType

BidMatchType

The match type of the keyword that was bid on (e.g., Exact, Phrase, Broad).

dimension

BidStrategyType

BidStrategyType

The type of bidding strategy used for a campaign or ad group (e.g., Manual CPC, Enhanced CPC, Maximize Conversions).

dimension

Budget

Budget

The daily budget amount for a campaign.

metric

Budget Id

Budget Id

The unique system identifier of the shared budget.

dimension

Budget Name

Budget Name

The name of the budget.

dimension

Budget Type

Budget Type

The type of budget, determining how the allocated amount is spent throughout the day, e.g., DailyBudgetStandard.

dimension

BudgetAssociationStatus

BudgetAssociationStatus

dimension

BudgetName

BudgetName

The name of the budget.

dimension

BudgetStatus

BudgetStatus

The status of the budget, such as Active or Deleted.

dimension

Business Name

Business Name

The name of the business associated with an ad or account.

dimension

BusinessName

BusinessName

The name of the business associated with the ad or account.

dimension

CPA

CPA

The cost per acquisition or conversion.

dimension

CPI

CPI

The cost per install for app campaigns.

dimension

CPP

CPP

The cost per purchase.

dimension

CPS

CPS

The cost per sale.

dimension

CTR

CTR

The click-through rate, calculated as the number of clicks divided by the number of impressions.

metric

Call To Action

Call To Action

A phrase in an ad that encourages users to take a specific action, such as ‘Shop Now’ or ‘Learn More’.

dimension

Call To Action Text

Call To Action Text

The specific text content of the call to action.

dimension

Call Tracking Enabled

Call Tracking Enabled

Indicates if call tracking is enabled to measure calls from ads.

dimension

Callout Text

Callout Text

Additional descriptive text that can be displayed with an ad as an extension.

dimension

Campaign

Campaign

The name of the campaign.

dimension

Campaign Goal

Campaign Goal

The specific goal or objective for the campaign, e.g., increasing website traffic or conversions.

dimension

Campaign Id

Campaign Id

The unique Microsoft Advertising identifier for the campaign.

dimension

Campaign Objective Type

Campaign Objective Type

dimension

Campaign Type

Campaign Type

The type of campaign, such as Search, Audience, Shopping, Hotel Ads, or Performance Max.

dimension

CampaignId

CampaignId

The unique Microsoft Advertising identifier of the campaign.

dimension

CampaignLabels

CampaignLabels

User-defined labels applied to a campaign, used for organizing and filtering campaign data in reports.

dimension

CampaignName

CampaignName

The name of the campaign.

dimension

CampaignStatus

CampaignStatus

The status of the campaign (e.g., Active, Paused, Deleted).

dimension

CampaignType

CampaignType

The type of campaign (e.g., Search, Audience, Shopping).

dimension

City

City

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

dimension

ClickSharePercent

ClickSharePercent

The percentage of estimated available clicks that an ad received.

metric

ClickType

ClickType

The specific part of an ad that a user clicked (e.g., ad title, sitelink, phone number).

dimension

Clicks

Clicks

The number of times an ad was clicked.

metric

Client Id

Client Id

A custom identifier provided by the client, used to associate records in bulk operations.

dimension

Color

Color

The color code associated with a label, used for visual organization.

dimension

Commission Rate

Commission Rate

The commission rate charged for Commission bid strategies.

dimension

CompletedVideoViews

CompletedVideoViews

The number of times a video ad was played to 100% completion.

metric

Conversion Name

Conversion Name

The name of the conversion goal.

dimension

Conversion Time

Conversion Time

The date and time when a conversion occurred.

dimension

Conversion Value

Conversion Value

The value attributed to a conversion.

dimension

ConversionRate

ConversionRate

The percentage of clicks that resulted in a conversion.

metric

Conversions

Conversions

The number of conversions attributed to an ad, based on your conversion tracking settings.

metric

ConversionsQualified

ConversionsQualified

The total number of conversions recorded. A conversion represents a completed action by a customer after interacting with your ad.

metric

Cost

Cost

The total cost incurred for ad interactions.

metric

CostPerAssist

CostPerAssist

Spend divided by the number of times an entity contributed to a conversion that is associated with a different entity.

dimension

CostPerConversion

CostPerConversion

The cost incurred for each conversion.

dimension

Country

Country

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

dimension

Country Code

Country Code

The country or region code for a geographical target.

dimension

County

County

The county associated with the user’s physical location at the time of the ad interaction.

dimension

Cpc Bid

Cpc Bid

The Cost Per Click (CPC) bid amount.

dimension

Cpm Bid

Cpm Bid

The bid amount specified for an ad group, representing the cost an advertiser is willing to pay for 1,000 viewed impressions (Cost Per Mille).

dimension

Cpv Bid

Cpv Bid

The Cost Per View (CPV) bid amount, typically for video ads.

dimension

Ctr

Ctr

The click-through rate, calculated as (Clicks / Impressions) * 100.

metric

Currency Code

Currency Code

The currency type used for the account.

dimension

CurrencyCode

CurrencyCode

The currency in which the account operates (e.g., USD, EUR).

dimension

CurrentMaxCpc

CurrentMaxCpc

The current maximum cost per click that is charged to the advertiser’s account when a search user clicks an ad.

metric

Custom Parameter

Custom Parameter

A key-value pair used for URL tracking or dynamic content in ads.

dimension

CustomLabel0

CustomLabel0

A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns.

dimension

CustomLabel1

CustomLabel1

The value of the Custom_label_1 field from your Microsoft Merchant Center catalog, used for product grouping and filtering.

dimension

CustomLabel2

CustomLabel2

A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns.

dimension

CustomLabel3

CustomLabel3

A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns.

dimension

CustomLabel4

CustomLabel4

A custom label (0-4) defined in the Microsoft Merchant Center product catalog, used for organizing and targeting products in shopping campaigns.

dimension

CustomParameters

CustomParameters

Custom key-value pairs that can be used in tracking templates.

dimension

CustomerId

CustomerId

The unique Microsoft Advertising identifier of the customer (manager account).

dimension

CustomerName

CustomerName

The name of the customer (manager account).

dimension

DailyBudget

DailyBudget

The amount allocated to be spent daily on a campaign or shared budget.

metric

Date

Date

The calendar date, specified by month, day, and year, used for reporting purposes to filter or aggregate performance data.

dimension

DeliveredMatchType

DeliveredMatchType

The actual match type of the keyword that triggered the ad (e.g., Exact, Phrase, Broad).

dimension

Description

Description

The descriptive text of an ad or entity.

dimension

Descriptions

Descriptions

Multiple descriptive texts for an ad or entity.

dimension

Destination Url

Destination Url

The URL to which the ad directs the user after a click.

dimension

DestinationUrl

DestinationUrl

The URL that users are directed to after clicking an ad.

dimension

Device Preference

Device Preference

Determines the device preference for showing the ad.

dimension

Device Type

Device Type

The type of device an impression or click originated from (e.g., desktop, mobile, tablet).

dimension

DeviceOS

DeviceOS

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

dimension

DeviceType

DeviceType

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

dimension

Disclaimer Ads Enabled

Disclaimer Ads Enabled

Indicates if disclaimer ads are enabled for the campaign or account.

dimension

Display Url

Display Url

The URL shown in the ad, which may differ from the final landing page URL.

dimension

DisplayUrl

DisplayUrl

The URL displayed in the ad.

dimension

Domain Name

Domain Name

The domain name associated with an ad, campaign, or website.

dimension

Dynamic Ad Target Condition 1

Dynamic Ad Target Condition 1

The first condition that determines whether a webpage property (e.g., URL, content, title) matches the dynamic ad target.

dimension

Dynamic Ad Target Condition 2

Dynamic Ad Target Condition 2

The second condition that determines whether a webpage property (e.g., URL, content, title) matches the dynamic ad target.

dimension

Dynamic Ad Target Condition 3

Dynamic Ad Target Condition 3

The third condition that determines whether a webpage property (e.g., URL, content, title) matches the dynamic ad target.

dimension

Dynamic Ad Target Condition Operator 1

Dynamic Ad Target Condition Operator 1

The operator used with the first dynamic ad target condition (e.g., ‘contains’, ‘equals’).

dimension

Dynamic Ad Target Condition Operator 2

Dynamic Ad Target Condition Operator 2

The operator used with the second dynamic ad target condition (e.g., ‘contains’, ‘equals’).

dimension

Dynamic Ad Target Condition Operator 3

Dynamic Ad Target Condition Operator 3

The operator used with the third dynamic ad target condition (e.g., ‘contains’, ‘equals’).

dimension

Dynamic Ad Target Value 1

Dynamic Ad Target Value 1

The value used with the first dynamic ad target condition to target webpages (e.g., a specific URL, category, page title, or page content).

dimension

Dynamic Ad Target Value 2

Dynamic Ad Target Value 2

The value used with the second dynamic ad target condition to target webpages.

dimension

Dynamic Ad Target Value 3

Dynamic Ad Target Value 3

The value used with the third dynamic ad target condition to target webpages.

dimension

Dynamic Description Enabled

Dynamic Description Enabled

Indicates whether dynamic descriptions are enabled for an ad. This allows the system to automatically generate descriptive text.

dimension

Editorial Reason Code

Editorial Reason Code

A code that defines the reason why an ad, keyword, or ad extension failed editorial review.

dimension

Editorial Status

Editorial Status

The editorial review status of the ad, indicating whether it’s pending review, approved, or disapproved.

dimension

End Date

End Date

The date when the campaign or other scheduled entity will stop running.

dimension

EndDate

EndDate

The scheduled end date for an entity or the end date for reported data.

dimension

Entity Type

Entity Type

dimension

Error

Error

An error message or code from an API operation.

dimension

Error Detail

Error Detail

Additional details describing an error.

dimension

Error Number

Error Number

A numeric code associated with an error.

dimension

ExactMatchImpressionSharePercent

ExactMatchImpressionSharePercent

The estimated percentage of impressions from searches that exactly matched your keyword, out of the total available exact match impressions it was eligible to receive.

metric

Exclude From Bidding

Exclude From Bidding

Indicates if the conversion goal is excluded from bidding optimization calculations.

dimension

ExpectedCtr

ExpectedCtr

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

metric

Experiment Campaign Id

Experiment Campaign Id

The unique identifier of the campaign created as a copy of the base campaign for an experiment.

dimension

Experiment Id

Experiment Id

The unique identifier for an advertising experiment.

dimension

Experiment Type

Experiment Type

dimension

ExtendedCost

ExtendedCost

The total cost incurred for advertising, representing the spend for a specific period or entity.

metric

Feed Id

Feed Id

The unique identifier for a feed, such as a product feed or page feed.

dimension

Final Mobile Url 1

Final Mobile Url 1

The first mobile landing page URL where users are directed after clicking an ad.

dimension

Final Mobile Url 2

Final Mobile Url 2

The second mobile landing page URL where users are directed after clicking an ad.

dimension

Final Mobile Url 3

Final Mobile Url 3

The third mobile landing page URL where users are directed after clicking an ad.

dimension

Final Mobile Url 4

Final Mobile Url 4

The fourth mobile landing page URL where users are directed after clicking an ad.

dimension

Final Mobile Url 5

Final Mobile Url 5

The fifth mobile landing page URL where users are directed after clicking an ad.

dimension

Final Mobile Url 6

Final Mobile Url 6

The sixth mobile landing page URL where users are directed after clicking an ad.

dimension

Final Mobile Url 7

Final Mobile Url 7

The seventh mobile landing page URL where users are directed after clicking an ad.

dimension

Final Mobile Url 8

Final Mobile Url 8

The eighth mobile landing page URL where users are directed after clicking an ad.

dimension

Final Url

Final Url

The last or final URL where a user is ultimately taken after clicking an ad.

dimension

Final Url 1

Final Url 1

The first final URL where users are ultimately taken after clicking an ad.

dimension

Final Url 2

Final Url 2

The second final URL where users are ultimately taken after clicking an ad.

dimension

Final Url 3

Final Url 3

The third final URL where users are ultimately taken after clicking an ad.

dimension

Final Url 4

Final Url 4

The fourth final URL where users are ultimately taken after clicking an ad.

dimension

Final Url 5

Final Url 5

The fifth final URL where users are ultimately taken after clicking an ad.

dimension

Final Url 6

Final Url 6

The sixth final URL where users are ultimately taken after clicking an ad.

dimension

Final Url 7

Final Url 7

The seventh final URL where users are ultimately taken after clicking an ad.

dimension

Final Url 8

Final Url 8

The eighth final URL where users are ultimately taken after clicking an ad.

dimension

Final Url Suffix

Final Url Suffix

Tracking parameters appended to the end of the landing page URL.

dimension

FinalAppUrl

FinalAppUrl

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

dimension

FinalMobileUrl

FinalMobileUrl

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

dimension

FinalUrl

FinalUrl

The landing page URL where customers are taken after clicking the ad.

dimension

FinalUrlSuffix

FinalUrlSuffix

Additional tracking parameters appended to the final URL.

dimension

FirstPageBid

FirstPageBid

Based on campaign performance and marketplace dynamics, this estimate is the bid amount that Microsoft Advertising calculates for your ad to be placed on the first page sidebar in the search results.

metric

Frequency Cap Settings

Frequency Cap Settings

dimension

FridayHours

FridayHours

The scheduled hours during which ads are eligible to be shown on Fridays.

dimension

From Hour

From Hour

The starting hour for an ad schedule time range.

dimension

From Minute

From Minute

The starting minute for an ad schedule time range.

dimension

Gender

Gender

Audience targeting criterion specifying gender (Male, Female) for ad delivery.

dimension

Gender Types

Gender Types

The gender types targeted by the ad.

dimension

Goal

Goal

The name of the campaign analytics goal for tracking potential land, browse, prospect, and conversion steps.

dimension

Goal Id

Goal Id

The unique identifier of a conversion goal.

dimension

GoalId

GoalId

The unique identifier of a conversion goal.

dimension

GoalType

GoalType

The type or category of a conversion goal (e.g., purchase, lead, sign-up).

dimension

Header 1

Header 1

The first headline or title part of an ad.

dimension

Header 2

Header 2

The second headline or title part of an ad.

dimension

Header 3

Header 3

The third headline or title part of an ad.

dimension

Header 4

Header 4

The fourth headline or title part of an ad.

dimension

Header 5

Header 5

The fifth headline or title part of an ad.

dimension

Header 6

Header 6

The sixth headline or title part of an ad.

dimension

Header 7

Header 7

The seventh headline or title part of an ad.

dimension

Header 8

Header 8

The eighth headline or title part of an ad.

dimension

Headline

Headline

The main headline text of the ad.

dimension

Headlines

Headlines

The main titles or headlines of the ad.

dimension

HistoricalAdRelevance

HistoricalAdRelevance

The historical measure of how relevant an ad is to the keyword and user’s search query.

metric

HistoricalExpectedCtr

HistoricalExpectedCtr

A historical prediction of the click-through rate for an ad or keyword, used for campaign optimization.

metric

HistoricalLandingPageExperience

HistoricalLandingPageExperience

The historical measure of how relevant and useful an ad’s landing page is to people who click your ad.

metric

HistoricalQualityScore

HistoricalQualityScore

The historical overall quality score of a keyword, determining ad rank and cost per click.

metric

Hotel Ad Group Type

Hotel Ad Group Type

The specific type of ad group used for Hotel Ads, primarily for organizing hotel listings.

dimension

Hour

Hour

The hour component of a time, used for scheduling or report aggregation (0-23 for start, 0-24 for end).

dimension

Id

Id

The unique Microsoft Advertising identifier for the entity.

dimension

Impression Tracking Urls

Impression Tracking Urls

dimension

ImpressionLostToBudgetPercent

ImpressionLostToBudgetPercent

The estimated percentage of impressions lost due to an insufficient budget.

metric

ImpressionLostToRankAggPercent

ImpressionLostToRankAggPercent

The estimated percentage of potential ad impressions that were not achieved due to a low ad rank, which is influenced by factors like bid, quality, and ad formats.

metric

ImpressionSharePercent

ImpressionSharePercent

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

metric

Impressions

Impressions

The number of times an ad was displayed.

metric

Include View Through Conversions

Include View Through Conversions

Indicates whether view-through conversions are included in conversion reporting.

dimension

Inherited Bid Strategy Type

Inherited Bid Strategy Type

The bid strategy type inherited from a higher-level entity, such as the campaign.

dimension

Is Deal Campaign

Is Deal Campaign

dimension

Job Function

Job Function

dimension

Keyword

Keyword

The keyword text that triggered the ad.

dimension

Keyword Relevance

Keyword Relevance

A measure of how well a keyword competes against other keywords targeting the same traffic.

dimension

KeywordId

KeywordId

The unique system-generated identifier of the keyword.

dimension

KeywordLabels

KeywordLabels

These are the labels you applied to keywords.

dimension

KeywordStatus

KeywordStatus

The status of the keyword (e.g., Active, Paused, Deleted).

dimension

Label

Label

A custom tag used to organize campaigns, ad groups, ads, or keywords for filtering and reporting.

dimension

Landing Page Relevance

Landing Page Relevance

A measure of how relevant the landing page is to the ad and search query.

dimension

Landing Page User Experience

Landing Page User Experience

A measure of the quality of the user experience on the landing page.

dimension

LandingPageExperience

LandingPageExperience

A component of Quality Score, measuring the relevance and usefulness of an ad’s landing page.

metric

Language

Language

The language targeted by the campaign or ad group.

dimension

LastModifiedTime

LastModifiedTime

The date and time when an entity was last modified or when a data record was generated.

dimension

LastModifiedTime_Date

LastModifiedTime_Date

The date component of when an entity was last modified or when a data record was generated.

dimension

Latitude

Latitude

dimension

LocationId

LocationId

The unique identifier for a geographical location.

metric

LocationType

LocationType

The type of geographical location, such as country, state, city, or county.

dimension

Long Headline

Long Headline

A longer headline text used in certain ad formats, such as Responsive Search Ads.

dimension

Long Headlines

Long Headlines

An array of longer headline texts for an ad.

dimension

LongHeadline

LongHeadline

A longer headline text variant for responsive search ads.

dimension

Longitude

Longitude

dimension

LowQualityClicks

LowQualityClicks

The number of low-quality clicks on ads.

metric

LowQualityClicksPercent

LowQualityClicksPercent

The percentage of low-quality clicks.

metric

LowQualityConversionRate

LowQualityConversionRate

The rate of conversions determined to be of low quality.

metric

LowQualityConversions

LowQualityConversions

The number of low-quality conversions recorded.

metric

LowQualityGeneralClicks

LowQualityGeneralClicks

The number of generally low-quality clicks on ads.

metric

LowQualityImpressions

LowQualityImpressions

The number of low-quality ad impressions.

metric

LowQualityImpressionsPercent

LowQualityImpressionsPercent

The percentage of low-quality impressions.

metric

LowQualitySophisticatedClicks

LowQualitySophisticatedClicks

The number of sophisticated but low-quality clicks on ads.

metric

Match Type

Match Type

The keyword match type, such as Broad, Exact, or Phrase.

dimension

Maximum Bid

Maximum Bid

The maximum amount allowed for a bid.

dimension

Mcpa Bid

Mcpa Bid

dimension

MerchantProductId

MerchantProductId

The unique identifier for a product within your Microsoft Merchant Center store product catalog. This ID is used for reporting analytics in Microsoft Shopping Campaigns.

dimension

MetroArea

MetroArea

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

dimension

Microsoft Click Id

Microsoft Click Id

dimension

Mobile Final Url

Mobile Final Url

The mobile landing page URL where a user is ultimately taken after clicking an ad.

dimension

Modified Time

Modified Time

The date and time when the entity was last modified.

dimension

MondayHours

MondayHours

The scheduled hours during which ads are eligible to be shown on Mondays.

dimension

MostSpecificLocation

MostSpecificLocation

The most granular geographical location targeted by an ad or campaign.

dimension

Name

Name

The name of the entity.

dimension

Network

Network

The advertising network where the ad was shown (e.g., owned and operated, syndicated search).

dimension

Network Distribution

Network Distribution

The network where the ads are shown, such as the Microsoft Advertising Network or partner traffic.

dimension

Page Feed Ids

Page Feed Ids

The identifiers for page feeds used in dynamic ads or Performance Max campaigns.

dimension

Param1

Param1

The first custom parameter used for URL tracking or dynamic content.

dimension

Param2

Param2

The second custom parameter used for URL tracking or dynamic content.

dimension

Param3

Param3

The third custom parameter used for URL tracking or dynamic content.

dimension

Parent Account Id

Parent Account Id

The identifier of the parent account in an account hierarchy.

metric

Parent Criterion Id

Parent Criterion Id

The unique identifier of the parent criterion in a hierarchical targeting structure.

dimension

Parent Id

Parent Id

The identifier of the parent entity, used to establish hierarchical relationships.

dimension

Path 1

Path 1

The first optional display path shown in the ad’s URL.

dimension

Path 2

Path 2

The second optional display path shown in the ad’s URL.

dimension

Path1

Path1

A shorter or “friendlier” version of your URL address that appears in your ads, as the first subdirectory.

dimension

Path2

Path2

A shorter or “friendlier” version of your URL address that appears in your ads, as the second subdirectory.

dimension

Percent Cpc Bid

Percent Cpc Bid

The percentage of Cost Per Click (CPC) used for bidding, typically for hotel campaigns.

dimension

Phone Number

Phone Number

The phone number displayed in a call ad or call extension.

dimension

PhoneCalls

PhoneCalls

The number of phone calls generated by ads or ad extensions.

metric

PhoneImpressions

PhoneImpressions

The number of impressions for phone numbers displayed in ads or extensions.

metric

Placement

Placement

The specific location on a webpage or app where an ad is displayed.

dimension

Postal Code

Postal Code

The postal code for a geographical target.

dimension

PostalCode

PostalCode

The postal code for a geographical target.

dimension

Price 1

Price 1

The first price component or value associated with a product or service in an ad.

dimension

Price 2

Price 2

The second price component or value associated with a product or service in an ad.

dimension

Price 3

Price 3

The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.

dimension

Price 4

Price 4

The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.

dimension

Price 5

Price 5

The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.

dimension

Price 6

Price 6

The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.

dimension

Price 7

Price 7

The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.

dimension

Price 8

Price 8

The advertised price for a specific item within a Price Ad Extension. These fields represent individual price entries in a price table, allowing up to 8 entries.

dimension

Price Description 1

Price Description 1

A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.

dimension

Price Description 2

Price Description 2

A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.

dimension

Price Description 3

Price Description 3

A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.

dimension

Price Description 4

Price Description 4

A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.

dimension

Price Description 5

Price Description 5

A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.

dimension

Price Description 6

Price Description 6

A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.

dimension

Price Description 7

Price Description 7

A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.

dimension

Price Description 8

Price Description 8

A short description providing more information about a specific price item within a Price Ad Extension, with a maximum length of 25 characters.

dimension

Price Extension Type

Price Extension Type

The type of price ad extension, determining how prices are displayed (e.g., “From”, “Up To”, “Average”).

dimension

Price Qualifier 1

Price Qualifier 1

The qualifier text (e.g., “From”, “Up To”, “Average”) that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.

dimension

Price Qualifier 2

Price Qualifier 2

The qualifier text (e.g., “From”, “Up To”, “Average”) that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.

dimension

Price Qualifier 3

Price Qualifier 3

The qualifier text (e.g., “From”, “Up To”, “Average”) that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.

dimension

Price Qualifier 4

Price Qualifier 4

The qualifier text (e.g., “From”, “Up To”, “Average”) that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.

dimension

Price Qualifier 5

Price Qualifier 5

The qualifier text (e.g., “From”, “Up To”, “Average”) that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.

dimension

Price Qualifier 6

Price Qualifier 6

The qualifier text (e.g., “From”, “Up To”, “Average”) that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.

dimension

Price Qualifier 7

Price Qualifier 7

The qualifier text (e.g., “From”, “Up To”, “Average”) that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.

dimension

Price Qualifier 8

Price Qualifier 8

The qualifier text (e.g., “From”, “Up To”, “Average”) that precedes the price in a Price Ad Extension, indicating how the price should be interpreted.

dimension

Price Unit 1

Price Unit 1

The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension.

dimension

Price Unit 2

Price Unit 2

The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension.

dimension

Price Unit 3

Price Unit 3

The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension.

dimension

Price Unit 4

Price Unit 4

The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension.

dimension

Price Unit 5

Price Unit 5

The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension.

dimension

Price Unit 6

Price Unit 6

The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension.

dimension

Price Unit 7

Price Unit 7

The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension.

dimension

Price Unit 8

Price Unit 8

The unit of time or measure (e.g., “Per Day”, “Per Hour”) associated with the price in a Price Ad Extension.

dimension

Priority

Priority

The priority of a shopping campaign, determining which campaign serves ads when multiple campaigns target the same product.

dimension

Product Condition 1

Product Condition 1

A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”.

dimension

Product Condition 2

Product Condition 2

A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”.

dimension

Product Condition 3

Product Condition 3

A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”.

dimension

Product Condition 4

Product Condition 4

A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”.

dimension

Product Condition 5

Product Condition 5

A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”.

dimension

Product Condition 6

Product Condition 6

A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”.

dimension

Product Condition 7

Product Condition 7

A condition used in Shopping Campaigns to filter products from a Microsoft Merchant Center catalog, such as “New”, “Used”, or “Refurbished”.

dimension

Product Value 1

Product Value 1

The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand.

dimension

Product Value 2

Product Value 2

The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand.

dimension

Product Value 3

Product Value 3

The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand.

dimension

Product Value 4

Product Value 4

The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand.

dimension

Product Value 5

Product Value 5

The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand.

dimension

Product Value 6

Product Value 6

The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand.

dimension

Product Value 7

Product Value 7

The specific attribute value that a product must match to satisfy a product condition, for example, “Contoso” for the “Brand” operand.

dimension

ProductCategory1

ProductCategory1

A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.

dimension

ProductCategory2

ProductCategory2

A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.

dimension

ProductCategory3

ProductCategory3

A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.

dimension

ProductCategory4

ProductCategory4

A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.

dimension

ProductCategory5

ProductCategory5

A category level (1-5) used to classify products in a product catalog, often for reporting and targeting in shopping campaigns.

dimension

ProductType1

ProductType1

A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.

dimension

ProductType2

ProductType2

A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.

dimension

ProductType3

ProductType3

A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.

dimension

ProductType4

ProductType4

A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.

dimension

ProductType5

ProductType5

A classification of a product (Product Type 1 being the broadest, Product Type 5 the most granular) as defined by the merchant in their product catalog.

dimension

ProximityTargetLocation

ProximityTargetLocation

A geographical location used as the center point for radius targeting.

dimension

PublisherUrl

PublisherUrl

dimension

Purchases

Purchases

The number of purchase conversions recorded from advertising campaigns.

metric

Quality Score

Quality Score

A metric (1-10) reflecting the relevance and quality of ads, keywords, and landing pages, impacting ad placement and cost.

dimension

QualityImpact

QualityImpact

A numeric score (0-3) indicating the potential increase in keyword impressions if the Quality Score improves. Higher scores suggest a greater impact on impressions.

metric

QualityScore

QualityScore

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

metric

RSA Auto Generated Assets Enabled

RSA Auto Generated Assets Enabled

Indicates if responsive search ad assets are dynamically generated by the system.

dimension

Radius

Radius

The radius around a target location for geographical targeting.

metric

Report End Date

Report End Date

The end date for the report data.

dimension

Report Start Date

Report Start Date

The start date for the report data.

dimension

ReturnOnAdSpend

ReturnOnAdSpend

The Return on Ad Spend (ROAS), calculated as (Revenue / Spend).

metric

Revenue

Revenue

The total revenue generated from conversions.

metric

Revenue Value

Revenue Value

The revenue value optionally reported by the advertiser as a result of conversions.

dimension

RevenuePerAssist

RevenuePerAssist

Revenue divided by the number of assists.

dimension

RevenuePerConversion

RevenuePerConversion

The revenue generated for each conversion.

dimension

RevenuePerInstall

RevenuePerInstall

The average revenue generated for each app install.

dimension

Sales

Sales

The number of sales attributed to ad activity.

metric

SaturdayHours

SaturdayHours

The scheduled operating hours for Saturday, used for ad extension scheduling.

dimension

Schedule

Schedule

Defines the calendar date and time ranges when an ad extension is eligible to be shown.

dimension

SearchQuery

SearchQuery

The search query entered by the user that triggered an ad.

dimension

Settings.AutoGeneratedAssetsEnabled_1

Settings.AutoGeneratedAssetsEnabled_1

Indicates whether assets are dynamically generated for Performance Max campaigns.

dimension

Settings.AutoGeneratedAssetsEnabled_2

Settings.AutoGeneratedAssetsEnabled_2

Indicates whether assets are dynamically generated for Performance Max campaigns.

dimension

Settings.AutoGeneratedImageOptOut_1

Settings.AutoGeneratedImageOptOut_1

Indicates if auto-generated image assets are opted out for Performance Max campaigns.

dimension

Settings.AutoGeneratedTextOptOut_1

Settings.AutoGeneratedTextOptOut_1

Indicates if auto-generated text assets are opted out for Performance Max campaigns.

dimension

Settings.CostPerSaleOptOut_1

Settings.CostPerSaleOptOut_1

Indicates if bidding is opted out of cost per sale for Performance Max campaigns.

dimension

Settings.Details.TargetSettingDetail_1

Settings.Details.TargetSettingDetail_1

dimension

Settings.Details.TargetSettingDetail_2

Settings.Details.TargetSettingDetail_2

dimension

Settings.Details.TargetSettingDetail_3

Settings.Details.TargetSettingDetail_3

dimension

Settings.DisclaimerAdsEnabled_1

Settings.DisclaimerAdsEnabled_1

A setting indicating if disclaimer ads are enabled.

dimension

Settings.FinalUrlExpansionOptOut_1

Settings.FinalUrlExpansionOptOut_1

For Performance Max campaigns, indicates if final URL expansion is opted out, meaning only specified final URLs will be targeted.

dimension

Settings.PageFeedIds_1

Settings.PageFeedIds_1

The identifiers for page feeds used in Performance Max campaigns.

dimension

Settings.Type_1

Settings.Type_1

dimension

Settings.Type_2

Settings.Type_2

dimension

Settings.Type_3

Settings.Type_3

dimension

Sitelink Extension Description1

Sitelink Extension Description1

An additional line of descriptive text for a Sitelink Ad Extension, providing more detail about the linked page. Maximum length is 35 characters.

dimension

Sitelink Extension Description2

Sitelink Extension Description2

An additional line of descriptive text for a Sitelink Ad Extension, providing more detail about the linked page. Maximum length is 35 characters.

dimension

Sitelink Extension Destination Url

Sitelink Extension Destination Url

The URL where users are directed when they click on a Sitelink Ad Extension.

dimension

Sitelink Extension Link Text

Sitelink Extension Link Text

The clickable text displayed for a Sitelink Ad Extension.

dimension

Sitelink Extension Order

Sitelink Extension Order

The order in which Sitelink Extensions are expected to be displayed within an ad.

dimension

Source

Source

The source of content for dynamic search ads or the origin of campaign data.

dimension

Spend

Spend

The total cost of clicks on an ad.

metric

Start Date

Start Date

The date when an entity, such as an ad extension or campaign, is scheduled to begin serving.

dimension

StartDate

StartDate

The scheduled start date for an entity or the start date for reported data.

dimension

State

State

The state or province where the impression, click, or conversion occurred.

dimension

State Or Province Code

State Or Province Code

The geographical code for a state or province, used for location targeting in campaigns.

dimension

Status

Status

The current status of the entity (e.g., Active, Paused, Deleted).

dimension

Store Id

Store Id

The name of the store you created in Microsoft Merchant Center that contains your offers for this campaign.

dimension

StoreCode

StoreCode

A unique code identifying a physical store location, typically used in local campaigns.

dimension

Structured Snippet Header

Structured Snippet Header

The header for a Structured Snippet Ad Extension, which categorizes the associated snippet values (e.g., “Brands”, “Services”).

dimension

Structured Snippet Values

Structured Snippet Values

A list of values associated with a Structured Snippet Header, providing specific examples or details (e.g., “Windows, Xbox, Skype” for a “Brands” header).

dimension

Sub Type

Sub Type

A more granular classification for a campaign or ad group, providing additional context beyond the main “Type” field (e.g., “ShoppingSmartAds” for a Shopping campaign).

dimension

SundayHours

SundayHours

The scheduled operating hours for Sunday, used for ad extension scheduling.

dimension

Target Ad Group Id

Target Ad Group Id

The unique identifier of the ad group that is the target of an action or report.

dimension

Target Campaign Id

Target Campaign Id

The unique identifier of the campaign that is the target of an action or report.

dimension

Target Setting

Target Setting

Defines the targeting options for criteria groups (e.g., Age, Gender), specifying whether to “target and bid” or “bid only” for those audiences.

dimension

Text

Text

The main body text or description of an ad.

dimension

ThursdayHours

ThursdayHours

The scheduled operating hours for Thursday, used for ad extension scheduling.

dimension

Time Zone

Time Zone

The time zone used for campaign operations, ad scheduling, and report aggregation.

dimension

TimePeriod

TimePeriod

The aggregation period for report data, such as daily, weekly, or monthly.

dimension

TimeStamp

TimeStamp

The date and time of a data record, often indicating when the data was captured or generated.

dimension

TimeZone

TimeZone

The time zone used for campaign operations, ad scheduling, and report aggregation.

dimension

Title

Title

The title of an ad or asset.

dimension

Title Part 1

Title Part 1

Components of the ad title, allowing for multiple headlines to be displayed in Expanded Text Ads.

dimension

Title Part 2

Title Part 2

Components of the ad title, allowing for multiple headlines to be displayed in Expanded Text Ads.

dimension

Title Part 3

Title Part 3

Components of the ad title, allowing for multiple headlines to be displayed in Expanded Text Ads.

dimension

TitlePart1

TitlePart1

In Expanded Text ads, Ad title 1 is the first line of the most prominent part of your ad that links to your website.

dimension

TitlePart2

TitlePart2

This is the second line of the most prominent part of your ad that links to your website.

dimension

TitlePart3

TitlePart3

This is the third line of the most prominent part of your ad that links to your website.

dimension

To Hour

To Hour

The ending hour of a scheduled time range for ad delivery, on a 24-hour clock (0-24).

dimension

To Minute

To Minute

The ending minute of a scheduled time range for ad delivery, ranging from 0 to 60.

dimension

TopImpressionRatePercent

TopImpressionRatePercent

The percentage of times an ad appeared in the mainline (top placement above search results) out of its total impressions. This indicates how changes in ad position can impact performance.

metric

TopImpressionShareLostToBudgetPercent

TopImpressionShareLostToBudgetPercent

The estimated percentage of times an ad failed to show in the top ad positions (above organic search results) due to an insufficient budget.

metric

TopImpressionShareLostToRankPercent

TopImpressionShareLostToRankPercent

The estimated percentage of mainline impressions (ads appearing above search results) lost due to poor ad rank. This metric helps assess why ads are missing out on optimal ad positions.

metric

TopImpressionSharePercent

TopImpressionSharePercent

The percentage of estimated available impressions in the top positions that an ad received. (first search)

metric

TopVsOther

TopVsOther

The position (mainline vs. bottom or sidebar) of your ad on a Bing, AOL, or Yahoo search results page.

dimension

TotalClicks

TotalClicks

The total number of clicks received by an ad or other entity.

metric

TotalWatchTimeInMS

TotalWatchTimeInMS

The total watch time of videos in milliseconds.

metric

Tracking Template

Tracking Template

A URL template that contains tracking parameters, which are appended to landing page URLs to collect data about ad clicks.

dimension

TrackingTemplate

TrackingTemplate

The URL template used for tracking clicks and other metrics.

dimension

TrackingUrlTemplate

TrackingUrlTemplate

The tracking template used as a default for all landing page URLs.

dimension

TuesdayHours

TuesdayHours

The scheduled operating hours for Tuesday, used for ad extension scheduling.

dimension

Type

Type

The classification or category of an entity, such as an ad, campaign, or ad extension.

dimension

UET Tag Id

UET Tag Id

The unique identifier for a Universal Event Tracking (UET) tag, used to track website actions and conversions.

dimension

Url

Url

A web address associated with an advertising entity, such as a landing page or an ad extension.

dimension

UrlCustomParameters

UrlCustomParameters

A collection of key-value custom parameters for URL tracking.

dimension

Use MaxClicks

Use MaxClicks

Indicates whether the Maximize Clicks bid strategy is employed for a campaign.

dimension

Use Searcher Time Zone

Use Searcher Time Zone

A setting that determines whether ad scheduling should use the searcher’s local time zone instead of the account’s time zone.

dimension

Version

Version

A version number that tracks updates made to an entity, typically an ad extension.

dimension

Video Id

Video Id

The unique identifier for a video asset.

dimension

Video Url

Video Url

The URL of a video asset.

dimension

VideoCompletionRate

VideoCompletionRate

The rate at which video ads are completed by viewers.

metric

VideoViews

VideoViews

The total number of times a video ad was played.

metric

VideoViewsAt25Percent

VideoViewsAt25Percent

The number of times a video ad was played to at least 25% of its total duration.

metric

VideoViewsAt50Percent

VideoViewsAt50Percent

The number of times a video ad was played to at least 50% of its total duration.

metric

VideoViewsAt75Percent

VideoViewsAt75Percent

The number of times a video ad was played to at least 75% of its total duration.

metric

ViewThroughConversions

ViewThroughConversions

The number of view-through conversions, where a user saw an ad but did not click, then converted later.

metric

ViewThroughConversionsQualified

ViewThroughConversionsQualified

The number of view-through conversions, which occur when a customer converts after seeing an ad but without clicking it. These are specifically counted for ads on the Microsoft Audience network.

dimension

ViewThroughRevenue

ViewThroughRevenue

The revenue amount optionally reported by the advertiser as a result of view-through conversions (conversions that occur after a user sees an ad but does not click it).

metric

WednesdayHours

WednesdayHours

The scheduled operating hours for Wednesday, used for ad extension scheduling.

dimension

Year

Year

The year for the reported data.

dimension

YearMonth

YearMonth

The year and month for the reported data.

metric

account_id

account_id

The unique identifier for the advertising account.

dimension

account_name

account_name

The name of the advertising account.

dimension

ad_group_id

ad_group_id

The unique identifier for the ad group.

dimension

ad_group_name

ad_group_name

The name of the ad group.

dimension

ad_network

ad_network

The advertising network where ads are eligible to be displayed (e.g., Microsoft Audience Network, search partners).

dimension

campaign_day

campaign_day

The day component of a campaign’s performance data, typically used for report aggregation.

dimension

campaign_id

campaign_id

The unique identifier for the advertising campaign.

dimension

campaign_month

campaign_month

The month component of a campaign’s performance data, typically used for report aggregation.

dimension

campaign_name

campaign_name

The name of the advertising campaign.

dimension

campaign_type

campaign_type

The classification of an advertising campaign (e.g., Search, Shopping, Audience, Performance Max).

dimension

campaign_year

campaign_year

The year component of a campaign’s performance data, typically used for report aggregation.

dimension

clicks

clicks

The number of times users clicked on an ad.

metric

conversions

conversions

The number of desired actions (e.g., purchases, leads) completed by users after clicking an ad.

metric

date

date

The date for which performance data is reported.

dimension

day

day

The day component of a date for which performance data is reported.

dimension

device_type

device_type

The type of device (e.g., Computer, Smartphone, Tablet) on which an ad was displayed.

dimension

hour

hour

The hour component of a time for which performance data is reported.

dimension

impressions

impressions

The number of times an ad was displayed to users.

metric

network

network

The advertising network where ads are eligible to be displayed (e.g., Microsoft Audience Network, search partners).

dimension

spend

spend

The total cost incurred for advertising campaigns in the account’s currency.

metric