The new Search Ads 360 Reporting API is now available. Join the searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.

visit

A visit.

Attributed resources
ad_group
ad_group_criterion
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 visit. However, when you specify visit 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 visit is specified in the FROM clause.

Is visit specified in the FROM clause of your query?

Resource fields
ad_id
asset_field_type
asset_id
click_id
criterion_id
id
merchant_id
product_channel
product_country_code
product_id
product_language_code
product_store_id
resource_name
visit_date_time

Segments
ad_network_type
date
day_of_week
device
keyword.ad_group_criterion
keyword.info.match_type
keyword.info.text
month
product_channel
product_item_id
product_language
product_store_id
quarter
week
year

visit.ad_id
Field description	Ad ID. A value of 0 indicates that the ad is unattributed.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.asset_field_type
Field description	Asset field type of the visit event.
Category	`ATTRIBUTE`
Data Type	`ENUM AD_IMAGE BOOK_ON_GOOGLE BUSINESS_LOGO BUSINESS_NAME CALL CALLOUT CALL_TO_ACTION CALL_TO_ACTION_SELECTION DESCRIPTION DISCOVERY_CAROUSEL_CARD HEADLINE HOTEL_CALLOUT HOTEL_PROPERTY LANDSCAPE_LOGO LEAD_FORM LOGO LONG_DESCRIPTION LONG_HEADLINE MANDATORY_AD_TEXT MARKETING_IMAGE MEDIA_BUNDLE MOBILE_APP PORTRAIT_MARKETING_IMAGE PRICE PROMOTION SITELINK SQUARE_MARKETING_IMAGE STRUCTURED_SNIPPET UNKNOWN UNSPECIFIED VIDEO YOUTUBE_VIDEO`
Type URL	`google.ads.searchads360.v0.enums.AssetFieldTypeEnum.AssetFieldType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.asset_id
Field description	ID of the asset which was interacted with during the visit event.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.click_id
Field description	A unique string for each visit that is passed to the landing page as the click id URL parameter.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.criterion_id
Field description	Search Ads 360 keyword ID. A value of 0 indicates that the keyword is unattributed.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.id
Field description	The ID of the visit.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.merchant_id
Field description	The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.product_channel
Field description	The sales channel of the product that was clicked on: Online or Local.
Category	`ATTRIBUTE`
Data Type	`ENUM LOCAL ONLINE UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.ProductChannelEnum.ProductChannel`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.product_country_code
Field description	The country (ISO-3166 format) registered for the inventory feed that contains the product clicked on.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.product_id
Field description	The ID of the product clicked on.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.product_language_code
Field description	The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.product_store_id
Field description	The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit.resource_name
Field description	The resource name of the visit. Visit resource names have the form: `customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

visit.visit_date_time
Field description	The timestamp of the visit event. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.ad_network_type
Field description	Ad network type.
Category	`SEGMENT`
Data Type	`ENUM CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH`
Type URL	`google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.date
Field description	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.day_of_week
Field description	Day of the week, for example, MONDAY.
Category	`SEGMENT`
Data Type	`ENUM FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY`
Type URL	`google.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.device
Field description	Device to which metrics apply.
Category	`SEGMENT`
Data Type	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.keyword.ad_group_criterion
Field description	The AdGroupCriterion resource name.
Category	`SEGMENT`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

segments.keyword.info.match_type
Field description	The match type of the keyword.
Category	`SEGMENT`
Data Type	`ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.keyword.info.text
Field description	The text of the keyword (at most 80 characters and 10 words).
Category	`SEGMENT`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.month
Field description	Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.product_channel
Field description	Channel of the product.
Category	`SEGMENT`
Data Type	`ENUM LOCAL ONLINE UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.ProductChannelEnum.ProductChannel`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.product_item_id
Field description	Item ID of the product.
Category	`SEGMENT`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.product_language
Field description	Resource name of the language constant for the language of the product.
Category	`SEGMENT`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.product_store_id
Field description	Store ID of the product.
Category	`SEGMENT`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.quarter
Field description	Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.week
Field description	Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.year
Field description	Year, formatted as yyyy.
Category	`SEGMENT`
Data Type	`INT32`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

visit Stay organized with collections Save and categorize content based on your preferences.

Fields/Segments/Metrics

visit.ad_id

visit.asset_field_type

visit.asset_id

visit.click_id

visit.criterion_id

visit.id

visit.merchant_id

visit.product_channel

visit.product_country_code

visit.product_id

visit.product_language_code

visit.product_store_id

visit.resource_name

visit.visit_date_time

segments.ad_network_type

segments.date

segments.day_of_week

segments.device

segments.keyword.ad_group_criterion

segments.keyword.info.match_type

segments.keyword.info.text

segments.month

segments.product_channel

segments.product_item_id

segments.product_language

segments.product_store_id

segments.quarter

segments.week

segments.year

visit