Rapports

Vous pouvez obtenir une liste de composants et de leurs attributs en envoyant une requête Google Ads Query Language (GAQL) à 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

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 liste les ID de vidéos YouTube pour tous les YoutubeVideoAsset objets d'un compte en filtrant la valeur asset.type. Consultez 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 sur les composants sont disponibles via quelques ressources :

• ad_group_asset
• campaign_asset
• customer_asset

Avec ces ressources, vous pouvez interroger les métriques sur les 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

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 pour les éléments par annonce individuelle. Ainsi, 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.

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 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 des composants

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

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