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
device
month
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_SELECTION DESCRIPTION DISCOVERY_CAROUSEL_CARD HEADLINE HOTEL_CALLOUT HOTEL_PROPERTY LANDSCAPE_LOGO LEAD_FORM LOGO 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.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.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.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

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.device

segments.month

segments.quarter

segments.week

segments.year