Vous pouvez obtenir la liste des éléments et de leurs attributs en envoyant une requête Google Ads
Google Cloud à GoogleAdsService. Composants
sont représentés par l'entité asset
, qui expose un nombre
de champs spécifiques à chaque élément.
Attributs de l'élément
La requête GAQL suivante liste tous les éléments du compte d'un annonceur le nom et le type de ressource.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Notez que vous pouvez ajouter des attributs spécifiques à chaque type
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 pour tous les
d'objets YoutubeVideoAsset
dans un compte
filtrer la valeur asset.type
(consultez les
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:
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
, la classe 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
Les métriques de performances au niveau de l'annonce pour les composants sont regroupées dans
ad_group_ad_asset_view
Cette vue recueille
pour chaque annonce. Ainsi, l'interrogation de cette vue renvoie une ligne par
le groupe d'annonces et l'annonce.
Le ad_group_ad_asset_view
expose le
attribut spécifique à la vue
performance_label
qui
fournit des insights sur les caractéristiques de performances de cette annonce
association. 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'asset a commencé à être d'impressions, mais les statistiques ne sont pas assez pertinentes un libellé de performances de l'élément. |
PENDING | Cet élément n'en comporte aucun des informations sur les performances. 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 éléments d'un compte au cours du mois écoulé, 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