Vous souhaitez nous faire part de vos commentaires sur l'API Google Ads ? Inscrivez-vous pour être invité à participer à des recherches sur l'expérience utilisateur.

Cette page a été traduite par l'API Cloud Translation.

Rapports

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

Attributs des composants

La requête GAQL suivante liste tous les composants du compte d'un annonceur, ainsi que leur nom et leur type de ressource.

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

Notez que vous pouvez ajouter des attributs spécifiques au type à cette requête pour lire des propriétés spécifiques aux composants, comme ImageAsset ou YoutubeVideoAsset.

Par exemple, la requête suivante liste les ID de vidéo YouTube pour tous les objets YoutubeVideoAsset d'un compte en filtrant la valeur asset.type (voir la documentation pour obtenir la liste des 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 sur les composants

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

Grâce à ces ressources, vous pouvez interroger les métriques des composants à chaque niveau. Par exemple, lorsque vous interrogez la ressource ad_group_asset, le champ ad_group.id peut être utilisé pour segmenter les résultats, en récupérant ainsi des 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 composants sont agrégées dans ad_group_ad_asset_view. Cette vue collecte des métriques pour les composants par annonce individuelle. Par conséquent, interroger cette vue renvoie une ligne par groupe d'annonces et par annonce.

ad_group_ad_asset_view expose l'attribut spécifique à la vue performance_label qui fournit des informations sur les caractéristiques de performances de cet appariement d'asset-annonce spécifique. Les valeurs possibles des champs performance_label sont énumérées dans le tableau suivant.

`performance_label`	Description
`BEST`	Composants les plus performants.
`GOOD`	Composants performants
`LOW`	Composants les moins performants.
`LEARNING`	Le composant a commencé à générer des impressions, mais les statistiques ne sont pas suffisamment pertinentes d'un point de vue statistique pour obtenir un libellé de performances.
`PENDING`	Nous ne disposons pas encore d'informations sur les performances de cet élément. Il se peut qu'il soit toujours en cours d'examen.
`UNKNOWN`	Représente la valeur inconnue dans cette version.
`UNSPECIFIED`	Non 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 au cours du dernier mois, 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 des composants

Asset.source n'est précis que pour les éléments mutable.

Pour la source d'utilisation des composants ARR, AdGroupAdAsset.source.

Compléments automatiques

Éléments