Puoi ottenere un elenco di asset e dei relativi attributi inviando una query Google Ads Query Language
(GAQL) a
GoogleAdsService. Gli asset sono rappresentati da
l'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 della risorsa e al tipo.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Puoi aggiungere attributi specifici per il 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
YoutubeVideoAsset oggetti in un account Google Ads
filtrando il valore asset.type. Visualizza un
elenco dei possibili asset.type valori.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'
Metriche asset
Le metriche asset sono disponibili tramite alcune risorse:
Con queste risorse, puoi eseguire query sulle metriche asset a ogni livello.
Ad esempio, quando esegui una query sulla risorsa ad_group_asset, puoi utilizzare il
ad_group.id campo 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 informazioni solo per gli asset correlati agli annunci per app, Demand Gen e agli annunci adattabili della rete di ricerca.
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 ogni singolo annuncio. Pertanto, l'esecuzione di query su questa visualizzazione restituisce una riga per gruppo di annunci e annuncio.
Il ad_group_ad_asset_view espone l' attributo specifico della visualizzazione performance_label, che fornisce insight sulle caratteristiche di rendimento di questa specifica coppia annuncio basato su asset. 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 statisticamente significative a sufficienza per ottenere un'etichetta di rendimento dell'asset. |
PENDING | Per questo asset non sono ancora disponibili informazioni sul rendimento. Questo potrebbe essere dovuto al fatto che è ancora in fase 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 Google Ads durante l'ultimo mese, ordinati in base a 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 degli annunci della rete di ricerca adattabili, utilizza
ad_group_ad_asset_view.source.