Reporting

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

Attributs de l'élément

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

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

Par exemple, la requête suivante répertorie les ID vidéo YouTube de tous les objets YoutubeVideoAsset d'un compte en filtrant la valeur asset.type (consultez 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 éléments

Les métriques sur les assets sont disponibles via quelques ressources:

• ad_group_asset
• campaign_asset
• customer_asset

Grâce à ces ressources, vous pouvez interroger les métriques sur les composants à chaque niveau respectif. Par exemple, lorsque vous interrogez la ressource ad_group_asset, le champ ad_group.id peut être utilisé pour segmenter les résultats, 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 de l'annonce

Important :ad_group_ad_asset_view ne renvoie des informations que sur les assets associés aux annonces pour une application.

Les métriques de performances au niveau de l'annonce pour les composants sont agrégées dans le ad_group_ad_asset_view. Cette vue collecte des métriques sur les composants de chaque annonce. L'interrogation de cette vue renvoie donc 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 fournit des insights sur les caractéristiques de performances de cette association spécifique asset-annonce. 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	L'élément 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 de l'élément.
PENDING	Aucune information sur les performances n'est encore disponible pour cet élément. Il se peut qu'elle soit toujours en cours d'examen.
UNKNOWN	Représente une 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 mois précédent, triés en fonction de leur 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