Windsor brings all your Bing Ads/Microsoft Ads data into Power BI, Looker Studio, Google Sheets, Excel, BigQuery, Snowflake, Tableau, PostgreSQL, MySQL, Python, Amazon S3, Azure, Azure MS SQL
Bing Ads/Microsoft Ads Field Reference
Sample
https://connectors.windsor.ai/bing?api_key=[your API key]&date_preset=last_7d&fields=campaign,clicks,spend,impressions,date,source
Fields
| ID | Type | Name | Description | Reports |
|---|---|---|---|---|
| absolute_top_impression_rate_percent | PERCENT | Absolute Top Impression Rate Percent | How often your ad was in the first position of all results, as a percentage of your total impressions. | ad_performance; campaign_performance; keyword_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| absolute_top_impression_share_lost_to_budget | NUMERIC | Absolute Top Impression Lost To Budget | Absolute Top Impression Lost To Budget | campaign_performance; |
| absolute_top_impression_share_lost_to_budget_percent | PERCENT | Absolute Top Impression Share Lost To Budget Percent | The estimated percentage of how often your ad missed showing in the very top ad position, above search results, due to insufficient budget. | campaign_performance; ad_group_performance; |
| absolute_top_impression_share_lost_to_rank | NUMERIC | Absolute Top Impression Lost To Rank | Absolute Top Impression Lost To Rank | campaign_performance; |
| absolute_top_impression_share_lost_to_rank_percent | PERCENT | Absolute Top Impression Share Lost To Rank Percent | 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. | campaign_performance; ad_group_performance; |
| absolute_top_impression_share_percent | PERCENT | Absolute Top Impression Share Percent | The estimated percentage of times your ad was in the first position of all results, out of the estimated number of first position impressions you were eligible to receive. | campaign_performance; |
| absolute_top_impressions | NUMERIC | Absolute Top Impressions | Absolute Top Impressions | ad_performance; campaign_performance; keyword_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| account_id | TEXT | Account ID | The account id | ad_performance; campaign_performance; keyword_performance; conversion_performance; budget_summary; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; |
| account_name | TEXT | Account Name | The account name | ad_performance; campaign_performance; keyword_performance; conversion_performance; budget_summary; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| account_number | TEXT | Account Number | The Microsoft Advertising assigned number of an account. | ad_performance; campaign_performance; keyword_performance; conversion_performance; budget_summary; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| account_status | TEXT | Account Status | The account status | ad_performance; campaign_performance; keyword_performance; conversion_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; product_dimension_performance; |
| ad_description | TEXT | Ad Description | The first ad description that appears below the path in your ad. | ad_performance; |
| ad_description2 | TEXT | Ad Description 2 | The second ad description that appears below the path in your ad. Ad description 2 might not appear in your ad. | ad_performance; |
| ad_distribution | TEXT | Ad Distribution | The network where you want your ads to show. This can be the entire Microsoft Advertising Network, Microsoft sites and select traffic, or only partner traffic. | user_location_performance; age_gender_report; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| ad_group_current_status | TEXT | Ad Group Current Status | The current ad group status. | ad_group_performance; |
| ad_group_id | TEXT | Ad group ID | The ID of the AdGroup. | ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| ad_group_name | TEXT | Ad group | The name of the AdGroup. | ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| ad_group_status | TEXT | Ad Group Status | The Ad Group status. | ad_performance; keyword_performance; conversion_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; product_dimension_performance; |
| ad_group_type | TEXT | Ad Group Type | The ad group type. In a Search campaign, the possible values are 'SearchDynamic' and 'SearchStandard'. The field will be empty for other campaign types. | ad_group_performance; |
| ad_id | TEXT | Ad ID | The ad id | ad_performance; dsa_auto_target_performance; dsa_search_query_performance; product_dimension_performance; |
| ad_labels | TEXT | Ad Labels | The labels applied to the ad. Delimited by a semicolon (;). | ad_performance; |
| ad_long_headline | TEXT | Long Headline | The longer of two possible responsive ad headlines for Audience campaigns. | ad_performance; |
| ad_path_1 | TEXT | Ad Path 1 | The path 1 attribute of an ad. | ad_performance; |
| ad_path_2 | TEXT | Ad Path 2 | The path 2 attribute of an ad. | ad_performance; |
| ad_quality_score | NUMERIC | Quality Score | The numeric score shows you how competitive your ads are in the marketplace by measuring how relevant your keywords and landing pages are to customers' search terms. The quality score is calculated by Microsoft Advertising using the ExpectedCtr, AdRelevance, and LandingPageExperience sub scores. If available, the quality score can range from a low of 1 to a high of 10. Quality score is based on the last rolling 30 days for the owned and operated search traffic. A quality score can be assigned without any impressions, in the case where a keyword bid did not win any auctions. The score is calculated only based on Search Traffic. The value in the report will be null if the score was not computed. This can occur if there have been no impressions for the keyword for 30 days or more. Quality score is typically updated 14-18 hours after the UTC day ends. Keywords in all time zones will be assigned a quality score for the corresponding UTC day. If you run the report multiple times in a day, the quality score values could change from report to report based on when you run the report relative to when the scores are calculated. If you specify a time period that spans multiple days, the quality score is the current and most recently calculated score and will be reported as the same for each day in the time period. | campaign_performance; keyword_performance; ad_group_performance; |
| ad_relevance | TEXT | Ad Relevance | How closely related your ads is to the customer's search query or other input. It tells you how relevant your ad and landing page are to potential customers. | campaign_performance; keyword_performance; ad_group_performance; |
| ad_short_headline | TEXT | Headline | The shorter of two possible responsive ad headlines for Audience campaigns. | ad_performance; |
| ad_status | TEXT | Ad Status (Bing) | The ad status. | ad_performance; dsa_search_query_performance; product_dimension_performance; |
| ad_title | TEXT | Ad Title | The ad title | ad_performance; |
| ad_title_part_1 | TEXT | Title Part 1 | The title part 1 attribute of an ad. | ad_performance; |
| ad_title_part_2 | TEXT | Title Part 2 | The title part 2 attribute of an ad. | ad_performance; |
| ad_title_part_3 | TEXT | Title Part 3 | The title part 3 attribute of an ad. | ad_performance; |
| ad_type | TEXT | Ad Type | The ad type. | ad_performance; keyword_performance; |
| adnetwork_conversions | NUMERIC | Ad Network Conversions | The ad network reported conversions | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| adnetwork_revenue | NUMERIC | Ad Network Revenue | The ad network reported revenue | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| age_group | TEXT | Age Group | The age group of the audience who viewed the ad. The possible values are 13-17, 18-24, 25-34, 35-49, 50-64, and 65+. | age_gender_report; |
| all_conversion_rate | PERCENT | All Conversion Rate | The conversion rate as a percentage. | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| all_conversions | NUMERIC | All Conversions | The number of conversions. This column is deprecated in 2022,; so you should use the all_conversions_qualified column instead. Going forward,; performance reports will return '0' (zero) in this column.; | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| all_conversions_qualified | NUMERIC | All Conversions Qualified | The number of conversions. | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| all_cost_per_conversion | NUMERIC | AllCostPerConversion | The cost per conversion. | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| all_revenue | NUMERIC | All Revenue | The revenue optionally reported by the advertiser as a result of conversions. | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| all_revenue_per_conversion | NUMERIC | All Revenue Per Conversion | The revenue per conversion.The formula for calculating the revenue per conversion is (Revenue / Conversions). | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| all_roas | NUMERIC | AllReturnOnAdSpend | The return on ad spend (ROAS).The formula for calculating the ROAS is (Revenue / Spend). | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| asset_group_id | TEXT | Asset Group ID | The Microsoft Advertising assigned identifier of an asset group. | user_location_performance; product_dimension_performance; |
| asset_group_name | TEXT | Asset Group Name | The asset group name. | user_location_performance; product_dimension_performance; |
| asset_group_status | TEXT | Asset Group Status | The asset group status. | product_dimension_performance; |
| assists | NUMERIC | Assists | The number of conversions from other ads within the same account that were preceded by one or; more clicks from this ad. An ad is considered to have assisted the conversion if it was clicked; before the most recently clicked ad that was credited with the conversion. Additionally, the; click corresponding to the assist must occur within the conversion period of the goal.; | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; dsa_auto_target_performance; dsa_search_query_performance; |
| association_id | TEXT | Association ID | The Microsoft Advertising assigned identifier of the association between the audience and either an ad group or campaign. | audience_performance; |
| association_level | TEXT | Association Level | The level of the audience's association. The possible values are 'Ad group' or 'Campaign'. | audience_performance; |
| association_status | TEXT | Audience Association Status | The status of the association between the audience and either an ad group or campaign. | audience_performance; |
| audience_id | TEXT | Audience ID | The Microsoft Advertising assigned identifier of the audience, for example the remarketing list ID. | audience_performance; |
| audience_name | TEXT | Audience Name | The audience name. | audience_performance; |
| audience_type | TEXT | Audience Type | The audience type. | audience_performance; |
| average_cpc | NUMERIC | Average CPC | The average cost per click (CPC). The total cost of all clicks on an ad divided by the number of clicks. This is the average amount you're actually charged each time your ad is clicked. | ad_performance; campaign_performance; keyword_performance; user_location_performance; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| average_cpm | NUMERIC | Average CPM | The total advertising cost divided by the number of impressions (in thousands). | ad_performance; campaign_performance; keyword_performance; user_location_performance; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| average_cpv | NUMERIC | Average CPV | Average total spend divided by video views. | ad_performance; campaign_performance; ad_group_performance; |
| base_campaign_id | TEXT | Base (Experiment) Campaign ID | The Microsoft Advertising assigned identifier of an experiment campaign.; This will be the same value as the CampaignId if the campaign is not an experiment.; | ad_performance; campaign_performance; keyword_performance; age_gender_report; audience_performance; ad_group_performance; |
| bid_adjustment | NUMERIC | Bid Adjustment | This attribute reflects the current value of your ad group's audience bid adjustment,; even if a different bid adjustment value was used when the ad was shown. This value; is the requested percentage to increase or decrease the bid amount for the remarketing list.; | audience_performance; |
| bid_match_type | TEXT | Bid Match Type | The keyword bid match type. This can be different from the DeliveredMatchType column,; for example if you bid on a broad match and the search term was an exact match.; For more information, see Budget and Bid Strategies. The possible values are Broad, Exact, Phrase, and Unknown.; | ad_performance; campaign_performance; keyword_performance; user_location_performance; |
| bid_strategy_type | TEXT | Bid Strategy Type | The bid strategy type. Possible values include EnhancedCpc, ManualCpc, MaxClicks, MaxConversions, and TargetCpa. | keyword_performance; dsa_auto_target_performance; product_dimension_performance; |
| business_name | TEXT | Business Name | Depending on your responsive ad's placement, your business's name may appear in your ad.; This column only applies to Audience campaigns.; | ad_performance; |
| campaign | TEXT | Campaign | The campaign Name | ad_performance; campaign_performance; keyword_performance; conversion_performance; budget_summary; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| campaign_id | TEXT | Campaign ID | The campaign ID | ad_performance; campaign_performance; keyword_performance; conversion_performance; budget_summary; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| campaign_labels | TEXT | Campaign Labels | The labels applied to the campaign. Delimited by a semicolon (;). | campaign_performance; |
| campaign_status | TEXT | Campaign Status | The campaign status. | ad_performance; campaign_performance; keyword_performance; conversion_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; product_dimension_performance; |
| campaign_type | TEXT | Campaign Type | The campaign type. | ad_performance; campaign_performance; user_location_performance; ad_group_performance; product_dimension_performance; |
| city | CITY | City | The city where the user was physically located when they clicked the ad. | user_location_performance; |
| click_share_percent | PERCENT | Click Share Percent | The percentage of clicks that went to your ads. It is the share of the prospective customer's mindshare and buying intent you captured. You can use this performance metric to see where your growth opportunites are. | campaign_performance; ad_group_performace; |
| clicks | NUMERIC | Clicks | The number of clicks | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| conversion_rate | PERCENT | Conversion Rate | The conversion rate as a percentage. | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| conversions | NUMERIC | Conversions | The number of conversions. This column is deprecated in 2022,; so you should use the conversions_qualified column instead. Going forward,; performance reports will return '0' (zero) in this column.; | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| conversions_qualified | NUMERIC | Conversions Qualified | The number of conversions. | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; ad_group_performance; product_dimension_performance; |
| cost_per_conversion | NUMERIC | CostPerConversion | The cost per conversion. | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| cost_per_install | PERCENT | Cost per Install | The cost per install. The formula for calculating the cost per install is (Spend / Installs) | campaign_performance; ad_group_performance; product_dimension_performance; |
| cost_per_sale | PERCENT | Cost per Sale | The cost per sale. The formula for calculating the cost per sale is (Spend / Sales) | campaign_performance; ad_group_performance; product_dimension_performance; |
| country | COUNTRY | Country | The country where the user was physically located when they clicked the ad. | user_location_performance; |
| county | TEXT | County | The county where the user was physically located when they clicked the ad. | user_location_performance; |
| cpa | NUMERIC | Cost Per Assist | The cost per assist. The formula for calculating the CPA is (Spend / Assists). | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; dsa_auto_target_performance; dsa_search_query_performance; |
| ctr | PERCENT | CTR | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| currency | TEXT | Currency | The account currency type. | ad_performance; campaign_performance; keyword_performance; budget_summary; user_location_performance; ad_group_performance; product_dimension_performance; |
| currency_code | TEXT | Currency Code | The account currency type. | ad_performance; campaign_performance; keyword_performance; budget_summary; user_location_performance; ad_group_performance; product_dimension_performance; |
| customer_id | TEXT | Customer ID | The Microsoft Advertising assigned identifier of a customer. | ad_performance; campaign_performance; dsa_search_query_performance; |
| customer_name | TEXT | Customer Name | The customer name. | ad_performance; campaign_performance; dsa_search_query_performance; |
| daily_budget_spend | NUMERIC | Daily Spend | The average amount of campaign budget spent per day. | budget_summary; |
| datasource | TEXT | Data Source | The name of the Windsor connector returning the row | |
| date | DATE | Date | The date | ad_performance; campaign_performance; keyword_performance; conversion_performance; budget_summary; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| day | TEXT | Day | Each row of the report identifies the month, day, and year when the transaction occurred. The report data will be aggregated by each day. The time period will be formatted as yyyy-mm-dd. | campaign_performance; ad_performance; keyword_performance; conversion_performance; budget_summary; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| day_of_month | TEXT | Day of month | Day of the month | |
| day_of_week | TEXT | Day of week | Each row of the report identifies the day of the week when the transaction occurred. The report data will be aggregated by each of the seven days in a week. The possible data values are 1 - 7 where 1 represents Sunday and 7 represents Saturday. If the report time spans multiple weeks, then the performance data across all weeks for a given day of the week will be aggregated in one row. For example if Campaign A has 5 impressions every Monday (day 2) throughout each of the 3 weeks included in the report time range, then the report will include one row with a 2 in the date column and the impressions in that row totaling 15. | campaign_performance; ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| day_of_week_mon | TEXT | Week (Mon-Sun) | Each row of the report identifies the week when the transaction occurred. The report data will be aggregated by each week running from Monday through Sunday. The time period that contains the date of the Monday for each week will be formatted as yyyy-mm-dd. NOTE: partial data aggregation for weekly time period is not supported. If the selected dates are not full weeks and the corresponding weekly time period column is requested, the selected dates will be converted to full weeks. | campaign_performance; ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| delivered_match_type | TEXT | Delivered Match Type | The match type used to deliver an ad. This can be different from the BidMatchType; column, for example if you bid on a broad match and the search term was an exact match.; For more information, see Budget and Bid Strategies. The possible values are Broad, Exact, Phrase, and Unknown.; | ad_performance; campaign_performance; keyword_performance; user_location_performance; |
| destination_url | TEXT | Destination Url | The destination URL attribute of the ad, keyword, or ad group criterion. | ad_performance; keyword_performance; |
| device | TEXT | Device Type | Device type | ad_performance; campaign_performance; keyword_performance; user_location_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| device_os | TEXT | Device OS | The operating system of the device reported in the DeviceType column. The possible values include Android,; Blackberry, iOS, Other, Unknown, and Windows. If the operating system of the device cannot be determined; or is not one of the operating systems that you can target, the value in this column will be Unknown.; | ad_performance; campaign_performance; keyword_performance; user_location_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; |
| display_url | TEXT | Display Url | The ad display URL. | ad_performance; |
| dynamic_ad_target | TEXT | Dynamic Ad Target | The dynamic ad target or webpage condition that Bing matched to your website.; For example the condition could be returned in the report as URL contains xyz.; | dsa_auto_target_performance; dsa_search_query_performance; |
| dynamic_ad_target_id | TEXT | Dynamic Ad Target ID | The Microsoft Advertising assigned identifier of the dynamic ad target,; also known in Campaign Management and Bulk API as the ad group criterion ID.; | dsa_auto_target_performance; dsa_search_query_performance; |
| dynamic_ad_target_status | TEXT | Dynamic Ad Target Status | The current status of the dynamic ad target. | dsa_auto_target_performance; |
| dynamic_search_ad_description | TEXT | Dynamic Ad Description | The dynamic search ad text automatically generated by Microsoft Advertising when DynamicDescriptionEnabled is set to true. | dsa_search_query_performance; |
| dynamic_search_headline | TEXT | Dynamic Search Ad Headline | The Dynamic Search Ad headline that was dynamically generated by Microsoft Advertising. | dsa_search_query_performance; |
| eligible_absolute_top_impressions | NUMERIC | Eligible Absolute Top Impressions | Eligible Absolute Top Impressions | campaign_performance; |
| eligible_top_impressions | NUMERIC | Eligible Top Impressions | Eligible Top Impressions | campaign_performance; |
| expected_ctr | NUMERIC | Expected CTR | How well your keyword competes against other keywords targeting the same traffic. Ads that are relevant to searchers' queries or other input are more likely to have a higher click-through rate. This metric tells you if a keyword is underperforming and causing a loss in impression share, so you can make keyword changes or remove ads altogether. A score of 3 is Above Average; a score of 2 is Average; and a score of 1 is considered Below Average. The score is calculated only based on Search Traffic. The value in the report will be null if the score was not computed. If you specify a time period that spans multiple days, the score will be the same for each day in the time period, and the value is the most recent calculated score. Data for this column is typically updated 14-18 hours after the UTC day ends. | campaign_performance; keyword_performance; ad_group_performance; |
| feed_url | TEXT | Feed URL | The feed URL will appear either as 'True' or 'False'. If it's 'True', the final; URL came from a page feed associated to the campaign. If it's 'False', the final; URL did not come from a page feed.; | dsa_search_query_performance; |
| final_mobile_url | TEXT | Final Mobile Url | The Final Mobile URL of the ad, keyword, or criterion. Only the first; URL in the list is reported. If the URL contains dynamic text substitution; parameters (for example, {param1}), the report will contain the URL before substitution.; | ad_performance; keyword_performance; |
| final_url | TEXT | The Final URL | Only the first URL in the list is reported. If the URL contains dynamic text substitution parameters (for example, {param1}), the report will contain the URL before substitution. | ad_performance; keyword_performance; dsa_search_query_performance; |
| final_url_suffix | TEXT | Final Url Suffix | A place in your final URL where you can add parameters that will be attached to the end of your landing page URL. | ad_performance; campaign_performance; keyword_performance; |
| first_page_bid | NUMERIC | Mainline Bid First Page Amount (Duplicate) | Based on your 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 in the search results. These estimates are provided as a reference only.; They are automatically generated by Microsoft Advertising and are not a guarantee of ad position.; | keyword_performance; |
| gender | TEXT | Gender | The gender (male or female) of the search users to whom the ad was delivered. | age_gender_report; |
| goal | TEXT | Goal | The name of the goal you set for the conversions you want, meaning actions customers take after clicking your ad. | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| goal_id | TEXT | Goal ID | The Microsoft Advertising assigned identifier of a conversion goal. | conversion_performance; product_dimension_performance; |
| goal_type | TEXT | Goal Type | The type of conversion goal. Possible values include AppInstall, Duration, Event, InStoreTransaction, OfflineConversion, PagesViewedPerVisit, and Url. | ad_performance; conversion_performance; keyword_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| hour | TEXT | Hour | Each row of the report identifies the hour when the transaction occurred. The report data will be aggregated by each hour of the day. The possible values for the hour component are 0 - 23. If the report time spans multiple days, then the performance data for a given hour will be provided separately across multiple rows i.e. the report will include one row for each unique day and hour. For example if Campaign A has 5 impressions during Hour 7 on each of the 3 days included in the report time range, then the report will include three rows each with 5 impressions for Hour 7. | campaign_performance; ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| hour_of_day | NUMERIC | Hour of day | Each row of the report identifies the hour of the day when the transaction occurred. The report data will be aggregated by each of the 24 hours across all days. The possible values are 0 - 23. If the report time spans multiple days, then the performance data across all days for a given hour will be aggregated in one row. For example if Campaign A has 5 impressions during hour 7 on each of the 3 days included in the report time range, then the report will include one row with impressions for HourOfDay totaling 15. | campaign_performance; ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| impression_lost_to_budget | NUMERIC | Impression Lost To Budget | Impression Lost To Budget | campaign_performance; |
| impression_lost_to_budget_percent | PERCENT | Impression Lost To Budget Percent | The estimated percentage of impressions your ad did not receive due to issues with your daily or monthly budget. | campaign_performance; ad_group_performance; product_dimension_performance; |
| impression_share_percent | PERCENT | Impression Share Percent | The estimated percentage of impressions, out of the total available impressions in the market you were targeting. | campaign_performance; ad_group_performance; product_dimension_performance; |
| impressions | NUMERIC | Impressions | The number of impressions | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| installs | NUMERIC | Installs | The total number of installs. | campaign_performance; ad_group_performance; product_dimension_performance; |
| keyword | TEXT | Keyword | The keyword. | keyword_performance; conversion_performance; |
| keyword_id | TEXT | The Keyword ID | The keyword ID. | keyword_performance; conversion_performance; |
| keyword_labels | TEXT | Keyword Labels | The labels applied to the keyword. Delimited by a semicolon (;). | keyword_performance; |
| landing_page_experience | TEXT | Landing Page Experience | An aggregate quality assessment of all landing pages on your site. The landing page experience score measures whether your landing page is likely to provide a good experience to customers who click your ad and land on your website. | campaign_performance; keyword_performance; ad_group_performance; |
| landing_page_title | TEXT | Landing Page Title | The title of your webpage where the search user landed. | dsa_search_query_performance; |
| language | TEXT | Language | The language of the publisher where the ad was shown. The language display name will be provided in the report e.g. English. | ad_performance; keyword_performance; user_location_performance; age_gender_report; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| location_id | TEXT | Location Id | The Microsoft Advertising identifier of the location where the user was physically located; when they clicked the ad. For geographical location identifiers, see Geographical Location; Codes. If the location ID is in the report but not found in the file downloaded via; GetGeoLocationsFileUrl, it is not targetable.; | user_location_performance; |
| mainline_bid | NUMERIC | Mainline Bid First Page Amount | Based on your 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 in the search results. These estimates are provided as a reference only.; They are automatically generated by Microsoft Advertising and are not a guarantee of ad position.; | keyword_performance; |
| mainline_bid_1 | NUMERIC | Mainline Bid Top Amount | Based on your 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. These estimates are provided as a reference only. They are automatically; generated by Microsoft Advertising and are not a guarantee of ad position.; | keyword_performance; |
| metro_area | TEXT | Metro Area | The metro area (Nielsen DMA in the United States) where the user was physically located when they clicked the ad. | user_location_performance; |
| month | TEXT | Month | Each row of the report identifies the month when the transaction occurred. The report data will be aggregated by each month. The time period that contains the first day of the month will be formatted as yyyy-mm-dd. NOTE: partial data aggregation for monthly time period is not supported. If the selected dates are not full months and the corresponding monthly time period column is requested, the selected dates will be converted to full months. | campaign_performance; ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| month_to_date_budget_spend | NUMERIC | Month to Date Budget Spend | The amount of money spent to date for the month. | budget_summary; |
| monthly_budget | NUMERIC | Monthly Budget | The anticipated maximum monthly budget amount that was calculated on the date of the most recent budget change. | budget_summary; |
| neighborhood | TEXT | Neighborhood | The neighborhood where an ad was physically served, or the neighborhood that your customer; had shown interest in through searches or content they had viewed. This helps you find out; how your ads are doing in different locations, which can help you decide where to; focus more of your advertising efforts.; | user_location_performance; |
| network | TEXT | Network | The entire Microsoft Advertising Network made up of Microsoft sites and select traffic,; and only partner traffic. Use this data to make the best decision on network selection for your ad groups.; | ad_performance; campaign_performance; keyword_performance; user_location_performance; dsa_auto_target_performance; dsa_search_query_performance; product_dimension_performance; |
| phone_calls | NUMERIC | Phone Calls | The number of total calls to the tracked phone number that showed with your ad. | campaign_performance; ad_group_performance; |
| postal_code | TEXT | Postal Code | The postal code where the user was physically located when they clicked the ad. | user_location_performance; |
| potential_clicks | NUMERIC | Potential Clicks | Potential Clicks | campaign_performance; |
| product_assisted_clicks | NUMERIC | Product Assisted Clicks | Clicks on your ads that have received co-bids from your manufacturer partners. Clicks are what you pay for. Clicks typically include a customer clicking an ad on a search results page or on a website on the search network. Clicks can also come from other sources (for example, spiders, robots, and test servers).This performance statistic is only available for Sponsored Products in Microsoft Shopping Campaigns. | product_dimension_performance; |
| product_assisted_conversions | NUMERIC | Product Assisted Conversions | The number of conversions. A conversion is the completion of an action by a customer after viewing your ad. The action could be purchasing your product, registering for your webinar, joining an organization, or whatever you consider your goal and best measure of the ad's success.Available for accounts that are setup to use analytics with Microsoft Advertising Universal Event Tracking. | product_dimension_performance; |
| product_assisted_impressions | NUMERIC | Product Assisted Impressions | The number of times an ad that is being co-bid by your manufacturer partners has been displayed on search results pages or other sites on the Microsoft Advertising Network. This performance statistic is only available for Sponsored Products in Microsoft Shopping Campaigns. | product_dimension_performance; |
| product_benchmark_ctr | NUMERIC | Product Benchmark CTR | Shows you how other product ads for similar products are performing on average based on how often people who see the ad end up clicking on it. If the benchmark CTR is significantly higher than the CTR for your product group, you might consider raising your bid for that product group, or improving the product information, particularly product images and titles. | product_dimension_performance; |
| product_bought | TEXT | Product Bought | The product purchased from your catalog or via your retail partner. The purchased product will always match the same brand, but can differ from the specific product ad that was clicked on. If different products were purchased as a result of one click, the report will include multiple rows with the same ad ID and Merchant product ID, and each will contain a unique ProductBought value. You can also include the QuantityBought column to get data on quantity purchased per product. | product_dimension_performance; |
| product_bought_title | TEXT | Product Bought Title | The title associated with the purchased product. | product_dimension_performance; |
| product_brand | TEXT | Product brand | The product item's manufacturer, brand, or publisher. | product_dimension_performance; |
| product_category_1 | TEXT | Product category 1 | The first level value of the Product_category field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_category_2 | TEXT | Product category 2 | The second level value of the Product_category field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_category_3 | TEXT | Product category 3 | The third level value of the Product_category field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_category_4 | TEXT | Product category 4 | The fourth level value of the Product_category field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_category_5 | TEXT | Product category 5 | The fifth level value of the Product_category field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_click_type | TEXT | Product Click Type | Click type refers to each component of an ad that a customer can click. The possible click types are ad title, image, phone number, driving directions, sitelink, and review. | product_dimension_performance; |
| product_click_type_id | TEXT | Product Click Type ID | The click type ID. | product_dimension_performance; |
| product_condition | TEXT | Product condition | The condition of a product item. | product_dimension_performance; |
| product_country_of_sale | COUNTRY | Product Country of Sale | The country/region of sale for the product catalog. | product_dimension_performance; |
| product_custom_label_0 | TEXT | Product custom label 0 | The value of the Custom_label_0 field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_custom_label_1 | TEXT | Product custom label 1 | The value of the Custom_label_1 field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_custom_label_2 | TEXT | Product custom label 2 | The value of the Custom_label_2 field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_custom_label_3 | TEXT | Product custom label 3 | The value of the Custom_label_3 field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_custom_label_4 | TEXT | Product custom label 4 | The value of the Custom_label_4 field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_gtin | TEXT | Product gtin | Global Trade Item Number (GTIN) is a unique numerical value for commercial products that usually appears printed under the barcode on retail products. | product_dimension_performance; |
| product_id | TEXT | Product ID | The unique identifier provided by a merchant for each product offer. | product_dimension_performance; |
| product_local_store_code | TEXT | Product Local Store Code | An alphanumeric identifier defined by the merchant to uniquely identify each local store. | product_dimension_performance; |
| product_mpn | TEXT | Product mpn | Manufacturer Part Number (MPN) is a unique number that identifies the product to its manufacturer. | product_dimension_performance; |
| product_offer_language | TEXT | Product Offer Language | The language for the product offer. | product_dimension_performance; |
| product_price | NUMERIC | Product price | The different price for products in your catalog. | product_dimension_performance; |
| product_quantity_bought | NUMERIC | Product Quantity Bought | The quantity of the product purchased (product_bought) from your catalog or via your retail partner. | product_dimension_performance; |
| product_seller_name | TEXT | Product Seller Name | The merchant or store name that offers the product. | product_dimension_performance; |
| product_store_id | TEXT | Product Store ID | The unique identifier for the Microsoft Merchant Center store. | product_dimension_performance; |
| product_total_clicks | TEXT | Product Total Clicks On Ad Elements | The number of clicks when this ad element was present in the ad copy, whether this or another ad element was clicked on. | product_dimension_performance; |
| product_type_1 | TEXT | Product type 1 | The first level value of the Product_type field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_type_2 | TEXT | Product type 2 | The second level value of the Product_type field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_type_3 | TEXT | Product type 3 | The third level value of the Product_type field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_type_4 | TEXT | Product type 4 | The fourth level value of the Product_type field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| product_type_5 | TEXT | Product type 5 | The fifth level value of the Product_type field in your Microsoft Merchant Center catalog. | product_dimension_performance; |
| proximity_target_location | TEXT | Proximity Target Location | The radius target bid name. The name of the geographic radius where the user was physically located when they clicked the ad. The Radius attribute column contains the distance of the radius. | user_location_performance; |
| query_intent_city | CITY | Query Intent City | The name of a city if the user's geographical intent can be determined. The city is set if the user's intent is a city, and not necessarily if they are physically located in the city. | user_location_performance; |
| query_intent_country | COUNTRY | Query Intent Country | The name of a country if the user's geographical intent can be determined. The country is set if the user's intent is related to a country, and not necessarily if they are physically located in the county. | user_location_performance; |
| query_intent_county | TEXT | Query Intent County | The name of a county if the user's geographical intent can be determined. The county is set if the user's intent is related to a county, and not necessarily if they are physically located in the county. | user_location_performance; |
| query_intent_dma | TEXT | Query Intent DMA | The name of a metro area (Nielsen DMA in the United States) if the user's geographical intent can be determined. The metro area is set if the user's intent; is a metro area or city within the metro area, and not necessarily if they are physically located in the metro area.; | user_location_performance; |
| query_intent_location_id | TEXT | Query Intent Location Id | The location identifier if the user's geographical intent can be determined. | user_location_performance; |
| query_intent_neighborhood | TEXT | Query Intent Neighborhood | The name of a neighborhood if the user's geographical intent can be determined.; The neighborhood is set if the user's intent is related to a neighborhood, and not; necessarily if they are physically located in the neighborhood. For example, the user's; search query was rental cars in Encino.; | user_location_performance; |
| query_intent_postal_code | TEXT | Query Intent Postal Code | The name of a postal code if the user's geographical intent can be determined. The postal code is set if the user's intent is a postal code, and not necessarily if they are physically located in the postal code. | user_location_performance; |
| query_intent_state | TEXT | Query Intent State | The name of a state if the user's geographical intent can be determined. The state is set if the user's intent is a state or sub geography of the state, and not necessarily if they are physically located in the state. | user_location_performance; |
| radius | NUMERIC | Radius | The radius of a radius target bid. The geographic radius where the user was physically located when they clicked the ad. The ProximityTargetLocation attribute column contains the address or landmark name of the radius. | user_location_performance; |
| revenue | NUMERIC | Revenue | The amount of revenue | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| revenue_per_install | PERCENT | Revenue per Install | The revenue per install. The formula for calculating the revenue per install is (Revenue / Installs) | campaign_performance; ad_group_performance; product_dimension_performance; |
| revenue_per_sale | PERCENT | Revenue per Sale | The revenue per sale. The formula for calculating the revenue per sale is (Revenue / Sales) | campaign_performance; ad_group_performance; product_dimension_performance; |
| rpa | NUMERIC | Revenue Per Assist | The revenue per assist. The formula for calculating the RPA is (Revenue / Assists). | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; dsa_auto_target_performance; dsa_search_query_performance; |
| sales | NUMERIC | Sales | The total number of sales. | campaign_performance; ad_group_performance; product_dimension_performance; |
| search_query | TEXT | Search query | The search term used by your potential audience. | dsa_search_query_performance; |
| source | TEXT | Source | The name of the Windsor connector returning the row | |
| spend | NUMERIC | Spend | The media spend | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| state | TEXT | State | The state where the user was physically located when they clicked the ad. | user_location_performance; |
| summary | TEXT | Summary | The report data will be aggregated by the entire specified report time. The report column will be equal in the format 'start_date - end_date'. | campaign_performance; ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| targeting_setting | TEXT | Targeting Setting | This attribute reflects the current value of your ad group's audience targeting setting.; The possible values are 'Target and bid' or 'Bid only'. Target and bid: Show ads only to; people included in the remarketing list, with the option to change the bid amount.; Bid only: Show ads to people searching for your ad, with the option to change the bid; amount for people included in the remarketing list.; | audience_performance; |
| today | DATE | Today | Today's date | |
| top_impression_rate_percent | PERCENT | Top Impression Rate Percent | The percentage of times your ad showed in the mainline, the top placement where ads appear above the search results, out of your total impressions. | ad_performance; campaign_performance; keyword_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; |
| top_impression_share_lost_to_budget | NUMERIC | Top Impression Lost To Budget | Top Impression Lost To Budget | campaign_performance; |
| top_impression_share_lost_to_budget_percent | PERCENT | Top Impression Share Lost To Budget Percent | The estimated percentage of mainline impressions, where ads appear above the search results, that were lost due to insufficient budget. | campaign_performance; ad_group_performance; |
| top_impression_share_lost_to_rank | NUMERIC | Top Impression Share Lost To Rank | Top Impression Share Lost To Rank | campaign_performance; |
| top_impression_share_lost_to_rank_percent | PERCENT | Top Impression Share Lost To Rank Percent | A percentage estimate of how often poor ad rank kept your ad from showing in the mainline, the top ad placements above the search results. | campaign_performance; ad_group_performance; |
| top_impression_share_percent | PERCENT | Top Impression Share Percent | The percentage of impressions for your ad in the mainline, the top ad placements above the search results, out of the estimated number of mainline impressions you were eligible to receive. | campaign_performance; ad_group_performance; |
| top_impressions | NUMERIC | Top Impressions | Top Impressions | ad_performance; campaign_performance; keyword_performance; |
| top_vs_other | TEXT | Top vs Other | Indicates whether the ad impression appeared in a top position or elsewhere.; The possible values include AOL search - Top, AOL search - Other, Audience network,; Bing and Yahoo! search - Top, Bing and Yahoo! search - Other, Syndicated search; partners - Top, Syndicated search partners - Other, Content network, and Unknown.; | ad_performance; campaign_performance; keyword_performance; user_location_performance; dsa_auto_target_performance; dsa_search_query_performance; product_dimension_performance; |
| totalcost | NUMERIC | Total Cost | The media spend (Duplicate) | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| tracking_template | TEXT | Tracking Template | The current tracking template of the ad, keyword, or criterion. | ad_performance; campaign_performance; keyword_performance; dsa_auto_target_performance; |
| transactionrevenue | NUMERIC | Transaction Revenue | The amount of revenue | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| video_average_watch_time_per_impression | PERCENT | Average Watch Time Per Impression | Total video watch time divided by the number of impressions. | ad_performance; campaign_performance; ad_group_performance; |
| video_average_watch_time_per_view | PERCENT | Average Watch Time Per Video View | Total video watch time divided by the number of video views. | ad_performance; campaign_performance; ad_group_performance; |
| video_completion_rate | NUMERIC | Video Completion Rate | The number of completed video views divided by the number of total video views. | ad_performance; campaign_performance; ad_group_performance; |
| video_total_watch_time_ms | NUMERIC | Total Video Watch Time MS | Total amount of time a person spent watching the video in milliseconds. | ad_performance; campaign_performance; ad_group_performance; |
| video_views | NUMERIC | Video Views | The number of times the video was played and watched for; at least two continuous seconds with more than 50% of the screen in view.; | ad_performance; campaign_performance; ad_group_performance; |
| video_views_100 | NUMERIC | Video Views Completed (100%) | Number of times a person watched the entire video to completion. | ad_performance; campaign_performance; ad_group_performance; |
| video_views_25 | NUMERIC | Video Views 25% | The number of times a person completed at least 25% of a video. | ad_performance; campaign_performance; ad_group_performance; |
| video_views_50 | NUMERIC | Video Views 50% | The number of times a person completed at least 50% of a video. | ad_performance; campaign_performance; ad_group_performance; |
| video_views_75 | NUMERIC | Video Views 75% | The number of times a person completed at least 75% of a video. | ad_performance; campaign_performance; ad_group_performance; |
| view_through_conversions | NUMERIC | View Through Conversions | View-through conversions are conversions that people make after they have seen; your ad, even though they did not click the ad.; View-through conversions don't have a click associated but do have an impression; associated within the advertiser defined conversion window. If the user also clicked; on an ad that was delivered via the Microsoft Audience or Search network, there won't; be any view-through conversion counted. Only the click-based conversion would be counted.; View-through conversions are only counted for ads in the Microsoft Audience network.; | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| view_through_rate | PERCENT | View Through Rate | The number of video views divided by the number of impressions. | ad_performance; campaign_performance; ad_group_performance; |
| view_through_revenue | NUMERIC | View Through Revenue | The revenue optionally reported by the advertiser as a result of view-through conversions. | ad_performance; campaign_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; ad_group_performance; product_dimension_performance; |
| website_coverage | NUMERIC | Website Coverage | A score from 0.0 to 1.0 that indicates the percentage of pages in the; requested language that belong to a particular domain out of all the pages; that Bing has indexed for the same language your website's domain. In other; words coverage is the percentage of webpages that match a category and language; divided by the total number of webpages using the same language in the domain.; For example, if the category US/CA/SFO matches 500 english webpages and US/CA matches; 1,000 english webpages, then the coverage will be 0.50 (50 percent).; | dsa_auto_target_performance; |
| week | TEXT | Week | Each row of the report identifies the week when the transaction occurred. The report data will be aggregated by each week running from Sunday through Saturday. The time period that contains the date of the Sunday for each week will be formatted as yyyy-mm-dd. NOTE: partial data aggregation for weekly time period is not supported. If the selected dates are not full weeks and the corresponding weekly time period column is requested, the selected dates will be converted to full weeks. | campaign_performance; ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| week_day | TEXT | Day of week and day number | Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday. | |
| week_day_iso | TEXT | Day of week and day number, ISO | Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7 | |
| week_iso | TEXT | Week ISO | Week, ISO format (Mon-Sun). | |
| year | TEXT | Year | Each row of the report identifies the year when the transaction occurred. The report data will be aggregated by each year. The time period that contains the year will be formatted as yyyy. NOTE: partial data aggregation for yearly time period is not supported. If the selected dates are not full years and the corresponding yearly time period column is requested, the selected dates will be converted to full years. | campaign_performance; ad_performance; keyword_performance; conversion_performance; user_location_performance; age_gender_report; audience_performance; dsa_auto_target_performance; dsa_search_query_performance; ad_group_performance; product_dimension_performance; |
| year_month | TEXT | Yearmonth | Year and month, e.g. 2024|3 | |
| year_of_week | TEXT | Year of week | The year that contains first day of the week (Sun-Sat). | |
| year_of_week_iso | TEXT | Year of week, ISO | The year that contains first day of the ISO week (Mon-Sun). | |
| year_week | TEXT | Year week | Year and week for US weeks (Sun-Sat), e.g. 2024|15 | |
| year_week_iso | TEXT | Year week ISO | Year and week for ISO weeks (Mon-Sun), e.g. 2024|20 |