Puoi ottenere un elenco di asset e dei relativi attributi inviando una query Google Ads Query Language (GAQL) a GoogleAdsService. 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
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 oggetti
YoutubeVideoAsset in un account filtrando il valore asset.type. Consulta 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 degli asset
Le metriche degli asset sono disponibili tramite alcune risorse:
Con queste risorse, puoi eseguire query sulle metriche degli asset a ogni livello.
Ad esempio, quando esegui una query sulla risorsa ad_group_asset, puoi utilizzare il campo ad_group.id per segmentare i risultati, recuperando così 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
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, l'interrogazione di questa visualizzazione restituisce una riga
per gruppo di annunci e annuncio.
ad_group_ad_asset_view espone l'attributo
specifico della visualizzazione
performance_label che
fornisce informazioni sulle caratteristiche di rendimento di questa specifica coppia asset-annuncio. 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 generare impressioni, ma le statistiche non sono statisticamente significative per ottenere un'etichetta del rendimento dell'asset. |
PENDING | Per questo asset non è ancora disponibile alcun dato sul rendimento. Il motivo potrebbe essere che è ancora in corso di revisione. |
UNKNOWN | Rappresenta il 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
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 è preciso solo per gli asset
mutable.
Per l'origine dell'utilizzo degli asset RSA, utilizza
AdGroupAdAsset.source.