The new Search Ads 360 Reporting API is now available. Join thesearchads-api-announcementsGoogle group to stay up to date on upcoming enhancements and releases.
assetStay organized with collectionsSave and categorize content based on your preferences.
Page Summary
Assets are reusable components of ads, such as images or videos, that cannot be modified or deleted after being created.
Call assets offer specific fields for managing call details, including setting active time intervals, call conversion actions, and call reporting states.
Callout assets, similar to call assets, have fields for managing their active time intervals and also include a field for the callout's text.
General asset fields cover metadata like creation time, ID, last modified time, as well as the current engine status, final URLs and many others.
Image assets offer fields for information like file size, dimensions, and MIME type, while location assets manage business profiles and place identifiers.
Asset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. Assets are immutable and cannot be removed. To stop an asset from serving, remove the asset from the entity that is using it.
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fieldswill not segmentmetrics in yourSELECTclause.
Fields/Segments/Metrics
This page shows all metrics and segments that can be put in the same SELECT clause as the fields ofasset.
However, when you specifyassetin the FROM clause, some metrics and segments
cannot be used.
Use the following filter to show only the fields that can be used whenassetis specified in the FROM clause.
Isassetspecified in the FROM clause of your query?
List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
Category
ATTRIBUTE
Data Type
MESSAGE
Type URL
google.ads.searchads360.v0.common.AdScheduleInfo
Filterable
False
Selectable
True
Sortable
False
Repeated
True
asset.call_asset.call_conversion_action
Field description
The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.call_asset.call_conversion_reporting_state
Field description
Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
Category
ATTRIBUTE
Data Type
MESSAGE
Type URL
google.ads.searchads360.v0.common.AdScheduleInfo
Filterable
False
Selectable
True
Sortable
False
Repeated
True
asset.callout_asset.callout_text
Field description
The callout text. The length of this string should be between 1 and 25, inclusive.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.callout_asset.end_date
Field description
Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.callout_asset.start_date
Field description
Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.callout_asset.use_searcher_time_zone
Field description
Whether to show the asset in search user's time zone. Applies to Microsoft Ads.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.creation_time
Field description
The timestamp when this asset was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
The datetime when this asset was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.location_asset.business_profile_locations
Field description
The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. Seehttps://developers.google.com/places/web-service/place-idto learn more about Place ID.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.mobile_app_asset.app_id
Field description
Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.mobile_app_asset.app_store
Field description
Required. The application store that distributes this specific app.
The resource name of the asset. Asset resource names have the form:customers/{customer_id}/assets/{asset_id}
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
asset.sitelink_asset.ad_schedule_targets
Field description
List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
Category
ATTRIBUTE
Data Type
MESSAGE
Type URL
google.ads.searchads360.v0.common.AdScheduleInfo
Filterable
False
Selectable
True
Sortable
False
Repeated
True
asset.sitelink_asset.description1
Field description
First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.sitelink_asset.description2
Field description
Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.sitelink_asset.end_date
Field description
Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.sitelink_asset.link_text
Field description
URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.sitelink_asset.mobile_preferred
Field description
Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads.
Category
ATTRIBUTE
Data Type
BOOLEAN
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.sitelink_asset.start_date
Field description
Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
Category
ATTRIBUTE
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.sitelink_asset.tracking_id
Field description
ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
asset.sitelink_asset.use_searcher_time_zone
Field description
Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.
Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit.
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
metrics.absolute_top_impression_percentage
Field description
Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions
Field description
The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_by_conversion_date
Field description
The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available athttps://support.google.com/sa360/answer/9250611.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_from_interactions_rate
Field description
All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
The value of all conversions from interactions divided by the total number of interactions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_value
Field description
The value of all conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_value_by_conversion_date
Field description
The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available athttps://support.google.com/sa360/answer/9250611.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.all_conversions_value_per_cost
Field description
The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.average_cost
Field description
The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_conversions_value
Field description
The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.client_account_view_through_conversions
Field description
The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad.
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions
Field description
The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_by_conversion_date
Field description
The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in date column means the conversion date.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_from_interactions_rate
Field description
Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion.
The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_value
Field description
The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_value_by_conversion_date
Field description
The sum of biddable conversions value by conversion date. When this column is selected with date, the values in date column means the conversion date.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions_value_per_cost
Field description
The value of biddable conversion divided by the total cost of conversion eligible interactions.
The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cross_device_conversions
Field description
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 all_conversions.
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.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.interactions
Field description
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.
Category
METRIC
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.top_impression_percentage
Field description
The percent of your ad impressions that are shown adjacent to the top organic search results.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.value_per_all_conversions
Field description
The value of all conversions divided by the number of all conversions.
The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available athttps://support.google.com/sa360/answer/9250611.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.value_per_conversion
Field description
The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.value_per_conversions_by_conversion_date
Field description
Biddable conversions value by conversion date divided by biddable conversions by conversion date. Shows how much, on average, each of the biddable conversions is worth (by conversion date). When this column is selected with date, the values in date column means the conversion date.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-05-11 UTC."],[],["Assets, immutable components of ads, include images and videos. To deactivate, remove them from associated entities. Asset properties vary by type, such as call assets with phone numbers and scheduling, callout assets with text, and image assets with size and URL information. Key fields include `id`, `creation_time`, `final_urls`, and type-specific attributes. Assets have statuses and are associated with a variety of data types, filtering, and sorting criteria. Customer allows to choose fields that will not segment metrics.\n"]]