Allowed fields

Fields are specified in the following report parameters:

  • FieldNames — Fields to output in the report (columns).

  • Field in the Filter structure — Fields to use for filtering data in the report.

  • Field in the OrderBy structure — Fields to use for sorting rows in the report.

These parameters allow different sets of fields (see the table below). For example, the CampaignName field can be added to the report as a column, but it can't be used for filtering data; the opposite is true for the Keyword field, which is only used for filtering data and can't be shown in the report.

The report type also affects which fields are allowed and how they are applied (see the table below):

  • filter — The field is only used for filtering data, and can't be shown in a report.

  • segment — The field is used for grouping data in the report.

  • metric — The field contains a numeric value based on filters and data groupings.

  • attribute — The field contains a fixed value for the specified segments. Adding this field to the report doesn't create a new grouping.

For example, the CampaignId field for the CUSTOM_REPORT type is a segment: if you add it to the report, data is grouped by campaigns. But for the ADGROUP_PERFORMANCE_REPORT, CampaignId is an attribute: data is already grouped by AdGroupId, and the campaign ID is a fixed value for each group.

A dash “–” means that this field can't be used in the parameter or report type.

ParametersReport types
Field name
AdFormat+++segmentsegmentsegmentsegmentsegment
AdGroupId+++attributeattributeattributesegmentsegmentattribute
AdGroupName++attributeattributeattributesegmentsegmentattribute
AdId+++attributesegmentsegmentsegment
AdNetworkType+++segmentsegmentsegmentsegmentsegmentsegment
Age+++segmentsegmentsegmentsegmentsegmentsegmentsegment
AudienceTargetId+filterfilter
AvgClickPosition+++metricmetricmetricmetricmetricmetricmetric
AvgCpc+++metricmetricmetricmetricmetricmetricmetricmetric
AvgCpm+++metric
AvgImpressionFrequency+++metric
AvgImpressionPosition+++metricmetricmetricmetricmetricmetricmetric
AvgPageviews+++metricmetricmetricmetricmetricmetricmetricmetric
AvgTrafficVolume+++metricmetricmetricmetricmetricmetricmetric
BounceRate+++metricmetricmetricmetricmetricmetricmetricmetric
Bounces++metricmetricmetricmetricmetricmetricmetricmetric
CampaignId+++attributeattributeattributeattributesegmentsegmentattribute
CampaignName++attributeattributeattributeattributesegmentsegmentattribute
CampaignType+++segmentattributeattributeattributeattributesegmentsegmentattribute
CarrierType+++segmentsegmentsegmentsegmentsegmentsegment
Clicks+++metricmetricmetricmetricmetricmetricmetricmetric
ClickType+++segmentsegmentsegmentsegmentsegmentsegment
ConversionRate+++metricmetricmetricmetricmetricmetricmetricmetric
Conversions+++metricmetricmetricmetricmetricmetricmetricmetric
Cost+++metricmetricmetricmetricmetricmetricmetricmetric
CostPerConversion+++metricmetricmetricmetricmetricmetricmetricmetric
Criteria+attributesegmentsegment
CriteriaId+attributesegmentsegment
CriteriaType+++segmentsegmentsegmentsegmentattributesegmentsegment
Criterion+attributesegmentsegment
CriterionId+attributesegmentsegment
CriterionType+++segmentsegmentsegmentsegmentattributesegmentsegment
Ctr+++metricmetricmetricmetricmetricmetricmetricmetric
Date++segmentsegmentsegmentsegmentsegmentsegmentsegmentsegment
Device+++segmentsegmentsegmentsegmentsegmentsegmentsegment
DynamicTextAdTargetId+filterfilterfilter
ExternalNetworkName+++segmentsegmentsegmentsegmentsegmentsegment
Gender+++segmentsegmentsegmentsegmentsegmentsegmentsegment
GoalsRoi+++metricmetricmetricmetricmetricmetricmetricmetric
ImpressionReach+++metric
Impressions+++metricmetricmetricmetricmetricmetricmetricmetric
ImpressionShare+++metricmetricmetric
Keyword+filterfilterfilter
LocationOfPresenceId+++segmentsegmentsegmentsegmentsegmentsegment
LocationOfPresenceName++segmentsegmentsegmentsegmentsegmentsegment
MatchedKeyword+++segment
MatchType+++segmentsegmentsegmentsegmentsegmentsegmentsegment
MobilePlatform+++segmentsegmentsegmentsegmentsegmentsegment
Month++segmentsegmentsegmentsegmentsegmentsegmentsegmentsegment
Placement+++segmentsegmentsegmentsegmentsegmentsegmentsegment
Quarter++segmentsegmentsegmentsegmentsegmentsegmentsegmentsegment
Query+++attribute
Revenue+++metricmetricmetricmetricmetricmetricmetricmetric
RlAdjustmentId+++segmentsegment
Sessions++metricmetricmetricmetricmetricmetricmetric
Slot+++segmentsegmentsegmentsegmentsegmentsegment
SmartBannerFilterId+filterfilter
TargetingLocationId+++segmentsegmentsegmentsegmentsegmentsegmentsegment
TargetingLocationName++segmentsegmentsegmentsegmentsegmentsegmentsegment
Week++segmentsegmentsegmentsegmentsegmentsegmentsegmentsegment
WeightedCtr+++metricmetricmetricmetricmetricmetricmetric
WeightedImpressions+++metricmetricmetricmetricmetricmetricmetric
Year++segmentsegmentsegmentsegmentsegmentsegmentsegmentsegment