Per ottenere un elenco degli asset e dei relativi attributi, invia una query GAQL (Google Ads Query Language) a Google AdsService. 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 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 per tipo che potresti aggiungere alla query precedente
per leggere proprietà specifiche di asset come
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 dei 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 asset
Le metriche delle risorse sono rese disponibili attraverso alcune risorse:
Con queste risorse, è possibile eseguire query sulle metriche degli asset a ogni rispettivo livello.
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 vengono aggregate in ad_group_ad_asset_view
. Questa visualizzazione raccoglie
le metriche degli asset per ogni singolo annuncio. Di conseguenza, l'esecuzione di una query su questa vista restituisce una riga per gruppo di annunci e annuncio.
L'elemento ad_group_ad_asset_view
mostra l'attributo
specifico della vista
performance_label
,
che fornisce insight sulle caratteristiche del rendimento di questo specifico accoppiamento
asset-annuncio. I possibili valori dei campi performance_label
sono enumerati nella tabella seguente.
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 sufficientemente significative da ottenere un'etichetta di rendimento degli asset. |
PENDING | Per questo asset non sono ancora disponibili 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 nell'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