La nuova API Search Ads 360 Reporting è ora disponibile. Unisciti al gruppo Google
searchads-api-announcements per non perderti i prossimi miglioramenti e release.
Recupero attributi e metriche degli asset
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Attributi asset
Puoi ottenere un elenco di asset e dei relativi attributi inviando una query nel linguaggio di query di Search Ads 360 a SearchAds360Service.
Gli asset sono rappresentati dall'entità asset
, che espone un numero di campi specifici per gli asset.
La seguente query elenca tutti gli asset nell'account di un inserzionista insieme al nome e al tipo di risorsa.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Tieni presente che esistono attributi specifici per tipo che puoi aggiungere alla query riportata sopra per leggere proprietà specifiche degli asset, come SitelinkAsset
o MobileAppAsset
.
Ad esempio, la seguente query elenca gli ID app mobile per tutti gli oggetti
MobileAppAsset
di un account filtrando il valore asset.type
per
MobileAppAsset
.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.mobile_app_asset.app_store
FROM asset
WHERE asset.type = 'MOBILE_APP'
Metriche degli asset
Le metriche delle risorse vengono rese disponibili tramite alcune risorse:
Con queste risorse è possibile eseguire query sulle metriche degli asset a ciascun livello corrispondente.
Ad esempio, quando esegui una query sulla risorsa ad_group_asset
, il campo ad_group.id
può essere utilizzato per segmentare i risultati, in modo da recuperare le metriche per ogni combinazione unica di ad_group
e asset
:
SELECT
ad_group.id,
asset.id,
metrics.clicks,
metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[[["\u003cp\u003eRetrieve a list of assets and their attributes, including resource name and type, using Search Ads 360 Query Language.\u003c/p\u003e\n"],["\u003cp\u003eAccess type-specific attributes, such as mobile app IDs, by filtering the \u003ccode\u003easset.type\u003c/code\u003e value in your query.\u003c/p\u003e\n"],["\u003cp\u003eQuery asset metrics at the ad group, campaign, or customer level through respective resources like \u003ccode\u003ead_group_asset\u003c/code\u003e, \u003ccode\u003ecampaign_asset\u003c/code\u003e, and \u003ccode\u003ecustomer_asset\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSegment asset metric results by fields like \u003ccode\u003ead_group.id\u003c/code\u003e to analyze performance for specific combinations of assets and ad groups, campaigns, or customers.\u003c/p\u003e\n"]]],["Assets and their attributes can be retrieved by sending a Search Ads 360 Query Language query to the SearchAds360Service, using the `asset` entity. Type-specific attributes can be added to queries. Asset metrics are available through `ad_group_asset`, `campaign_asset`, and `customer_asset` resources, enabling queries at various levels. For example, metrics can be retrieved for each unique combination of `ad_group` and `asset` using `ad_group_asset` resource.\n"],null,["# Fetching Asset Attributes and Metrics\n\nAsset attributes\n----------------\n\nYou can get a list of assets and their attributes by sending a [Search Ads 360\nQuery Language query](/search-ads/reporting/query/query-language) to the SearchAds360Service.\nAssets are represented by the [`asset`](/search-ads/reporting/api/reference/fields/v0/asset) entity, which exposes a\nnumber of asset-specific fields.\n\nThe following query lists all assets in an advertiser's account along with\ntheir resource name and type. \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.type\n FROM asset\n\nNote that there are type-specific attributes that you could add to the above\nquery to read properties specific to assets such as\n[`SitelinkAsset`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.common#unifiedsitelinkasset) or\n[`MobileAppAsset`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.common#mobileappasset).\n\nFor example, the following query lists the mobile app IDs for all\n[`MobileAppAsset`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.common#mobileappasset) objects in an account by\nfiltering the [`asset.type`](/search-ads/reporting/api/reference/fields/v0/asset#asset.type) value for\n[`MobileAppAsset`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.common#mobileappasset). \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.mobile_app_asset.app_store\n FROM asset\n WHERE asset.type = 'MOBILE_APP'\n\nAsset metrics\n-------------\n\nAsset metrics are made available through a few resources:\n\n- [`ad_group_asset`](/search-ads/reporting/api/reference/fields/v0/ad_group_asset)\n- [`campaign_asset`](/search-ads/reporting/api/reference/fields/v0/campaign_asset)\n- [`customer_asset`](/search-ads/reporting/api/reference/fields/v0/customer_asset)\n\nWith these resources, asset metrics can be queried at each respective level.\nFor instance, when querying the `ad_group_asset` resource, the `ad_group.id`\nfield can be used to segment the results, thereby retrieving metrics for each\nunique combination of `ad_group` and `asset`: \n\n SELECT\n ad_group.id,\n asset.id,\n metrics.clicks,\n metrics.impressions\n FROM ad_group_asset\n WHERE segments.date DURING LAST_MONTH\n ORDER BY metrics.impressions DESC"]]