Rapporti

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

Attributi asset

La seguente query GAQL elenca tutti gli asset nell'account di un inserzionista, nonché il nome e il tipo della risorsa.

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

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

Ad esempio, la seguente query elenca gli ID video di YouTube di tutti gli oggetti YoutubeVideoAsset di un account filtrando il valore asset.type. Consulta un elenco di possibili valori di tipo 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 delle risorse

Le metriche delle risorse sono disponibili tramite alcune risorse:

• ad_group_asset
• campaign_asset
• customer_asset

Con queste risorse, puoi eseguire query sulle metriche delle risorse a ogni rispettivo livello. Ad esempio, quando esegui una query sulla risorsa ad_group_asset, puoi utilizzare il campo ad_group.id 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

Metriche a livello di annuncio

Punto chiave: ad_group_ad_asset_view restituisce solo informazioni per gli asset correlati agli annunci per app.

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, la query su questa vista restituisce una riga per gruppo di annunci e annuncio.

ad_group_ad_asset_view espone l'attributo specifico per la visualizzazione performance_label che fornisce informazioni sulle caratteristiche di rendimento di questa specifica combinazione di asset e annunci. La tabella seguente elenca i possibili valori dei campi performance_label.

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 sufficientemente significative dal punto di vista statistico per ottenere un'etichetta sul rendimento dell'asset.
PENDING	Per questo asset non sono ancora disponibili informazioni sul rendimento. Il motivo potrebbe essere che è ancora in corso la 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 di un account nell'ultimo mese, ordinati in base al valore di 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 mutable.

Per l'origine dell'utilizzo degli asset RSA, AdGroupAdAsset.source.