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

Placeholder Feed Item Report

The Placeholder Feed Item report includes all statistics at the feed-item level (e.g., a single sitelink). If other segment fields are used, you may get more than one row per feed item. See segmentation for more information.

The stats in the row for sitelink X show all clicks and costs when X was shown. This includes headline clicks on X, as well as clicks on other sitelinks and other ad extensions (e.g., a call extension) when X was also shown. Also included are the costs accrued by all clicks.

To see the clicks/costs/etc. for just sitelink X, use segment "IsSelfAction", and look at the "This extension" rows. To see a breakdown by type of click (e.g., headline vs. sitelink), use segment "ClickType".

 Attribute

 Segment

 Metric

Ctr

Download this table in CSV format

PLACEHOLDER_FEED_ITEM_REPORT

AccountCurrencyCode

The currency of the Customer account.

TypeString
Display NameCurrency
XML Attributecurrency
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AccountDescriptiveName

The descriptive name of the Customer account.

TypeString
Display NameAccount
XML Attributeaccount
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AccountTimeZone

Name of the timezone selected for the Customer account. For example: "(GMT-05:00) Eastern Time". This field does not reflect the current state of daylight saving time for the timezone.

TypeString
Display NameTime zone
XML AttributetimeZone
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

AdGroupId

The ID of the AdGroup.

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

AdGroupName

The name of the AdGroup.

TypeString
Display NameAd group
XML AttributeadGroup
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

AdGroupStatus

Status of the ad group.

TypeAdGroupStatus
Display NameAd group state
XML AttributeadGroupState
BehaviorSegment
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

AttributeValues

The FeedItem's attribute values. List elements are returned in JSON list format.

TypeList
Display NameAttribute Values
XML AttributeattributeValues
BehaviorAttribute
FilterableFalse
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
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

CampaignName

The name of the Campaign.

TypeString
Display NameCampaign
XML Attributecampaign
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

CampaignStatus

The status of the Campaign.

TypeCampaignStatus
Display NameCampaign state
XML AttributecampaignState
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

Clicks

The number of clicks.

TypeLong
Display NameClicks
XML Attributeclicks
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsTrue

ClickType

Indicates the click type for metric fields such as Impressions. Since ads that serve can be attributed to multiple click types, metric fields may be double-counted and thus totals may not be accurate, especially for Display network campaigns.

TypeClickType
Display NameClick type
XML AttributeclickType
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

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

Criteria

Descriptive string for the Criterion. For more information on the format of criteria types in reports, see the Criteria prefixes section of the reporting guide.

TypeString
Display NameTarget keyword text
XML AttributetargetKeywordText
BehaviorAttribute
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

CustomerDescriptiveName

The descriptive name of the Customer.

TypeString
Display NameClient name
XML AttributeclientName
BehaviorAttribute
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

DevicePreference

Platform ID of the device preference. You can look up the corresponding name and other information in the Platforms reference.

TypeFeedItemDevicePreference
Display NameDevice preference
XML AttributedevicePreference
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

DisapprovalShortNames

List of reasons why the FeedItem is not approved. List elements are returned in JSON list format.

TypeList
Display NameDisapproval reasons
XML AttributedisapprovalReasons
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

EndTime

The end time in which the FeedItem is no longer effective and will stop serving.

TypeDateTime
Display NameEnd date
XML AttributeendDate
BehaviorAttribute
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

FeedItemId

The FeedItem ID.

TypeLong
Display NameItem ID
XML AttributeitemID
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

GeoTargetingRestriction

The type of location that can be used for targeting.

TypeGeoRestriction
Display NameTarget location restriction
XML AttributetargetLocationRestriction
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

IsSelfAction

Indicates if the extension for the placeholder feed item of this row was clicked (true) or merely displayed (false).

TypeEnum
Display NameThis extension vs. Other
XML AttributethisExtensionVsOther
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

KeywordMatchType

The match type for the Keyword.

TypeKeywordMatchType
Display NameTarget keyword match type
XML AttributetargetKeywordMatchType
BehaviorAttribute
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

PlaceholderType

Placeholder type indicating the type of extension.

TypeInteger
Display NameFeed placeholder type
XML AttributefeedPlaceholderType
BehaviorAttribute
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

Scheduling

Schedule specifying when the FeedItem may serve. FeedItemScheduling elements are returned in JSON list format.

TypeFeedItemScheduling
Display NameScheduling
XML Attributescheduling
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

Slot

The position of the Ad.

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

StartTime

The start time in which the FeedItem is effective and can begin serving.

TypeDateTime
Display NameStart date
XML AttributestartDate
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsTrue

Status

The status of the main object in this row. For example, in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.

TypeStatus
Display NameItem state
XML AttributeitemState
BehaviorAttribute
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

UrlCustomParameters

Custom URL parameters of the main object of this row. CustomParameters elements are returned in JSON map format.

TypeCustomParameters
Display NameCustom parameter
XML AttributecustomParameter
BehaviorAttribute
FilterableFalse
Supports Zero ImpressionsTrue

ValidationDetails

Details about the validation state for the FeedItem. List elements are returned in JSON list format.

TypeList
Display NameApproval Status
XML AttributeapprovalStatus
BehaviorAttribute
FilterableFalse
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