Segnalazione

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

Attributi asset

La seguente query GAQL 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 del tipo che potresti aggiungere alla query sopra per leggere proprietà specifiche di 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 filtrando il valore asset.type (consulta la documentazione per un elenco di possibili valori per i tipi) per YoutubeVideoAsset.

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:

• ad_group_asset
• campaign_asset
• customer_asset

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, 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

Le metriche sul rendimento a livello di annuncio per gli asset sono aggregate in ad_group_ad_asset_view. Questa vista raccoglie le metriche relative agli asset per singolo annuncio. L'esecuzione di una query in questa vista restituisce una riga per gruppo di annunci e annuncio.

Il ad_group_ad_asset_view espone l'attributo specifico per la visualizzazione performance_label, che fornisce informazioni sulle caratteristiche di rendimento di questa specifica associazione asset-annuncio. I valori possibili dei campi performance_label sono elencati nella seguente tabella.

performance_label	Descrizione
BEST	Asset con il rendimento migliore.
GOOD	Asset con un buon rendimento.
LOW	Asset con il rendimento peggiore.
LEARNING	L'asset ha iniziato a ricevere impressioni, ma le statistiche non sono statisticamente significative per ottenere un'etichetta di rendimento dell'asset.
PENDING	Questo asset non dispone ancora di informazioni sul rendimento. Ciò potrebbe essere dovuto al fatto che è ancora in corso di revisione.
UNKNOWN	Rappresenta un valore sconosciuto in questa versione.
UNSPECIFIED	Non specificato.

La seguente query GAQL restituisce impressioni, clic, costi e conversioni per tutti gli asset in un account durante l'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