Rapports

Vous pouvez obtenir une liste de composants et de leurs attributs en envoyant une requête en langage de requête Google Ads (GAQL) à GoogleAdsService. Les composants sont représentés par asset l'entité, qui expose un certain nombre de champs spécifiques aux composants.

Attributs des composants

La requête GAQL suivante répertorie tous les composants d'un compte Google Ads, ainsi que leur nom de ressource et leur type.

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

Vous pouvez ajouter des attributs spécifiques à un type à cette requête pour lire les propriétés spécifiques aux composants, tels que ImageAsset ou YoutubeVideoAsset.

Par exemple, la requête suivante répertorie les ID de vidéos YouTube pour tous les YoutubeVideoAsset objets d'un compte Google Ads en filtrant la valeur asset.type. Consultez la liste des valeurs asset.type possibles.

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

Métriques des composants

Les métriques des composants sont disponibles via plusieurs ressources :

Avec ces ressources, vous pouvez interroger les métriques des composants à chaque niveau respectif. Par exemple, lorsque vous interrogez la ressource ad_group_asset, vous pouvez utiliser le ad_group.id champ 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

Point important : ad_group_ad_asset_view ne renvoie des informations que pour les composants associés aux annonces pour applications, aux annonces Demand Gen et aux annonces responsives sur le Réseau de Recherche.

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

The ad_group_ad_asset_view expose le attribut spécifique à la vue performance_label, qui fournit des informations sur les caractéristiques de performances de cette association spécifique composant-annonce Le tableau suivant énumère les valeurs possibles des champs performance_label.

performance_labelDescription
BESTComposants les plus performants.
GOODComposants performants.
LOWComposants les moins performants.
LEARNINGLe composant a commencé à générer des impressions, mais les statistiques ne sont pas suffisamment statistiquement significatives pour obtenir un libellé de performances.
PENDINGCe composant ne dispose pas encore d'informations sur ses performances. Cela peut être dû au fait qu'il est toujours en cours d'examen.
UNKNOWNReprésente une valeur inconnue dans cette version.
UNSPECIFIEDNon spécifié.

La requête GAQL suivante renvoie les impressions, les clics, les coûts et les conversions pour tous les composants d'un compte Google Ads au cours du mois dernier, 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

Source de l'élément

Asset.source n'est précis que pour les composants modifiables.

Pour la source des composants d'annonces responsives sur le Réseau de Recherche, utilisez ad_group_ad_asset_view.source.

Précédent
Importer des vidéos