Windsor brings all your Google Ad Manager data into Power BI, Looker Studio, Google Sheets, Excel, BigQuery, Snowflake, Tableau, PostgreSQL, MySQL, Python, Amazon S3, Azure, Azure MS SQL
Google Ad Manager Field Reference
Sample
https://connectors.windsor.ai/google_ad_manager?api_key=[your API
key]&date_preset=last_7d&fields=campaign,clicks,spend,impressions,date,source&_renderer=csv
Fields
| ID | Type | Name | Description |
|---|---|---|---|
| account_id | TEXT | Account ID | Breaks down reporting data by advertising company Company ID. Can be used to filter by Company.id. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. |
| account_name | TEXT | Account name | Breaks down reporting data by advertising company. Company.name and Company.id are automatically included as columns in the report. Can be used to filter by Company.name. Corresponds to "Advertiser" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. |
| ad_exchange_line_item_average_ecpm | PERCENT | Ad Exchange average eCPM | The average estimated cost-per-thousand-impressions earned from the delivery of Ad Exchange ads for line item-level dynamic allocation. Compatible with the 'Historical' report type. |
| ad_exchange_line_item_clicks | NUMERIC | Ad Exchange clicks | The number of clicks an Ad Exchange ad delivered for line item-level dynamic allocation. Compatible with the 'Historical' report type. |
| ad_exchange_line_item_clicks_percent | PERCENT | Ad Exchange clicks (%) | The ratio of the number of clicks delivered to the total clicks delivered by Ad Exchange for line item-level dynamic allocation. Represented as a percentage. Compatible with the 'Historical' report type. |
| ad_exchange_line_item_ctr | NUMERIC | Ad Exchange CTR | The ratio of clicks an Ad Exchange ad delivered to the number of impressions it delivered for line item-level dynamic allocation. Compatible with the 'Historical' report type. |
| ad_exchange_line_item_impressions_percent | PERCENT | Ad Exchange impressions (%) | The ratio of the number of impressions delivered to the total impressions delivered by Ad Exchange for line item-level dynamic allocation. Represented as a percentage. Compatible with the 'Historical' report type. |
| ad_exchange_line_item_revenue | NUMERIC | Ad Exchange revenue | Revenue generated from Ad Exchange ads delivered for line item-level dynamic allocation. Represented in publisher currency and time zone. Compatible with the 'Historical' report type. |
| ad_exchange_line_item_revenue_percent | PERCENT | Ad Exchange revenue (%) | The ratio of revenue generated by Ad Exchange to the total revenue earned by CPM and CPC ads delivered for line item-level dynamic allocation. Represented as a percentage. Compatible with the 'Historical' report type. |
| ad_exchange_line_item_revenue_percent_cpd | PERCENT | Ad Exchange revenue with CPD (%) | The ratio of revenue generated by Ad Exchange to the total revenue earned by CPM, CPC and CPD ads delivered for line item-level dynamic allocation. Represented as a percentage.Compatible with the 'Historical' report type. |
| ad_exchange_line_item_targeted_clicks | NUMERIC | Ad Exchange targeted clicks | The number of clicks an Ad Exchange ad delivered for line item-level dynamic allocation by explicit custom criteria targeting. Compatible with the 'Historical' report type. |
| ad_exchange_line_item_targeted_impressions | NUMERIC | Ad Exchange targeted impressions | The number of impressions an Ad Exchange ad delivered for line item-level dynamic allocation by explicit custom criteria targeting. Compatible with the 'Historical' report type. |
| ad_network_id | TEXT | Ad network id | The network that provided the ad for SDK ad mediation. If selected for a report, that report will include only SDK mediation ads and will not contain non-SDK mediation ads. SDK mediation ads are ads for mobile devices. They have a list of ad networks which can provide ads to serve. Not every ad network will have an ad to serve so the device will try each network one-by-one until it finds an ad network with an ad to serve. The ad network that ends up serving the ad will appear here. Note that this id does not correlate to anything in the companies table and is not the same id as is served by ADVERTISER_ID. Compatible with any of the following report types: Historical, Reach. |
| ad_network_name | TEXT | Ad network name | Name of the ad network. |
| ad_server_all_revenue | NUMERIC | Ad Server All Revenue | The CPM, CPC and CPD revenue earned, calculated in publisher currency, for the ads delivered by the ad server. Can correspond to any of the following in the Ad Manager UI: Ad server CPM, CPC, CPD, and vCPM revenue, Ad server CPM, CPC and CPD revenue. Compatible with the "Historical" report type. |
| ad_server_clicks | NUMERIC | Ad server clicks | The number of clicks delivered by the ad server. |
| ad_server_ctr | PERCENT | Ad server CTR | The CTR for an ad delivered by the ad server. |
| ad_server_impressions | NUMERIC | Ad server impressions | The number of impressions delivered by the ad server. |
| ad_server_targeted_impressions | NUMERIC | Ad server targeted impressions | The number of impressions delivered by the ad server by explicit custom criteria targeting. |
| ad_unit_id | TEXT | Ad unit ID | The id of the ad unit. |
| ad_unit_name | TEXT | Ad unit name | The name of the ad unit. |
| adsense_line_item_level_impressions | NUMERIC | AdSense impressions | The number of impressions an AdSense ad delivered for line item-level dynamic allocation. Compatible with the "Historical" report type. |
| advertiser | TEXT | Advertiser | The name of the advertiser company assigned to an order. |
| advertiser_id | TEXT | Advertiser id | The id of the advertiser company assigned to an order. |
| campaign | TEXT | Campaign | Breaks down reporting data by placement. Placement.name and Placement.id are automatically included as columns in the report. Can be used to filter by Placement.name. Corresponds to "Placement" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach. |
| clicks | NUMERIC | Clicks | The number of clicks delivered by the ad server. Corresponds to "Ad server clicks" in the Ad Manager UI. Compatible with the "Historical" report type. |
| country | COUNTRY | Country | Country associated to IP address from ad slot request |
| creative_id | TEXT | Creative | The name of the Creative that served to the ad slot request. |
| creative_size | TEXT | Creative size | Size of creative that served to the ad slot request. Creative size does not represent the actual size of a creative being served. |
| creative_type | TEXT | Creative type | Type of creative that served to the ad slot request. |
| custom_criteria | TEXT | Custom Criteria | Breaks down reporting data by custom criteria. Cannot be used for filtering; When using this Dimension, metrics for freeform key values are only reported on when they are registered with CustomTargetingService. Corresponds to 'Key-values' in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. |
| datasource | TEXT | Data Source | The name of the Windsor connector returning the row |
| date | DATE | Date | Breaks down reporting data by date in the network time zone. Can be used to filter by date using ISO 8601's format 'YYYY-MM-DD'". Note: In v201802 and later, this dimension is compatible with the following time zone types: TimeZoneType.PUBLISHER TimeZoneType.PROPOSAL_LOCAL Corresponds to "Date" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. |
| day_of_month | TEXT | Day of month | Day of the month |
| impressions | NUMERIC | Impressions | The number of impressions an AdSense ad delivered for line item-level dynamic allocation. Corresponds to "AdSense impressions" in the Ad Manager UI. Compatible with the "Historical" report type. |
| line_item_average_number_of_viewers | TEXT | Nielsen Average Number Of Viewers (Line item) | Corresponds to 'Nielsen Average Number Of Viewers' in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. |
| line_item_contracted_quantity | TEXT | Contracted quantity (Line item) | Represents the LineItem.contractedUnitsBought quantity for Dimension.LINE_ITEM_NAME. |
| line_item_cost_per_unit | NUMERIC | Line Item Cost Per Unit | Represents Line Item cost per unit for Line item name. Corresponds to 'Rate' in the Ad Manager UI |
| line_item_cost_type | TEXT | Cost type (Line item) | Represents LineItem.costType for Dimension.LINE_ITEM_NAME. Can be used for filtering. |
| line_item_creative_end_date | DATE | Creative end date (Line item) | Represents a LineItemCreativeAssociation.endDateTime for a Dimension.LINE_ITEM_NAME and a Dimension.CREATIVE_NAME. Includes the date without the time. |
| line_item_creative_start_date | DATE | Creative start date (Line item) | Represents a LineItemCreativeAssociation.startDateTime for a Dimension.LINE_ITEM_NAME and a Dimension.CREATIVE_NAME. Includes the date without the time. |
| line_item_currency_code | TEXT | Currency code (Line item) | Represents the 3 letter currency code for Dimension.LINE_ITEM_NAME. |
| line_item_delivery_indicator | TEXT | Line item delivery Indicator | Indicates the progress made for the delivery of the line item. |
| line_item_delivery_pacing | TEXT | Line item delivery pacing | Represents delivery rate type for the line item. |
| line_item_discount | TEXT | Discount (Line item) | Represents the LineItem.discount for Dimension.LINE_ITEM_NAME. The number is either a percentage or an absolute value depending on LineItem.discountType. |
| line_item_end_date_time | DATE | Line item end date | Represents the end date (in YYYY-MM-DD format) for Dimension.LINE_ITEM_NAME. Can be used for filtering. |
| line_item_external_id | TEXT | External Line Item ID | Represents LineItem.externalId for Dimension.LINE_ITEM_NAME. Can be used for filtering. |
| line_item_frequency_cap | TEXT | Frequency cap (Line item) | Represents LineItem.frequencyCaps as a comma separated list of 'FrequencyCap.maxImpressions impressions per/every FrequencyCap.numTimeUnits FrequencyCap.timeUnit' (e.g. '10 impressions every day,500 impressions per lifetime') for Dimension.LINE_ITEM_NAME. |
| line_item_goal_quantity | TEXT | Line Item Goal Quantity | The total number of impressions, clicks or days that is reserved for Line item name. |
| line_item_id | TEXT | Line item ID | The id of the line item associated to the Creative that served to the ad slot request. |
| line_item_label_ids | TEXT | Line item label IDs | Represents LineItem.effectiveAppliedLabels as a comma separated list of Label.id for Dimension.LINE_ITEM_NAME. |
| line_item_labels | TEXT | Line item labels | Represents LineItem.effectiveAppliedLabels as a comma separated list of Label.name for Dimension.LINE_ITEM_NAME. |
| line_item_last_reconciliation_date_time | TEXT | Line item last reconciliation time | Represents the monthly last reconciliation date time of the line item for Dimension.LINE_ITEM_NAME and Dimension.MONTH_YEAR. |
| line_item_lifetime_clicks | TEXT | Line item lifetime clicks | The total number of clicks delivered over the lifetime of a Dimension.LINE_ITEM_NAME. |
| line_item_lifetime_impressions | TEXT | Line item lifetime impressions | The total number of impressions delivered over the lifetime of a Dimension.LINE_ITEM_NAME. |
| line_item_name | TEXT | Line item name | The name of the line item associated to the Creative that served to the ad slot request. |
| line_item_non_cpd_booked_revenue | NUMERIC | Line Item Non CPD Booked Revenue | The cost of booking for a non-CPD Line item name. |
| line_item_optimizable | TEXT | Line item Optimizable | Generated as true for Dimension.LINE_ITEM_NAME which is eligible for optimization, false otherwise. Can be used for filtering. |
| line_item_priority | TEXT | Line Item Priority | Represents Line item priority for Line item name as a valuebetween 1 and 16. Can be used for filtering. |
| line_item_reconciliation_status | TEXT | Line item reconciliation status | Represents the monthly reconciliation status of the line item for Dimension.LINE_ITEM_NAME and Dimension.MONTH_YEAR. |
| line_item_sponsorship_goal_percentage | PERCENT | Sponsorship goal (%) (Line item) | The ratio between the goal quantity for Dimension.LINE_ITEM_NAME of LineItemType.SPONSORSHIP and the LINE_ITEM_GOAL_QUANTITY. Represented as a number between 0..100. |
| line_item_start_date_time | DATE | Line item start date | Represents the start date (in YYYY-MM-DD format) for Dimension.LINE_ITEM_NAME. Can be used for filtering. |
| line_item_type | TEXT | Line item type | Type of line item associated to the Creative that served to the ad slot request. |
| month | TEXT | Month | Number of the month |
| month_and_year | TEXT | Month and year | Breaks down reporting data by month and year in the network time zone. Can be used to filter on month using ISO 4601 format 'YYYY-MM'. Note: In v201802 and later, this dimension is compatible with the following time zone types: TimeZoneType.PUBLISHER TimeZoneType.PROPOSAL_LOCAL Corresponds to "Month and year" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Partner finance. |
| order_delivery_status | TEXT | Order delivery status | Delivery status of the order. Not available as a dimension to report on, but exists as a dimension in order to filter on it using PQL. Valid values are 'STARTED', 'NOT_STARTED' and 'COMPLETED'. Compatible with any of the following report types: Historical, Reach. |
| order_id | TEXT | Order ID | The id of the Order associated to the line item linked to the Creative that served to the ad slot request. |
| order_name | TEXT | Order name | The name of the Order associated to the line item linked to the Creative that served to the ad slot request. |
| placement_id | TEXT | Placement ID | The id of the placement that currently includes an ad unit associated with an impression, click, or other event. |
| placement_name | TEXT | Placement name | Name of the placement that currently includes an ad unit associated with an impression, click, or other event. |
| programmatic_match_rate | PERCENT | Programmatic match rate | The number of programmatic responses served divided by the number of requests eligible for programmatic. Includes Ad Exchange, Open Bidding, and Preferred Deals. Compatible with the 'Historical' report type. |
| region | REGION | Region | Region associated with the IP address included in the ad slot request. |
| source | TEXT | Source | The name of the Windsor connector returning the row |
| spend | NUMERIC | Spend | The total CPM and CPC revenue generated by the ad servers including line item-level dynamic allocation. Corresponds to "Total CPM and CPC revenue" in the Ad Manager UI. Compatible with the "Historical" report type. |
| today | DATE | Today | Today's date |
| total_ad_requests | NUMERIC | Total ad requests | The total number of times that an ad request is sent to the ad server including dynamic allocation. |
| total_average_viewable_seconds | NUMERIC | Total average viewable seconds | Active View total average time in seconds that specific impressions are reported as being viewable. Corresponds to "Total Active View Average Viewable Time (seconds)" in the Ad Manager UI. Compatible with the 'Historical' report type. |
| total_eligible_impressions | NUMERIC | Total eligible impressions | Total number of impressions that were eligible to measure viewability. Corresponds to "Total Active View eligible impressions" in the Ad Manager UI. Compatible with the 'Historical' report type. |
| total_line_item_level_all_revenue | NUMERIC | Total Line Item Level All Revenue | The total CPM, CPC and CPD revenue generated by the ad servers including line item-level dynamic allocation. Can correspond to any of the following in the Ad Manager UI: Total CPM, CPC, CPD, and vCPM revenue, Total CPM, CPC and CPD revenue. Compatible with the "Historical" report type. |
| total_line_item_level_clicks | NUMERIC | Total clicks | The total number of clicks delivered including line item-level dynamic allocation. |
| total_line_item_level_cpm_and_cpc_revenue | NUMERIC | Total CPM and CPC revenue (Line item) | The total CPM and CPC revenue generated by the ad servers including line item-level dynamic allocation. Corresponds to 'Total CPM and CPC revenue' in the Ad Manager UI. Compatible with the 'Historical' report type. |
| total_line_item_level_ctr | NUMERIC | Total CTR | The ratio of total clicks on ads delivered by the ad servers to the total number of impressions delivered for an ad including line item-level dynamic allocation. |
| total_line_item_level_impressions | NUMERIC | Total impressions | The total number of impressions delivered including line item-level dynamic allocation. |
| total_line_item_level_targeted_clicks | NUMERIC | Total targeted clicks (Line item) | The total number of clicks delivered including line item-level dynamic allocation by explicit custom criteria targeting Corresponds to 'Total targeted clicks' in the Ad Manager UI. Compatible with the 'Historical' report type. |
| total_line_item_level_targeted_impressions | NUMERIC | Total targeted impressions (Line item) | The total number of impressions delivered including line item-level dynamic allocation by explicit custom criteria targeting. Corresponds to 'Total targeted impressions' in the Ad Manager UI. Compatible with the 'Historical' report type. |
| total_line_item_level_with_cpd_average_ecpm | NUMERIC | Total average eCPM with CPD (Line item) | Estimated cost-per-thousand-impressions (eCPM) of CPM, CPC and CPD ads delivered by the ad servers including line item-level dynamic allocation. |
| total_line_item_level_without_cpd_average_ecpm | NUMERIC | Total average eCPM without CPD (Line item) | Estimated cost-per-thousand-impressions (eCPM) of CPM and CPC ads delivered by the ad servers including line item-level dynamic allocation. Corresponds to 'Total average eCPM' in the Ad Manager UI. Compatible with the 'Historical' report type. |
| total_measurable_impressions | NUMERIC | Total measurable impressions | The total number of impressions that were sampled and measured by active view. Corresponds to "Total Active View measurable impressions" in the Ad Manager UI. Compatible with the 'Historical' report type. |
| total_measurable_impressions_rate | NUMERIC | Total measurable impressions rate | The percentage of total impressions that were measurable by active view (out of all the total impressions sampled for active view). Corresponds to "Total Active View % measurable impressions" in the Ad Manager UI. Compatible with the 'Historical' report type. |
| total_viewable_impressions | NUMERIC | Total viewable impressions | The total number of impressions viewed on the user's screen. Corresponds to "Total Active View viewable impressions" in the Ad Manager UI. Compatible with the 'Historical' report type. |
| total_viewable_impressions_rate | NUMERIC | Total viewable impressions rate | The percentage of total impressions viewed on the user's screen (out of the total impressions measurable by active view). Compatible with the 'Historical' report type. |
| totalcost | NUMERIC | Total cost | The total CPM and CPC revenue generated by the ad servers including line item-level dynamic allocation. Corresponds to "Total CPM and CPC revenue" in the Ad Manager UI. Compatible with the "Historical" report type. |
| video_viewership_average_view_rate | NUMERIC | Video viewership Average view rate | Average percentage of the video watched by users. |
| video_viewership_average_view_time | NUMERIC | Video viewership Average view time | Average time(seconds) users watched the video. |
| video_viewership_complete | NUMERIC | Video viewership Complete | The number of times the video played to completion. |
| video_viewership_completion_rate | NUMERIC | Video viewership Completion rate | Percentage of times the video played to the end. |
| video_viewership_engaged_view | NUMERIC | Video viewership Engaged view | The number of engaged views i.e. ad is viewed to completion or for 30s, whichever comes first. |
| video_viewership_first_quartile | NUMERIC | Video viewership First quartile | The number of times the video played to 25% of its length. |
| video_viewership_midpoint | NUMERIC | Video viewership midpoint | The number of times the video reached its midpoint during play. |
| video_viewership_start | NUMERIC | Video viewership Start | The number of impressions where the video was played. |
| video_viewership_third_quartile | NUMERIC | Video viewership third quartile | The number of times the video played to 75% of its length. |
| video_viewership_video_length | NUMERIC | Video viewership Video length | Duration of the video creative. |
| video_viewership_view_through_rate | NUMERIC | Video viewership View-through rate | View-through rate represented as a percentage. |
| week | TEXT | Week | Week (Sun-Sat). |
| 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 | Year |
| 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 |