Report

Puoi ottenere un elenco degli asset e dei relativi attributi inviando una query Google Ads Query Language (GAQL) all'GoogleAdsService. Gli asset sono rappresentati dall'entità asset, che espone una serie di campi specifici per gli asset.

Attributi asset

La seguente query GAQL elenca tutti gli asset in un account Google Ads insieme al nome e al tipo di risorsa.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

Puoi aggiungere attributi specifici del tipo a questa query per leggere le proprietà specifiche degli asset, ad esempio ImageAsset o YoutubeVideoAsset.

Ad esempio, la seguente query elenca gli ID video di YouTube per tutti gli oggetti YoutubeVideoAsset in un account Google Ads filtrando il valore asset.type. Consulta un elenco dei possibili valori di asset.type.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

Metriche degli asset

Le metriche degli asset sono disponibili tramite alcune risorse:

Con queste risorse, puoi eseguire query sulle metriche degli asset a ogni livello. Ad esempio, quando esegui una query sulla risorsa ad_group_asset, puoi utilizzare il campo ad_group.id per segmentare i risultati, recuperando così le metriche per ogni combinazione univoca 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

Metriche a livello di annuncio

Punto chiave: ad_group_ad_asset_view restituisce solo informazioni sugli asset correlati ad annunci per app, Demand Gen e annunci della rete di ricerca adattabili.

Le metriche sul rendimento a livello di annuncio per gli asset vengono aggregate in ad_group_ad_asset_view. Questa visualizzazione raccoglie le metriche per gli asset per singolo annuncio. Pertanto, l'interrogazione di questa visualizzazione restituisce una riga per gruppo di annunci e annuncio.

ad_group_ad_asset_view espone l'attributo specifico della visualizzazione performance_label che fornisce informazioni sulle caratteristiche di rendimento di questa specifica coppia asset-annuncio. La tabella seguente elenca i possibili valori dei campi performance_label.

performance_labelDescrizione
BESTAsset con il rendimento migliore.
GOODAsset con un buon rendimento.
LOWAsset con il rendimento peggiore.
LEARNINGL'asset ha iniziato a ricevere impressioni, ma le statistiche non sono statisticamente significative per ottenere un'etichetta di rendimento dell'asset.
PENDINGPer questo asset non è ancora disponibile alcun dato sul rendimento. Il motivo potrebbe essere che è ancora in corso di revisione.
UNKNOWNRappresenta un valore sconosciuto in questa versione.
UNSPECIFIEDNon specificato.

La seguente query GAQL restituisce impressioni, clic, costi e conversioni per tutti gli asset di un account Google Ads nell'ultimo mese, ordinati in base al performance_label:

SELECT
  ad_group_ad_asset_view.ad_group_ad,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.field_type,
  ad_group_ad_asset_view.performance_label,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label

Origine asset

Asset.source è accurato solo per gli asset modificabili.

Per l'origine degli asset RSA, utilizza ad_group_ad_asset_view.source.