La nuova API Search Ads 360 Reporting è ora disponibile. Unisciti al gruppo Google searchads-api-announcements per non perderti i prossimi miglioramenti e release.
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.
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.
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:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["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"]]