Hide

type ReportQuery (v201411)

A ReportQuery object allows you to specify the selection criteria for generating a report.


Namespace
https://www.google.com/apis/ads/publisher/v201411
Fields
Field Type Description
dimensions Dimension[] The list of break-down types being requested in the report. The generated report will contain the dimensions in the same order as requested.
Enumerations
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'.
WEEK
Breaks down reporting data by week of the year in the network time zone. Cannot be used for filtering.
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'".
DAY
Breaks down reporting data by day of the week in the network time zone. Can be used to filter by day of the week using the index of the day (from 1 for Monday is 1 to 7 for Sunday).
HOUR
Breaks down reporting data by hour of the day in the network time zone. Can be used to filter by hour of the day (from 0 to 23).
LINE_ITEM_ID
Breaks down reporting data by LineItem.id. Can be used to filter by LineItem.id.
LINE_ITEM_NAME
Breaks down reporting data by line item. LineItem.name and LineItem.id are automatically included as columns in the report. Can be used to filter by LineItem.name.
LINE_ITEM_TYPE
Breaks down reporting data by LineItem.lineItemType. Can be used to filter by line item type using LineItemType enumeration names.
ORDER_ID
Breaks down reporting data by Order.id. Can be used to filter by Order.id.
ORDER_NAME
Breaks down reporting data by order. Order.name and Order.id are automatically included as columns in the report. Can be used to filter by Order.name.
ADVERTISER_ID
Breaks down reporting data by advertising company Company.id. Can be used to filter by Company.id.
ADVERTISER_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.
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.

AD_NETWORK_NAME
The name of the network defined in AD_NETWORK_ID.
SALESPERSON_ID
Breaks down reporting data by salesperson User.id. Can be used to filter by User.id.
SALESPERSON_NAME
Breaks down reporting data by salesperson. User.name and User.id of the salesperson are automatically included as columns in the report. Can be used to filter by User.name.
CREATIVE_ID
Breaks down reporting data by Creative.id or creative set id (master's Creative.id) if the creative is part of a creative set. Can be used to filter by Creative.id.
CREATIVE_NAME
Breaks down reporting data by creative. Creative.name and Creative.id are automatically included as columns in the report. Can be used to filter by Creative.name.
CREATIVE_TYPE
Breaks down reporting data by creative type.
CUSTOM_EVENT_ID
Breaks down reporting data by custom event ID.
CUSTOM_EVENT_NAME
Breaks down reporting data by custom event name.
CUSTOM_EVENT_TYPE
Breaks down reporting data by custom event type (timer/exit/counter).
CREATIVE_SIZE
Breaks down reporting data by Creative.size. Cannot be used for filtering.
AD_UNIT_ID
Breaks down reporting data by AdUnit.id. Can be used to filter by AdUnit.id. AD_UNIT_NAME, i.e. AdUnit.name, is automatically included as a dimension in the report.
AD_UNIT_NAME
Breaks down reporting data by ad unit. AdUnit.name and AdUnit.id are automatically included as columns in the report. Can be used to filter by AdUnit.name.
PARENT_AD_UNIT_ID
Used to filter on all the descendants of an ad unit by AdUnit.id. Not available as a dimension to report on.
PARENT_AD_UNIT_NAME
Used to filter on all the descendants of an ad unit by AdUnit.name. Not available as a dimension to report on.
PLACEMENT_ID
Breaks down reporting data by Placement.id. Can be used to filter by Placement.id.
PLACEMENT_NAME
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.
TARGETING
Breaks down reporting data by criteria predefined by DoubleClick For Publishers like the operating system, browser etc. Cannot be used for filtering.
DEVICE_CATEGORY_ID
The ID of the device category to which an ad is being targeted. Can be used to filter by device category ID.
DEVICE_CATEGORY_NAME
The category of device (smartphone, feature phone, tablet, or desktop) to which an ad is being targeted. Can be used to filter by device category name.
COUNTRY_CRITERIA_ID
Breaks down reporting data by country criteria ID. Can be used to filter by country criteria ID.
COUNTRY_NAME
Breaks down reporting data by country name. The country name and the country criteria ID are automatically included as columns in the report. Can be used to filter by country name using the US English name.
REGION_CRITERIA_ID
Breaks down reporting data by region criteria ID. Can be used to filter by region criteria ID.
REGION_NAME
Breaks down reporting data by region name. The region name and the region criteria ID are automatically included as columns in the report. Can be used to filter by region name using the US English name.
CITY_CRITERIA_ID
Breaks down reporting data by city criteria ID. Can be used to filter by city criteria ID.
CITY_NAME
Breaks down reporting data by city name. The city name and the city criteria ID are automatically included as columns in the report. Can be used to filter by city name using the US English name.
METRO_CRITERIA_ID
Breaks down reporting data by metro criteria ID. Can be used to filter by metro criteria ID.
METRO_NAME
Breaks down reporting data by metro name. The metro name and the metro criteria ID are automatically included as columns in the report. Can be used to filter by metro name using the US English name.
POSTAL_CODE_CRITERIA_ID
Breaks down reporting data by postal code criteria ID. Can be used to filter by postal code criteria ID.
POSTAL_CODE
Breaks down reporting data by postal code. The postal code and the postal code criteria ID are automatically included as columns in the report. Can be used to filter by postal code.
CUSTOM_TARGETING_VALUE_ID
Breaks down reporting data by CustomTargetingValue.id. Can be used to filter by CustomTargetingValue.id.
CUSTOM_CRITERIA
Breaks down reporting data by custom criteria. The CustomTargetingValue is displayed in the form: CUSTOM_TARGETING_VALUE_ID, i.e. CustomTargetingValue.id is automatically included as a column in the report. Cannot be used for filtering; use CUSTOM_TARGETING_VALUE_ID instead.

When using this Dimension, metrics for freeform key values are only reported on when they are registered with CustomTargetingService.

ACTIVITY_ID
Breaks down reporting data by activity ID. Can be used to filter by activity ID.
ACTIVITY_NAME
Breaks down reporting data by activity. The activity name and the activity ID are automatically included as columns in the report. Can be used to filter by activity name.
ACTIVITY_GROUP_ID
Breaks down reporting data by activity group ID. Can be used to filter by activity group ID.
ACTIVITY_GROUP_NAME
Breaks down reporting data by activity group. The activity group name and the activity group ID are automatically included as columns in the report. Can be used to filter by activity group name.
CONTENT_ID
Breaks down reporting data by Content.id. Can be used to filter by Content.id.
CONTENT_NAME
Breaks down reporting data by content. Content.name and Content.id are automatically included as columns in the report. Can be used to filter by Content.name.
CONTENT_BUNDLE_ID
Breaks down reporting data by ContentBundle.id. Can be used to filter by ContentBundle.id.
CONTENT_BUNDLE_NAME
Breaks down reporting data by content bundle. ContentBundle.name and ContentBundle.id are automatically included as columns in the report. Can be used to filter by ContentBundle.name.
CONTENT_HIERARCHY
Breaks down reporting data by the content hierarchy. To use this dimension, a list of custom targeting key IDs must be specified in ReportQuery.contentMetadataKeyHierarchyCustomTargetingKeyIds.

This dimension can be used as a filter in the Statement in PQL syntax: CONTENT_HIERARCHY_CUSTOM_TARGETING_KEY[contentMetadataKeyHierarchyCustomTargetingKeyId]_ID = custom targeting value ID

For example: WHERE CONTENT_HIERARCHY_CUSTOM_TARGETING_KEY[4242]_ID = 53423

VIDEO_FALLBACK_POSITION
Breaks down reporting data by the fallback position of the video ad, i.e., NON_FALLBACK, FALLBACK_POSITION_1, FALLBACK_POSITION_2, etc. Can be used for filtering.
POSITION_OF_POD
Breaks down reporting data by the position of the video ad within the video stream, i.e., UNKNOWN_POSITION, PREROLL, POSTROLL, UNKNOWN_MIDROLL, MIDROLL_1, MIDROLL_2, etc. UNKNOWN_MIDROLL represents a midroll, but which specific midroll is unknown. Can be used for filtering.
POSITION_IN_POD
Breaks down reporting data by the position of the video ad within the pod, i.e., UNKNOWN_POSITION, POSITION_1, POSITION_2, etc. Can be used for filtering.
GRP_DEMOGRAPHICS
Breaks down reporting data by gender and age group, i.e., MALE_13_TO_17, MALE_18_TO_24, MALE_25_TO_34, MALE_35_TO_44, MALE_45_TO_54, MALE_55_TO_64, MALE_65_PLUS, FEMALE_13_TO_17, FEMALE_18_TO_24, FEMALE_25_TO_34, FEMALE_35_TO_44, FEMALE_45_TO_54, FEMALE_55_TO_64, FEMALE_65_PLUS, UNKNOWN_0_TO_17 and UNKNOWN. Whenever this dimension is selected, COUNTRY_NAME must be selected.

This dimension is supported only for GRP columns.

AD_REQUEST_SIZE
Size of the creative requested for an ad.
AD_REQUEST_AD_UNIT_SIZES
Breaks down reporting data by the ad unit sizes specified in ad requests.

Formatted as comma separated values, e.g. "300x250,300x250v,300x60".

This dimension is supported only for sell-through columns.

AD_REQUEST_CUSTOM_CRITERIA
Breaks down reporting data by the custom criteria specified in ad requests.

Formatted as comma separated key-values, where a key-value is formatted as key1=value_1|...|value_n,key2=value_1|...|value_n,....

This dimension is supported only for sell-through columns.

BUYER_ID
The unique identifier used for an ad network that is associated with the company that the ad is served for.
BUYER_NAME
The name of the ad network that is associated with the company that the ad is served for.
VERIFIED_ADVERTISER_ID
ID of the advertiser that filled the ad either directly (through DFP) or indirectly via Google Ad Exchange or another ad network or exchange.
VERIFIED_ADVERTISER_NAME
Name of the advertiser that filled the ad either directly (through DFP) or indirectly via Google Ad Exchange or another ad network or exchange.
MASTER_COMPANION_CREATIVE_ID
Breaks down reporting data by Creative.id. This includes regular creatives, and master and companions in case of creative sets.
MASTER_COMPANION_CREATIVE_NAME
Breaks down reporting data by creative. This includes regular creatives, and master and companions in case of creative sets.
DISTRIBUTION_PARTNER_ID
Breaks down reporting data by ID of the distribution partner.
DISTRIBUTION_PARTNER_NAME
Breaks down reporting data by name of the distribution partner.
CONTENT_PARTNER_ID
Breaks down reporting data by ID of the content partner.
CONTENT_PARTNER_NAME
Breaks down reporting data by name of the content partner.
RIGHTS_HOLDER_ID
Breaks down reporting data by ID of the rights holder.
RIGHTS_HOLDER_NAME
Breaks down reporting data by name of the rights holder.
PROPOSAL_LINE_ITEM_ID
Breaks down reporting data by ProposalLineItem.id. Can be used to filter by ProposalLineItem.id.
PROPOSAL_LINE_ITEM_NAME
Breaks down reporting data by ProposalLineItem.name. Can be used to filter by ProposalLineItem.name.
PROPOSAL_ID
Breaks down reporting data by Proposal.id. Can be used to filter by Proposal.id.
PROPOSAL_NAME
Breaks down reporting data by Proposal.name. Can be used to filter by Proposal.name.
ALL_SALESPEOPLE_ID
Breaks down reporting data by salesperson User.id, including both salesperson and secondary salespeople. Can be used to filter by all salespeople User.id.
ALL_SALESPEOPLE_NAME
Breaks down reporting data by salesperson User.name, including both salesperson and secondary salespeople. Can be used to filter by all salespeople User.name.
PROPOSAL_AGENCY_ID
Breaks down reporting data by proposal agency Company.id. Can be used to filter by proposal agency Company.id.
PROPOSAL_AGENCY_NAME
Breaks down reporting data by proposal agency Company.name. Can be used to filter by proposal agency Company.name.
PRODUCT_ID
Breaks down reporting data by Product.id. Can be used to filter by Product.id.
PRODUCT_NAME
Breaks down reporting data by Product.name.
PRODUCT_TEMPLATE_ID
Breaks down reporting data by ProductTemplate.id. Can be used to filter by ProductTemplate.id.
PRODUCT_TEMPLATE_NAME
Breaks down reporting data by ProductTemplate.name. Can be used to filter by ProductTemplate.name.
RATE_CARD_ID
Breaks down reporting data by RateCard.id. Can be used to filter by RateCard.id.
RATE_CARD_NAME
Breaks down reporting data by RateCard.name. Can be used to filter by RateCard.name.
WORKFLOW_ID
Used to filter by Workflow.id. Not available as a dimension to report on.
WORKFLOW_NAME
Used to filter by Workflow.name. Not available as a dimension to report on.
AUDIENCE_SEGMENT_ID
Breaks down reporting data by billable audience segment ID.
AUDIENCE_SEGMENT_NAME
Breaks down reporting data by billable audience segment name.
AUDIENCE_SEGMENT_DATA_PROVIDER_NAME
Breaks down reporting data by audience segment data provider name.
NIELSEN_OCR_SEGMENT
Campaign date segment of Nielsen OCR reporting.

This column is deprecated and replaced with NIELSEN_SEGMENT beginning in V201508.

adUnitView ReportQuery.AdUnitView The ad unit view for the report. Defaults to AdUnitView.TOP_LEVEL.
Enumerations
TOP_LEVEL
Only the top level ad units. Metrics include events for their descendants that are not filtered out.
FLAT
All the ad units. Metrics do not include events for the descendants.
HIERARCHICAL
Use the ad unit hierarchy. There will be as many ad unit columns as levels of ad units in the generated report:
  • The column Dimension.AD_UNIT_NAME is replaced with columns "Ad unit 1", "Ad unit 2", ... "Ad unit n". If level is not applicable to a row, "N/A" is returned as the value.
  • The column Dimension.AD_UNIT_ID is replaced with columns "Ad unit ID 1", "Ad unit ID 2", ... "Ad unit ID n". If level is not applicable to a row, "N/A" is returned as the value.

Metrics do not include events for the descendants.

columns Column[] The list of trafficking statistics and revenue information being requested in the report. The generated report will contain the columns in the same order as requested.
Enumerations
AD_SERVER_IMPRESSIONS
The number of impressions delivered by the ad server.
AD_SERVER_TARGETED_IMPRESSIONS
The number of impressions delivered by the ad server by explicit custom criteria targeting.
AD_SERVER_CLICKS
The number of clicks delivered by the ad server.
AD_SERVER_TARGETED_CLICKS
The number of clicks delivered by the ad server by explicit custom criteria targeting.
AD_SERVER_CTR
The CTR for an ad delivered by the ad server.
AD_SERVER_CPM_AND_CPC_REVENUE
The CPM and CPC revenue earned, calculated in publisher currency, for the ads delivered by the ad server.
AD_SERVER_CPD_REVENUE
The CPD revenue earned, calculated in publisher currency, for the ads delivered by the ad server.
AD_SERVER_CPA_REVENUE
The CPA revenue earned, calculated in publisher currency, for the ads delivered by the ad server.
AD_SERVER_ALL_REVENUE
The CPM, CPC and CPD revenue earned, calculated in publisher currency, for the ads delivered by the ad server.
AD_SERVER_WITHOUT_CPD_AVERAGE_ECPM
The average estimated cost-per-thousand-impressions earned from the CPM and CPC ads delivered by the ad server.
AD_SERVER_WITH_CPD_AVERAGE_ECPM
The average estimated cost-per-thousand-impressions earned from the CPM, CPC and CPD ads delivered by the ad server.
AD_SERVER_INVENTORY_LEVEL_PERCENT_IMPRESSIONS
The ratio of the number of impressions delivered to the total impressions delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well. Represented as a percentage.
AD_SERVER_LINE_ITEM_LEVEL_PERCENT_IMPRESSIONS
The ratio of the number of impressions delivered to the total impressions delivered by the ad server for line item-level dynamic allocation. Represented as a percentage.
AD_SERVER_INVENTORY_LEVEL_PERCENT_CLICKS
The ratio of the number of clicks delivered to the total clicks delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well. Represented as a percentage.
AD_SERVER_LINE_ITEM_LEVEL_PERCENT_CLICKS
The ratio of the number of clicks delivered to the total clicks delivered by the ad server for line item-level dynamic allocation. Represented as a percentage.
AD_SERVER_INVENTORY_LEVEL_WITHOUT_CPD_PERCENT_REVENUE
The ratio of revenue generated by ad server to the total CPM and CPC revenue earned by ads delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well. Represented as a percentage.
AD_SERVER_INVENTORY_LEVEL_WITH_CPD_PERCENT_REVENUE
The ratio of revenue generated by ad server to the total CPM, CPC and CPD revenue earned by ads delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well. Represented as a percentage.
AD_SERVER_LINE_ITEM_LEVEL_WITHOUT_CPD_PERCENT_REVENUE
The ratio of revenue generated by ad server to the total CPM and CPC revenue earned by the ads delivered for line item-level dynamic allocation. Represented as a percentage.
AD_SERVER_LINE_ITEM_LEVEL_WITH_CPD_PERCENT_REVENUE
The ratio of revenue generated by ad server to the total CPM, CPC and CPD revenue earned by the ads delivered for line item-level dynamic allocation. Represented as a percentage.
AD_SERVER_DELIVERY_INDICATOR
Indicates the progress made for the delivery of the LineItem.
Progress Definition
100% The LineItem is on track to deliver in full as per LineItem.unitsBought.
> 100% The LineItem is on track to overdeliver.
< 100% The LineItem is on track to underdeliver.
N/A The LineItem does not have any quantity goals, or there is insufficient information about the LineItem.
AD_SERVER_CODE_SERVED_COUNT
The number of times that the code for an ad is served by the ad server.
AD_SERVER_IMPRESSIONS_OUT_OF_NETWORK
The number of impressions delivered by the ad server on shared inventory unit in a partner's network.
AD_SERVER_CLICKS_OUT_OF_NETWORK
The number of clicks delivered by the ad server on shared inventory unit in a partner's network.
AD_SERVER_CTR_OUT_OF_NETWORK
The CTR for an ad delivered by the ad server on shared inventory unit in a partner's network.
DYNAMIC_ALLOCATION_INVENTORY_LEVEL_IMPRESSIONS
The number of impressions a dynamic allocation ad delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well.
TOTAL_DYNAMIC_ALLOCATION_IMPRESSIONS_OUT_OF_NETWORK
The number of partner network impressions a dynamic allocation ad delivered when no LineItem reservation could be found by the ad server for shared inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well.
ADSENSE_LINE_ITEM_LEVEL_IMPRESSIONS
The number of impressions an AdSense ad delivered for line item-level dynamic allocation.
ADSENSE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS
The number of impressions an AdSense ad delivered for line item-level dynamic allocation by explicit custom criteria targeting.
DYNAMIC_ALLOCATION_INVENTORY_LEVEL_CLICKS
The number of clicks a dynamic allocation ad delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well.
ADSENSE_LINE_ITEM_LEVEL_CLICKS
The number of clicks an AdSense ad delivered for line item-level dynamic allocation.
ADSENSE_LINE_ITEM_LEVEL_TARGETED_CLICKS
The number of clicks an AdSense ad delivered for line item-level dynamic allocation by explicit custom criteria targeting.
DYNAMIC_ALLOCATION_INVENTORY_LEVEL_CTR
The ratio of clicks a dynamic allocation ad delivered to the number of impressions it delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well.
ADSENSE_LINE_ITEM_LEVEL_CTR
The ratio of clicks an AdSense reservation ad delivered to the number of impressions it delivered, including line item-level dynamic allocation.
DYNAMIC_ALLOCATION_INVENTORY_LEVEL_REVENUE
Revenue generated from ads delivered for dynamic allocation when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well.
ADSENSE_LINE_ITEM_LEVEL_REVENUE
Revenue generated from AdSense ads delivered for line item-level dynamic allocation.
DYNAMIC_ALLOCATION_INVENTORY_LEVEL_AVERAGE_ECPM
The average estimated cost-per-thousand-impressions earned from dynamic allocation ads delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well.
ADSENSE_LINE_ITEM_LEVEL_AVERAGE_ECPM
The average estimated cost-per-thousand-impressions earned from the ads delivered by AdSense for line item-level dynamic allocation.
DYNAMIC_ALLOCATION_INVENTORY_LEVEL_PERCENT_IMPRESSIONS
The ratio of the number of impressions delivered by dynamic allocation ads to the total impressions delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well. Represented as a percentage.
ADSENSE_LINE_ITEM_LEVEL_PERCENT_IMPRESSIONS
The ratio of the number of impressions delivered by AdSense reservation ads to the total impressions delivered for line item-level dynamic allocation. Represented as a percentage.
DYNAMIC_ALLOCATION_INVENTORY_LEVEL_PERCENT_CLICKS
The ratio of the number of clicks delivered by dynamic allocation ads to the total clicks delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well. Represented as a percentage.
ADSENSE_LINE_ITEM_LEVEL_PERCENT_CLICKS
The ratio of the number of clicks delivered by AdSense reservation ads to the total clicks delivered for line item-level dynamic allocation. Represented as a percentage.
DYNAMIC_ALLOCATION_INVENTORY_LEVEL_WITHOUT_CPD_PERCENT_REVENUE
The ratio of revenue to the total revenue earned from the dynamic allocation CPM and CPC ads delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well. Represented as a percentage.
DYNAMIC_ALLOCATION_INVENTORY_LEVEL_WITH_CPD_PERCENT_REVENUE
The ratio of revenue to the total revenue earned from the dynamic allocation CPM, CPC and CPD ads delivered when no LineItem reservation could be found by the ad server for inventory-level dynamic allocation. For premium networks, this includes line item-level dynamic allocation as well. Represented as a percentage.
ADSENSE_LINE_ITEM_LEVEL_WITHOUT_CPD_PERCENT_REVENUE
The ratio of revenue to the total revenue earned from the CPM and CPC ads delivered by AdSense for line item-level dynamic allocation. Represented as a percentage.
ADSENSE_LINE_ITEM_LEVEL_WITH_CPD_PERCENT_REVENUE
The ratio of revenue to the total revenue earned from the CPM, CPC and CPD ads delivered by AdSense for line item-level dynamic allocation. Represented as a percentage.
AD_EXCHANGE_LINE_ITEM_LEVEL_IMPRESSIONS
The number of impressions an Ad Exchange ad delivered for line item-level dynamic allocation.
AD_EXCHANGE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS
The number of impressions an Ad Exchange ad delivered for line item-level dynamic allocation by explicit custom criteria targeting.
AD_EXCHANGE_LINE_ITEM_LEVEL_CLICKS
The number of clicks an Ad Exchange ad delivered for line item-level dynamic allocation.
AD_EXCHANGE_LINE_ITEM_LEVEL_TARGETED_CLICKS
The number of clicks an Ad Exchange ad delivered for line item-level dynamic allocation by explicit custom criteria targeting.
AD_EXCHANGE_LINE_ITEM_LEVEL_CTR
The ratio of clicks an Ad Exchange ad delivered to the number of impressions it delivered for line item-level dynamic allocation.
AD_EXCHANGE_LINE_ITEM_LEVEL_PERCENT_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.
AD_EXCHANGE_LINE_ITEM_LEVEL_PERCENT_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.
AD_EXCHANGE_LINE_ITEM_LEVEL_REVENUE
Revenue generated from Ad Exchange ads delivered for line item-level dynamic allocation. Represented in publisher currency and time zone.
AD_EXCHANGE_LINE_ITEM_LEVEL_WITHOUT_CPD_PERCENT_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.
AD_EXCHANGE_LINE_ITEM_LEVEL_WITH_CPD_PERCENT_REVENUE
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.
AD_EXCHANGE_LINE_ITEM_LEVEL_AVERAGE_ECPM
The average estimated cost-per-thousand-impressions earned from the delivery of Ad Exchange ads for line item-level dynamic allocation.
TOTAL_INVENTORY_LEVEL_IMPRESSIONS
The total number of impressions delivered by the ad servers including inventory-level dynamic allocation.
TOTAL_LINE_ITEM_LEVEL_IMPRESSIONS
The total number of impressions delivered including line item-level dynamic allocation.
TOTAL_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS
The total number of impressions delivered including line item-level dynamic allocation by explicit custom criteria targeting.
TOTAL_LINE_ITEM_LEVEL_IMPRESSIONS_INCLUDING_OUT_OF_NETWORK_DELIVERY
The total number of impressions delivered by the ad server on a shared inventory unit in a partner's network and through line item-level dynamic allocation.
TOTAL_INVENTORY_LEVEL_CLICKS
The total number of clicks delivered by the ad servers including inventory-level dynamic allocation.
TOTAL_LINE_ITEM_LEVEL_CLICKS
The total number of clicks delivered including line item-level dynamic allocation.
TOTAL_LINE_ITEM_LEVEL_TARGETED_CLICKS
The total number of clicks delivered including line item-level dynamic allocation by explicit custom criteria targeting
TOTAL_INVENTORY_LEVEL_CTR
The ratio of total clicks on ads delivered by the ad servers to the total number of impressions delivered for an ad including inventory-level dynamic allocation.
TOTAL_LINE_ITEM_LEVEL_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_INVENTORY_LEVEL_CPM_AND_CPC_REVENUE
The total CPM and CPC revenue generated by the ad servers including inventory-level dynamic allocation.
TOTAL_INVENTORY_LEVEL_ALL_REVENUE
The total CPM, CPC and CPD revenue generated by the ad servers including inventory-level dynamic allocation.
TOTAL_LINE_ITEM_LEVEL_CPM_AND_CPC_REVENUE
The total CPM and CPC revenue generated by the ad servers including line item-level dynamic allocation.
TOTAL_LINE_ITEM_LEVEL_ALL_REVENUE
The total CPM, CPC and CPD revenue generated by the ad servers including line item-level dynamic allocation.
TOTAL_INVENTORY_LEVEL_WITHOUT_CPD_AVERAGE_ECPM
Estimated cost-per-thousand-impressions (eCPM) of CPM and CPC ads delivered by the ad servers including inventory-level dynamic allocation.
TOTAL_INVENTORY_LEVEL_WITH_CPD_AVERAGE_ECPM
Estimated cost-per-thousand-impressions (eCPM) of CPM, CPC and CPD ads delivered by the ad servers including inventory-level dynamic allocation.
TOTAL_LINE_ITEM_LEVEL_WITHOUT_CPD_AVERAGE_ECPM
Estimated cost-per-thousand-impressions (eCPM) of CPM and CPC ads delivered by the ad servers including line item-level dynamic allocation.
TOTAL_LINE_ITEM_LEVEL_WITH_CPD_AVERAGE_ECPM
Estimated cost-per-thousand-impressions (eCPM) of CPM, CPC and CPD ads delivered by the ad servers including line item-level dynamic allocation.
TOTAL_CODE_SERVED_COUNT
The total number of times that the code for an ad is served by the ad server including inventory-level dynamic allocation.
TOTAL_INVENTORY_LEVEL_UNFILLED_IMPRESSIONS
The total number of missed impressions due to the ad servers' inability to find ads to serve, including inventory-level dynamic allocation.
TOTAL_UNFILLED_IMPRESSIONS_INCLUDING_OUT_OF_NETWORK_DELIVERY
The total number of missed impressions due to the ad servers' inability to find ads to serve, including inventory-level dynamic allocation on shared inventory units.
MERGED_AD_SERVER_DELIVERY_INDICATOR
Indicates the progress made for the delivery of the LineItem based on the units delivered by both DART and DoubleClick For Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.
Progress Definition
100% The LineItem is on track to deliver in full as per LineItem.unitsBought.
> 100% The LineItem is on track to overdeliver.
< 100% The LineItem is on track to underdeliver.
N/A The LineItem does not have any quantity goals, or there is insufficient information about the LineItem.

This column is deprecated use AD_SERVER_DELIVERY_INDICATOR instead.

MERGED_AD_SERVER_IMPRESSIONS
The total number of impressions delivered by both DART and DoubleClick For Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

DART data is available for the following timeframes:

  • 6 months before upgrade date for daily reports.
  • 16 months before upgrade date for monthly reports.
  • This column is deprecated use AD_SERVER_IMPRESSIONS instead.

MERGED_AD_SERVER_CLICKS
The total number of clicks delivered by both DART and DoubleClick For Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

DART data is available for the following timeframes:

  • 6 months before upgrade date for daily reports.
  • 16 months before upgrade date for monthly reports.
  • This column is deprecated use AD_SERVER_CLICKS instead.

MERGED_AD_SERVER_CTR
The sum of the CTR achieved from both DART and DoubleClick For Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

DART data is available for the following timeframes:

  • 6 months before upgrade date for daily reports.
  • 16 months before upgrade date for monthly reports.
  • This column is deprecated use AD_SERVER_CTR instead.

MERGED_AD_SERVER_CPM_AND_CPC_REVENUE
The sum of the CPM and CPC revenue generated from both DART and DoubleClick For Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

DART data is available for the following timeframes:

  • 6 months before upgrade date for daily reports.
  • 16 months before upgrade date for monthly reports.
  • This column is deprecated use AD_SERVER_CPM_AND_CPC_REVENUE instead.

MERGED_AD_SERVER_ALL_REVENUE
The sum of the CPM, CPC and CPD revenue generated from both DART and DoubleClick For Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

DART data is available for the following timeframes:

  • 6 months before upgrade date for daily reports.
  • 16 months before upgrade date for monthly reports.
  • This column is deprecated use AD_SERVER_ALL_REVENUE instead.

MERGED_AD_SERVER_WITHOUT_CPD_AVERAGE_ECPM
The average estimated cost-per-thousand-impressions earned from the CPM and CPC ads delivered by both DART and DoubleClick For Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

DART data is available for the following timeframes:

  • 6 months before upgrade date for daily reports.
  • 16 months before upgrade date for monthly reports.
  • This column is deprecated use AD_SERVER_WITHOUT_CPD_AVERAGE_ECPM instead.

MERGED_AD_SERVER_WITH_CPD_AVERAGE_ECPM
The average estimated cost-per-thousand-impressions earned from the CPM, CPC and CPD ads delivered by both DART and DoubleClick For Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

DART data is available for the following timeframes:

  • 6 months before upgrade date for daily reports.
  • 16 months before upgrade date for monthly reports.
  • This column is deprecated use AD_SERVER_WITH_CPD_AVERAGE_ECPM instead.

OPTIMIZATION_CONTROL_IMPRESSIONS
The number of control (unoptimized) impressions delivered for an ad for which the optimization feature has been enabled.
OPTIMIZATION_CONTROL_CLICKS
Number of clicks resulting from the delivery of control (unoptimized) impressions for an ad for which the optimization feature has been enabled.
OPTIMIZATION_CONTROL_CTR
The CTR for control (unoptimized) impressions for an order for which the optimization feature has been enabled.
OPTIMIZATION_OPTIMIZED_IMPRESSIONS
Number of optimized impressions delivered for an ad for which the optimization feature has been enabled.
OPTIMIZATION_OPTIMIZED_CLICKS
Number of clicks resulting from the delivery of optimized impressions for an ad for which the optimization feature has been enabled.
OPTIMIZATION_NON_OPTIMIZED_IMPRESSIONS
Number of non-optimized impressions delivered for an ad for which the optimization feature has been enabled.
OPTIMIZATION_NON_OPTIMIZED_CLICKS
Number of clicks resulting from the delivery of non-optimized impressions for an ad for which the optimization feature has been enabled.
OPTIMIZATION_EXTRA_CLICKS
Number of extra clicks resulting from the delivery of optimized impressions for an ad for which the optimization feature has been enabled.
OPTIMIZATION_OPTIMIZED_CTR
The CTR for optimized impressions for an ad for which the optimization feature has been enabled.
OPTIMIZATION_LIFT
The percentage by which optimized CTRs are greater than the unoptimized CTRs. This is calculated as ((Column.OPTIMIZATION_OPTIMIZED_CTR/ Column.OPTIMIZATION_CONTROL_CTR) - 1) * 100 for an ad for which the optimization feature has been enabled.
OPTIMIZATION_COVERAGE
The line item coverage measures how often the traffic was sent for optimization.
OPTIMIZATION_BEHIND_SCHEDULE_IMPRESSIONS
The number of impressions that were behind schedule at the time of their delivery.
OPTIMIZATION_NO_CLICKS_RECORDED_IMPRESSIONS
The number of impressions that did not have any clicks recorded in the recent past.
OPTIMIZATION_SPONSORSHIP_IMPRESSIONS
The number of impressions that were delivered as sponsorship items.
OPTIMIZATION_AS_FAST_AS_POSSIBLE_IMPRESSIONS
The number of impressions that were set to deliver as fast as possible.
OPTIMIZATION_NO_ABSOLUTE_LIFETIME_GOAL_IMPRESSIONS
The number of impressions that have no absolute lifetime delivery goals.
OPTIMIZATION_CONTROL_REVENUE
Total revenue resulting from the delivery of control (unoptimized) impressions for an ad for which the optimization feature has been enabled.
OPTIMIZATION_OPTIMIZED_REVENUE
Total revenue resulting from the delivery of optimized impressions for an ad for which the optimization feature has been enabled.
OPTIMIZATION_CONTROL_ECPM
Estimated cost-per-thousand-impressions (eCPM) of control (unoptimized) impressions for an ad for which the optimization feature has been enabled.
OPTIMIZATION_OPTIMIZED_ECPM
Estimated cost-per-thousand-impressions (eCPM) of optimized impressions for an ad for which the optimization feature has been enabled.
OPTIMIZATION_FREED_UP_IMPRESSIONS
Freed-up impressions as a result of optimization.
OPTIMIZATION_ECPM_LIFT
Relative change in eCPM as a result of optimization.
REACH_FREQUENCY
The average number of ads displayed to each unique visitor.
REACH_AVERAGE_REVENUE
The average revenue earned per unique visitor.
REACH
The number of unique visitors.
GRP_POPULATION
The number of people in the given demographic bucket.
GRP_UNIQUE_AUDIENCE
The number of unique users reached in the given demographic bucket.
GRP_UNIQUE_AUDIENCE_SHARE
Percentage of the number of unique users reached in the given demographic bucket (out of the number of unique users reached in all demographics).
GRP_AUDIENCE_IMPRESSIONS
The number of impressions in the given demographic bucket.
GRP_AUDIENCE_IMPRESSIONS_SHARE
Percentage of the number of impressions in the given demographic bucket (out of the number of impressions in all demographics).
GRP_AUDIENCE_REACH
The audience reach calculated as GRP_UNIQUE_AUDIENCE / GRP_POPULATION.
GRP_AUDIENCE_AVERAGE_FREQUENCY
The audience average frequency calculated as GRP_AUDIENCE_IMPRESSIONS / GRP_UNIQUE_AUDIENCE.
GRP_GROSS_RATING_POINTS
The gross rating points (GRP) calculated as GRP_AUDIENCE_REACH * GRP_AUDIENCE_AVERAGE_FREQUENCY * 100.
SDK_MEDIATION_CREATIVE_IMPRESSIONS
The number of impressions for a particular SDK mediation creative.
SDK_MEDIATION_CREATIVE_CLICKS
The number of clicks for a particular SDK mediation creative.
SELL_THROUGH_FORECASTED_IMPRESSIONS
The number of forecasted impressions for future sell-through reports.

This metric is available for the next 90 days with a daily break down and for the next 12 months with a monthly break down.

SELL_THROUGH_AVAILABLE_IMPRESSIONS
The number of available impressions for future sell-through reports.

This metric is available for the next 90 days with a daily break down and for the next 12 months with a monthly break down.

SELL_THROUGH_RESERVED_IMPRESSIONS
The number of reserved impressions for future sell-through reports.

This metric is available for the next 90 days with a daily break down and for the next 12 months with a monthly break down.

SELL_THROUGH_SELL_THROUGH_RATE
The sell-through rate for impressions for future sell-through reports.

This metric is available for the next 90 days with a daily break down and for the next 12 months with a monthly break down.

RICH_MEDIA_BACKUP_IMAGES
The total number of times a backup image is served in place of a rich media ad.
RICH_MEDIA_DISPLAY_TIME
The amount of time(seconds) that each rich media ad is displayed to users.
RICH_MEDIA_AVERAGE_DISPLAY_TIME
The average amount of time(seconds) that each rich media ad is displayed to users.
RICH_MEDIA_EXPANSIONS
The number of times an expanding ad was expanded.
RICH_MEDIA_EXPANDING_TIME
The average amount of time(seconds) that an expanding ad is viewed in an expanded state.
RICH_MEDIA_INTERACTION_TIME
The average amount of time(seconds) that a user interacts with a rich media ad.
RICH_MEDIA_INTERACTION_COUNT
The number of times that a user interacts with a rich media ad.
RICH_MEDIA_INTERACTION_RATE
The ratio of rich media ad interactions to the number of times the ad was displayed. Represented as a percentage.
RICH_MEDIA_AVERAGE_INTERACTION_TIME
The average amount of time(seconds) that a user interacts with a rich media ad.
RICH_MEDIA_INTERACTION_IMPRESSIONS
The number of impressions where a user interacted with a rich media ad.
RICH_MEDIA_MANUAL_CLOSES
The number of times that a user manually closes a floating, expanding, in-page with overlay, or in-page with floating ad.
RICH_MEDIA_FULL_SCREEN_IMPRESSIONS
A metric that measures an impression only once when a user opens an ad in full screen mode.
RICH_MEDIA_VIDEO_INTERACTIONS
The number of times a user clicked on the graphical controls of a video player.
RICH_MEDIA_VIDEO_INTERACTION_RATE
The ratio of video interactions to video plays. Represented as a percentage.
RICH_MEDIA_VIDEO_MUTES
The number of times a rich media video was muted.
RICH_MEDIA_VIDEO_PAUSES
The number of times a rich media video was paused.
RICH_MEDIA_VIDEO_PLAYES
The number of times a rich media video was played.
RICH_MEDIA_VIDEO_MIDPOINTS
The number of times a rich media video was played upto midpoint.
RICH_MEDIA_VIDEO_COMPLETES
The number of times a rich media video was fully played.
RICH_MEDIA_VIDEO_REPLAYS
The number of times a rich media video was restarted.
RICH_MEDIA_VIDEO_STOPS
The number of times a rich media video was stopped.
RICH_MEDIA_VIDEO_UNMUTES
The number of times a rich media video was unmuted.
RICH_MEDIA_VIDEO_VIEW_TIME
The average amount of time(seconds) that a rich media video was viewed per view.
RICH_MEDIA_VIDEO_VIEW_RATE
The percentage of a video watched by a user.
RICH_MEDIA_CUSTOM_EVENT_TIME
The amount of time (seconds) that a user interacts with a rich media ad.
RICH_MEDIA_CUSTOM_EVENT_COUNT
The number of times a user views and interacts with a specified part of a rich media ad.
VIDEO_VIEWERSHIP_START
The number of impressions where the video was played.
VIDEO_VIEWERSHIP_FIRST_QUARTILE
The number of times the video played to 25% of its length.
VIDEO_VIEWERSHIP_MIDPOINT
The number of times the video reached its midpoint during play.
VIDEO_VIEWERSHIP_THIRD_QUARTILE
The number of times the video played to 75% of its length.
VIDEO_VIEWERSHIP_COMPLETE
The number of times the video played to completion.
VIDEO_VIEWERSHIP_AVERAGE_VIEW_RATE
Average percentage of the video watched by users.
VIDEO_VIEWERSHIP_AVERAGE_VIEW_TIME
Average time(seconds) users watched the video.
VIDEO_VIEWERSHIP_COMPLETION_RATE
Percentage of times the video played to the end.
VIDEO_VIEWERSHIP_TOTAL_ERROR_COUNT
The number of times an error occurred, such as a VAST redirect error, a video playback error, or an invalid response error.
VIDEO_VIEWERSHIP_VIDEO_LENGTH
Duration of the video creative.
VIDEO_VIEWERSHIP_SKIP_BUTTON_SHOWN
The number of times a skip button is shown in video.
VIDEO_VIEWERSHIP_ENGAGED_VIEW
The number of engaged views i.e. ad is viewed to completion or for 30s, whichever comes first.
VIDEO_VIEWERSHIP_VIEW_THROUGH_RATE
View-through rate represented as a percentage.
VIDEO_VIEWERSHIP_TOTAL_ERROR_RATE
Error rate is the percentage of video error count from (error count + total impressions).
VIDEO_ERRORS_VAST_2_ERROR_COUNT
Number of VAST2 video errors.
VIDEO_ERRORS_VAST_3_ERROR_100_COUNT
Number of VAST3 video errors of type 100.
VIDEO_ERRORS_VAST_3_ERROR_101_COUNT
Number of VAST3 video errors of type 101.
VIDEO_ERRORS_VAST_3_ERROR_102_COUNT
Number of VAST3 video errors of type 102.
VIDEO_ERRORS_VAST_3_ERROR_200_COUNT
Number of VAST3 video errors of type 200.
VIDEO_ERRORS_VAST_3_ERROR_201_COUNT
Number of VAST3 video errors of type 201.
VIDEO_ERRORS_VAST_3_ERROR_202_COUNT
Number of VAST3 video errors of type 202.
VIDEO_ERRORS_VAST_3_ERROR_203_COUNT
Number of VAST3 video errors of type 203.
VIDEO_ERRORS_VAST_3_ERROR_300_COUNT
Number of VAST3 video errors of type 300.
VIDEO_ERRORS_VAST_3_ERROR_301_COUNT
Number of VAST3 video errors of type 301.
VIDEO_ERRORS_VAST_3_ERROR_302_COUNT
Number of VAST3 video errors of type 302.
VIDEO_ERRORS_VAST_3_ERROR_303_COUNT
Number of VAST3 video errors of type 303.
VIDEO_ERRORS_VAST_3_ERROR_400_COUNT
Number of VAST3 video errors of type 400.
VIDEO_ERRORS_VAST_3_ERROR_401_COUNT
Number of VAST3 video errors of type 401.
VIDEO_ERRORS_VAST_3_ERROR_402_COUNT
Number of VAST3 video errors of type 402.
VIDEO_ERRORS_VAST_3_ERROR_403_COUNT
Number of VAST3 video errors of type 403.
VIDEO_ERRORS_VAST_3_ERROR_405_COUNT
Number of VAST3 video errors of type 405.
VIDEO_ERRORS_VAST_3_ERROR_500_COUNT
Number of VAST3 video errors of type 500.
VIDEO_ERRORS_VAST_3_ERROR_501_COUNT
Number of VAST3 video errors of type 501.
VIDEO_ERRORS_VAST_3_ERROR_502_COUNT
Number of VAST3 video errors of type 502.
VIDEO_ERRORS_VAST_3_ERROR_503_COUNT
Number of VAST3 video errors of type 503.
VIDEO_ERRORS_VAST_3_ERROR_600_COUNT
Number of VAST3 video errors of type 600.
VIDEO_ERRORS_VAST_3_ERROR_601_COUNT
Number of VAST3 video errors of type 601.
VIDEO_ERRORS_VAST_3_ERROR_602_COUNT
Number of VAST3 video errors of type 602.
VIDEO_ERRORS_VAST_3_ERROR_603_COUNT
Number of VAST3 video errors of type 603.
VIDEO_ERRORS_VAST_3_ERROR_604_COUNT
Number of VAST3 video errors of type 604.
VIDEO_ERRORS_VAST_3_ERROR_900_COUNT
Number of VAST3 video errors of type 900.
VIDEO_ERRORS_VAST_3_ERROR_901_COUNT
Number of VAST3 video errors of type 901.
VIDEO_INTERACTION_PAUSE
Video interaction event: The number of times user paused ad clip.
VIDEO_INTERACTION_RESUME
Video interaction event: The number of times the user unpaused the video.
VIDEO_INTERACTION_REWIND
Video interaction event: The number of times a user rewinds the video.
VIDEO_INTERACTION_MUTE
Video interaction event: The number of times video player was in mute state during play of ad clip.
VIDEO_INTERACTION_UNMUTE
Video interaction event: The number of times a user unmutes the video.
VIDEO_INTERACTION_COLLAPSE
Video interaction event: The number of times a user collapses a video, either to its original size or to a different size.
VIDEO_INTERACTION_EXPAND
Video interaction event: The number of times a user expands a video.
VIDEO_INTERACTION_FULL_SCREEN
Video interaction event: The number of times ad clip played in full screen mode.
VIDEO_INTERACTION_AVERAGE_INTERACTION_RATE
Video interaction event: The number of user interactions with a video, on average, such as pause, full screen, mute, etc.
VIDEO_INTERACTION_VIDEO_SKIPS
Video interaction event: The number of times a skippable video is skipped.
VIDEO_OPTIMIZATION_CONTROL_STARTS
The number of control starts.
VIDEO_OPTIMIZATION_OPTIMIZED_STARTS
The number of optimized starts.
VIDEO_OPTIMIZATION_CONTROL_COMPLETES
The number of control completes.
VIDEO_OPTIMIZATION_OPTIMIZED_COMPLETES
The number of optimized completes.
VIDEO_OPTIMIZATION_CONTROL_COMPLETION_RATE
The rate of control completions.
VIDEO_OPTIMIZATION_OPTIMIZED_COMPLETION_RATE
The rate of optimized completions.
VIDEO_OPTIMIZATION_COMPLETION_RATE_LIFT
The percentage by which optimized completion rate is greater than the unoptimized completion rate. This is calculated as (( Column.VIDEO_OPTIMIZATION_OPTIMIZED_COMPLETION_RATE/ Column.VIDEO_OPTIMIZATION_CONTROL_COMPLETION_RATE) - 1) * 100 for an ad for which the optimization feature has been enabled.
VIDEO_OPTIMIZATION_CONTROL_SKIP_BUTTON_SHOWN
The number of control skip buttons shown.
VIDEO_OPTIMIZATION_OPTIMIZED_SKIP_BUTTON_SHOWN
The number of optimized skip buttons shown.
VIDEO_OPTIMIZATION_CONTROL_ENGAGED_VIEW
The number of control engaged views.
VIDEO_OPTIMIZATION_OPTIMIZED_ENGAGED_VIEW
The number of optimized engaged views.
VIDEO_OPTIMIZATION_CONTROL_VIEW_THROUGH_RATE
The control view-through rate.
VIDEO_OPTIMIZATION_OPTIMIZED_VIEW_THROUGH_RATE
The optimized view-through rate.
VIDEO_OPTIMIZATION_VIEW_THROUGH_RATE_LIFT
The percentage by which optimized view-through rate is greater than the unoptimized view-through rate. This is calculated as (( Column.VIDEO_OPTIMIZATION_OPTIMIZED_VIEW_THROUGH_RATE/ Column.VIDEO_OPTIMIZATION_CONTROL_VIEW_THROUGH_RATE) - 1) * 100 for an ad for which the optimization feature has been enabled.
TOTAL_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS
The total number of impressions viewed on the user's screen.
TOTAL_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS
The total number of impressions that were sampled and measured by active view.
TOTAL_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE
The percentage of total impressions viewed on the user's screen (out of the total impressions measurable by active view).
TOTAL_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS
Total number of impressions that were eligible to measure viewability.
TOTAL_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS_RATE
The percentage of total impressions that were measurable by active view (out of all the total impressions sampled for active view).
AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS
The number of impressions delivered by the ad server viewed on the user's screen.
AD_SERVER_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS
The number of impressions delivered by the ad server that were sampled, and measurable by active view.
AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE
The percentage of impressions delivered by the ad server viewed on the user's screen (out of the ad server impressions measurable by active view).
AD_SERVER_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS
Total number of impressions delivered by the ad server that were eligible to measure viewability.
AD_SERVER_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS_RATE
The percentage of impressions delivered by the ad server that were measurable by active view ( out of all the ad server impressions sampled for active view).
ADSENSE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS
The number of impressions delivered by AdSense viewed on the user's screen,
ADSENSE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS
The number of impressions delivered by AdSense that were sampled, and measurable by active view.
ADSENSE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE
The percentage of impressions delivered by AdSense viewed on the user's screen (out of AdSense impressions measurable by active view).
ADSENSE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS
Total number of impressions delivered by AdSense that were eligible to measure viewability.
ADSENSE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS_RATE
The percentage of impressions delivered by AdSense that were measurable by active view ( out of all AdSense impressions sampled for active view).
AD_EXCHANGE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS
The number of impressions delivered by Ad Exchange viewed on the user's screen,
AD_EXCHANGE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS
The number of impressions delivered by Ad Exchange that were sampled, and measurable by active view.
AD_EXCHANGE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE
The percentage of impressions delivered by Ad Exchange viewed on the user's screen (out of Ad Exchange impressions measurable by active view).
AD_EXCHANGE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS
Total number of impressions delivered by Ad Exchange that were eligible to measure viewability.
AD_EXCHANGE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS_RATE
The percentage of impressions delivered by Ad Exchange that were measurable by active view ( out of all Ad Exchange impressions sampled for active view).
DISTRIBUTION_PARTNER_IMPRESSIONS
The total number of impressions delivered by the network to the distribution partner.
DISTRIBUTION_PARTNER_CLICKS
The total number of clicks delivered by the network to the distribution partner.
DISTRIBUTION_PARTNER_CTR
The ratio of clicks to the total number of impressions delivered by the network to the distribution partner.
DISTRIBUTION_PARTNER_GROSS_REVENUE
The total revenue generated by the network to the distribution partner. It could be estimated or reconiled revenue according to current stage.
DISTRIBUTION_PARTNER_HOST_REVENUE
The host revenue generated by the network host through the distribution partner inventory units. It could be estimated or reconiled revenue according to current stage.
DISTRIBUTION_PARTNER_HOST_ECPM
Cost-per-thousand-impressions (eCPM) generated by the network host through the distribution partner inventory units. It could be estimated or reconiled eCPM according to current stage.
DISTRIBUTION_PARTNER_PARTNER_REVENUE
The revenue generated by the network distribution partner. It could be estimated or reconiled revenue according to current stage.
DISTRIBUTION_PARTNER_PARTNER_ECPM
Cost-per-thousand-impressions (eCPM) generated by the distribution partner. It could be estimated or reconiled eCPM according to current stage.
CONTENT_PARTNER_IMPRESSIONS
The total number of impressions delivered by the network to the content partner.
CONTENT_PARTNER_CLICKS
The total number of clicks delivered by the network to the content partner.
CONTENT_PARTNER_CTR
The ratio of clicks to the total number of impressions delivered by the network to the content partner.
CONTENT_PARTNER_GROSS_REVENUE
The total revenue generated by the network to the content partner. It could be estimated or reconiled revenue according to current stage.
CONTENT_PARTNER_HOST_REVENUE
The host revenue generated by the network host through the content partner's contents. It could be estimated or reconiled revenue according to current stage.
CONTENT_PARTNER_HOST_ECPM
Cost-per-thousand-impressions (eCPM) generated by the network host to the content partner's contents. It could be estimated or reconiled eCPM according to current stage.
CONTENT_PARTNER_PARTNER_REVENUE
The revenue generated by the network content partner. It could be estimated or reconiled revenue according to current stage.
CONTENT_PARTNER_PARTNER_ECPM
Cost-per-thousand-impressions (eCPM) generated by the content partner. It could be estimated or reconiled eCPM according to current stage.
RIGHTS_HOLDER_IMPRESSIONS
The total number of impressions delivered by the network to the rights holder.
RIGHTS_HOLDER_CLICKS
The total number of clicks delivered by the network to the rights holder.
RIGHTS_HOLDER_CTR
The ratio of clicks to the total number of impressions delivered by the network to the rights holder.
RIGHTS_HOLDER_GROSS_REVENUE
The total revenue generated by the network to the rights holder. It could be estimated or reconiled revenue according to current stage.
RIGHTS_HOLDER_HOST_REVENUE
The host revenue generated by the network host through the rights holder's contents. It could be estimated or reconiled revenue according to current stage.
RIGHTS_HOLDER_HOST_ECPM
Cost-per-thousand-impressions (eCPM) generated by the network host through the rights holder's contents. It could be estimated or reconiled eCPM according to current stage.
RIGHTS_HOLDER_PARTNER_REVENUE
The revenue generated by the network rights holder. It could be estimated or reconiled revenue according to current stage.
RIGHTS_HOLDER_PARTNER_ECPM
Cost-per-thousand-impressions (eCPM) generated by the rights holder. It could be estimated or reconiled eCPM according to current stage.
VIEW_THROUGH_CONVERSIONS
Number of view-through conversions.
CONVERSIONS_PER_THOUSAND_IMPRESSIONS
Number of view-through conversions per thousand impressions.
CLICK_THROUGH_CONVERSIONS
Number of click-through conversions.
CONVERSIONS_PER_CLICK
Number of click-through conversions per click.
VIEW_THROUGH_REVENUE
Revenue for view-through conversions.
CLICK_THROUGH_REVENUE
Revenue for click-through conversions.
TOTAL_CONVERSIONS
Total number of conversions.
TOTAL_CONVERSION_REVENUE
Total revenue for conversions.
DYNAMIC_ALLOCATION_OPPORTUNITY_IMPRESSIONS_COMPETING_TOTAL
The number of impressions sent to Ad Exchange / AdSense, regardless of whether they won or lost (total number of dynamic allocation impressions).
DYNAMIC_ALLOCATION_OPPORTUNITY_UNFILLED_IMPRESSIONS_COMPETING
The number of unfilled queries that attempted dynamic allocation by Ad Exchange / AdSense.
DYNAMIC_ALLOCATION_OPPORTUNITY_ELIGIBLE_IMPRESSIONS_TOTAL
The number of Ad Exchange / AdSense and DFP impressions.
DYNAMIC_ALLOCATION_OPPORTUNITY_IMPRESSIONS_NOT_COMPETING_TOTAL
The difference between eligible impressions and competing impressions in dynamic allocation.
DYNAMIC_ALLOCATION_OPPORTUNITY_IMPRESSIONS_NOT_COMPETING_PERCENT_TOTAL
The percentage of eligible impressions that are not competing in dynamic allocation.
DYNAMIC_ALLOCATION_OPPORTUNITY_SATURATION_RATE_TOTAL
The percent of eligible impressions participating in dynamic allocation.
DYNAMIC_ALLOCATION_OPPORTUNITY_MATCH_RATE_TOTAL
The percent of total dynamic allocation queries that won.
CONTRACTED_REVENUE_CONTRACTED_NET_REVENUE
The contracted net revenue of the ProposalLineItem.
CONTRACTED_REVENUE_LOCAL_CONTRACTED_NET_REVENUE
The contracted net revenue in the local currency of the ProposalLineItem. See CONTRACTED_REVENUE_CONTRACTED_NET_REVENUE
CONTRACTED_REVENUE_CONTRACTED_GROSS_REVENUE
The contracted gross revenue of the ProposalLineItem, including agency commission.
CONTRACTED_REVENUE_LOCAL_CONTRACTED_GROSS_REVENUE
The contracted gross revenue in the local currency of the ProposalLineItem, including agency commission. See CONTRACTED_REVENUE_CONTRACTED_GROSS_REVENUE
CONTRACTED_REVENUE_CONTRACTED_PLACEMENT_NET_REVENUE
The contracted net revenue of the ProposalLineItem. This revenue is the raw revenue without a Proposal level additional adjustment applied.
CONTRACTED_REVENUE_CONTRACTED_PLACEMENT_GROSS_REVENUE
The contracted gross revenue of the ProposalLineItem. This revenue is the raw revenue without a Proposal level additional adjustment applied, and including agency commission.
CONTRACTED_REVENUE_CONTRACTED_VAT
The value added tax on contracted net revenue of the ProposalLineItem or Proposal.
CONTRACTED_REVENUE_LOCAL_CONTRACTED_VAT
The value added tax on contracted net revenue in the local currency of the ProposalLineItem or Proposal. See CONTRACTED_REVENUE_CONTRACTED_VAT
CONTRACTED_REVENUE_CONTRACTED_AGENCY_COMMISSION
The contracted agency commission of the ProposalLineItem or Proposal.
CONTRACTED_REVENUE_LOCAL_CONTRACTED_AGENCY_COMMISSION
The contracted agency commission in the local currency of the ProposalLineItem or Proposal. See CONTRACTED_REVENUE_CONTRACTED_AGENCY_COMMISSION
SALES_CONTRACT_CONTRACTED_IMPRESSIONS
The contracted impressions of the ProposalLineItem.
SALES_CONTRACT_CONTRACTED_CLICKS
The contracted clicks of the ProposalLineItem.
SALES_CONTRACT_CONTRACTED_VOLUME
The contracted volume of the ProposalLineItem. Volume represents impressions for rate type CPM, clicks for CPC, and days for CPD.
SALES_CONTRACT_BUDGET
The budget of the Proposal.
SALES_CONTRACT_REMAINING_BUDGET
The remaining budget of the Proposal. It is calculated by subtracting the contracted net revenue from the budget.
SALES_CONTRACT_BUFFERED_IMPRESSIONS
The buffered impressions of the ProposalLineItem.
SALES_CONTRACT_BUFFERED_CLICKS
The buffered clicks of the ProposalLineItem.
SCHEDULED_SCHEDULED_IMPRESSIONS
The scheduled impressions of a ProposalLineItem. It is the sum of SALES_CONTRACT_CONTRACTED_IMPRESSIONS and SALES_CONTRACT_BUFFERED_IMPRESSIONS.
SCHEDULED_SCHEDULED_CLICKS
The scheduled clicks of a ProposalLineItem. It is the sum of SALES_CONTRACT_CONTRACTED_CLICKS and SALES_CONTRACT_BUFFERED_CLICKS.
SCHEDULED_SCHEDULED_VOLUME
The scheduled volume of a ProposalLineItem. It is the sum of SALES_CONTRACT_CONTRACTED_VOLUME and buffered volume.
SCHEDULED_SCHEDULED_NET_REVENUE
The scheduled net revenue of a ProposalLineItem.
SCHEDULED_LOCAL_SCHEDULED_NET_REVENUE
The scheduled net revenue in the local currency of a ProposalLineItem.
SCHEDULED_SCHEDULED_GROSS_REVENUE
The scheduled gross revenue of a ProposalLineItem.
SCHEDULED_LOCAL_SCHEDULED_GROSS_REVENUE
The scheduled gross revenue in the local currency of a ProposalLineItem.
SALES_TOTAL_TOTAL_BUDGET
The total budget of the Proposal. It differs from SALES_CONTRACT_BUDGET since it always contains the total budget, not the prorated budget.
SALES_TOTAL_TOTAL_REMAINING_BUDGET
The total remaining budget of the Proposal. It differs from SALES_CONTRACT_REMAINING_BUDGET since it always contains the total remaining budget, not the prorated remaining budget.
SALES_TOTAL_TOTAL_CONTRACTED_VOLUME
The total contracted volume of the ProposalLineItem. It differs from SALES_CONTRACT_CONTRACTED_VOLUME that the volume is not prorated with regard to the date range.
SALES_TOTAL_TOTAL_CONTRACTED_NET_REVENUE
The total contracted net revenue of the ProposalLineItem. It differs from CONTRACTED_REVENUE_CONTRACTED_NET_REVENUE that the revenue is not prorated with regard to the date range.
SALES_TOTAL_LOCAL_TOTAL_CONTRACTED_NET_REVENUE
The total contracted net revenue in the local currency of the ProposalLineItem. It differs from CONTRACTED_REVENUE_LOCAL_CONTRACTED_NET_REVENUE that the revenue is not prorated with regard to the date range. See SALES_TOTAL_TOTAL_CONTRACTED_NET_REVENUE
SALES_TOTAL_TOTAL_CONTRACTED_GROSS_REVENUE
The total contracted gross revenue of the ProposalLineItem. It differs from CONTRACTED_REVENUE_CONTRACTED_GROSS_REVENUE that the revenue is not prorated with regard to the date range.
SALES_TOTAL_LOCAL_TOTAL_CONTRACTED_GROSS_REVENUE
The total contracted gross revenue in the local currency of the ProposalLineItem. It differs from CONTRACTED_REVENUE_LOCAL_CONTRACTED_GROSS_REVENUE that the revenue is not prorated with regard to the date range. See SALES_TOTAL_TOTAL_CONTRACTED_GROSS_REVENUE
SALES_TOTAL_TOTAL_CONTRACTED_AGENCY_COMMISSION
The total contracted agency commission of the ProposalLineItem. It differs from CONTRACTED_REVENUE_CONTRACTED_AGENCY_COMMISSION that the revenue is not prorated with regard to the date range.
SALES_TOTAL_LOCAL_TOTAL_CONTRACTED_AGENCY_COMMISSION
The total contracted agency commission in the local currency of the ProposalLineItem. It differs from CONTRACTED_REVENUE_LOCAL_CONTRACTED_AGENCY_COMMISSION that the revenue is not prorated with regard to the date range. See SALES_TOTAL_TOTAL_CONTRACTED_AGENCY_COMMISSION
SALES_TOTAL_TOTAL_CONTRACTED_NET_REVENUE_WITH_VAT
The total net revenue plus its value added tax of the ProposalLineItem. The revenue is not prorated with regard to the date range.
SALES_TOTAL_LOCAL_TOTAL_CONTRACTED_NET_REVENUE_WITH_VAT
The total net revenue plus its value added tax in the local currency of the ProposalLineItem. The revenue is not prorated with regard to the date range. See SALES_TOTAL_TOTAL_CONTRACTED_WITH_VAT
SALES_TOTAL_TOTAL_SCHEDULED_VOLUME
The total scheduled volume of the ProposalLineItem. It differs from SCHEDULED_SCHEDULED_VOLUME that the volume is not prorated with regard to the date range.
SALES_TOTAL_TOTAL_SCHEDULED_NET_REVENUE
The total scheduled net revenue of the ProposalLineItem. It differs from SCHEDULED_SCHEDULED_NET_REVENUE that the revenue is not prorated with regard to the date range.
SALES_TOTAL_LOCAL_TOTAL_SCHEDULED_NET_REVENUE
The total scheduled net revenue in the local currency of the ProposalLineItem. It differs from SCHEDULED_LOCAL_SCHEDULED_NET_REVENUE that the revenue is not prorated with regard to the date range. See SALES_TOTAL_TOTAL_SCHEDULED_NET_REVENUE
SALES_TOTAL_TOTAL_SCHEDULED_GROSS_REVENUE
The total scheduled gross revenue of the ProposalLineItem. It differs from SCHEDULED_SCHEDULED_GROSS_REVENUE that the revenue is not prorated with regard to the date range.
SALES_TOTAL_LOCAL_TOTAL_SCHEDULED_GROSS_REVENUE
The total scheduled gross revenue in the local currency of the ProposalLineItem. It differs from SCHEDULED_LOCAL_SCHEDULED_GROSS_REVENUE that the revenue is not prorated with regard to the date range. See SALES_TOTAL_TOTAL_SCHEDULED_GROSS_REVENUE
UNIFIED_REVENUE_UNRECONCILED_NET_REVENUE
The unreconciled net revenue of the ProposalLineItem. It is the portion of UNIFIED_REVENUE_UNIFIED_NET_REVENUE coming from unreconciled DFP volume.
UNIFIED_REVENUE_LOCAL_UNRECONCILED_NET_REVENUE
The unreconciled net revenue of the ProposalLineItem in local currency. It is the portion of UNIFIED_REVENUE_LOCAL_UNIFIED_NET_REVENUE coming from unreconciled DFP volume. See UNIFIED_REVENUE_UNRECONCILED_NET_REVENUE
UNIFIED_REVENUE_UNRECONCILED_GROSS_REVENUE
The unreconciled gross revenue of the ProposalLineItem. It is the portion of UNIFIED_REVENUE_UNIFIED_GROSS_REVENUE coming from unreconciled DFP volume.
UNIFIED_REVENUE_LOCAL_UNRECONCILED_GROSS_REVENUE
The unreconciled gross revenue of the ProposalLineItem in local currency. It is the portion of UNIFIED_REVENUE_LOCAL_UNIFIED_GROSS_REVENUE coming from unreconciled DFP volume. See UNIFIED_REVENUE_UNRECONCILED_GROSS_REVENUE
UNIFIED_REVENUE_FORECASTED_NET_REVENUE
The forecasted net revenue of the ProposalLineItem. It is the portion of UNIFIED_REVENUE_UNIFIED_NET_REVENUE coming from forecasted DFP volume.
UNIFIED_REVENUE_LOCAL_FORECASTED_NET_REVENUE
The forecasted net revenue of the ProposalLineItem in local currency. It is the portion of UNIFIED_REVENUE_LOCAL_UNIFIED_NET_REVENUE coming from forecasted DFP volume. See UNIFIED_REVENUE_FORECASTED_NET_REVENUE
UNIFIED_REVENUE_FORECASTED_GROSS_REVENUE
The forecasted gross revenue of the ProposalLineItem. It is the portion of UNIFIED_REVENUE_UNIFIED_GROSS_REVENUE coming from forecasted DFP volume.
UNIFIED_REVENUE_LOCAL_FORECASTED_GROSS_REVENUE
The forecasted gross revenue of the ProposalLineItem in local currency. It is the portion of UNIFIED_REVENUE_LOCAL_UNIFIED_GROSS_REVENUE coming from forecasted DFP volume. See UNIFIED_REVENUE_FORECASTED_GROSS_REVENUE
UNIFIED_REVENUE_UNIFIED_NET_REVENUE
The unified net revenue of the ProposalLineItem. It is a combination of UNIFIED_REVENUE_UNRECONCILED_NET_REVENUE, BILLING_BILLABLE_NET_REVENUE, and UNIFIED_REVENUE_FORECASTED_NET_REVENUE when query date range spans historical delivery and forecasted delivery.
UNIFIED_REVENUE_LOCAL_UNIFIED_NET_REVENUE
The unified net revenue of the ProposalLineItem in local currency. It is a combination of UNIFIED_REVENUE_LOCAL_UNRECONCILED_NET_REVENUE, BILLING_LOCAL_BILLABLE_NET_REVENUE, and UNIFIED_REVENUE_LOCAL_FORECASTED_NET_REVENUE when query date range spans historical delivery and forecasted delivery. See UNIFIED_REVENUE_UNIFIED_NET_REVENUE
UNIFIED_REVENUE_UNIFIED_GROSS_REVENUE
The unified net revenue of the ProposalLineItem. It is a combination of UNIFIED_REVENUE_UNRECONCILED_GROSS_REVENUE, BILLING_BILLABLE_GROSS_REVENUE, and UNIFIED_REVENUE_FORECASTED_GROSS_REVENUE when query date range spans historical delivery and forecasted delivery.
UNIFIED_REVENUE_LOCAL_UNIFIED_GROSS_REVENUE
The unified gross revenue of the ProposalLineItem in local currency. It is a combination of UNIFIED_REVENUE_LOCAL_UNRECONCILED_GROSS_REVENUE, BILLING_LOCAL_BILLABLE_GROSS_REVENUE, and UNIFIED_REVENUE_LOCAL_FORECASTED_GROSS_REVENUE when query date range spans historical delivery and forecasted delivery. See UNIFIED_REVENUE_UNIFIED_GROSS_REVENUE
UNIFIED_REVENUE_UNIFIED_AGENCY_COMMISSION
The unified agency commission of the ProposalLineItem. It is a combination of the unreconciled agency commission, the BILLING_BILLABLE_AGENCY_COMMISSION, and the forecasted agency commission when query date range spans historical delivery and forecasted delivery.
UNIFIED_REVENUE_LOCAL_UNIFIED_AGENCY_COMMISSION
The unified agency commission of the ProposalLineItem in local currency. It is a combination of the unreconciled agency commission, the BILLING_BILLABLE_AGENCY_COMMISSION, and the forecasted agency commission when query date range spans historical delivery and forecasted delivery. See UNIFIED_REVENUE_UNIFIED_AGENCY_COMMISSION
EXPECTED_REVENUE_EXPECTED_NET_REVENUE
The expected revenue of the ProposalLineItem. It is equivalent to UNIFIED_REVENUE_UNIFIED_NET_REVENUE when the ProposalLineItem is sold and SALES_PIPELINE_PIPELINE_NET_REVENUE otherwise.
EXPECTED_REVENUE_LOCAL_EXPECTED_NET_REVENUE
The expected revenue of the ProposalLineItem in local currency. It is equivalent to UNIFIED_REVENUE_LOCAL_UNIFIED_NET_REVENUE when the ProposalLineItem is sold and SALES_PIPELINE_LOCAL_PIPELINE_NET_REVENUE otherwise. See EXPECTED_REVENUE_EXPECTED_NET_REVENUE
EXPECTED_REVENUE_EXPECTED_GROSS_REVENUE
The expected gross revenue of the ProposalLineItem. It is equivalent to UNIFIED_REVENUE_UNIFIED_GROSS_REVENUE when the ProposalLineItem is sold and SALES_PIPELINE_PIPELINE_GROSS_REVENUE otherwise.
EXPECTED_REVENUE_LOCAL_EXPECTED_GROSS_REVENUE
The expected gross revenue of the ProposalLineItem in local currency. It is equivalent to UNIFIED_REVENUE_LOCAL_UNIFIED_GROSS_REVENUE when the ProposalLineItem is sold and SALES_PIPELINE_LOCAL_PIPELINE_GROSS_REVENUE otherwise. See EXPECTED_REVENUE_EXPECTED_GROSS_REVENUE
SALES_PIPELINE_PIPELINE_NET_REVENUE
The pipeline net revenue of the ProposalLineItem. It is calculated by multiplying probability to close by the contracted revenue for those unsold ProposalLineItems. There is no revenue for those sold ProposalLineItems.
SALES_PIPELINE_LOCAL_PIPELINE_NET_REVENUE
The pipeline net revenue in the local currency of the ProposalLineItem. It is calculated by multiplying probability to close by the contracted revenue for those unsold ProposalLineItems. There is no revenue for those sold ProposalLineItems. See SALES_PIPELINE_PIPELINE_NET_REVENUE
SALES_PIPELINE_PIPELINE_GROSS_REVENUE
The pipeline gross revenue of the ProposalLineItem. It is calculated by multiplying probability to close by the contracted revenue including agency commission for those unsold ProposalLineItems. There is no revenue for those sold ProposalLineItems.
SALES_PIPELINE_LOCAL_PIPELINE_GROSS_REVENUE
The pipeline gross revenue in the local currency of the ProposalLineItem. It is calculated by multiplying probability to close by the contracted revenue including agency commission for those unsold ProposalLineItems. There is no revenue for those sold ProposalLineItems. See SALES_PIPELINE_PIPELINE_GROSS_REVENUE
SALES_PIPELINE_PIPELINE_AGENCY_COMMISSION
The pipeline agency commission of the ProposalLineItem. It is calculated by multiplying probability to close by the contracted agency commission for those unsold ProposalLineItems. There is no revenue for those sold ProposalLineItems.
SALES_PIPELINE_LOCAL_PIPELINE_AGENCY_COMMISSION
The pipeline agency commission in the local currency of the ProposalLineItem. It is calculated by multiplying probability to close by the contracted agency commission for those unsold ProposalLineItems. There is no revenue for those sold ProposalLineItems. See SALES_PIPELINE_PIPELINE_AGENCY_COMMISSION
RECONCILIATION_LAST_DATE_TIME
The last reconciliation date of the ProposalLineItem.

Replaced with attribute PROPOSAL_LINE_ITEM_LAST_RECONCILIATION_DATE_TIME beginning in V201508.

RECONCILIATION_RECONCILIATION_STATUS
The reconciliation status of the ProposalLineItem.

Replaced with attribute PROPOSAL_LINE_ITEM_RECONCILIATION_STATUS beginning in V201508.

RECONCILIATION_DFP_VOLUME
The DFP volume of the ProposalLineItem, which is used for reconciliation. Volume represents impressions for rate type CPM, clicks for CPC and days for CPD.
RECONCILIATION_THIRD_PARTY_VOLUME
The third party volume of the ProposalLineItem, which is used for reconciliation. Volume represents impressions for rate type CPM, clicks for CPC and days for CPD.
RECONCILIATION_RECONCILED_VOLUME
The reconciled volume of the ProposalLineItem, which is used for reconciliation. Volume represents impressions for rate type CPM, clicks for CPC and days for CPD.
RECONCILIATION_DISCREPANCY
The discrepancy between DFP volume and third party volume.
RECONCILIATION_RECONCILED_REVENUE
The reconciled revenue of the LineItem.
RECONCILIATION_IMPRESSION_DISCREPANCY
The discrepancy between DFP impressions and third party impressions.
RECONCILIATION_CLICK_DISCREPANCY
The discrepancy between DFP clicks and third party clicks.
RECONCILIATION_REVENUE_DISCREPANCY
The discrepancy between DFP revenue and third party revenue.
BILLING_BILLABLE_NET_REVENUE
The billable net revenue of the ProposalLineItem. It is calculated from reconciled volume and rate, with cap applied.
BILLING_LOCAL_BILLABLE_NET_REVENUE
The billable net revenue in the local currency of the ProposalLineItem. It is calculated from reconciled volume and rate, with cap applied. See BILLING_BILLABLE_NET_REVENUE
BILLING_BILLABLE_GROSS_REVENUE
The billable gross revenue of the ProposalLineItem. It is calculated from reconciled volume and rate, with cap applied, and including agency commission.
BILLING_LOCAL_BILLABLE_GROSS_REVENUE
The billable gross revenue in the local currency of the ProposalLineItem. It is calculated from reconciled volume and rate, with cap applied, and including agency commission. See BILLING_BILLABLE_GROSS_REVENUE
BILLING_BILLABLE_NET_REVENUE_BEFORE_MANUAL_ADJUSTMENT
The billable net revenue of the ProposalLineItem before manual adjustment. It is calculated from reconciled volume and rate, with cap applied, before manual adjustment.
BILLING_LOCAL_BILLABLE_NET_REVENUE_BEFORE_MANUAL_ADJUSTMENT
The billable net revenue in local currency of the ProposalLineItem before manual adjustment. It is calculated from reconciled volume and rate, with cap applied, before manual adjustment. See BILLING_BILLABLE_NET_REVENUE_BEFORE_MANUAL_ADJUSTMENT
BILLING_BILLABLE_GROSS_REVENUE_BEFORE_MANUAL_ADJUSTMENT
The billable gross revenue of the ProposalLineItem before manual adjustment. It is calculated from reconciled volume and rate, with cap applied, before manual adjustment.
BILLING_LOCAL_BILLABLE_GROSS_REVENUE_BEFORE_MANUAL_ADJUSTMENT
The billable net revenue in local currency of the ProposalLineItem before manual adjustment. It is calculated from reconciled volume and rate, with cap applied, before manual adjustment. See BILLING_BILLABLE_GROSS_REVENUE_BEFORE_MANUAL_ADJUSTMENT
BILLING_BILLABLE_VAT
The value added tax on billable net revenue of the ProposalLineItem or Proposal.
BILLING_LOCAL_BILLABLE_VAT
The value added tax on billable net revenue in the local currency of the ProposalLineItem or Proposal. See BILLING_BILLABLE_VAT
BILLING_BILLABLE_AGENCY_COMMISSION
The billable agency commission of the ProposalLineItem or Proposal.
BILLING_LOCAL_BILLABLE_AGENCY_COMMISSION
The billable agency commission in the local currency of the ProposalLineItem or Proposal. See BILLING_BILLABLE_AGENCY_COMMISSION
BILLING_CAP_QUANTITY
The cap quantity of the ProposalLineItem for each cycle. Quantity represents impressions for rate type CPM, clicks for CPC and days for CPD.
BILLING_BILLABLE_VOLUME
The billable volume of the ProposalLineItem for each cycle. Billable volumes are calculated by applying cap quantity to reconciled volumes. Volume represents impressions for rate type CPM, clicks for CPC and days for CPD.
BILLING_DELIVERY_ROLLOVER_FROM_PREVIOUS
The delivery rollover volume of the ProposalLineItem from previous cycle. Volume represents impressions for rate type CPM, clicks for CPC and days for CPD.
BILLING_REALIZED_CPM
The CPM calcuated by BILLING_BILLABLE_NET_REVENUE and AD_SERVER_IMPRESSIONS.
BILLING_REALIZED_RATE
The rate calcuated by BILLING_BILLABLE_NET_REVENUE and DFP volume.
DISCOUNTS_BREAKDOWN_ADDITIONAL_ADJUSTMENT
The additional adjustment of the Proposal.
DISCOUNTS_BREAKDOWN_CONTRACTED_NET_OVERALL_DISCOUNT
The contracted net overall discount of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_BILLABLE_NET_OVERALL_DISCOUNT
The billable net overall discount of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_BILLABLE_NET_EXCLUDED_PREMIUMS
The billable net excluded premiums of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_BILLABLE_NET_ADVERTISER_DISCOUNT
The billable net advertiser discount of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_BILLABLE_NET_PRODUCT_ADJUSTMENT
The billable net product adjustment of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_BILLABLE_NET_PROPOSAL_DISCOUNT
The billable net proposal discount of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_CONTRACTED_NET_EXCLUDED_PREMIUMS
The contracted net excluded premiums of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_CONTRACTED_NET_ADVERTISER_DISCOUNT
The contracted net advertiser discount of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_CONTRACTED_NET_PRODUCT_ADJUSTMENT
The contracted net product adjustment of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_CONTRACTED_NET_PROPOSAL_DISCOUNT
The contracted net proposal discount of the ProposalLineItem.
DISCOUNTS_BREAKDOWN_CONTRACTED_NET_NON_BILLABLE
The contracted non-billable (net) of the ProposalLineItem. The non-billable means revenue that marked as make good, added value or barter.
SALESPERSON_PERFORMANCE_SHARED_PIPELINE_NET_REVENUE
The shared pipeline net revenue of the ProposalLineItem. It is calculated by multiplying salesperson credit by the pipeline net revenue.
SALESPERSON_PERFORMANCE_SHARED_PIPELINE_GROSS_REVENUE
The shared pipeline gross revenue of the ProposalLineItem. It is calculated by multiplying salesperson credit by the pipeline gross revenue.
SALESPERSON_PERFORMANCE_SHARED_UNIFIED_NET_REVENUE
The shared unified net revenue of the ProposalLineItem. It is calculated by multiplying salesperson credit by the unified net revenue.
SALESPERSON_PERFORMANCE_SHARED_UNIFIED_GROSS_REVENUE
The shared unified gross revenue of the ProposalLineItem. It is calculated by multiplying salesperson credit by the unified gross revenue.
INVOICED_IMPRESSIONS
The number of invoiced impressions.
INVOICED_UNFILLED_IMPRESSIONS
The number of invoiced unfilled impressions.
NIELSEN_OCR_IMPRESSIONS
The total number of impressions tracked for Nielsen OCR measurement.

This column is deprecated and replaced with NIELSEN_IMPRESSIONS beginning in V201508.

NIELSEN_OCR_POPULATION_BASE
The population in the demographic.

This column is deprecated and replaced with NIELSEN_POPULATION_BASE beginning in V201508.

NIELSEN_OCR_UNIQUE_AUDIENCE
The total number of different people within the selected demographic who were reached.

This column is deprecated and replaced with NIELSEN_OCR_UNIQUE_AUDIENCE beginning in V201508.

NIELSEN_OCR_PERCENT_AUDIENCE_REACH
The unique audience reached as a percentage of the population base.

This column is deprecated and replaced with NIELSEN_PERCENT_AUDIENCE_REACH beginning in V201508.

NIELSEN_OCR_AVERAGE_FREQUENCY
The average number of times that a person within the target audience sees an advertisement.

This column is deprecated and replaced with NIELSEN_AVERAGE_FREQUENCY beginning in V201508.

NIELSEN_OCR_GROSS_RATING_POINTS
The unit of audience volume, which is based on the percentage of the reached target audience population multiplied by the average frequency.

This column is deprecated and replaced with NIELSEN_GROSS_RATING_POINTS beginning in V201508.

NIELSEN_OCR_PERCENT_IMPRESSIONS_SHARE
The share of impressions that reached the target demographic.

This column is deprecated and replaced with NIELSEN_PERCENT_IMPRESSIONS_SHARE beginning in V201508.

NIELSEN_OCR_PERCENT_POPULATION_SHARE
The share of the total population represented by the population base.

This column is deprecated and replaced with NIELSEN_PERCENT_POPULATION_SHARE beginning in V201508.

NIELSEN_OCR_PERCENT_AUDIENCE_SHARE
The share of the unique audience in the demographic.

This column is deprecated and replaced with NIELSEN_PERCENT_AUDIENCE_SHARE beginning in V201508.

NIELSEN_OCR_AUDIENCE_INDEX
The relative unique audience in the demographic compared with its share of the overall population.

This column is deprecated and replaced with NIELSEN_AUDIENCE_INDEX beginning in V201508.

NIELSEN_OCR_IMPRESSIONS_INDEX
The relative impressions per person in the demographic compared with the impressions per person for the overall population.

This column is deprecated and replaced with NIELSEN_IMPRESSIONS_INDEX beginning in V201508.

dimensionAttributes DimensionAttribute[] The list of break-down attributes being requested in this report. Some DimensionAttribute values can only be used with certain Dimension values that must be included in the dimensions attribute. The generated report will contain the attributes in the same order as requested.
Enumerations
LINE_ITEM_LABELS
Represents LineItem.effectiveAppliedLabels as a comma separated list of Label.name for Dimension.LINE_ITEM_NAME.
LINE_ITEM_LABEL_IDS
Represents LineItem.effectiveAppliedLabels as a comma separated list of Label.id for Dimension.LINE_ITEM_NAME.
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_DELIVERY_PACING
Represents LineItem.deliveryRateType for Dimension.LINE_ITEM_NAME.
LINE_ITEM_FREQUENCY_CAP
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_RECONCILED_RATE
Represents the monthly reconciled rate of the line item for Dimension.LINE_ITEM_NAME and Dimension.MONTH_AND_YEAR.
ADVERTISER_EXTERNAL_ID
Represents Company.externalId for Dimension.ADVERTISER_NAME.
ADVERTISER_PRIMARY_CONTACT
Represents name and email address in the form of name(email) of primary contact for Dimension.ADVERTISER_NAME.
ORDER_START_DATE_TIME
Represents Order.startDateTime for Dimension.ORDER_NAME. Can be used for filtering.
ORDER_END_DATE_TIME
Represents Order.endDateTime for Dimension.ORDER_NAME. Can be used for filtering.
ORDER_EXTERNAL_ID
Represents Order.externalOrderId for Dimension.ORDER_NAME.
ORDER_PO_NUMBER
Represents Order.poNumber for Dimension.ORDER_NAME. Can be used for filtering.
ORDER_IS_PROGRAMMATIC
Represents Order.orderIsProgrammatic for Dimension.ORDER_NAME. Can be used for filtering.
ORDER_AGENCY
Represents the name of Order.agencyId for Dimension.ORDER_NAME.
ORDER_AGENCY_ID
Represents Order.agencyId for Dimension.ORDER_NAME. Can be used for filtering.
ORDER_LABELS
Represents Order.effectiveAppliedLabels as a comma separated list of Label.name for Dimension.ORDER_NAME.
ORDER_LABEL_IDS
Represents Order.effectiveAppliedLabels as a comma separated list of Label.id for Dimension.ORDER_NAME.
ORDER_TRAFFICKER
The name and email address in the form of name(email) of the trafficker for Dimension.ORDER_NAME
ORDER_TRAFFICKER_ID
Represents Order.traffickerId for Dimension.ORDER_NAME. Can be used for filtering.
ORDER_SECONDARY_TRAFFICKERS
The names and email addresses as a comma separated list of name(email) of the Order.secondaryTraffickerIds for Dimension.ORDER_NAME.
ORDER_SALESPERSON
The name and email address in the form of name(email) of the Order.salespersonId for Dimension.ORDER_NAME.
ORDER_SECONDARY_SALESPEOPLE
The names and email addresses as a comma separated list of name(email) of the Order.secondarySalespersonIds for Dimension.ORDER_NAME.
ORDER_LIFETIME_IMPRESSIONS
The total number of impressions delivered over the lifetime of an Dimension.ORDER_NAME.
ORDER_LIFETIME_CLICKS
The total number of clicks delivered over the lifetime of an Dimension.ORDER_NAME.
ORDER_LIFETIME_MERGED_IMPRESSIONS
The lifetime impressions for Dimension.ORDER_NAME delivered by both DART and DoubleClick for Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

This dimension attribute is deprecated use ORDER_LIFETIME_IMPRESSIONS instead.

ORDER_LIFETIME_MERGED_CLICKS
The lifetime clicks for Dimension.ORDER_NAME delivered by both DART and DoubleClick for Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

This dimension attribute is deprecated use ORDER_LIFETIME_CLICKS instead.

ORDER_BOOKED_CPM
The cost of booking all the CPM ads for Dimension.ORDER_NAME.
ORDER_BOOKED_CPC
The cost of booking all the CPC ads for Dimension.ORDER_NAME.
LINE_ITEM_START_DATE_TIME
Represents LineItem.startDateTime for Dimension.LINE_ITEM_NAME. Can be used for filtering.
LINE_ITEM_END_DATE_TIME
Represents LineItem.endDateTime for Dimension.LINE_ITEM_NAME. Can be used for filtering.
LINE_ITEM_EXTERNAL_ID
Represents LineItem.externalId for Dimension.LINE_ITEM_NAME. Can be used for filtering.
LINE_ITEM_COST_TYPE
Represents LineItem.costType for Dimension.LINE_ITEM_NAME. Can be used for filtering.
LINE_ITEM_COST_PER_UNIT
Represents LineItem.costPerUnit for Dimension.LINE_ITEM_NAME.
LINE_ITEM_CURRENCY_CODE
Represents the 3 letter currency code for Dimension.LINE_ITEM_NAME.
LINE_ITEM_GOAL_QUANTITY
The total number of impressions, clicks or days that is reserved for Dimension.LINE_ITEM_NAME.
LINE_ITEM_SPONSORSHIP_GOAL_PERCENTAGE
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_LIFETIME_IMPRESSIONS
The total number of impressions delivered over the lifetime of a Dimension.LINE_ITEM_NAME.
LINE_ITEM_LIFETIME_CLICKS
The total number of clicks delivered over the lifetime of a Dimension.LINE_ITEM_NAME.
LINE_ITEM_LIFETIME_MERGED_IMPRESSIONS
The lifetime impressions for Dimension.LINE_ITEM_NAME delivered by both DART and DoubleClick for Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

This dimension attribute is deprecated use LINE_ITEM_LIFETIME_IMPRESSIONS instead.

LINE_ITEM_LIFETIME_MERGED_CLICKS
The lifetime clicks for Dimension.LINE_ITEM_NAME delivered by both DART and DoubleClick for Publishers ad servers. This is only available for networks that have been upgraded from the old to the new system.

This dimension attribute is deprecated use LINE_ITEM_LIFETIME_CLICKS instead.

LINE_ITEM_PRIORITY
Represents LineItem.priority for Dimension.LINE_ITEM_NAME as a value between 1 and 16. Can be used for filtering.
CREATIVE_OR_CREATIVE_SET
Indicates if a creative is a regular creative or creative set. Values will be 'Creative' or 'Creative set'
MASTER_COMPANION_TYPE
The type of creative in a creative set - master or companion.
LINE_ITEM_CONTRACTED_QUANTITY
Represents the LineItem.contractedUnitsBought quantity for Dimension.LINE_ITEM_NAME.
LINE_ITEM_DISCOUNT
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_NON_CPD_BOOKED_REVENUE
The cost of booking for a non-CPD Dimension.LINE_ITEM_NAME.
ADVERTISER_LABELS
Represents Company.appliedLabels as a comma separated list of Label.name for Dimension.ADVERTISER_NAME.
ADVERTISER_LABEL_IDS
Represents Company.appliedLabels as a comma separated list of Label.id for Dimension.ADVERTISER_NAME.
CREATIVE_CLICK_THROUGH_URL
Represents the click-through URL for Dimension.CREATIVE_NAME.
CREATIVE_SSL_SCAN_RESULT
Represents whether a creative is SSL-compliant.
CREATIVE_SSL_COMPLIANCE_OVERRIDE
Represents whether a creative's SSL status was overridden.
LINE_ITEM_CREATIVE_START_DATE
Represents a LineItemCreativeAssociation.startDateTime for a Dimension.LINE_ITEM_NAME and a Dimension.CREATIVE_NAME. Includes the date without the time.
LINE_ITEM_CREATIVE_END_DATE
Represents a LineItemCreativeAssociation.endDateTime for a Dimension.LINE_ITEM_NAME and a Dimension.CREATIVE_NAME. Includes the date without the time.
PROPOSAL_START_DATE_TIME
Represents Proposal.startDateTime for Dimension.PROPOSAL_NAME.
PROPOSAL_END_DATE_TIME
Represents Proposal.endDateTime for Dimension.PROPOSAL_NAME.
PROPOSAL_CREATION_DATE_TIME
Represents Proposal.creationDateTime for Dimension.PROPOSAL_NAME. Can be used for filtering.
PROPOSAL_SOLD_DATE_TIME
Represents the sold time for Dimension.PROPOSAL_NAME.
PROPOSAL_IS_SOLD
Represents Proposal.isSold for Dimension.PROPOSAL_NAME. Can be used for filtering.
PROPOSAL_PROBABILITY_TO_CLOSE
Represents Proposal.probabilityToClose for Dimension.PROPOSAL_NAME.
PROPOSAL_STATUS
Represents Proposal.status for Dimension.PROPOSAL_NAME, including those post-sold status, e.g. DRAFT(SOLD). Can be used for filtering.
PROPOSAL_ARCHIVAL_STATUS
Represents Proposal.isArchived for Dimension.PROPOSAL_NAME. Can be used for filtering.
PROPOSAL_CURRENCY
Represents Proposal.currency for Dimension.PROPOSAL_NAME.
PROPOSAL_EXCHANGE_RATE
Represents Proposal.exchangeRate for Dimension.PROPOSAL_NAME.
PROPOSAL_AGENCY_COMMISSION_RATE
Represents Proposal.agencyCommission for Dimension.PROPOSAL_NAME.
PROPOSAL_VAT_RATE
Represents Proposal.valueAddedTax for Dimension.PROPOSAL_NAME.
PROPOSAL_DISCOUNT
Represents Proposal.proposalDiscount for Dimension.PROPOSAL_NAME.
PROPOSAL_ADVERTISER_DISCOUNT
Represents Proposal.advertiserDiscount for Dimension.PROPOSAL_NAME.
PROPOSAL_ADVERTISER
Represents the advertiser name of Dimension.PROPOSAL_NAME.
PROPOSAL_ADVERTISER_ID
Represents the advertiser id of Dimension.PROPOSAL_NAME.
PROPOSAL_AGENCIES
Represents the agency names as a comma separated string for Dimension.PROPOSAL_NAME.
PROPOSAL_AGENCY_IDS
Represents the agency ids as a comma separated string for Dimension.PROPOSAL_NAME.
PROPOSAL_PO_NUMBER
Represents Proposal.poNumber for Dimension.PROPOSAL_NAME.
PROPOSAL_PRIMARY_SALESPERSON
Represents name and email address in the form of name(email) of primary salesperson for Dimension.PROPOSAL_NAME.
PROPOSAL_SECONDARY_SALESPEOPLE
Represents name and email addresses in the form of name(email) of secondary salespeople as a comma separated string for Dimension.PROPOSAL_NAME.
PROPOSAL_CREATOR
Represents name and email address in the form of name(email) of creator for Dimension.PROPOSAL_NAME.
PROPOSAL_SALES_PLANNERS
Represents name and email addresses in the form of name(email) of Proposal.salesPlannerIds as a comma separated list string for Dimension.PROPOSAL_NAME.
PROPOSAL_PRICING_MODEL
Represents Proposal.pricingModel for Dimension.PROPOSAL_NAME.
PROPOSAL_BILLING_SOURCE
Represents Proposal.billingSource for Dimension.PROPOSAL_NAME.
PROPOSAL_BILLING_CAP
Represents Proposal.billingCap for Dimension.PROPOSAL_NAME.
PROPOSAL_BILLING_SCHEDULE
Represents Proposal.billingSchedule for Dimension.PROPOSAL_NAME.
PROPOSAL_APPLIED_TEAM_NAMES
Represents Proposal.appliedTeamIds as a comma separated list of Team.names for Dimension.PROPOSAL_NAME.
PROPOSAL_APPROVAL_STAGE
Represents the approval stage for Dimension.PROPOSAL_NAME.
PROPOSAL_INVENTORY_RELEASE_DATE_TIME
Represents the inventory release date time for Dimension.PROPOSAL_NAME.
PROPOSAL_LOCAL_BUDGET
Represents Proposal.budget in local currency for Dimension.PROPOSAL_NAME.
PROPOSAL_LOCAL_REMAINING_BUDGET
Represents the remaining budget in local currency for Dimension.PROPOSAL_NAME.
PROPOSAL_LINE_ITEM_START_DATE_TIME
Represents ProposalLineItem.startDateTime for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_END_DATE_TIME
Represents ProposalLineItem.endDateTime for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_RATE_TYPE
Represents ProposalLineItem.rateType for Dimension.PROPOSAL_LINE_ITEM_NAME. Can be used for filtering.
PROPOSAL_LINE_ITEM_COST_PER_UNIT
Represents ProposalLineItem.costPerUnit for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_LOCAL_COST_PER_UNIT
Represents ProposalLineItem.costPerUnit in local currency for Dimension.PROPOSAL_LINE_ITEM_NAME. See PROPOSAL_LINE_ITEM_COST_PER_UNIT
PROPOSAL_LINE_ITEM_COST_PER_UNIT_GROSS
Represents gross cost per unit for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_LOCAL_COST_PER_UNIT_GROSS
Represents gross cost per unit in local currency for Dimension.PROPOSAL_LINE_ITEM_NAME. See PROPOSAL_LINE_ITEM_COST_PER_UNIT_GROSS
PROPOSAL_LINE_ITEM_TYPE_AND_PRIORITY
Represents line item type (if applicable) and line item priority (if applicable) for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_SIZE
Represents the size of ProposalLineItem.creativePlaceholders for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_ARCHIVAL_STATUS
Represents ProposalLineItem.isArchived for Dimension.PROPOSAL_LINE_ITEM_NAME. Can be used for filtering.
PROPOSAL_LINE_ITEM_PRODUCT_ADJUSTMENT
Represents the product adjustment of Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_BUFFER
Represents ProposalLineItem.unitsBoughtBuffer for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_TARGET_RATE_NET
Represents the target rate (net) of Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_BILLING_SOURCE
Represents ProposalLineItem.billingSource for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_BILLING_CAP
Represents ProposalLineItem.billingCap for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_BILLING_SCHEDULE
Represents ProposalLineItem.billingSchedule for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_GOAL_PERCENTAGE
Represents ProposalLineItem.unitsBought for Dimension.PROPOSAL_LINE_ITEM_NAME The attribute is available only if ProposalLineItem.lineItemType is of type LineItemType.SPONSORSHIP, LineItemType.HOUSE, LineItemType.NETWORK, or LineItemType.BUMPER.
PROPOSAL_LINE_ITEM_COST_ADJUSTMENT
Represents ProposalLineItem.costAdjustment for Dimension.PROPOSAL_LINE_ITEM_NAME.
PROPOSAL_LINE_ITEM_COMMENTS
Represents the comments for Dimension.PROPOSAL_LINE_ITEM_NAME.
PRODUCT_TEMPLATE_RATE_TYPE
Represents ProductTemplate.rateType for Dimension.PRODUCT_TEMPLATE_NAME.
PRODUCT_TEMPLATE_STATUS
Represents ProductTemplate.status for Dimension.PRODUCT_TEMPLATE_NAME.
PRODUCT_TEMPLATE_TYPE_AND_PRIORITY
Represents the line item type (if applicable) and line item priority (if applicable) of Dimension.PRODUCT_TEMPLATE_NAME.
PRODUCT_TEMPLATE_PRODUCT_TYPE
Represents ProductTemplate.productType for Dimension.PRODUCT_TEMPLATE_NAME.
PRODUCT_TEMPLATE_DESCRIPTION
Represents ProductTemplate.description for Dimension.PRODUCT_TEMPLATE_NAME.
PRODUCT_PRODUCT_TEMPLATE_NAME
Represents the product template's name of Dimension.PRODUCT_NAME.
PRODUCT_RATE_TYPE
Represents Product.rateType for Dimension.PRODUCT_NAME.
PRODUCT_STATUS
Represents Product.status for Dimension.PRODUCT_NAME.
PRODUCT_TYPE_AND_PRIORITY
Represents the line item type (if applicable) and line item priority (if applicable) of Dimension.PRODUCT_NAME.
PRODUCT_PRODUCT_TYPE
Represents the product type of Dimension.PRODUCT_NAME.
PRODUCT_NOTES
Represents Product.notes for .
PROPOSAL_AGENCY_TYPE
Represents the Company.type of Dimension.PROPOSAL_AGENCY_NAME.
PROPOSAL_AGENCY_CREDIT_STATUS
Represents the Company.creditStatus of Dimension.PROPOSAL_AGENCY_NAME.
PROPOSAL_AGENCY_EXTERNAL_ID
Represents Company.externalId for Dimension.PROPOSAL_AGENCY_NAME.
PROPOSAL_AGENCY_COMMENT
Represents Company.comment for Dimension.PROPOSAL_AGENCY_NAME.
SALESPEOPLE_PROPOSAL_CONTRIBUTION
Represents the Dimension.ALL_SALESPEOPLE_NAME's contribution to a Dimension.PROPOSAL_NAME. This is different from SALESPERSON_PROPOSAL_CONTRIBUTION as this will include both primary and secondary salespeople.
SALESPERSON_PROPOSAL_CONTRIBUTION
Represents the Dimension.SALESPERSON_NAME's contribution to a Dimension.PROPOSAL_NAME. See SALESPERSON_PROPOSAL_CONTRIBUTION.
CONTENT_CMS_NAME
Represents the CmsContent.displayName within the first element of Content.cmsContent for Dimension.CONTENT_NAME.
CONTENT_CMS_VIDEO_ID
Represents the CmsContent.cmsContentId within the first element of Content.cmsContent for Dimension.CONTENT_NAME.
AD_UNIT_CODE
Represents AdUnit.adUnitCode for Dimension.AD_UNIT_NAME.
customFieldIds xsd:long[] The list of CustomField.id being requested in this report. To add a CustomField to the report, you must include its corresponding Dimension, determined by the CustomField.entityType, as a dimension.
CustomFieldEntityType.entityType Dimension
CustomFieldEntityType.LINE_ITEM Dimension.LINE_ITEM_NAME
CustomFieldEntityType.ORDER Dimension.ORDER_NAME
CustomFieldEntityType.CREATIVE Dimension.CREATIVE_NAME
contentMetadataKeyHierarchyCustomTargetingKeyIds xsd:long[] The list of content metadata hierarchy custom targeting key IDs being requested in this report. Each of these IDs must have been defined in the content metadata key hierarchy. This will include dimensions in the form of CONTENT_HIERARCHY_CUSTOM_TARGETING_KEY[id]_ID and CONTENT_HIERARCHY_CUSTOM_TARGETING_KEY[id]_VALUE where where ID is the ID of the custom targeting value and VALUE is the name.

To add IDs, you must include Dimension.CONTENT_HIERARCHY in dimensions, and specify a non-empty list of custom targeting key IDs. The order of content hierarchy columns in the report correspond to the place of Dimension.CONTENT_HIERARCHY in dimensions. For example, if dimensions contains the following dimensions in the order: Dimension.ADVERTISER_NAME, Dimension.CONTENT_HIERARCHY and Dimension.COUNTRY_NAME, and contentMetadataKeyHierarchyCustomTargetingKeyIds contains the following IDs in the order: 1001 and 1002. The order of dimensions in the report will be: Dimension.ADVERTISER_NAME, Dimension.CONTENT_HIERARCHY_CUSTOM_TARGETING_KEY[1001]_VALUE, Dimension.CONTENT_HIERARCHY_CUSTOM_TARGETING_KEY[1002]_VALUE, Dimension.COUNTRY_NAME, Dimension.ADVERTISER_ID, Dimension.CONTENT_HIERARCHY_CUSTOM_TARGETING_KEY[1001]_ID, Dimension.CONTENT_HIERARCHY_CUSTOM_TARGETING_KEY[1002]_ID, Dimension.COUNTRY_CRITERIA_ID

startDate Date The start date from which the reporting information is gathered. The ReportQuery#dateRangeType field must be set to DateRangeType.CUSTOM_DATE in order to use this.
endDate Date The end date upto which the reporting information is gathered. The ReportQuery#dateRangeType field must be set to DateRangeType.CUSTOM_DATE in order to use this.
dateRangeType DateRangeType The period of time for which the reporting data is being generated. In order to define custom time periods, set this to DateRangeType.CUSTOM_DATE. If set to DateRangeType.CUSTOM_DATE, then ReportQuery.startDate and ReportQuery.endDate will be used.
Enumerations
TODAY
The current day.
YESTERDAY
The previous day.
LAST_WEEK
The last week, from monday to sunday.
LAST_MONTH
The previous month.
REACH_LIFETIME
The last 5 months and the current month to date. This date range is only usable for the columns Column.REACH_FREQUENCY, Column.REACH_AVERAGE_REVENUE and Column.REACH.
CUSTOM_DATE
Specifying this value will enable the user to specify ReportQuery.startDate and ReportQuery.endDate.
NEXT_DAY
The next day.
NEXT_90_DAYS
The next ninety days.
NEXT_WEEK
The next week, from monday to sunday.
NEXT_MONTH
The next month.
CURRENT_AND_NEXT_MONTH
Beginning of the next day until the end of the next month.
NEXT_QUARTER
The next quarter.
NEXT_3_MONTHS
The next three months.
NEXT_12_MONTHS
The next twelve months.
dimensionFilters DimensionFilter[] The restrictions that apply to Dimension objects. These filters are AND'ed together to produce the result.
Enumerations
ADVERTISERS
Filters the results to include only advertisers. That is, Company.type is either Company.Type.HOUSE_ADVERTISER or Company.Type.ADVERTISER.
ACTIVE_ADVERTISERS
Filters the results to include only active advertisers. That is, Company.type is either Company.Type.HOUSE_ADVERTISER or Company.Type.ADVERTISER and the Company is active. This filter is applied by default when Dimension.ADVERTISER is chosen.
HOUSE_ADVERTISERS
Filters the results to include only the publisher's own advertiser. That is, Company.Type is Company.Type.HOUSE_ADVERTISER.
NON_HOUSE_ADVERTISERS
Filters the results to include only advertisers that do not belong to the publisher. That is Company.Type is Company.Type.ADVERTISER or Company.Type.AD_NETWORK.
ALL_SALESPEOPLE
Filters the results to include only salespeople. This filter is applied by default when Dimension.SALESPERSON is chosen.
WHOLE_NETWORK
Results for the entire network are returned. This is the default filter if none are specified.
CURRENT_USER_ORDERS
Filters the results to include only Order objects that are visible to the User.
STARTED_ORDERS
Filters the results to include only Order objects that have their Order.startDateTime in the past and their Order.endDateTime in the future.
COMPLETED_ORDERS
Filters the results to include only Order objects that have their Order.endDateTime in the past.
MOBILE_LINE_ITEMS
Filters the results to include only LineItem objects delivered on the platform TargetPlatform.MOBILE.
WEB_LINE_ITEMS
Filters the results to include only LineItem objects delivered on the platform TargetPlatform.WEB.
ACTIVE_AD_UNITS
Filters the results to include only AdUnit objects whose status is InventoryStatus.ACTIVE.
INACTIVE_AD_UNITS
Filters the results to include only AdUnit objects whose status is InventoryStatus.INACTIVE.
MOBILE_INVENTORY_UNITS
Filters the results to include only AdUnit objects delivered on the platform TargetPlatform.MOBILE.
WEB_INVENTORY_UNITS
Filters the results to include only AdUnit objects delivered on the platform TargetPlatform.WEB.
ARCHIVED_AD_UNITS
Filters the results to include only AdUnit objects whose status is InventoryStatus.ARCHIVED.
ACTIVE_PLACEMENTS
Filters the results to include only Placement objects whose status is InventoryStatus.ACTIVE.
INACTIVE_PLACEMENTS
Filters the results to include only Placement objects whose status is InventoryStatus.INACTIVE.
ARCHIVED_PLACEMENTS
Filters the results to include only Placement objects whose status is InventoryStatus.ARCHIVED.
OPTIMIZABLE_ORDERS
Filters the results to include only Order objects for which the optimization feature has been turned on.
PARTNER_STATS_TYPE_ESTIMATED
Filters the results to include only estimated partner stats.
PARTNER_STATS_TYPE_RECONCILED
Filters the results to include only reconciled partner stats.
statement Statement Specifies a filter to use for reporting on data. This filter will be used in conjunction (joined with an AND statement) with the date range selected through dateRangeType, startDate, and endDate and the dimension filters selected through dimensionFilters. The syntax currently allowed for Statement.query is
[WHERE <condition> {AND <condition> ...}]

<condition>
     := <property> = <value>
<condition>
     := <property> = <bind variable>
<condition> := <property> IN <list>
<bind variable> := :<name>
where property is the enumeration name of a Dimension that can be filtered.

For example, the statement "WHERE LINE_ITEM_ID IN (34344, 23235)" can be used to generate a report for a specific set of line items

Filtering on IDs is highly recommended over filtering on names, especially for geographical entities. When filtering on names, matching is case sensitive.

timeZone xsd:string The time zone in the form of America/New_York which the startDate and endDate are in, and the reporting information is gathered in. Defaults to Network.timeZone if it is null. All supported time zones can be found in the Time_Zone PQL table with SupportedInReports being true. Only time zones that are full hour offsets from Network.timeZone are supported.

Send feedback about...

DoubleClick for Publishers
Need help? Visit our support page.