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