Récupérer les attributs et les métriques des éléments

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Attributs de l'élément

Pour obtenir la liste des éléments et de leurs attributs, envoyez une requête Google Ads Query Language (GAQL) à GoogleServiceService. Les éléments sont représentés par l'entité asset, qui expose un certain nombre de champs spécifiques aux éléments.

La requête GAQL suivante répertorie tous les éléments du compte d'un annonceur, ainsi que le nom et le type de leur ressource.

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

Sachez que vous pouvez ajouter des attributs spécifiques au type à la requête ci-dessus pour lire des propriétés spécifiques à des éléments tels que ImageAsset ou YoutubeVideoAsset.

Par exemple, la requête suivante présente les ID vidéo YouTube pour tous les objets YoutubeVideoAsset d'un compte en filtrant la valeur asset.type (consultez la documentation sur les valeurs de type possibles) pour YoutubeVideoAsset.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

Métriques de l'élément

Les métriques sur les éléments sont disponibles via plusieurs ressources:

Avec ces ressources, vous pouvez interroger les métriques sur les éléments à chaque niveau. Par exemple, lors de l'interrogation de la ressource ad_group_asset, le champ ad_group.id peut être utilisé pour segmenter les résultats, et ainsi récupérer les métriques pour chaque combinaison unique de ad_group et 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

Métriques au niveau des annonces

Les métriques de performances au niveau de l'annonce pour les éléments sont cumulées dans la métrique ad_group_ad_asset_view. Cette vue collecte des métriques pour les éléments par annonce individuelle. Par conséquent, l'interrogation de cette vue renvoie une ligne par groupe d'annonces et par annonce.

Le ad_group_ad_asset_view expose l'attribut spécifique à la vue performance_label qui donne les informations sur les caractéristiques de performance de cette paire asset-annonce spécifique. Les valeurs possibles des champs performance_label sont énumérées dans le tableau suivant.

performance_labelDescription
BESTÉléments les plus performants.
GOODÉléments performants.
LOWÉléments les moins performants.
LEARNINGL'élément a commencé à générer des impressions, mais les statistiques ne sont pas suffisamment pertinentes pour obtenir un libellé de performances.
PENDINGNous ne disposons pas encore d'informations sur les performances de cet élément. Il se peut que cette fonctionnalité soit encore en cours d'examen.
UNKNOWNReprésente une valeur inconnue dans cette version.
UNSPECIFIEDNon spécifié.

La requête GAQL suivante renvoie des impressions, des clics, des coûts et des conversions pour tous les éléments d'un compte au cours du mois précédent, triés par 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