The AdWords API is no longer available. Use the Google Ads API instead.

Ad Customizers Feed Item Report

The Ad Customizers Feed Item report provides statistics for feed items used in Ad Customizers. Statistics are aggregated at the feed item level, one row per feed item. If other segment fields are used, you may get more than one row per feed item. See segmentation for more information.

 Attribute

 Segment

 Metric

Ctr

Download this table in CSV format

AD_CUSTOMIZERS_FEED_ITEM_REPORT

AccountDescriptiveName

The descriptive name of the Customer account.

TypeString
Display NameAccount
XML Attributeaccount
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AdGroupId

The ID of the AdGroup.

TypeLong
Display NameAd group ID
XML AttributeadGroupID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdGroupName

The name of the AdGroup.

TypeString
Display NameAd group
XML AttributeadGroup
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdId

The ID of the Ad. This field may contain IDs of ads that are not supported in the report request's API version.

TypeLong
Display NameAd ID
XML AttributeadID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdNetworkType1

First level network type.

TypeAdNetworkType1
Display NameNetwork
XML Attributenetwork
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

AdNetworkType2

Second level network type (includes search partners).

TypeAdNetworkType2
Display NameNetwork (with search partners)
XML AttributenetworkWithSearchPartners
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

AllConversionRate

AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAll conv. rate
XML AttributeallConvRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AllConversions

Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAll conv.
XML AttributeallConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AllConversionValue

The total value of all of your conversions, including those that are estimated. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAll conv. value
XML AttributeallConvValue
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageCost

The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameAvg. Cost
XML AttributeavgCost
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageCpc

The total cost of all clicks divided by the total number of clicks received. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameAvg. CPC
XML AttributeavgCPC
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageCpe

The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAvg. CPE
XML AttributeavgCPE
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageCpm

Average Cost-per-thousand impressions (CPM). Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameAvg. CPM
XML AttributeavgCPM
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AverageCpv

The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAvg. CPV
XML AttributeavgCPV
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

AveragePosition

Your ad's position relative to those of other advertisers. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAvg. position
XML AttributeavgPosition
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CampaignId

The ID of the Campaign.

TypeLong
Display NameCampaign ID
XML AttributecampaignID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CampaignName

The name of the Campaign.

TypeString
Display NameCampaign
XML Attributecampaign
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

Clicks

The number of clicks.

TypeLong
Display NameClicks
XML Attributeclicks
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ConversionCategoryName

A category that describes the action the user will take to complete a conversion. Prevents zero-conversion rows from being returned. Values: "Download", "Lead", "Purchase/Sale", "Signup", "View of a key page", and "Other".

TypeString
Display NameConversion category
XML AttributeconversionCategory
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionRate

The number of conversions divided by total clicks that can be tracked to conversions. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameConv. rate
XML AttributeconvRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Conversions

The number of conversions for all conversion actions that you have opted into optimization. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameConversions
XML Attributeconversions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ConversionTrackerId

ID of the conversion tracker.

TypeLong
Display NameConversion Tracker Id
XML AttributeconversionTrackerId
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionTypeName

The name of the conversion type. Prevents zero-conversion rows from being returned.

TypeString
Display NameConversion name
XML AttributeconversionName
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionValue

The sum of conversion values for all conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameTotal conv. value
XML AttributetotalConvValue
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Cost

The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameCost
XML Attributecost
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CostPerAllConversion

Total cost divided by all conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameCost / all conv.
XML AttributecostAllConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CostPerConversion

The Cost attributable to conversion-tracked clicks divided by the number of conversions. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.

TypeMoney
Display NameCost / conv.
XML AttributecostConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

CrossDeviceConversions

Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in your AllConversions column. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameCross-device conv.
XML AttributecrossDeviceConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Ctr

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameCTR
XML Attributectr
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Date

The date formatted as yyyy-MM-dd.

TypeDate
Display NameDay
XML Attributeday
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

DayOfWeek

The name of the day of the week, e.g., "Monday".

TypeDayOfWeek
Display NameDay of week
XML AttributedayOfWeek
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

Device

Device type where the impression was shown.

TypeDeviceType
Display NameDevice
XML Attributedevice
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

EngagementRate

How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameEngagement rate
XML AttributeengagementRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Engagements

The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.

TypeLong
Display NameEngagements
XML Attributeengagements
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ExternalConversionSource

The source of conversion such as website, import from calls.

TypeExternalConversionSource
Display NameConversion source
XML AttributeconversionSource
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ExternalCustomerId

The Customer ID.

TypeLong
Display NameCustomer ID
XML AttributecustomerID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

FeedId

The Feed ID.

TypeLong
Display NameFeed ID
XML AttributefeedID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

FeedItemAttributes

List of attribute values for the FeedItem.

TypeByte
Display NameAttribute Values
XML AttributeattributeValues
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

FeedItemEndTime

End time at which the FeedItem is no longer effective and will stop serving.

TypeLong
Display NameEnd date
XML AttributeendDate
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

FeedItemId

The FeedItem ID.

TypeLong
Display NameItem ID
XML AttributeitemID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

FeedItemStartTime

Start time when the FeedItem is effective and can begin serving.

TypeLong
Display NameStart date
XML AttributestartDate
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

FeedItemStatus

Status of the FeedItem.

TypeStatus
Display NameItem state
XML AttributeitemState
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

GeoTargetingCriterionId

Location ID of the feed item's geoTargeting.

TypeLong
Display NameTarget location
XML AttributetargetLocation
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Impressions

Count of how often your ad has appeared on a search results page or website on the Google Network.

TypeLong
Display NameImpressions
XML Attributeimpressions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

InteractionRate

How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameInteraction Rate
XML AttributeinteractionRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Interactions

The number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.

TypeLong
Display NameInteractions
XML Attributeinteractions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

InteractionTypes

The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.

TypeEnumSet
Display NameInteraction Types
XML AttributeinteractionTypes
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

KeywordTargetingId

The ID of the feed item's keyword targeting.

TypeLong
Display NameKeyword ID
XML AttributekeywordID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

KeywordTargetingMatchType

Match type of the feed item's keywordTargeting.

TypeString
Display NameTarget keyword match type
XML AttributetargetKeywordMatchType
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

KeywordTargetingText

Text of the feed item's keywordTargeting.

TypeString
Display NameTarget keyword text
XML AttributetargetKeywordText
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Month

The first day of the month, formatted as yyyy-MM-dd.

TypeString
Display NameMonth
XML Attributemonth
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

MonthOfYear

The name of the month of the year, e.g., "December".

TypeMonthOfYear
Display NameMonth of Year
XML AttributemonthOfYear
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

Quarter

The first day of the quarter, formatted as yyyy-MM-dd. Uses the calendar year for quarters, e.g., the second quarter of 2014 starts on 2014-04-01.

TypeString
Display NameQuarter
XML Attributequarter
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

Slot

The position of the Ad.

TypeSlot
Display NameTop vs. Other
XML AttributetopVsOther
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

TargetingAdGroupId

Ad group ID of the feed item's adGroupTargeting.

TypeLong
Display NameTarget ad group ID
XML AttributetargetAdGroupID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

TargetingCampaignId

Campaign ID of the feed item's campaignTargeting.

TypeLong
Display NameTarget campaign ID
XML AttributetargetCampaignID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

ValuePerAllConversion

The value, on average, of all conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameValue / all conv.
XML AttributevalueAllConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ValuePerConversion

The total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameValue / conv.
XML AttributevalueConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

VideoViewRate

The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameView rate
XML AttributeviewRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

VideoViews

The number of times your video ads were viewed.

TypeLong
Display NameViews
XML Attributeviews
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

Week

The date for the Monday of the week, formatted as yyyy-MM-dd.

TypeString
Display NameWeek
XML Attributeweek
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue

Year

The year, formatted as yyyy.

TypeInteger
Display NameYear
XML Attributeyear
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsTrue