Google Ads API is returning to beta status. Please read our blog post for more details.

detail_placement_view

The detail placement view referenced in the query.
Attributed resources
ad_group
campaign
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

Fields/Segments/Metrics

This page shows all metrics and segments that can be put in the same SELECT clause as the fields of detail_placement_view. However, when you specify detail_placement_view in the FROM clause, some metrics and segments cannot be used. Use the following filter to show only the fields that can be used when detail_placement_view is specified in the FROM clause.

Is detail_placement_view specified in the FROM clause of your query?

info_outline  Resource fields
display_name
group_placement_target_url
placement
placement_type
resource_name
target_url
layers  Segments
date
device
month
quarter
week
year
show_chart  Metrics
clicks
impressions
video_views

detail_placement_view.display_name

Field descriptionThe display name is URL name for websites, YouTube video name for YouTube videos, and translated mobile app name for mobile apps.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

detail_placement_view.group_placement_target_url

Field descriptionURL of the group placement, e.g. domain, link to the mobile application in app store, or a YouTube channel URL.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

detail_placement_view.placement

Field descriptionThe automatic placement string at detail level, e. g. website URL, mobile application ID, or a YouTube video ID.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableFalse
SelectableTrue
SortableTrue
RepeatedFalse

detail_placement_view.placement_type

Field descriptionType of the placement, e.g. Website, YouTube Video, and Mobile Application.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.PlacementTypeEnum.PlacementType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

detail_placement_view.resource_name

Field descriptionThe resource name of the detail placement view. Detail placement view resource names have the form: `customers/{customer_id}/detailPlacementViews/{ad_group_id}~{base64_placement}`
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

detail_placement_view.target_url

Field descriptionURL of the placement, e.g. website, link to the mobile application in app store, or a YouTube video URL.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.date

Field descriptionDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
CategorySEGMENT
Data TypeDATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.device

Field descriptionDevice to which metrics apply.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v1.enums.DeviceEnum.Device
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.month

Field descriptionMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
CategorySEGMENT
Data TypeDATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.quarter

Field descriptionQuarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
CategorySEGMENT
Data TypeDATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.week

Field descriptionWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
CategorySEGMENT
Data TypeDATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.year

Field descriptionYear, formatted as yyyy.
CategorySEGMENT
Data TypeINT32
Type URLgoogle.protobuf.Int32Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

metrics.clicks

Field descriptionThe number of clicks.
CategoryMETRIC
Data TypeINT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

metrics.impressions

Field descriptionCount of how often your ad has appeared on a search results page or website on the Google Network.
CategoryMETRIC
Data TypeINT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

metrics.video_views

Field descriptionThe number of times your video ads were viewed.
CategoryMETRIC
Data TypeINT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse