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_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_id | TEXT | Line item ID | The id of the line item associated to the Creative that served to the ad slot request. |
| 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_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_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_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 |