Vous pouvez obtenir la liste des 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 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 de ressource et leur type.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Vous pouvez ajouter des attributs spécifiques à ce type de requête pour lire les propriétés spécifiques aux composants, telles que ImageAsset ou YoutubeVideoAsset.
Par exemple, la requête suivante liste les ID de vidéos YouTube pour tous les objets YoutubeVideoAsset 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 dans plusieurs ressources :
Ces ressources vous permettent d'interroger les métriques des composants à chaque niveau respectif.
Par exemple, lorsque vous interrogez la ressource ad_group_asset, vous pouvez utiliser le champ ad_group.id 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 composants sont agrégées dans l'ad_group_ad_asset_view. Cette vue collecte les métriques des composants pour chaque annonce. Par conséquent, l'interrogation de 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 donne un aperçu des caractéristiques de performances de cette association spécifique entre composant et annonce. Le tableau suivant énumère les valeurs possibles des champs performance_label.
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 pour lui attribuer un libellé de performances. |
PENDING | Nous ne disposons pas encore d'informations sur les performances de ce composant. Il est possible qu'il 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 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 composants mutable.
Pour la source des composants d'ARR, utilisez AdGroupAdAsset.source.